Menu

## func.helpers.php

Набор функций, облегчающих труд разработчика :) Содержит функции для быстрого получения данных сущностей системы Выделено из func.php для уменьшения размера файла

##### Tags

author

  Vladislav Andreev v@salesman.pro

version

  v.1.0 (06/09/2019)

### Table of Contents

clientFormatTitle() : array<string|int, mixed>|string|array<string|int, string>
  Переформатирование имени клиента
getPeriodDeal() : array<string|int, mixed>
  Возвращает новый период для сервисной сделки
getPeriodSmart() : array<string|int, mixed>
  Помогает сформировать новый период дат на основе указанного (производтся расчет количества дней в периоде) - если начало периода 1 число месяца, то новый период делаем с 1 числа - если конец периода последнее число месяца, то конец нового периода делаем последнее число
setPeriodDeal() : string
  Усанавливает новый период для сервисной сделки
getOldTaskCount() : string
  Возвращает количество просроченных активностей по iduser
get_taskinfo() : array<string|int, mixed>
get_historyinfo() : array<string|int, mixed>
  Возвращает информацию об активности
get_accesse() : string
  Возвращает доступ к Клиенту, Контакту или Сделке для текущего сотрудника
get_accesse_other() : string
  Доступ текущего пользователя iduser1 к данным пользователя id
getUserAccesse() : string
  Определяет досутп указанного сотрудника к клиенту, контакту или сделке
get_cpaccesse() : string
  Определяет доступ к управлению контрольной точкой по её id
get_people() : array<string|int, mixed>|string
  Возвращает список подчиненных сотрудника
get_userlist() : array<string|int, mixed>|string
  Возвращает список подчиненных текущего пользователя
get_userarray() : array<string|int, mixed>
  Возвращает массив iduser пользователей
Blacklist() : array<string|int, mixed>
  Список массив e-mail(-ов), с которых запрещено принимать почту
get_user() : string
  Получение имени пользователя по его iduser
get_partnerbysite() : string
  Получение clid по сайту
current_user() : string
  Возвращает имя пользователя
current_userbylogin() : int
  Возвращает iduser по логину
current_userlogin() : string
  Получение логина пользователя по его iduser
current_userUID() : string
  Получение UID по iduser пользователя
current_client() : string
  Получение названия клиента по его clid
current_person() : string
  Получение имени контакта по его pid
current_dogovor() : string
  Название договора по его did
getUsersPhones() : array<string|int, mixed>
  Возвращает телефоны и email сотрудников Применяется для фильтрации в парсере html2data()
getPersonWPhone() : string|array<string|int, mixed>
  Получение контакта со списком телефонов в виде ссылки с учетом интеграции с телефонией
getPersonWMail() : string|array<string|int, mixed>
  Получение контакта со списком email в виде ссылки
getClientWPhone() : string|array<string|int, mixed>
  Получение клиента со списком телефонов в виде ссылки с учетом интеграции с телефонией
getClientWMail() : string|array<string|int, mixed>
  Получение клиента со списком email в виде ссылки
getAppendixClient() : string
  Получение клиента с приставкой в зависимости от типа активности. Используется в напоминаниях
getMobileFromCard() : array<string|int, mixed>
  Список мобильных номеров клиента + контакта
getPersonMobile() : array<string|int, mixed>
  Список мобильных номеров контакта
current_dogstepname() : string
  Название этапа сделки по id
current_dogstepcontent() : string|null
  Описание этапа по id
current_dogstep() : string|null
  Текущий этап сделки по её did в виде названия этапа (20, 40...)
current_dogstepid() : int|null
  id этапа сделки по did сделки
next_dogstep() : int|null
  id следующего этапа по id сделки
prev_step() : int
  возвращает id предыдущего этапа по id текущего этапа
current_dogtype() : string|int|null
  Возвращает название типа сделки по её id, либо наоборот
current_dogstatus() : string
  Возвращает название статуса закрытой сделки по id сделки
current_dstatus() : array<string|int, mixed>
  По id статуса закрытия сделки возвращает массив из названия и описания статуса
current_contract() : string
  Возвращает номер договора по его id
current_category() : int|string|null
  Возвращает навание отрасли по её id или наоборот
current_direction() : int|string|null
  Возвращает название направления по её id или наоборот
current_company() : int|string|null
  Возвращает название нашей компании по её id или наоборот
getSigner() : array<string|int, mixed>
  Получение подписанта или списка подписантов Если не указан ни один параметр, то возвращает всех подписантов в массиве, где ключи - id компаний
current_territory() : int|string|null
  Возвращает название территории по её id или наоборот
current_clientpath() : string
  Возвращает название Канала по id клиента
current_clientpathbyid() : string
  Возвращает название Канала по его id
current_loyalty() : int|string|null
  Возвращает название Типа лояльности по её id или наоборот
isServices() : bool|array<string|int, mixed>
  Возвращает true, если тип сделки относится к ежемесячным Если id не указан возвращает массив id типов сделок, относящихся к сервисным
get_client_category() : string
  Возвращает название отрасли по её id
get_userid() : int
  Возвращает ответственного по типу и id записи tip: clid, pid, did
