Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Как создать поставщика в CRM», проанализируем лучшие практики и покажем, как правильно использовать битрикс в реальных задачах.

Как создать поставщика в CRM

> Scope: crm
>
> Кто может выполнять метод: пользователи с правом на создание контактов или компаний в CRM

Поставщики — это контакты и компании CRM с признаком системной категории:

• CATALOG_CONTRACTOR_CONTACT — для контакта,
• CATALOG_CONTRACTOR_COMPANY — для компании.

Чтобы создать поставщика, последовательно выполним два метода:

1. crm.category.list — получим идентификатор категории для контакта или компании.
2. crm.item.add — создадим контакт или компанию как поставщика.

1. Получим идентификатор категории поставщика

Используем метод crm.category.list с параметрами:

• entityTypeId — идентификатор типа объекта CRM. Укажем 3 для контактов. Для компаний используйте 4.
• filter[code] — фильтр по коду категории. Укажем CATALOG_CONTRACTOR_CONTACT для контакта. Для компаний используйте CATALOG_CONTRACTOR_COMPANY.

• JS

    BX24.callMethod(
        'crm.category.list',
        {
            entityTypeId: 3, 
            filter: {
                code: 'CATALOG_CONTRACTOR_CONTACT'
            }
        },
        function(result) {
            console.log(result.data());
        }
    );

• PHP

    require_once('crest.php');

    $result = CRest::call(
        'crm.category.list',
        [
            'entityTypeId' => 3,
            'filter' => [
                'code' => 'CATALOG_CONTRACTOR_CONTACT'
            ]
        ]
    );

В результате получим идентификатор категории. В примере id:15. Идентификатор может отличаться на разных Битрикс24.

{
  "result": {
    "categories": [
      {
        "id": 15,
        "name": "Контакты поставщика",
        "entityTypeId": 3,
        "isSystem": "Y",
        "code": "CATALOG_CONTRACTOR_CONTACT"
      }
    ]
  }
}

2. Создадим поставщика

Используем метод crm.item.add с параметрами:

• entityTypeId — идентификатор типа объекта CRM. Укажем 3 для контактов. Для компаний используйте 4.

• fields[categoryId] — идентификатор системной категории из шага 1. В примере 15.

• fields[name] — имя.
• fields[lastName] — фамилия. Для компании вместо имени и фамилии можно передать поле fields[title] — название.

• fields[fm] — массив мультиполей crm_multifield для телефона и email.
• fields[comments] — комментарий.

Телефон и email система хранит как массив мультиполей fm. Каждый элемент массива содержит:

• typeId — тип мультиполя, PHONE или EMAIL,
• valueType — тип значения, например WORK или MOBILE,
• value — значение поля.

• JS

    BX24.callMethod(
        'crm.item.add',
        {
            entityTypeId: 3, 
            fields: {
                name: 'Иван',
                lastName: 'Иванов',
                categoryId: 15,  // id из шага 1
                fm: [
                    { typeId: 'PHONE', valueType: 'WORK', value: '+7 900 000 00 00' },
                    { typeId: 'PHONE', valueType: 'MOBILE', value: '+7 495 111 22 33' },
                    { typeId: 'EMAIL', valueType: 'WORK', value: 'supplier@example.ru' }
                ],
                comments: 'Поставщик электроники'
            }
        },
        function(result) {
            if (result.error()) {
                console.error(result.error() + ': ' + result.error_description());
            } else {
                console.log(result.data());
            }
        }
    );

