Идентификаторы сущностей в Битрикс24

Опубликовано автором

Каждый тип сущности имеет свои идентификаторы. И этих идентификаторов много. Ниже перечислены основные типы

  • entityTypeId — идентификатор типа сущности, int
  • entityName — строковый идентификатор типа сущности, string
  • entityTypeAbbr — сокращенный строковый идентификатор типа, string не больше 3х символов
  • userFieldEntityId — идентификатор сущности для настроек пользовательских полей, string
  • statusEntityId — значение колонки ENTITY_ID таблицы b_crm_status для стадий и статусов, string
  • permissionEntity — идентификатор типа элемента, используемый при проверке прав, string
  • suspendedEntityTypeId — идентификатор типа сущности для корзины, int
  • suspendedEntityTypeName — строковый идентификатор типа сущности для корзины, string
  • suspendedUserFieldEntityId — идентификатор сущности для настроек пользовательских полей в корзине, string

Для тех сущностей, которые имеют направления (сделки, смарт-процессы), некоторые идентификаторы будут уникальны в рамках направления

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

Основной — это entityTypeId. Зная этот идентификатор типа, можно (не всегда просто) получить остальную информацию

На фронте есть похожий хелпер, BX.CrmEntityType в файле crm/install/js/crm/common.js

Числовой и строковый идентификаторы можно получить через константы / методы класса \CCrmOwnerType.