get_client_info() : string|array<string|int, mixed>
  Возвращает массив данных по клиенту
get_client_recv() : array<string|int, mixed>|string
  Возвращает реквизиты клиента в массиве или в формате json
get_person_info() : array<string|int, mixed>|string|array<string|int, string>
  Возвращает базовую информацию по контакту в виде массива
get_dog_info() : array<string|int, mixed>|string|array<string|int, string>
  Возвращает базовую информацию по сделке в виде массива
rsadd() : bool
  Действие. Перемещение денег со счета на счет
DealStepLog() : bool
  Логгирование движения сделок по этапам
generate_num() : mixed|string
  формирует номер договора, счета и акта
genDocsNum() : mixed|string
  формирует номер пользовательского документа
getPrevNextStep() : array<string|int, mixed>
  Получение массива: title - Название этапа, content - Расшифровка, id
getMultiStepList() : array<string|int, mixed>
  возвращает информацию по мультиворонке
set_capacity() : mixed
  Устанавливает потенциал клиента функцию надо вызывать при закрытии сделки
getNewTag() : array<string|int, mixed>
  Возвращает массив тэгов для вставки в документы
getSmartTag() : array<string|int, mixed>
  Расширяет функцию getNewTag и дополняет новыми данными
getCallerID() : mixed|string
  По номеру телефона возвращает CallerID (имя абонента) Также создает глобальные переменные - !отключено с версии 2018.6 global $clientID - clid global $clientTitle - Название клиента global $personID - pid global $personTitle - Имя контакта global $userID - iduser global $userTitle - Имя пользователя
getxCallerID() : array<string|int, mixed>|array<string|int, string>
  По номеру телефона возвращает массив данных - int clientID - clid - clientTitle - Название клиента - int personID - pid - personTitle - Имя контакта - int userID - iduser - userTitle - Имя пользователя - callerID - Имя абонента - phonein - Внутренний номер
getCaller() : array<string|int, mixed>
  Аналог функции getCallerID, возвращает данные в виде массива
getUserID() : mixed
  Возвращает iduser сотрудника по внутреннему номеру
reCalculate() : string
  Пересчет сумм по сделке
addProviderRashod() : string
  Добавляет расход по поставщикам, партнерам в бюджет
getProviderSum() : float
  Расчет затрат на партнеров и поставщиков по сделке
getSpecaSum() : float|int
  Расчет себестоимости по сделке
get_nds() : string
  Расчет НДС по сделке
getSpekaData() : array<string|int, mixed>|null
  Возвращает спецификацию по сделке в массиве
getCreditData() : array<string|int, mixed>|null
  Возвращает массив выставленных счетов по сделке
getNalog() : array<string|int, mixed>
  Расчет налога если он в цене или добавляется сверху
getNalogScheme() : array<string|int, mixed>
  Возвращает информацию по налоговой схеме по расчетному счету или счету по умолчанию у компании
getMargaPayed() : int|string
  функция возвращает сумму маржи с оплаченной суммы, т.к. сумма оплаты может отличаться от сумы маржи по сделке
addHistorty() : int
  Добавляет запись в историю активности
editHistorty() : mixed
  Редактирование записи активности
getClientData() : string
  Возвращает указанный параметр по клиенту
getPersonData() : string
  Возвращает указанный параметр по контакту
getDogData() : string
  Возвращает указанный параметр по сделке
getClientpath() : int
  Возвращает id канала для трекинга источника клиента Если канал не найден в БД, то создает его
getClientCategory() : int
  id отрасли по названию
getClientTerritory() : int
  id территории по названию
getClientRelation() : string
  Проверка Типа отношений по названию Если не найден - создаем
getPersonLoyalty() : int
  Возвращает id типа лояльности по имени Если не найдено - создает
getTipTask() : string
  Если тип активности не наден по имени, то создает её
getTipHistory() : int
  Возвращает id типа активности по имени Если не найдено, то создает новую и возвращает id
getDogTip() : int
  Возвращает id типа сделки по имени Если не надено, то создает новый тип
getStep() : int
  Возвращает id этапа сделки по значению
getDirection() : int
  Возвращает id направления по названию
getStatusClose() : int
  Возвращает id статуса закрытия сделки
prepareLinkByTip() : string
  Подготавливает ссылку по типу: phone, email
personinfo() : array<string|int, mixed>
  инструменты для системы событий
dealFields() : array<string|int, mixed>
  Поля для сделок
clientFields() : array<string|int, mixed>
  Поля для клиентов
callTrack() : int
  Сопоставление номера телефона клиента, номера линии или clid с источником клиента Возвращает id источника
getPriceCatalog() : array<string|int, mixed>
  Вывод категорий прайса любой степени вложенности
addToService() : array<string|int, mixed>
  Добавление записи в группу почтового сервиса
getFilterQuery() : array<string|int, mixed>|string
  Возвращает SQL запрос для формирования списков Клиентов, Контактов и Сделок
doLogger() : string
  Лог изменений в записях Клиента, Контакта, Сделки
otherSettings() : array<string|int, mixed>|mixed
  Получает прочие настройки системы ( параметр other )
