Набор данных — это информация по лидам, сделкам, пользовательским полям, компаниям и другим элементам Битрикс24. Данные можно использовать в BI Конструкторе, Power BI, DataLens и Looker Studio. Они помогут создать новые отчеты и дополнить существующие.
В статье перечислим все доступные наборы данных и описание их полей.
Сделки
Cделки — crm_deal
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ, число |
DATE_CREATE
|
Время создания сделки |
DATE_MODIFY
|
Время изменения сделки |
CREATED_BY_ID
|
Идентификатор создателя, число |
CREATED_BY
|
Создатель, строка, ID и имя сотрудника, который создал сделку |
MODIFY_BY_ID
|
Идентификатор редактора, число |
MODIFIED_BY
|
Редактор, строка, ID и имя автора внесшего последние изменения |
ASSIGNED_BY_ID
|
Идентификатор ответственного, число |
ASSIGNED_BY
|
Ответственный, строка, ID и имя ответственного за сделку |
ASSIGNED_BY_DEPARTMENT
|
Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании |
OPENED
|
Открыт, строка (Y - да, N - нет), открыт для всех сотрудников или нет (относится к правам доступа) |
LEAD_ID
|
Идентификатор лида, число – появляется только при конверсии Лида в Сделку |
COMPANY_ID
|
Идентификатор компании, число - важно, что это просто связанная компания, это не результат конвертации |
COMPANY
|
Компания, строка, ID и название компании |
CONTACT_ID
|
Идентификатор контакта, устаревший, число, важно, что это просто связанный контакт, это не результат конвертации |
CONTACT
|
Контакт, строка, ID и имя контакта |
TITLE
|
Название сделки, строка |
CRM_PRODUCT
|
Товар из CRM (может быть несколько), строка, ID и названия товаров |
CATEGORY
|
Направление сделки, строка, ID и название. |
STAGE_ID
|
Идентификатор стадии, строка |
STAGE
|
Стадия, строка, ID и название стадии |
STAGE_SEMANTIC_ID
|
Идентификатор типа статуса (STAGE_SEMANTIC_ID), строка: "F": "(failed) - обработана неуспешно", "S": "(success) - обработана успешно", "P": "(processing) - сделка в обработке" |
STAGE_SEMANTIC
|
Тип статуса, строка, описание семантического статуса, например "Успех", "Провал", "В работе" |
IS_NEW
|
Новая сделка, строка (Y - да, N - нет), сделка находится в "первой" стадии воронки |
IS_RECURRING
|
Регулярная сделка, строка Y - да, N - нет |
IS_RETURN_CUSTOMER
|
Вернувшийся клиент, строка (Y - да, N - нет) |
CLOSED
|
Закрыта, строка (Y - да, N - нет), если сделка переводится в какую-то финальную стадию |
TYPE_ID
|
Тип сделки, строка, тип сделки, например "SALE" |
OPPORTUNITY
|
Ожидаемая сумма, число |
IS_MANUAL_OPPORTUNITY
|
Ожидаемая сумма введена вручную, строка Y - да, N - нет |
TAX_VALUE
|
Налог, число |
CURRENCY_ID
|
Валюта, строка ("RUB") |
OPPORTUNITY_ACCOUNT
|
Сумма в валюте отчетов, число |
TAX_VALUE_ACCOUNT
|
Налог в валюте отчетов, число |
ACCOUNT_CURRENCY_ID
|
Валюта отчета, строка ("RUB") |
PROBABILITY
|
Вероятность, число (23, 57, 12), вероятность (скоринг) перехода в успешный статус |
COMMENTS
|
Комментарии, строка |
BEGINDATE
|
Поле по умолчанию содержит дату создания сделки и его можно редактировать в интерфейсе |
CLOSEDATE
|
Поле по умолчанию содержит дату создания сделки плюс 7 дней. Поле можно редактировать в интерфейсе. В зависимости от настроек поле может быть автоматически заполнено текущей датой при переводе сделки в финальную стадию |
LOCATION_ID
|
Местоположение клиента, число |
SOURCE_ID
|
Идентификатор источника, строка |
SOURCE
|
Источник, строка, ид и название источника ("[STORE] Интернет-магазин") |
SOURCE_DESCRIPTION
|
Описание источника, строка, полезно для легенды графика источников |
ORIGINATOR_ID
|
Внешняя система, строка ("email-tracker", "other") |
ORIGIN_ID
|
Внешний идентификатор, строка |
ADDITIONAL_INFO
|
Дополнительная информация, строка |
UTM_SOURCE
|
Рекламный источник, строка |
UTM_MEDIUM
|
Рекламный носитель, строка |
UTM_CAMPAIGN
|
Рекламная кампания, строка |
UTM_CONTENT
|
Рекламный контент, строка |
UTM_TERM
|
Рекламный термин, строка |
BANK_DETAIL_ID
|
Идентификатор банковских реквизитов, строка |
CRM_PRODUCT_ID
|
Идентификаторы товаров из CRM |
CRM_PRODUCT_COUNT
|
Количество товаров из CRM |
Пользовательские поля сделок — crm_deal_uf
Все пользовательские поля автоматически передаются в набор данных. Их количество зависит от числа полей в Битрикс24. Название поля присваивается во время создания в формате UF_CRM_123456789.
| Поле | Описание |
|---|---|
DEAL_ID
|
Идентификатор сделки, число |
DATE_CREATE
|
Время создания, дата-время |
UF_CRM_123456789
|
Название пользовательского поля, разные типы |
UF_CRM_*
|
Остальные пользовательские поля из Битрикс24 |
История сделок — crm_deal_stage_history
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ, число, уникальный идентификатор записи |
TYPE_ID
|
Тип записи, число, может принимать значения: 1 - создание сущности, 2 - перевод на промежуточную стадию, 3 - перевод на финальную стадию |
DEAL_ID
|
Идентификатор сделки, число - идентификатор сущности, в которой изменилась стадия, в данном случае ID сделки |
DATE_CREATE
|
Время создания, дата-время, дата и время попадания на стадию |
START_DATE
|
Дата начала, дата-время, дата начала
|
END_DATE
|
Дата конца, дата-время, дата завершения
|
ASSIGNED_BY_ID
|
Идентификатор ответственного, число, ID ответственного за сделку |
ASSIGNED_BY
|
Ответственный, строка, ID и имя ответственного за сделку |
ASSIGNED_BY_DEPARTMENT
|
Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании |
STAGE_SEMANTIC_ID
|
Идентификатор типа стадии, строка: "F": "(failed) - обработана неуспешно", "S": "(success) - обработана успешно", "P": "(processing) - сделка в обработке" |
STAGE_SEMANTIC
|
Тип стадии, строка, "Провал", "Успех", "В работе" |
STAGE_ID
|
Идентификатор стадии, строка |
STAGE
|
Стадия, строка, ид и название стадии вида "[NEW] Новый" |
Товары в сделках — crm_deal_product_row
В коробочной версии Битрикс24 для работы с полями PARENT, SUPERPARENT, SUPERSUPERPARENT нужен модуль iblock. В зависимости от версии инфоблока используются разные таблицы и поля:
Для инфоблока версии 1.0:
- Таблица: b_iblock_element_property. Поля: IBLOCK_ELEMENT_ID, IBLOCK_PROPERTY_ID.
Для инфоблока версии 2.0:
- Таблица: b_iblock_element_prop_s{ИД инфоблока}.Поля: PROPERTY_{ИД свойства "Элемент каталога"}, IBLOCK_ELEMENT_ID.
- Таблица: b_iblock_section_element.Поле: IBLOCK_ELEMENT_ID.
- Таблица: b_iblock_section. Поля: ID, NAME.
Для поля INSTOCK нужны модули catalog и sale. Используются следующие таблицы и поля:
- Таблица: b_catalog_docs_element. Поля: DOC_ID, ELEMENT_ID.
- Таблица: b_catalog_store_docs. Поля: ID, DOC_TYPE, STATUS, DATE_STATUS.
- Таблица: b_sale_basket. Поля: QUANTITY, ID, PRODUCT_ID.
- Таблица: b_sale_order_dlv_basket. Поля: ORDER_DELIVERY_ID, BASKET_ID.
- Таблица: b_sale_order_delivery. Поля: ID, DEDUCTED, DATE_DEDUCTED.
| Поле | Описание |
|---|---|
ID
|
Уникальный идентификатор, число |
DEAL_ID
|
Идентификатор Сделки. Товар может быть привязан к Лиду или Сделке и в нем может быть изменена цена и другие атрибуты. По этому полю удобно соединять таблицы, скажем, сделок и товарных позиций сделок. |
DEAL_DATE_CREATE
|
Время создания Сделки |
DEAL_CLOSEDATE
|
Время закрытия Сделки |
PRODUCT
|
Товар, строка, ид и название товара/услуги |
PRODUCT_ID
|
Идентификатор товара, число, идентификатор товара/услуги в каталоге CRM. |
PRODUCT_NAME
|
Название товара, строка, название товара/услуги в каталоге CRM |
PRICE
|
Цена |
PRICE_EXCLUSIVE
|
Цена без налога со скидкой |
PRICE_NETTO
|
Цена без скидок и налогов |
PRICE_BRUTTO
|
Цена без скидок, с налогом |
QUANTITY
|
Количество |
DISCOUNT_TYPE
|
Скидка, строка, ид и название типа скидки |
DISCOUNT_TYPE_ID
|
Идентификатор скидки, число, ид типа скидки |
DISCOUNT_TYPE_NAME
|
Название скидки, строка, название типа скидки |
DISCOUNT_RATE
|
Величина скидки |
DISCOUNT_SUM
|
Сумма скидки |
TAX_RATE
|
Налог, величина налога в процентах |
TAX_INCLUDED
|
Налог включен в цену, строка "Y"|"N" |
CUSTOMIZED
|
Строка "Y"|"N", товарная позиция была изменена вручную после добавления в сущность CRM |
MEASURE
|
Единица измерения, строка, код и название единицы измерения |
MEASURE_CODE
|
Идентификатор единицы измерения, число, код единицы измерения |
MEASURE_NAME
|
Название единицы измерения, строка, название единицы измерения |
SORT
|
Порядок сортировки, число |
CATEGORY
|
уникальное название воронки типа "[234] Молоко" |
CATEGORY_NAME
|
название воронки типа "Молоко" |
PARENT
|
родительская категория ID типа "йогурты" |
SUPERPARENT
|
родительская категория PARENT типа "молочная продукция" |
SUPERSUPERPARENT
|
родительская категория SUPERPARENT типа "скоропортящаяся продукция" |
INSTOCK
|
остаток товара на момент продажи |
Лиды
Лиды — crm_lead
| Поле | Описание |
|---|---|
ID
|
Число, уникальный идентификатор записи |
DATE_MODIFY
|
Время изменения, дата-время |
DATE_CREATE
|
Время создания, дата-время |
CREATED_BY_ID
|
Идентификатор создателя, число, ID сотрудника, который создал лид |
CREATED_BY
|
Создатель, строка, идентификатор и имя пользователя, создавшего лид |
MODIFY_BY_ID
|
Идентификатор редактора, число, ид автора последнего изменения |
MODIFIED_BY
|
Редактор, строка, идентификатор и имя пользователя, последним изменившего документ |
ASSIGNED_BY_ID
|
Идентификатор ответственного, число |
ASSIGNED_BY
|
Ответственный, строка, ID и имя ответственного |
ASSIGNED_BY_DEPARTMENT
|
Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании |
OPENED
|
Открыт, строка (Y - да, N - нет), открыт для всех сотрудников или нет (относится к правам доступа) |
COMPANY_ID
|
Идентификатор компании, число |
COMPANY
|
Компания, строка, идентификатор и название Компании |
CONTACT_ID
|
Идентификатор контакта, число |
CONTACT
|
Контакт, строка, идентификатор и название контакта |
STATUS_ID
|
Идентификатор статуса в воронке, строка |
STATUS
|
Статус, строка, ID и название статуса вида "[NEW] Новый" |
STATUS_DESCRIPTION
|
Описание статуса (причин перехода в статус), строка |
STATUS_SEMANTIC_ID
|
Идентификатор типа статуса, строка: "F": "(failed) - обработан неуспешно", "S": "(success) - обработан успешно", "P": "(processing) - лид в обработке" |
STATUS_SEMANTIC
|
Тип статуса, строка ("Успех", "Провал") |
CRM_PRODUCT
|
Товар из CRM, строка |
OPPORTUNITY
|
Ожидаемая сумма, число |
CURRENCY_ID
|
Валюта, строка |
SOURCE_ID
|
Идентификатор источника, строка. |
SOURCE
|
Источник, строка, ID и название источника ("[STORE] Интернет-магазин") |
SOURCE_DESCRIPTION
|
Описание источника, строка |
TITLE
|
Заголовок, строка |
FULL_NAME
|
Полное имя, строка |
NAME
|
Имя, строка |
LAST_NAME
|
Фамилия, строка |
SECOND_NAME
|
Отчество, строка |
COMPANY_TITLE
|
Название компании, строка |
POST
|
Должность, строка |
ADDRESS_1
|
Адрес 1, строка |
ADDRESS_2
|
Адрес 2, строка |
ADDRESS_CITY
|
Город, строка |
ADDRESS_POSTAL_CODE
|
Почтовый индекс, число |
ADDRESS_REGION
|
Регион, строка |
ADDRESS_PROVINCE
|
Область, строка |
ADDRESS_COUNTRY
|
Страна, строка |
ADDRESS_COUNTRY_CODE
|
Код страны, важен ISO код, строка |
COMMENTS
|
Комментарии, строка |
ORIGINATOR_ID
|
Внешняя система, строка ("email-tracker", "other") |
ORIGIN_ID
|
Внешний идентификатор, строка |
DATE_CLOSED
|
Время закрытия, дата-время |
BIRTHDATE
|
День рождения, дата |
HONORIFIC
|
Обращение, строка |
UTM_SOURCE
|
Рекламный источник, строка |
UTM_MEDIUM
|
Рекламный носитель, строка |
UTM_CAMPAIGN
|
Рекламная кампания, строка |
UTM_CONTENT
|
Рекламный контент, строка |
UTM_TERM
|
Рекламный термин, строка |
PHONE
|
Телефон, строка, множественное |
WEB
|
URL, строка, множественное |
EMAIL
|
E-mail, строка, множественное |
IM
|
Мессенджеры, строка, множественное. |
CRM_PRODUCT_ID
|
идентификаторы товаров из CRM. |
CRM_PRODUCT_NAME
|
названия товаров из CRM. |
CRM_PRODUCT_COUNT
|
количество товаров из CRM. |
Пользовательские поля лидов — crm_lead_uf
Все пользовательские поля автоматически передаются в набор данных. Их количество зависит от числа полей в Битрикс24. Название поля присваивается во время создания в формате UF_CRM_123456789.
| Поле | Описание |
|---|---|
LEAD_ID
|
Идентификатор лида, число |
DATE_MODIFY
|
Время изменения, дата-время |
UF_CRM_123456789
|
Название пользовательского поля, разные типы |
UF_CRM_* | Остальные пользовательские поля из Битрикс24 |
История лидов — crm_lead_status_history
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ, число, уникальный идентификатор записи |
TYPE_ID
|
Тип записи, число, может принимать значения: 1 - создание сущности, 2 - перевод на промежуточную стадию, 3 - перевод на финальную стадию |
LEAD_ID
|
Идентификатор лида, число - идентификатор сущности, в которой изменилась стадия, в данном случае ID лида |
DATE_CREATE
|
Время создания, дата-время, дата и время попадания на стадию |
ASSIGNED_BY_ID
|
Идентификатор ответственного, число, ид ответственного за лид, для фильтрации стадий и причин проблем по ответственным |
ASSIGNED_BY
|
Ответственный, строка, ID и имя ответственного за лид |
ASSIGNED_BY_DEPARTMENT
|
Отдел ответственного, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место ответственного в иерархии структуры компании |
STATUS_SEMANTIC_ID
|
Идентификатор типа статуса, строка: "F": "(failed) - обработан неуспешно", "S": "(success) - обработан успешно", "P": "(processing) - лид в обработке" |
STATUS_SEMANTIC
|
Тип статуса, строка, "Провал", "Успех" |
STATUS_ID
|
Идентификатор статуса, строка |
STATUS
|
Статус, строка, ид и название статуса вида "[NEW] Новый" |
Товары лидах — crm_lead_product_row
| Поле | Описание |
|---|---|
ID
|
Уникальный идентификатор, число |
LEAD_ID
|
Идентификатор Лида. Товар может быть привязан к Лиду или Сделке и в нем может быть изменена цена и другие атрибуты. По этому полю удобно соединять таблицы, скажем, сделок и товарных позиций сделок. |
LEAD_DATE_MODIFY
|
Время изменения Лида |
LEAD_DATE_CREATE
|
Время создания Лида |
LEAD_DATE_CLOSED
|
Время закрытия Лида |
PRODUCT
|
Товар, строка, ид и название товара/услуги |
PRODUCT_ID
|
Идентификатор товара, число, идентификатор товара/услуги в каталоге CRM. |
PRODUCT_NAME
|
Название товара, строка, название товара/услуги в каталоге CRM |
PRICE
|
Цена |
PRICE_EXCLUSIVE
|
Цена без налога со скидкой |
PRICE_NETTO
|
Цена без скидок и налогов |
PRICE_BRUTTO
|
Цена без скидок, с налогом |
QUANTITY
|
Количество |
DISCOUNT_TYPE
|
Скидка, строка, ид и название типа скидки |
DISCOUNT_TYPE_ID
|
Идентификатор скидки, число, ид типа скидки |
DISCOUNT_TYPE_NAME
|
Название скидки, строка, название типа скидки |
DISCOUNT_RATE
|
Величина скидки |
DISCOUNT_SUM
|
Сумма скидки |
TAX_RATE
|
Налог, величина налога в процентах |
TAX_INCLUDED
|
Налог включен в цену, строка "Y"|"N" |
CUSTOMIZED
|
Строка "Y"|"N", товарная позиция была изменена вручную после добавления в сущность CRM |
MEASURE
|
Единица измерения, строка, код и название единицы измерения |
MEASURE_CODE
|
Идентификатор единицы измерения, число, код единицы измерения |
MEASURE_NAME
|
Название единицы измерения, строка, название единицы измерения |
SORT
|
Порядок сортировки, число |
Товары из каталога
Товары — crm_product
| Поле | Описание |
|---|---|
ID
|
Уникальный идентификатор |
NAME
|
Название |
TYPE
|
Тип товара |
PARENT_ID
|
Уникальный идентификатор основного товара |
MEASURE
|
Единица измерения |
PRICE
|
Цена |
Свойства товаров — crm_product_property
| Поле | Описание |
|---|---|
ID
|
Уникальный идентификатор |
NAME
|
Название |
Значения свойств товаров — crm_product_property_value
В наборе данных идентификаторы ID используют строковый формат. Это связано с тем, что в инфоблоках 2.0 каждое свойство хранится в своей таблице и для каждого свойства создается уникальное поле.
| Поле | Описание |
|---|---|
ID
|
Уникальный идентификатор |
PROPERTY_ID
|
Уникальный идентификатор свойства |
VALUE
|
Значение свойства |
Смарт-процессы и дела
Смарт-процессы — crm_dynamic_items_123
Каждый смарт-процесс — это отдельный набор данных со своими полями и колонками. Чтобы в отчете использовать данные из нужного смарт-процесса, надо знать его уникальный идентификатор.
Где посмотреть идентификатор смарт-процесса
Все пользовательские поля смарт-процессов автоматически передаются в набор данных. Их количество зависит от числа полей в Битрикс24. Название поля присваивается во время создания в формате UF_CRM_123456789.
| Поле | Описание | Тип данных |
|---|---|---|
| ID | Уникальный идентификатор записи. | число |
| XML_ID | Внешний идентификатор для связи с внешними системами. | строка |
| TITLE | Название или заголовок элемента. | строка |
| CREATED_BY | Ф.И.О. и идентификатор пользователя, создавшего запись. | строка |
| CREATED_BY_ID | Идентификатор пользователя, создавшего запись. | число |
| CREATED_BY_NAME | Имя пользователя, создавшего запись. | строка |
| UPDATED_BY | Ф.И.О. и идентификатор пользователя, последнего обновившего запись. | строка |
| UPDATED_BY_ID | Идентификатор пользователя, последнего обновившего запись. | число |
| UPDATED_BY_NAME | Имя пользователя, последнего обновившего запись. | строка |
| MOVED_BY | Ф.И.О. и идентификатор пользователя, изменившего стадию элемента. | строка |
| MOVED_BY_ID | Идентификатор пользователя, изменившего стадию элемента. | число |
| MOVED_BY_NAME | Имя пользователя, изменившего стадию элемента. | строка |
| CREATED_TIME | Дата и время создания записи. | дата-время |
| UPDATED_TIME | Дата и время последнего обновления записи. | дата-время |
| MOVED_TIME | Дата и время изменения стадии элемента. | дата-время |
| CATEGORY | Название и идентификатор категории, к которой относится элемент. | строка |
| CATEGORY_ID | Идентификатор категории, к которой относится элемент. | число |
| CATEGORY_NAME | Название категории, к которой относится элемент. | строка |
| OPENED | Признак того, открыт ли элемент для всех пользователей ('Y' - да, 'N' - нет). | строка |
| STAGE | Название и идентификатор текущей стадии элемента. | строка |
| STAGE_ID | Идентификатор текущей стадии элемента. | строка |
| STAGE_NAME | Название текущей стадии элемента. | строка |
| PREVIOUS_STAGE_ID | Идентификатор предыдущей стадии элемента. | строка |
| BEGINDATE | Дата начала события или процесса. | дата |
| CLOSEDATE | Дата окончания события или процесса. | дата |
| COMPANY | Название и идентификатор компании, связанной с элементом. | строка |
| COMPANY_ID | Идентификатор компании, связанной с элементом. | число |
| COMPANY_NAME | Название компании, связанной с элементом. | строка |
| CONTACT | Ф.И.О. и идентификатор контакта, связанного с элементом. | строка |
| CONTACT_ID | Идентификатор контакта, связанного с элементом. | число |
| CONTACT_NAME | Имя контакта, связанного с элементом. | строка |
| OPPORTUNITY | Ожидаемая сумма сделки. | число с плавающей точкой |
| IS_MANUAL_OPPORTUNITY | Признак того, введена ли сумма сделки вручную ('Y' - да, 'N' - нет). | строка |
| TAX_VALUE | Налоговая стоимость элемента. | число с плавающей точкой |
| CURRENCY_ID | Валюта, используемая для сделки (например, 'RUB'). | строка |
| OPPORTUNITY_ACCOUNT | Сумма сделки в валюте отчетов. | число с плавающей точкой |
| TAX_VALUE_ACCOUNT | Налог в валюте отчетов. | число с плавающей точкой |
| ACCOUNT_CURRENCY_ID | Валюта отчетов. | строка |
| MYCOMPANY | Название и идентификатор собственной компании. | строка |
| MYCOMPANY_ID | Идентификатор собственной компании. | число |
| MYCOMPANY_NAME | Название собственной компании. | строка |
| SOURCE | Название и идентификатор источника (например, '[STORE] Интернет-магазин'). | строка |
| SOURCE_ID | Идентификатор источника. | строка |
| SOURCE_NAME | Название источника. | строка |
| SOURCE_DESCRIPTION | Описание источника. | строка |
| ASSIGNED_BY | Ф.И.О. и идентификатор ответственного за элемент. | строка |
| ASSIGNED_BY_ID | Идентификатор ответственного за элемент. | число |
| ASSIGNED_BY_NAME | Имя ответственного за элемент. | строка |
| WEBFORM_ID | Идентификатор CRM-формы, из которой был создан элемент. | число |
| UF_CRM_123456789 | Название пользовательского поля (зависит от контекста). | зависит от контекста |
| UF_CRM_* | Описание остальных пользовательских полей из Битрикс24 (зависит от контекста). | зависит от контекста |
Список смарт-процессов — crm_smart_proc
| Поле | Описание | Тип данных |
|---|---|---|
| ENTITY_TYPE_ID | Идентификатор типа смарт-процесса. | число |
| TITLE | Название смарт-процесса. | строка |
| DATASET_NAME | Имя датасета, используемого в смарт-процессе. | строка |
| AUTOMATED_SOLUTION_DATASET_NAME | Имя датасета для цифрового рабочего места, если связано с процессом; если нет, то CRM. | строка |
| CUSTOM_SECTION_ID | Идентификатор цифрового рабочего места. | число |
| CUSTOM_SECTION_TITLE | Название рабочего места. | строка |
Стадии сущностей CRM — crm_stages
| Поле | Описание | Тип данных |
|---|---|---|
| ID | Уникальный идентификатор записи. | число |
| ENTITY_TYPE_ID | Идентификатор типа элемента. | число |
| STATUS_ID | Идентификатор текущей стадии элемента. | число |
| NAME | Название текущей стадии элемента. | строка |
| CATEGORY_ID | Идентификатор воронки, к которой относится элемент. | число |
| CATEGORY_NAME | Название воронки, к которой относится элемент. | строка |
| SORT | Порядковый номер для сортировки элемента. | число |
| SEMANTICS | Тип стадии: null для промежуточных стадий, 'S' для успешных, 'F' для провальных. | строка |
Связи между элементами CRM — crm_entity_relation
| Поле | Описание | Тип данных |
|---|---|---|
| SRC_ENTITY_TYPE_ID | Идентификатор типа элемента, с которым происходит связь. | число |
| SRC_ENTITY_ID | Идентификатор связанного элемента. | число |
| SRC_ENTITY_DATASET_NAME | Название датасета связанного элемента. | строка |
| DST_ENTITY_TYPE_ID | Идентификатор типа элемента, с которым устанавливается связь. | число |
| DST_ENTITY_ID | Идентификатор элемента, с которым устанавливается связь. | число |
| DST_ENTITY_DATASET_NAME | Название датасета элемента, с которым устанавливается связь. | строка |
Смарт-процессы цифрового рабочего места — crm_automated_solution_ХХХ
| Поле | Описание | Тип данных |
|---|---|---|
| XXX | Идентификатор рабочего места. | число |
| ENTITY_TYPE_ID | Идентификатор типа смарт-процесса. | число |
| TITLE | Название смарт-процесса. | строка |
| DATASET_NAME | Имя датасета смарт-процесса. | строка |
| AUTOMATED_SOLUTION_DATASET_NAME | Имя датасета цифрового рабочего места, если связано с процессом; иначе указывается CRM. | строка |
| CUSTOM_SECTION_ID | Идентификатор цифрового рабочего места. | число |
| CUSTOM_SECTION_TITLE | Название рабочего места. | строка |
Дело — crm_activity
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ, идентификатор дела |
SUBJECT
|
Название дела, например, Договориться о встрече |
ASSOCIATED_ENTITY_ID
|
ID сущности портала, идентификатор связанной сущности на портале. Например, Задачи и прочее. |
TYPE_ID
|
Код типа дела: 1 – встреча, 2 – звонок, 3 – задача, 4 – письмо, 6 – пользовательское действие. В пользовательских действиях учитываются: новые задачи, чаты, доставки, SMS сообщения и т.д. |
TYPE_NAME
|
Название типа дела: "Встреча", "Звонок" |
OWNER_ID
|
ID сущности CRM, идентификатор связанной сущности CRM, к которой привязано дело |
OWNER_TYPE_ID
|
Код типа сущности CRM: 1 - лид, 2 - сделка, 3 - контакт |
OWNER_TYPE_NAME
|
Название типа сущности. Например, OWNER_ID = 123, OWNER_TYPE_ID= 2 означает что дело привязано к сделке с ID= 123 |
PRIORITY_ID
|
Код важности, число: 2 – средняя, 3 – высокая |
PRIORITY_NAME
|
Важность, строка |
DIRECTION_ID
|
ID направления, число |
DIRECTION_NAME
|
Название направления, строка |
STATUS_ID
|
Код статуса: 1 - ожидается, 2- завершено, 3 - выполнено автоматически |
STATUS_NAME
|
Название статуса |
COMPLETED
|
Завершено, строка "Y"|"N", дело завершено |
DATE_CREATE
|
Создано, дата-время |
START_TIME
|
Время начала выполнения |
END_TIME
|
Время завершения |
DEADLINE
|
Срок исполнения, дата-время, поле напрямую не устанавливается, значение берётся из START_TIME для звонка и встречи и из END_TIME для задачи |
DATE_MODIFY
|
Время последнего изменения |
AUTHOR
|
Создатель, строка, имя создателя дела |
AUTHOR_ID
|
ID создателя, число, идентификатор создателя дела |
AUTHOR_NAME
|
Имя создателя, строка, имя создателя дела |
EDITOR
|
Редактор – (изменивший дело) |
EDITOR_ID
|
ID редактора |
EDITOR_NAME
|
Имя редактора |
RESPONSIBLE
|
ID и имя ответственного за дело |
RESPONSIBLE_ID
|
ID ответственного |
RESPONSIBLE_NAME
|
Имя ответственного |
DESCRIPTION
|
Описание, строка |
DESCRIPTION_TYPE_ID
|
Код типа описания, число |
DESCRIPTION_TYPE_NAME
|
Тип описания, строка |
ORIGINATOR_ID
|
ID источника данных, строка, используется только для привязки к внешнему источнику |
ORIGIN_ID
|
ID элемента в источнике данных, строка, используется только для привязки к внешнему источнику |
Компании
Компании — crm_company
| Поле | Описание |
|---|---|
ADDRESS_1
|
Адрес 1, строка |
ADDRESS_2
|
Адрес 2, строка |
ADDRESS_CITY
|
Город, строка |
ADDRESS_COUNTRY
|
Страна, строка |
ADDRESS_COUNTRY_CODE
|
Код страны, строка |
ADDRESS_POSTAL_CODE
|
Почтовый индекс, строка |
ADDRESS_PROVINCE
|
Область, строка |
ADDRESS_REGION
|
Регион, строка |
ASSIGNED_BY_ID
|
Идентификатор ответственного, число |
ASSIGNED_BY
|
Ответственный, строка, ID имя ответственного |
ASSIGNED_BY_NAME
|
Имя ответственного, строка |
BANKING_DETAILS
|
Банковские реквизиты, строка |
COMMENTS
|
Комментарии, строка |
COMPANY_TYPE
|
Тип компании, строка, "ID и название типа компании" |
COMPANY_TYPE_ID
|
Идентификатор типа компании, строка, ID типа компании |
COMPANY_TYPE_NAME
|
Название типа компании, строка, названии типа компании |
CREATED_BY_ID
|
Идентификатор создателя, число |
CREATED_BY
|
Создатель, строка, ID и имя создателя |
CREATED_BY_NAME
|
Имя создателя, строка |
CURRENCY_ID
|
Валюта, строка |
DATE_CREATE
|
Время создания, дата-время |
DATE_MODIFY
|
Время изменения, дата-время |
EMAIL
|
Email, строка, множественное |
EMPLOYESS
|
Количество сотрудников, строка, например "250-500" (берется из справочника) |
ID
|
Уникальный ключ, число |
IM
|
Мессенджеры, строка, множественное |
INDUSTRY
|
Сфера деятельности, строка, "ID и название сферы деятельности компании" |
INDUSTRY_ID
|
Идентификатор сферы деятельности, строка, ID сферы деятельности компании |
INDUSTRY_NAME
|
Название сферы деятельности, строка, название сферы деятельности компании |
IS_MY_COMPANY
|
Моя компания, строка |
LEAD_ID
|
Идентификатор лида, число, идентификатор лида, связанного с компанией |
MODIFIED_BY
|
Редактор, строка, ID и имя автора последнего изменения |
MODIFY_BY_ID
|
Идентификатор редактора, число, идентификатор автора последнего изменения |
MODIFIED_BY_NAME
|
Имя редактора, строка |
OPENED
|
Доступна для всех, строка |
ORIGINATOR_ID
|
Внешняя система, строка |
ORIGIN_ID
|
Внешний идентификатор, строка, используется только для привязки к внешнему источнику. |
ORIGIN_VERSION
|
Оригинальная версия, строка, используется для защиты данных от случайного перетирания внешней системой |
PHONE
|
Телефон, строка, множественное |
REVENUE
|
Годовой оборот, число с плав. точкой |
TITLE
|
Название компании, строка |
UTM_CAMPAIGN
|
Рекламная компания, строка |
UTM_CONTENT
|
Рекламный контент, строка |
UTM_MEDIUM
|
Рекламный носитель, строка, "CPC (объявления)", "CPM (баннеры)" |
UTM_SOURCE
|
Рекламный источник, строка, Yandex-Direct, Google-Adwords и другие. |
UTM_TERM
|
Рекламный термин, строка, например, ключевые слова контекстной рекламы. |
WEB
|
URL, строка, множественное |
Пользовательские поля компаний — crm_company_uf
Все пользовательские поля автоматически передаются в набор данных. Их количество зависит от числа полей в Битрикс24. Название поля присваивается во время создания в формате UF_CRM_123456789.
| Поле | Описание |
|---|---|
COMPANY_ID
|
Идентификатор компании |
DATE_CREATE
|
Время создания |
UF_CRM_123456789
|
Пользовательское поле |
UF_CRM_* | Остальные пользовательские поля из Битрикс24 |
Контакты
Контакты — crm_contact
| Поле | Описание |
|---|---|
ADDRESS_1
|
Адрес 1, строка |
ADDRESS_2
|
Адрес 2, строка |
ADDRESS_CITY
|
Город, строка |
ADDRESS_COUNTRY
|
Страна, строка |
ADDRESS_COUNTRY_CODE
|
Код страны, строка |
ADDRESS_POSTAL_CODE
|
Почтовый индекс, строка |
ADDRESS_PROVINCE
|
Область, строка |
ADDRESS_REGION
|
Регион, строка |
ASSIGNED_BY_ID
|
Идентификатор ответственного, число |
ASSIGNED_BY
|
Ответственный, строка, ID имя ответственного |
ASSIGNED_BY_NAME
|
Имя ответственного, строка |
BIRTHDATE
|
Дата рождения, дата-время |
COMMENTS
|
Комментарии, строка |
COMPANY_ID
|
Идентификатор компании, число, привязка контакта к компании (первой в списке) |
CREATED_BY_ID
|
Идентификатор создателя, число |
CREATED_BY
|
Создатель, строка, ID и имя создателя |
CREATED_BY_NAME
|
Имя создателя, строка |
DATE_CREATE
|
Время создания, дата-время |
DATE_MODIFY
|
Время изменения, дата-время |
EMAIL
|
Email, строка, множественное |
EXPORT
|
Участвует в экспорте, строка, участвует ли контакт в экспорте. Eсли "N", то выгрузить контакт невозможно |
FACE_ID
|
Идентификатор faceid, число |
HONORIFIC
|
Код обращения, строка, код обращения, например ""HNR_RU_1"" |
ID
|
Уникальный ключ, число |
IM
|
Мессенджеры, строка, множественное |
LEAD_ID
|
Идентификатор лида, число, идентификатор лида, связанного с контактом |
MODIFIED_BY
|
Редактор, строка, ID и имя автора последнего изменения |
MODIFIED_BY_NAME
|
Имя редактора, строка |
MODIFY_BY_ID
|
Идентификатор редактора, число |
NAME
|
Имя, строка |
SECOND_NAME
|
Отчество, строка |
LAST_NAME
|
Фамилия, строка |
OPENED
|
Доступен для всех, строка, Y - да или N - нет |
ORIGINATOR_ID
|
Внешняя система, строка |
ORIGIN_ID
|
Внешний идентификатор, строка, используется только для привязки к внешнему источнику. |
ORIGIN_VERSION
|
Оригинальная версия, строка, используется для защиты данных от случайного перетирания внешней системой |
PHONE
|
Телефон, строка, множественное |
POST
|
Должность, строка |
SOURCE_DESCRIPTION
|
Описание источника, строка |
SOURCE_ID
|
Идентификатор источника, строка, "CALL", "EMAIL" и другие значения из справочника. |
TYPE_ID
|
Идентификатор типа, строка, "CLIENT" и другие значения из справочника |
UTM_CAMPAIGN
|
Рекламная компания, строка |
UTM_CONTENT
|
Рекламный контент, строка |
UTM_MEDIUM
|
Рекламный носитель, строка, "CPC (объявления)", "CPM (баннеры)" |
UTM_SOURCE
|
Рекламный источник, строка, Yandex-Direct, Google-Adwords и другие. |
UTM_TERM
|
Рекламный термин, строка, например, ключевые слова контекстной рекламы. |
WEB
|
URL, строка, множественное |
Пользовательские поля контакта — crm_contact_uf
Все пользовательские поля автоматически передаются в набор данных. Их количество зависит от числа полей в Битрикс24. Название поля присваивается во время создания в формате UF_CRM_123456789.
| Поле | Описание |
|---|---|
CONTACT_ID
|
Идентификатор контакта |
DATE_CREATE
|
Время создания |
UF_CRM_123456789
|
Пользовательское поле |
UF_CRM_* | Остальные пользовательские поля из Битрикс24 |
Пользователи, проекты и звонки
Пользователи — users
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ |
ACTIVE
|
Активность, "Y - работает", "N - уволен" |
NAME
|
Имя пользователя |
DEPARTMENT
|
Отдел в компании: путь в иерархии отделов компании и отделы пользователя от корневого (названия компании) с разделителем '/'. Отделы форматируются в виде '[ИД] Название'. При привязке пользователя к нескольким подразделениям берётся подразделение с минимальным идентификатором. |
Проекты — socialnetwork_group
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ, идентификатор проекта или группы |
SITE_ID
|
Код сайта, строка |
NAME
|
Название проекта или группы |
DESCRIPTION
|
Описание проекта или группы |
PROJECT
|
Является проектом, строка, "Y" или "N" |
DATE_CREATE
|
Время создания |
DATE_MODIFY
|
Время изменения, время последнего изменения параметров проекта или группы |
OPENED
|
Открыта ли группа или проект для свободного вступления, строка, "Y" или "N" |
CLOSED
|
Архивная группа, строка, "Y" или "N" |
SUBJECT
|
Тема проекта или группы |
OWNER
|
Владелец проекта или группы |
OWNER_ID
|
ID владельца |
OWNER_NAME
|
Имя владельца |
KEYWORDS
|
Ключевые слова или тэги проекта |
NUMBER_OF_MEMBERS
|
Число участников |
DATE_ACTIVITY
|
Время последней активности |
Звонки — telephony_call
| Поле | Описание |
|---|---|
CALL_ID
|
Уникальный идентификатор звонка, строка. |
CALL_TYPE
|
Тип вызова, число, подробнее: 1 - исходящий, 2 - входящий, 3 - входящий с перенаправлением, 4 - обратный звонок. |
CALL_VOTE
|
Оценка звонка, число, оценка звонка. |
COMMENT
|
Комментарий к звонку, строка |
PORTAL_USER_ID
|
Идентификатор оператора, число |
PORTAL_USER
|
Оператор, строка, ID и имя оператора, например "[12] Иван Петров" |
PORTAL_USER_DEPARTMENT
|
Отдел оператора, строка по типу ("[1] Сладкая Жизнь / [7] ИТ-отдел"), место отдела оператора в иерархии структуры компании |
PORTAL_NUMBER
|
Номер оператора, строка, номер телефона портала, связанный со звонком. |
PHONE_NUMBER
|
Номер абонента, строка, номер телефона клиента, куда звонили с портала или откуда звонил клиент. |
CALL_DURATION
|
Продолжительность звонка, число, продолжительность звонка в секундах. |
CALL_START_TIME
|
Время начала звонка, дата-время |
COST
|
Стоимость звонка, число с плавающей точкой |
COST_CURRENCY
|
Валюта звонка, строка, валюта звонка типа: "RUR", "USD", "EUR" |
CALL_STATUS_CODE
|
Код вызова, строка |
CALL_STATUS_REASON
|
Описание кода вызова, строка, расширенное описание кода статуса вызова на латинице: "Skipped call", "Success call" и т.п. |
CRM_ACTIVITY_ID
|
Идентификатор дела CRM, число, идентификатор Дела CRM, созданного на основании звонка. |
CRM_ENTITY_ID
|
Идентификатор объекта CRM, число, идентификатор объекта CRM, найденного по номеру телефона, который может быть Лидом, Контактом или Компанией. |
CRM_ENTITY_TYPE
|
Тип объекта CRM, строка, тип объекта CRM, имеющего идентификатор "CRM_ENTITY_ID", например "CONTACT". |
REST_APP_ID
|
Идентификатор приложения, число, идентификатор приложения интеграции внешней телефонии. |
REST_APP_NAME
|
Название приложения, строка, название приложения интеграции внешней телефонии. |
REDIAL_ATTEMPT
|
Номер попытки дозвониться, число, номер попытки дозвониться (для обратных звонков) |
TRANSCRIPT_ID
|
Идентификатор расшифровки звонка, число, идентификатор расшифровки звонка |
TRANSCRIPT_PENDING
|
Готовность расшифровки, строка "Y/N", признак того, что расшифровка будет получена позднее |
RECORD_FILE_ID
|
Идентификатор файла с записью, число, |
Бизнес-процессы
Задания бизнес-процессов — bizproc_task
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ |
CODE_ID
|
Идентификатор типа задания |
CODE_NAME
|
Название типа задания |
CODE
|
Тип задания |
WORKFLOW_ID
|
Идентификатор процесса и идентификатор родительского процесса. |
NAME
|
Название задания |
CREATED_DATE
|
Дата и время создания задания |
MODIFIED
|
Дата и время изменения задания |
DURATION
|
Время выполнения задания, в секундах |
APPROVE_TYPE
|
Идентификатор типа утверждения задания |
APPROVE_TYPE_NAME
|
Название типа утверждения задания |
STATUS_ID
|
Идентификатор статуса |
STATUS_NAME
|
Название статуса выполнения задания |
STATUS
|
Идентификатор и название статуса выполнения задания |
USER_ID
|
Идентификатор участника задания |
USER_NAME
|
Имя участника задания |
USER
|
Идентификатор и имя участника задания |
Запущенные бизнес-процессы — bizproc_workflow
| Поле | Описание |
|---|---|
ID
|
Уникальный ключ |
STARTED_BY_ID
|
Идентификатор пользователя, запустившего процесс |
STARTED_BY_NAME
|
Имя пользователя, запустившего процесс |
STARTED_BY
|
Идентификатор и имя пользователя, запустившего процесс |
STARTED
|
Дата и время запуска |
COMPLETED
|
Статус завершения, Y - завершен, N - выполняется |
DOCUMENT_ID
|
Идентификатор документа |
DURATION
|
Время, затраченное на выполнение процесса, в секундах |
START_DURATION
|
Время, затраченное на запуск |
WORKFLOW_TEMPLATE_ID
|
Идентификатор шаблона |
WORKFLOW_TEMPLATE_NAME
|
Название шаблона |
MODULE_ID
|
Идентификатор модуля |
MODULE_ID_NAME
|
Название модуля |
ENTITY_ID
|
Идентификатор типа элемента |
ENTITY_ID_NAME
|
Название типа элемента |
MODIFIED_BY_ID
|
Идентификатор пользователя, редактировавшего шаблон |
MODIFIED_BY_NAME
|
Имя пользователя, редактировавшего шаблон |
MODIFIED_BY
|
Идентификатор и имя пользователя, редактировавшего шаблон |