• PHP

    require_once('crest.php');

    $result = CRest::call(
        'crm.item.add',
        [
            'entityTypeId' => 3,
            'fields' => [
                'name' => 'Иван',
                'lastName' => 'Иванов',
                'categoryId' => 15, // id из шага 1
                'fm' => [
                    [ 'typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => '+7 900 000 00 00' ],
                    [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+7 495 111 22 33' ],
                    [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'supplier@example.ru' ]
                ],
                'comments' => 'Поставщик электроники'
            ]
        ]
    );

В результате метод вернет объект item с данными созданного поставщика.

{
    "result": {
        "item": {
            "id": 2449,
            "createdTime": "2025-12-29T13:18:40+03:00",
            "updatedTime": "2025-12-29T13:18:40+03:00",
            "createdBy": 1,
            "updatedBy": 1,
            "assignedById": 1,
            "opened": "Y",
            "companyId": null,
            "name": "Иван",
            "lastName": "Иванов",
            "secondName": null,
            "shortName": null,
            "photo": null,
            "post": null,
            "address": null,
            "comments": "Поставщик электроники",
            "leadId": null,
            "export": "Y",
            "webformId": null,
            "originatorId": null,
            "originId": null,
            "originVersion": null,
            "birthdate": null,
            "honorific": null,
            "hasPhone": "Y",
            "hasEmail": "Y",
            "hasImol": "N",
            "searchContent": null,
            "categoryId": 15,
            "lastActivityBy": 1,
            "lastActivityTime": "2025-12-29T13:18:40+03:00",
            "login": null,
            "emailHome": null,
            "emailWork": null,
            "emailMailing": null,
            "phoneMobile": null,
            "phoneWork": null,
            "phoneMailing": null,
            "imol": null,
            "email": null,
            "phone": null,
            "lastCommunicationTime": null,
            "lastCommunicationCallTime": null,
            "lastCommunicationEmailTime": null,
            "lastCommunicationImolTime": null,
            "lastCommunicationWebformTime": null,
            "observers": [],
            "companyIds": [],
            "entityTypeId": 3,
            "fm": [
                {
                    "id": 8297,
                    "valueType": "WORK",
                    "value": "+7 900 000 00 00",
                    "typeId": "PHONE"
                },
                {
                    "id": 8299,
                    "valueType": "MOBILE",
                    "value": "+7 495 111 22 33",
                    "typeId": "PHONE"
                },
                {
                    "id": 8301,
                    "valueType": "WORK",
                    "value": "supplier@example.ru",
                    "typeId": "EMAIL"
                }
            ]
        }
    },
    "time": {
        "start": 1767003520,
        "finish": 1767003520.776535,
        "duration": 0.7765350341796875,
        "processing": 0,
        "date_start": "2025-12-29T13:18:40+03:00",
        "date_finish": "2025-12-29T13:18:40+03:00",
        "operating_reset_at": 1767004120,
        "operating": 0.4402291774749756
    }
}

Идентификатор поставщика, в примере id: 2449, используйте в методе складского учета catalog.documentcontractor.add.

Пример кода

• JS

    var entityTypeId = 3; // 3 - контакт; для компании укажите 4
    var categoryCode = 'CATALOG_CONTRACTOR_CONTACT'; // для компании укажите CATALOG_CONTRACTOR_COMPANY
    var categoryId = null;

    BX24.callMethod(
        'crm.category.list',
        {
            entityTypeId: entityTypeId,
            filter: { code: categoryCode }
        },
        function(resultCategory) {
            if (resultCategory.error()) {
                console.error(resultCategory.error() + ': ' + resultCategory.error_description());
                return;
            }

            var categories = resultCategory.data().categories || [];
            if (!categories.length) {
                console.error('Категория поставщиков не найдена');
                return;
            }

            categoryId = categories[0].id;

            BX24.callMethod(
                'crm.item.add',
                {
                    entityTypeId: entityTypeId,
                    fields: {
                        name: 'Иван',
                        lastName: 'Иванов',
                        categoryId: categoryId,
                        fm: [
                            { typeId: 'PHONE', valueType: 'WORK', value: '+7 900 000 00 00' },
                            { typeId: 'PHONE', valueType: 'MOBILE', value: '+7 495 111 22 33' },
                            { typeId: 'EMAIL', valueType: 'WORK', value: 'supplier@example.ru' }
                        ],
                        comments: 'Поставщик электроники'
                    }
                },
                function(resultItem) {
                    if (resultItem.error()) {
                        console.error(resultItem.error() + ': ' + resultItem.error_description());
                    } else {
                        console.log(resultItem.data());
                    }
                }
            );
        }
    );

• PHP

    require_once('crest.php');

    $entityTypeId = 3; // 3 - контакт; для компании укажите 4
    $categoryCode = 'CATALOG_CONTRACTOR_CONTACT'; // для компании укажите CATALOG_CONTRACTOR_COMPANY

    $resultCategory = CRest::call(
        'crm.category.list',
        [
            'entityTypeId' => $entityTypeId,
            'filter' => [
                'code' => $categoryCode
            ]
        ]
    );

    if (!empty($resultCategory['error_description'])) {
        echo $resultCategory['error_description'];
        return;
    }

    $categories = $resultCategory['result']['categories'] ?? [];
    if (empty($categories)) {
        echo 'Категория поставщиков не найдена';
        return;
    }

    $categoryId = $categories[0]['id'];

    $resultItem = CRest::call(
        'crm.item.add',
        [
            'entityTypeId' => $entityTypeId,
            'fields' => [
                'name' => 'Иван',
                'lastName' => 'Иванов',
                'categoryId' => $categoryId,
                'fm' => [
                    [ 'typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => '+7 900 000 00 00' ],
                    [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+7 495 111 22 33' ],
                    [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'supplier@example.ru' ]
                ],
                'comments' => 'Поставщик электроники'
            ]
        ]
    );

    if (!empty($resultItem['error_description'])) {
        echo $resultItem['error_description'];
    } else {
        print_r($resultItem['result']);
    }