getMargaSum() : float|int
  Расчет маржи по сделке с учетом расходов

### Functions

#### clientFormatTitle()

func.helpers.php : 40

Переформатирование имени клиента

`clientFormatTitle( $string) : array<string|int, mixed>|string|array<string|int, string>`

##### Parameters

$string :

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|string|array<string|int, string> —

#### getPeriodDeal()

func.helpers.php : 73

Возвращает новый период для сервисной сделки

`getPeriodDeal( $did) : array<string|int, mixed>`

##### Parameters

$did :

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### getPeriodSmart()

func.helpers.php : 135

Помогает сформировать новый период дат на основе указанного (производтся расчет количества дней в периоде) - если начало периода 1 число месяца, то новый период делаем с 1 числа - если конец периода последнее число месяца, то конец нового периода делаем последнее число

`getPeriodSmart([string|null $start = NULL ][, string|null $end = NULL ]) : array<string|int, mixed>`

##### Parameters

$start : string|null = NULL
$end : string|null = NULL

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### setPeriodDeal()

func.helpers.php : 195

Усанавливает новый период для сервисной сделки

`setPeriodDeal(int $did[, string|null $d1 = NULL ][, string|null $d2 = NULL ]) : string`

##### Parameters

$did : int
$d1 : string|null = NULL
  - date
$d2 : string|null = NULL
  - date

##### Tags

category

  Core

##### Return values

string —

#### getOldTaskCount()

func.helpers.php : 226

Возвращает количество просроченных активностей по iduser

