Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 6.37 KB

index.md

File metadata and controls

68 lines (45 loc) · 6.37 KB
Raw

Справочники в CRM: обзор методов

В карточках элементов CRM есть два вида полей типа «список»:

  • пользовательские поля — их можно создавать, изменять значения списка, удалять через методы crm.xx.userfield.*. Например, для создания пользовательского поля типа список в сделках используйте crm.deal.userfield.add

  • системные поля — предустановленны, их нельзя создать или удалить. В системных списочных полях можно изменять только значения списка. Перечень значений системных полей типа «список» называется справочником в CRM

Быстрый переход: все методы и события

Пользовательская документация: справочники в Битрикс24

Список справочников

Чтобы изменить справочник, в методах группы crm.status.* укажите параметр ENTITY_ID. Если значение указано неверно, будет изменен другой справочник.

Стадии. Справочник с этапами работы с клиентами, которые отображаются в канбане CRM. У каждого объекта CRM свой код справочника стадий:

  • Сделки — DEAL_STAGE для основного направления сделок и DEAL_STAGE_xx для дополнительного, xx — это ID направления
  • Лиды — STATUS
  • Счета — SMART_INVOICE_STAGE_xx, xx — значение ID направления счетов
  • Предложения — QUOTE_STATUS
  • Документы — SMART_DOCUMENT_STAGE_xx, xx — значение ID направления документов
  • Смарт-процессы — DYNAMIC_xx_STAGE_xx, первый xx — это ID смарт-процесса, второй xx — это ID направления

Чтобы получить ID направления на конкретном Битрикс24, используйте метод crm.status.entity.types.

Источники. Справочник со значениями системного поля Источник — SOURCE.

Тип контакта и компании. Справочники со значениями системных полей Тип контакта — CONTACT_TYPE, Тип компании — COMPANY_TYPE.

Количество сотрудников. Справочник со значениями системного поля Количество сотрудников в карточке компании — EMPLOYEES.

Сфера деятельности клиентов. Справочник со значениями системного поля Сфера деятельности в карточке компании — INDUSTRY.

Тип сделки. Справочник со значениями системного поля Тип сделки в карточке сделки — DEAL_TYPE.

Обращения. Справочник со значениями системного поля Обращение в карточке лида и контакта — HONORIFIC.

Статусы обзвона. Справочник со значениями Статуса звонка в карточка обзвона — CALL_LIST.

Как использовать значения справочника

У любого значения списка в справочниках есть:

  • название NAME — отображается в карточке элемента CRM
  • статус STATUS_ID — используется в методах создания и изменения элементов

Методом crm.deal.update можно изменить значения полей Стадия сделки — STAGE_ID и Источник — SOURCE_ID. Оба поля — это системные списочные поля.

Для того чтобы в карточке CRM отображалось название стадии или источника, в методе важно передавать не NAME значения, а его STATUS_ID. Для стадии «Новая заявка» это может быть C1:NEW, а для источника «звонок» — CALL.

Обзор методов и событий {#all-methods}

Scope: crm

Кто может выполнять метод: любой пользователь

#| || Метод | Описание || || crm.status.add | Создает новый элемент в указанном справочнике || || crm.status.delete | Удаляет элемент справочника || || crm.status.entity.items | Возвращает элементы справочника по его символьному идентификатору || || crm.status.entity.types | Возвращает описание типов справочников || || crm.status.fields | Возвращает описание полей справочника || || crm.status.get | Возвращает элемент справочника по идентификатору || || crm.status.list | Возвращает список элементов справочника по фильтру || || crm.status.update | Обновляет существующий элемент справочника || |#