Список основных идентификаторов:

    • Лид
      • entityTypeId = \CCrmOwnerType::Lead = 1
      • entityTypeName = \CCrmOwnerType::LeadName = 'LEAD'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Lead = 'L'
      • userFieldEntityId = \CAllCrmLead::USER_FIELD_ENTITY_ID = 'CRM_LEAD'
      • statusEntityId = 'STATUS'
      • permissionEntity = 'LEAD'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedLead = 18
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedLeadName = 'SUS_LEAD
      • suspendedUserFieldEntityId = \CAllCrmLead::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_LEAD_SPD'

 

    • Сделка в направлении по умолчанию.
      • entityTypeId = \CCrmOwnerType::Deal = 2
      • entityTypeName = \CCrmOwnerType::DealName = 'DEAL'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Deal = 'D'
      • userFieldEntityId = \CAllCrmDeal::USER_FIELD_ENTITY_ID = 'CRM_DEAL'
      • statusEntityId = 'DEAL_STAGE'
      • permissionEntity = 'DEAL'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedDeal = 19
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedDealName = 'SUS_DEAL
      • suspendedUserFieldEntityId = \CAllCrmDeal::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_DEAL_SPD'

 

    • Сделка в направлении с идентификатором 3
      • entityTypeId = \CCrmOwnerType::Deal = 2
      • entityTypeName = \CCrmOwnerType::DealName = 'DEAL'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Deal = 'D'
      • userFieldEntityId = \CAllCrmDeal::USER_FIELD_ENTITY_ID = 'CRM_DEAL'
      • statusEntityId = 'DEAL_STAGE_3'
      • permissionEntity = 'DEAL_C3'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedDeal = 19
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedDealName = 'SUS_DEAL
      • suspendedUserFieldEntityId = \CAllCrmDeal::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_DEAL_SPD'

 

    • Контакт
      • entityTypeId = \CCrmOwnerType::Contact = 3
      • entityTypeName = \CCrmOwnerType::ContactName = 'CONTACT'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Contact = 'C'
      • userFieldEntityId = \CAllCrmContact::USER_FIELD_ENTITY_ID = 'CRM_CONTACT'
      • statusEntityId — отсутствует
      • permissionEntity = 'CONTACT'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedContact = 20
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedContactName = 'SUS_CONTACT
      • suspendedUserFieldEntityId = \CAllCrmContact::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_CONTACT_SPD'

 

    • Компания
      • entityTypeId = \CCrmOwnerType::Company = 4
      • entityTypeName = \CCrmOwnerType::CompanyName = 'COMPANY'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Company = 'CO'
      • userFieldEntityId = \CAllCrmCompany::USER_FIELD_ENTITY_ID = 'CRM_COMPANY'
      • statusEntityId — отсутствует
      • permissionEntity = 'COMPANY'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedCompany = 21
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedCompanyName = 'SUS_COMPANY
      • suspendedUserFieldEntityId = \CAllCrmCompany::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_COMPANY_SPD'

 

    • Счета (старая версия)
      • entityTypeId = \CCrmOwnerType::Invoice = 5
      • entityTypeName = \CCrmOwnerType::InvoiceName = 'INVOICE'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Invoice = 'I'
      • userFieldEntityId = \CAllCrmInvoice::USER_FIELD_ENTITY_ID = 'CRM_INVOICE'
      • statusEntityId = 'INVOICE_STATUS'
      • permissionEntity = 'INVOICE'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedInvoice = 23
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedInvoiceName = 'SUS_INVOICE
      • suspendedUserFieldEntityId = \CAllCrmInvoice::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_INVOICE_SPD'

 

    • Предложения
      • entityTypeId = \CCrmOwnerType::Quote = 7
      • entityTypeName = \CCrmOwnerType::QuoteName = 'QUOTE'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Quote = 'Q'
      • userFieldEntityId = \CAllCrmQuote::USER_FIELD_ENTITY_ID = 'CRM_QUOTE'
      • statusEntityId = 'QUOTE_STATUS'
      • permissionEntity = 'QUOTE'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedQuote = 22
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedQuoteName = 'SUS_QUOTE
      • suspendedUserFieldEntityId = \CAllCrmQuote::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_QUOTE_SPD'

 

    • Заказы
      • entityTypeId = \CCrmOwnerType::Quote = 14
      • entityTypeName = \CCrmOwnerType::OrderName = 'ORDER'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::Order = 'O'
      • userFieldEntityId = \Bitrix\Crm\Order\Manager::getUfId() = 'ORDER'
      • statusEntityId — отсутствует, т.к. статусы заказа хранятся в b_sale_status
      • permissionEntity = 'ORDER'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedOrder = 24 — не используется, заказы не поддерживают корзину
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedOrderName = 'SUS_ORDER — не используется, заказы не поддерживают корзину
      • suspendedUserFieldEntityId — отсутствует, заказы не поддерживают корзину

 

    • Счета, у которых направление по умолчанию имеет ид = 10
      • entityTypeId = \CCrmOwnerType::SmartInvoice = 31
      • entityTypeName = \CCrmOwnerType::SmartInvoiceName = 'SMART_INVOICE'
      • entityTypeAbbr = \CCrmOwnerTypeAbbr::SmartInvoice = 'SI'
      • userFieldEntityId = \Bitrix\Crm\Service\Factory\SmartInvoice::USER_FIELD_ENTITY_ID = 'CRM_SMART_INVOICE'
      • statusEntityId = 'SMART_INVOICE_STAGE_10'
      • permissionEntity = 'SMART_INVOICE_C10'
      • suspendedEntityTypeId = \CCrmOwnerType::SuspendedSmartInvoice = 32
      • suspendedEntityTypeName = \CCrmOwnerType::SuspendedSmartInvoiceName = 'SUS_SMART_INVOICE
      • suspendedUserFieldEntityId = \Bitrix\Crm\Service\Factory\SmartInvoice::SUSPENDED_USER_FIELD_ENTITY_ID = 'CRM_SMART_INVOICE_SPD'

 

  • Смарт-процесс с идентификатором типа 128 и идентификатором 1 (колонка ID в b_crm_dynamic_type), направление по умолчанию которого имеет id = 20
    • entityTypeId = 128
    • entityTypeName = 'DYNAMIC_128'
    • entityTypeAbbr = 'T80'
    • userFieldEntityId = 'CRM_1'
    • statusEntityId = 'DYNAMIC_128_STAGE_20'
    • permissionEntity = 'DYNAMIC_128_C20'
    • suspendedEntityTypeId = 192
    • suspendedEntityTypeName = 'SUS_DYNAMIC_128
    • suspendedUserFieldEntityId = 'CRM_1_SPD'

Идентификаторы типа смарт-процессов находятся в промежутке от 128 до 191 (включительно).

Идентификаторы типа смарт-процессов, удаленных в корзину, находятся в промежутке от 192 до 255 (включительно).

Источник: https://dev.1c-bitrix.ru/api_d7/bitrix/crm/crm_owner_type/identifiers.php