`getOldTaskCount( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### get_taskinfo()

func.helpers.php : 245
`get_taskinfo( $id) : array<string|int, mixed>`

##### Parameters

$id :

##### Tags

deprecated

  Возвращает информацию по напоминанию по его id

category

  Core

##### Return values

array<string|int, mixed> —

#### get_historyinfo()

func.helpers.php : 281

Возвращает информацию об активности

`get_historyinfo( $id) : array<string|int, mixed>`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### get_accesse()

func.helpers.php : 315

Возвращает доступ к Клиенту, Контакту или Сделке для текущего сотрудника

`get_accesse([int|null $clidd = NULL ][, int|null $pidd = NULL ][, int|null $didd = NULL ]) : string`

##### Parameters

$clidd : int|null = NULL
$pidd : int|null = NULL
$didd : int|null = NULL

##### Tags

category

  Core

##### Return values

string —

#### get_accesse_other()

func.helpers.php : 465

Доступ текущего пользователя iduser1 к данным пользователя id

`get_accesse_other( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### getUserAccesse()

func.helpers.php : 542

Определяет досутп указанного сотрудника к клиенту, контакту или сделке

`getUserAccesse( $iduser[, array<string|int, mixed>|null $params = [] ]) : string`

##### Parameters

$iduser :
$params : array<string|int, mixed>|null = []

##### Tags

category

  Core

##### Return values

string —

#### get_cpaccesse()

func.helpers.php : 668

Определяет доступ к управлению контрольной точкой по её id

`get_cpaccesse( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### get_people()

func.helpers.php : 719

Возвращает список подчиненных сотрудника

`get_people( $iuser[, string $asarray = "no" ][, bool $onlyactive = false ]) : array<string|int, mixed>|string`

##### Parameters

$iuser :
$asarray : string = "no"
  - "yes" возвращает массив
$onlyactive : bool = false
  - true - учитывает только активных сотрудников

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|string —

#### get_userlist()

func.helpers.php : 805

Возвращает список подчиненных текущего пользователя

`get_userlist( $iuser[, bool $asarray = false ]) : array<string|int, mixed>|string`

##### Parameters

$iuser :
$asarray : bool = false

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|string —

#### get_userarray()

func.helpers.php : 864

Возвращает массив iduser пользователей

`get_userarray() : array<string|int, mixed>`

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### Blacklist()

func.helpers.php : 881

Список массив e-mail(-ов), с которых запрещено принимать почту

`Blacklist() : array<string|int, mixed>`

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### get_user()

func.helpers.php : 908

Получение имени пользователя по его iduser

`get_user( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### get_partnerbysite()

func.helpers.php : 932

Получение clid по сайту

`get_partnerbysite( $name) : string`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

string —

#### current_user()

func.helpers.php : 966

Возвращает имя пользователя

`current_user( $id[, string $short = 'no' ]) : string`

##### Parameters

$id :
$short : string = 'no'

  = "yes" для получения только Имя + Фамилия

##### Tags

category

  Core

##### Return values

string —

#### current_userbylogin()

func.helpers.php : 1007

Возвращает iduser по логину

`current_userbylogin( $login) : int`

##### Parameters

$login :

##### Tags

category

  Core

##### Return values

int —

#### current_userlogin()

func.helpers.php : 1034

Получение логина пользователя по его iduser

`current_userlogin( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_userUID()

func.helpers.php : 1061

Получение UID по iduser пользователя

`current_userUID( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_client()

func.helpers.php : 1088

Получение названия клиента по его clid

`current_client( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_person()

func.helpers.php : 1119

Получение имени контакта по его pid

`current_person( $id[, bool $short = true ]) : string`

##### Parameters

$id :
$short : bool = true

##### Tags

category

  Core

##### Return values

string —

#### current_dogovor()

func.helpers.php : 1157

Название договора по его did

`current_dogovor( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### getUsersPhones()

func.helpers.php : 1186

Возвращает телефоны и email сотрудников Применяется для фильтрации в парсере html2data()

`getUsersPhones() : array<string|int, mixed>`

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### getPersonWPhone()

func.helpers.php : 1229

Получение контакта со списком телефонов в виде ссылки с учетом интеграции с телефонией

`getPersonWPhone( $id[, bool $format = true ]) : string|array<string|int, mixed>`

##### Parameters

$id :
$format : bool = true
  - если true, то возвращает строку, иначе массив

##### Tags

category

  Core

##### Return values

string|array<string|int, mixed> —

#### getPersonWMail()

func.helpers.php : 1282

Получение контакта со списком email в виде ссылки

`getPersonWMail( $id[, bool $format = true ]) : string|array<string|int, mixed>`

##### Parameters

$id :
$format : bool = true
  - если true, то возвращает строку, иначе массив

##### Tags

category

  Core

##### Return values

string|array<string|int, mixed> —

#### getClientWPhone()

func.helpers.php : 1332

Получение клиента со списком телефонов в виде ссылки с учетом интеграции с телефонией

`getClientWPhone( $id[, bool $format = true ]) : string|array<string|int, mixed>`

##### Parameters

$id :
$format : bool = true
  - если true, то возвращает строку, иначе массив

##### Tags

category

  Core

##### Return values

string|array<string|int, mixed> —

#### getClientWMail()

func.helpers.php : 1380

Получение клиента со списком email в виде ссылки

`getClientWMail( $id[, bool $format = true ]) : string|array<string|int, mixed>`

##### Parameters

$id :
$format : bool = true
  - если true, то возвращает строку, иначе массив

##### Tags

category

  Core

##### Return values

string|array<string|int, mixed> —

#### getAppendixClient()

func.helpers.php : 1429

Получение клиента с приставкой в зависимости от типа активности. Используется в напоминаниях

`getAppendixClient( $tip, $clid) : string`

##### Parameters

$tip :
$clid :

##### Tags

category

  Core

##### Return values

string —

#### getMobileFromCard()

func.helpers.php : 1459

Список мобильных номеров клиента + контакта

`getMobileFromCard(int $clid, int $pid[, bool $all = false ]) : array<string|int, mixed>`

##### Parameters

$clid : int
$pid : int
$all : bool = false
  - искать номера среди всех контактов клиента, а не только основной

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### getPersonMobile()

func.helpers.php : 1583

Список мобильных номеров контакта

`getPersonMobile(int $pid) : array<string|int, mixed>`

##### Parameters

$pid : int

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### current_dogstepname()

func.helpers.php : 1622

Название этапа сделки по id

`current_dogstepname( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_dogstepcontent()

func.helpers.php : 1647

Описание этапа по id

`current_dogstepcontent( $id) : string|null`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string|null —

#### current_dogstep()

func.helpers.php : 1672

Текущий этап сделки по её did в виде названия этапа (20, 40...)

`current_dogstep( $id) : string|null`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string|null —

#### current_dogstepid()

func.helpers.php : 1699

id этапа сделки по did сделки

`current_dogstepid( $id) : int|null`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

int|null —

#### next_dogstep()

func.helpers.php : 1726

id следующего этапа по id сделки

`next_dogstep( $id) : int|null`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

int|null —

#### prev_step()

func.helpers.php : 1765

возвращает id предыдущего этапа по id текущего этапа

`prev_step( $id) : int`

##### Parameters

$id :
  - id этапа сделки

##### Tags

category

  Core

##### Return values

int —

#### current_dogtype()

func.helpers.php : 1803

Возвращает название типа сделки по её id, либо наоборот

`current_dogtype( $id[, string|null $title = NULL ]) : string|int|null`

##### Parameters

$id :
$title : string|null = NULL

##### Tags

category

  Core

##### Return values

string|int|null —

#### current_dogstatus()

func.helpers.php : 1834

Возвращает название статуса закрытой сделки по id сделки

`current_dogstatus( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_dstatus()

func.helpers.php : 1872

По id статуса закрытия сделки возвращает массив из названия и описания статуса

`current_dstatus( $id) : array<string|int, mixed>`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### current_contract()

func.helpers.php : 1896

Возвращает номер договора по его id

`current_contract( $id) : string`

##### Parameters

$id :

##### Return values

string —

#### current_category()

func.helpers.php : 1927

Возвращает навание отрасли по её id или наоборот

`current_category( $id[, string|null $title = NULL ]) : int|string|null`

##### Parameters

$id :
$title : string|null = NULL

##### Tags

category

  Core

##### Return values

int|string|null —

#### current_direction()

func.helpers.php : 1959

Возвращает название направления по её id или наоборот

`current_direction( $id[, string|null $title = NULL ]) : int|string|null`

##### Parameters

$id :
$title : string|null = NULL

##### Tags

category

  Core

##### Return values

int|string|null —

#### current_company()

func.helpers.php : 1990

Возвращает название нашей компании по её id или наоборот

`current_company( $id[, string|null $title = NULL ]) : int|string|null`

##### Parameters

$id :
$title : string|null = NULL

##### Tags

category

  Core

##### Return values

int|string|null —

#### getSigner()

func.helpers.php : 2022

Получение подписанта или списка подписантов Если не указан ни один параметр, то возвращает всех подписантов в массиве, где ключи - id компаний

`getSigner([int|null $id = NULL ][, int|null $mcid = NULL ]) : array<string|int, mixed>`

##### Parameters

$id : int|null = NULL
  - id подписанта
$mcid : int|null = NULL
  - id компании

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### current_territory()

func.helpers.php : 2096

Возвращает название территории по её id или наоборот

`current_territory( $id[, string|null $title = NULL ]) : int|string|null`

##### Parameters

$id :
$title : string|null = NULL

##### Tags

category

  Core

##### Return values

int|string|null —

#### current_clientpath()

func.helpers.php : 2127

Возвращает название Канала по id клиента

`current_clientpath( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_clientpathbyid()

func.helpers.php : 2155

Возвращает название Канала по его id

`current_clientpathbyid( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### current_loyalty()

func.helpers.php : 2183

Возвращает название Типа лояльности по её id или наоборот

`current_loyalty( $id[, string|null $title = NULL ]) : int|string|null`

##### Parameters

$id :
$title : string|null = NULL

##### Tags

category

  Core

##### Return values

int|string|null —

#### isServices()

func.helpers.php : 2214

Возвращает true, если тип сделки относится к ежемесячным Если id не указан возвращает массив id типов сделок, относящихся к сервисным

`isServices(string $id) : bool|array<string|int, mixed>`

##### Parameters

$id : string

##### Tags

category

  Core

##### Return values

bool|array<string|int, mixed> —

#### get_client_category()

func.helpers.php : 2242

Возвращает название отрасли по её id

`get_client_category( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### get_userid()

func.helpers.php : 2271

Возвращает ответственного по типу и id записи tip: clid, pid, did

`get_userid( $tip, $id) : int`

##### Parameters

$tip :
$id :

##### Tags

category

  Core

##### Return values

int —

#### get_client_info()

func.helpers.php : 2337

Возвращает массив данных по клиенту

`get_client_info( $id[, string $isArray = 'no' ]) : string|array<string|int, mixed>`

##### Parameters

$id :
$isArray : string = 'no'

  = yes возвращает в виде массива (default = no, в виде JSON)

##### Tags

category

  Core

##### Return values

string|array<string|int, mixed> —

"clid" - ID клиента "uid" - UID клиента "clientUID" - UID клиента "type" - тип записи (client, person, partner, concurent, contractor) "title" - название клиента "des" - описание клиента "idcategory" - ID отрасли "category" - название отрасли "phone" - список телефонов "fax" - список факсов "site_url" - сайт "mail_url" - список email "address" - адрес "iduser" - ID ответственного "pid" - ID основного контакта "fav" - в избранном (no|yes) "trash" - в корзине (no|yes) "head_clid" - ID головного клиента "head" - Название головного клиента "scheme" - Принятие решений "tip_cmr" - Тип отношений "relation" - тип отношений "territory" - ID территории "territoryname" - название Территории "date_create" - дата создания "creator" - имя автора "date_edit" - дата последнего редактирования "editor" - имя редактора "recv" - массив реквизитов "dostup" - массив iduser, у которых есть доступ к карточке "clientpath" - название Канала "clientpath2" - ID канала "priceLevel" - уровень цен "inputXXX" - доп.поля

#### get_client_recv()

func.helpers.php : 2444

Возвращает реквизиты клиента в массиве или в формате json

`get_client_recv( $id[, string $isArray = 'no' ]) : array<string|int, mixed>|string`

##### Parameters

$id :
$isArray : string = 'no'

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|string —

#### get_person_info()

func.helpers.php : 2503

Возвращает базовую информацию по контакту в виде массива

`get_person_info( $id[, string $isArray = 'no' ]) : array<string|int, mixed>|string|array<string|int, string>`

##### Parameters

$id :
$isArray : string = 'no'

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|string|array<string|int, string> —

#### get_dog_info()

func.helpers.php : 2565

Возвращает базовую информацию по сделке в виде массива

`get_dog_info( $id[, string $isArray = 'no' ]) : array<string|int, mixed>|string|array<string|int, string>`

##### Parameters

$id :
$isArray : string = 'no'

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|string|array<string|int, string> —

#### rsadd()

func.helpers.php : 2625

Действие. Перемещение денег со счета на счет

`rsadd(int $rs[, float $summa = 0.0 ][, string|null $operacia = NULL ][, string|null $rs_move = NULL ]) : bool`

##### Parameters

$rs : int
$summa : float = 0.0
$operacia : string|null = NULL
$rs_move : string|null = NULL

##### Tags

see
  Budget::rsadd()
deprecated
category

  Core

##### Return values

bool —

#### DealStepLog()

func.helpers.php : 2641

Логгирование движения сделок по этапам

`DealStepLog( $did, $step) : bool`

##### Parameters

$did :
$step :

##### Tags

category

  Core

##### Return values

bool —

#### generate_num()

func.helpers.php : 2677

формирует номер договора, счета и акта

`generate_num( $tip) : mixed|string`

##### Parameters

$tip :
  - contract - номер документа
  - invoice - номер счета
  - akt - номер акта
  - dogovor - номер сделки
  - namedogovor - название сделки

##### Tags

category

  Core

##### Return values

mixed|string —

#### genDocsNum()

func.helpers.php : 2769

формирует номер пользовательского документа

`genDocsNum( $id[, bool $onlyNum = false ]) : mixed|string`

##### Parameters

$id :
$onlyNum : bool = false

##### Tags

category

  Core

##### Return values

mixed|string —

#### getPrevNextStep()

func.helpers.php : 2834

Получение массива: title - Название этапа, content - Расшифровка, id

`getPrevNextStep( $id[, string $tip = 'current' ]) : array<string|int, mixed>`

##### Parameters

$id :
$tip : string = 'current'
  - default = current, next, prev

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### getMultiStepList()

func.helpers.php : 2916

возвращает информацию по мультиворонке

`getMultiStepList([array<string|int, mixed> $opt = [] ]) : array<string|int, mixed>`

##### Parameters

$opt : array<string|int, mixed> = []
  - параметры did - id сделки steps - массив этапов: id => длительность этапа default - id этапа по умолчанию length - длительность воронки current - текущий этап: id, title next - следующий этап: id, title prev - предыдущий этап: id, title $opt['steps'] - возвращает только этапы по сделке, работает вместе с $opt['did'] $opt['direction'] > 0, $opt['tip'] < 1 - возвращает все воронки по id Направления. Индекс = tip $opt['direction'] < 1, $opt['tip'] > 0 - возвращает все воронки по id Типа сделки. Индекс = direction $opt['direction'] > 0, $opt['tip'] > 0 - возвращает воронку $opt не установлен - возвращает все наборы воронок

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### set_capacity()

func.helpers.php : 3207

Устанавливает потенциал клиента функцию надо вызывать при закрытии сделки

`set_capacity( $id) : mixed`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

mixed —

#### getNewTag()

func.helpers.php : 3255

Возвращает массив тэгов для вставки в документы

`getNewTag(int $deid, int $did, int $clid, int $mcid, int $pid) : array<string|int, mixed>`

##### Parameters

$deid : int
  - идентификатор документа
$did : int
  - идентификатор сделки
$clid : int
  - идентификатор клиента, автоматически находим по did
$mcid : int
  - идентификатор собственной компании
$pid : int
  - идентификатор контакта

##### Tags

throws
  Exception
category

  Core

uses

  getNewTag('100','20');

##### Return values

array<string|int, mixed> —

#### getSmartTag()

func.helpers.php : 3885

Расширяет функцию getNewTag и дополняет новыми данными

`getSmartTag(int $did, int $clid, int $pid) : array<string|int, mixed>`

##### Parameters

$did : int
$clid : int
$pid : int

##### Tags

throws
  Exception
category

  Core

##### Return values

array<string|int, mixed> —

#### getCallerID()

func.helpers.php : 4030

По номеру телефона возвращает CallerID (имя абонента) Также создает глобальные переменные - !отключено с версии 2018.6 global $clientID - clid global $clientTitle - Название клиента global $personID - pid global $personTitle - Имя контакта global $userID - iduser global $userTitle - Имя пользователя

`getCallerID(string $phone[, bool $shownum = false ][, bool $translit = false ][, bool $full = false ]) : mixed|string`

##### Parameters

$phone : string
  - номер телефона
$shownum : bool = false
  - возвращать с Именем и номер телефона
$translit : bool = false
  - транслетировать имя
$full : bool = false
  - вернуть полный массив результатов

##### Tags

category

  Core

##### Return values

mixed|string —

#### getxCallerID()

func.helpers.php : 4224

По номеру телефона возвращает массив данных - int clientID - clid - clientTitle - Название клиента - int personID - pid - personTitle - Имя контакта - int userID - iduser - userTitle - Имя пользователя - callerID - Имя абонента - phonein - Внутренний номер

`getxCallerID(string $phone[, bool $shownum = false ][, bool $translit = false ]) : array<string|int, mixed>|array<string|int, string>`

##### Parameters

$phone : string
  - номер телефона
$shownum : bool = false
  - возвращать с Именем и номер телефона
$translit : bool = false
  - транслетировать имя

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|array<string|int, string> —

#### getCaller()

func.helpers.php : 4420

Аналог функции getCallerID, возвращает данные в виде массива

`getCaller( $phone) : array<string|int, mixed>`

##### Parameters

$phone :

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

[ "clid" => $clientID, "client" => $clientTitle, "pid" => $personID, "person" => $personTitle, "iduser" => $userID, "user" => $userTitle, "extension" => $phoneIN, "mob" => $mob, "callerID" => $callerID ]

#### getUserID()

func.helpers.php : 4572

Возвращает iduser сотрудника по внутреннему номеру

`getUserID( $phone) : mixed`

##### Parameters

$phone :

##### Tags

category

  Core

##### Return values

mixed —

$userID

#### reCalculate()

func.helpers.php : 4595

Пересчет сумм по сделке

`reCalculate( $did) : string`

##### Parameters

$did :

##### Tags

category

  Core

##### Return values

string —

#### addProviderRashod()

func.helpers.php : 4692

Добавляет расход по поставщикам, партнерам в бюджет

`addProviderRashod( $did, $summa) : string`

##### Parameters

$did :
$summa :

##### Tags

category

  Core

##### Return values

string —

#### getProviderSum()

func.helpers.php : 4781

Расчет затрат на партнеров и поставщиков по сделке

`getProviderSum( $did) : float`

##### Parameters

$did :

##### Tags

category

  Core

##### Return values

float —

#### getSpecaSum()

func.helpers.php : 4801

Расчет себестоимости по сделке

`getSpecaSum( $did) : float|int`

##### Parameters

$did :

##### Tags

category

  Core

##### Return values

float|int —

#### get_nds()

func.helpers.php : 4831

Расчет НДС по сделке

`get_nds( $id) : string`

##### Parameters

$id :

##### Tags

category

  Core

##### Return values

string —

#### getSpekaData()

func.helpers.php : 4875

Возвращает спецификацию по сделке в массиве

`getSpekaData( $did, int $rs) : array<string|int, mixed>|null`

##### Parameters

$did :
$rs : int

##### Tags

see
  Speka::getSpekaData()
deprecated
deprecated
category

  Core

##### Return values

array<string|int, mixed>|null —

#### getCreditData()

func.helpers.php : 4893

Возвращает массив выставленных счетов по сделке

`getCreditData( $did) : array<string|int, mixed>|null`

##### Parameters

$did :

##### Tags

deprecated
see
  Invoice::getCreditData()
category

  Core

##### Return values

array<string|int, mixed>|null —

#### getNalog()

func.helpers.php : 4910

Расчет налога если он в цене или добавляется сверху

`getNalog( $summa[, float|null $nalog = NULL ][, string|null $type = NULL ]) : array<string|int, mixed>`

##### Parameters

$summa :
$nalog : float|null = NULL
$type : string|null = NULL

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### getNalogScheme()

func.helpers.php : 4954

Возвращает информацию по налоговой схеме по расчетному счету или счету по умолчанию у компании

`getNalogScheme( $rs, int $mcid) : array<string|int, mixed>`

##### Parameters

$rs :
$mcid : int

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### getMargaPayed()

func.helpers.php : 4995

функция возвращает сумму маржи с оплаченной суммы, т.к. сумма оплаты может отличаться от сумы маржи по сделке

`getMargaPayed( $did[, array<string|int, mixed> $param = [] ]) : int|string`

##### Parameters

$did :
$param : array<string|int, mixed> = []

##### Tags

category

  Core

##### Return values

int|string —

#### addHistorty()

func.helpers.php : 5058

Добавляет запись в историю активности

`addHistorty([array<string|int, mixed> $params = [] ]) : int`

##### Parameters

$params : array<string|int, mixed> = []

##### Tags

category

  Core

##### Return values

int —

#### editHistorty()

func.helpers.php : 5120

Редактирование записи активности

`editHistorty( $id[, array<string|int, mixed> $params = [] ]) : mixed`

##### Parameters

$id :
$params : array<string|int, mixed> = []

##### Tags

throws
  Exception
category

  Core

##### Return values

mixed —

#### getClientData()

func.helpers.php : 5168

Возвращает указанный параметр по клиенту

`getClientData( $id, $tip) : string`

##### Parameters

$id :
$tip :

##### Tags

category

  Core

##### Return values

string —

#### getPersonData()

func.helpers.php : 5188

Возвращает указанный параметр по контакту

`getPersonData( $id, $tip) : string`

##### Parameters

$id :
$tip :

##### Tags

category

  Core

##### Return values

string —

#### getDogData()

func.helpers.php : 5216

Возвращает указанный параметр по сделке

`getDogData( $id, $tip) : string`

##### Parameters

$id :
$tip :

##### Tags

category

  Core

##### Return values

string —

#### getClientpath()

func.helpers.php : 5238

Возвращает id канала для трекинга источника клиента Если канал не найден в БД, то создает его

`getClientpath( $path[, string|null $source = NULL ][, string|null $destination = NULL ]) : int`

##### Parameters

$path :
$source : string|null = NULL
$destination : string|null = NULL

##### Tags

category

  Core

##### Return values

int —

#### getClientCategory()

func.helpers.php : 5280

id отрасли по названию

`getClientCategory( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getClientTerritory()

func.helpers.php : 5316

id территории по названию

`getClientTerritory( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getClientRelation()

func.helpers.php : 5354

Проверка Типа отношений по названию Если не найден - создаем

`getClientRelation( $name) : string`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

string —

#### getPersonLoyalty()

func.helpers.php : 5388

Возвращает id типа лояльности по имени Если не найдено - создает

`getPersonLoyalty( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getTipTask()

func.helpers.php : 5424

Если тип активности не наден по имени, то создает её

`getTipTask( $name) : string`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

string —

#### getTipHistory()

func.helpers.php : 5451

Возвращает id типа активности по имени Если не найдено, то создает новую и возвращает id

`getTipHistory( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getDogTip()

func.helpers.php : 5479

Возвращает id типа сделки по имени Если не надено, то создает новый тип

`getDogTip( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getStep()

func.helpers.php : 5506

Возвращает id этапа сделки по значению

`getStep( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getDirection()

func.helpers.php : 5535

Возвращает id направления по названию

`getDirection( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### getStatusClose()

func.helpers.php : 5562

Возвращает id статуса закрытия сделки

`getStatusClose( $name) : int`

##### Parameters

$name :

##### Tags

category

  Core

##### Return values

int —

#### prepareLinkByTip()

func.helpers.php : 5589

Подготавливает ссылку по типу: phone, email

`prepareLinkByTip( $t, $s) : string`

##### Parameters

$t :
$s :

##### Tags

category

  Core

##### Return values

string —

#### personinfo()

func.helpers.php : 5638

инструменты для системы событий

`personinfo( $pid) : array<string|int, mixed>`

##### Parameters

$pid :

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### dealFields()

func.helpers.php : 5669

Поля для сделок

`dealFields() : array<string|int, mixed>`

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### clientFields()

func.helpers.php : 5714

Поля для клиентов

`clientFields() : array<string|int, mixed>`

##### Tags

category

  Core

##### Return values

array<string|int, mixed> —

#### callTrack()

func.helpers.php : 5747

Сопоставление номера телефона клиента, номера линии или clid с источником клиента Возвращает id источника

`callTrack( $phone[, string $dest = NULL ][, int $clid = NULL ][, bool $update = false ]) : int`

##### Parameters

$phone :
$dest : string = NULL
$clid : int = NULL
$update : bool = false

  (true - обновляет источник клиента в базе)

##### Tags

category

  Core

##### Return values

int —

#### getPriceCatalog()

func.helpers.php : 5824

Вывод категорий прайса любой степени вложенности

`getPriceCatalog(int $id, int $level[, array<string|int, mixed> $ures = [] ]) : array<string|int, mixed>`

##### Parameters

$id : int
  - id категории или 0, для вывода всех
$level : int
  - уровень вывода
$ures : array<string|int, mixed> = []
  - глобальный массив, не заполняется

##### Tags

deprecated
see
  Price::getPriceCatalog()
category

  Core

##### Return values

array<string|int, mixed> —

#### addToService()

func.helpers.php : 5842

Добавление записи в группу почтового сервиса

`addToService( $tip, $id, int $gid) : array<string|int, mixed>`

##### Parameters

$tip :
$id :
$gid : int

##### Tags

throws
  Exception
deprecated

  Функционал удален

category

  Core

##### Return values

array<string|int, mixed> —

#### getFilterQuery()

func.helpers.php : 5867

Возвращает SQL запрос для формирования списков Клиентов, Контактов и Сделок

`getFilterQuery( $tip[, array<string|int, mixed> $params = [] ][, bool $countQuery = true ]) : array<string|int, mixed>|string`

##### Parameters

$tip :

  : client, person or dogovor

$params : array<string|int, mixed> = []
  - array fields - перечень полей, которые будут добавлены в запрос
  - bool excludeDostup - исключение записей, к которым есть доступ
  - string selectplus - дополнительные параметры для блока SELECT, разделенные запятой
  - bool namereplace - true | false - включить переименование полей, правила передаются в параметре freplace
  - array freplace - массив для переименования полей. например "title" => "name" будет "title as name"
$countQuery : bool = true

  : выводить запрос на расчет количества, если false, то возвращает строку запроса

##### Tags

throws
  Exception
category

  Core

##### Return values

array<string|int, mixed>|string —

#### doLogger()

func.helpers.php : 7757

Лог изменений в записях Клиента, Контакта, Сделки

`doLogger( $tip, $id[, array<string|int, mixed> $param = [] ][, array<string|int, mixed> $oldparam = [] ][, bool $add = false ]) : string`

##### Parameters

$tip :
$id :
$param : array<string|int, mixed> = []
$oldparam : array<string|int, mixed> = []
$add : bool = false

##### Tags

throws
  Exception
category

  Core

##### Return values

string —

#### otherSettings()

func.helpers.php : 8227

Получает прочие настройки системы ( параметр other )

`otherSettings([array<string|int, mixed> $params = [] ]) : array<string|int, mixed>|mixed`

##### Parameters

$params : array<string|int, mixed> = []
  - int identity
  - string name - имя параметра, если не указано возвращает массив всех параметров

##### Tags

category

  Core

##### Return values

array<string|int, mixed>|mixed —

#### getMargaSum()

func.helpers.php : 8315

Расчет маржи по сделке с учетом расходов

`getMargaSum( $did) : float|int`

##### Parameters

$did :

##### Tags

category

  Core

##### Return values

float|int —

## Search results