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

from b24pysdk import BitrixWebhook, Client

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.com",
        webhook_token="user_id/webhook_key",
    )
)

# обертка b24pysdk принимает только entity_type_id, поэтому отбираем воронку по коду в ответе
categories = client.crm.category.list(
    entity_type_id=3,  # 3 — контакт
).response.result["categories"]

contractor_categories = [
    category
    for category in categories
    if category["code"] == "CATALOG_CONTRACTOR_CONTACT"
]
category_id = contractor_categories[0]["id"] if contractor_categories else None

// composer require bitrix24/b24phpsdk:"^3.0"
require_once 'vendor/autoload.php';

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Psr\Log\NullLogger;

$sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
    ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');

// у crm.category.list нет обертки в SDK — вызываем метод напрямую
$result = $sb->core->call(
    'crm.category.list',
    [
        'entityTypeId' => 3, // 3 — контакт
        'filter' => [
            'code' => 'CATALOG_CONTRACTOR_CONTACT' // Код системной воронки поставщиков
        ]
    ]
);

$categories = $result->getResponseData()->getResult()['categories'] ?? [];
$categoryId = $categories[0]['id'] ?? null;

item = client.crm.item.add(
    entity_type_id=3,  # 3 — контакт
    fields={
        "name": "Иван",  # Имя
        "lastName": "Иванов",  # Фамилия
        "categoryId": category_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": "Поставщик электроники",  # Комментарий
    },
).response.result["item"]

contractor_id = item["id"]

$result = $sb->getCRMScope()->item()->add(
    3, // 3 — контакт
    [
        'name' => 'Иван', // Имя
        'lastName' => 'Иванов', // Фамилия
        'categoryId' => $categoryId, // Идентификатор воронки из шага 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' => 'Поставщик электроники' // Комментарий
    ]
);

$contractorId = $result->item()->id;

check_result = client.crm.item.list(
    3,
    filter={"categoryId": category_id, "id": contractor_id},
    select=["id", "name", "lastName", "categoryId"],
).response.result["items"]

print(check_result)

$checkResult = $sb->getCRMScope()->item()->list(
    3,
    [],
    ['categoryId' => $categoryId, 'id' => $contractorId],
    ['id', 'name', 'lastName', 'categoryId']
);

print_r($checkResult->getItems());

from b24pysdk import BitrixWebhook, Client
from b24pysdk.errors import BitrixAPIError

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.com",
        webhook_token="user_id/webhook_key",
    )
)

entity_type_id = 3  # 3 — контакт, для компании укажите 4
category_code = "CATALOG_CONTRACTOR_CONTACT"  # для компании укажите CATALOG_CONTRACTOR_COMPANY
name_fields = {"name": "Иван", "lastName": "Иванов"}  # для компании укажите {"title": "ООО Электроника"}

try:
    # обертка b24pysdk принимает только entity_type_id, поэтому отбираем воронку по коду в ответе
    categories = client.crm.category.list(
        entity_type_id=entity_type_id,
    ).response.result["categories"]

    contractor_categories = [
        category
        for category in categories
        if category["code"] == category_code
    ]
    if not contractor_categories:
        print("Воронка поставщиков не найдена: проверьте складской учет и доступ пользователя вебхука")
    else:
        item = client.crm.item.add(
            entity_type_id,
            {
                **name_fields,
                "categoryId": contractor_categories[0]["id"],
                "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": "Поставщик электроники",
            },
        ).response.result["item"]

        print(f"Поставщик создан, id: {item['id']}")
except BitrixAPIError as error:
    print(f"Поставщик не создан: {error}")

<?php
// composer require bitrix24/b24phpsdk:"^3.0"
require_once 'vendor/autoload.php';

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Psr\Log\NullLogger;

$sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
    ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');

$entityTypeId = 3; // 3 — контакт, для компании укажите 4
$categoryCode = 'CATALOG_CONTRACTOR_CONTACT'; // для компании укажите CATALOG_CONTRACTOR_COMPANY
$nameFields = ['name' => 'Иван', 'lastName' => 'Иванов']; // для компании укажите ['title' => 'ООО Электроника']

try {
    // у crm.category.list нет обертки в SDK — вызываем метод напрямую
    $resultCategory = $sb->core->call(
        'crm.category.list',
        [
            'entityTypeId' => $entityTypeId,
            'filter' => ['code' => $categoryCode]
        ]
    );

    $categories = $resultCategory->getResponseData()->getResult()['categories'] ?? [];
    if (empty($categories)) {
        echo 'Воронка поставщиков не найдена: проверьте складской учет и доступ пользователя вебхука';
        return;
    }
    $categoryId = $categories[0]['id'];

    $resultItem = $sb->getCRMScope()->item()->add(
        $entityTypeId,
        array_merge(
            $nameFields,
            [
                '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' => 'Поставщик электроники'
            ]
        )
    );

    echo 'Поставщик создан, id: ' . $resultItem->item()->id;
} catch (\Throwable $e) {
    echo 'Поставщик не создан: ' . $e->getMessage();
}