Как работать с полем Привязка к элементам CRM

from b24pysdk import BitrixWebhook

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

# Вызов через ядро SDK: типизированной обертки для пользовательских полей нет
one = token.call_method("crm.deal.userfield.add", {
    "fields": {
        "FIELD_NAME": "BIND_ONE",
        "USER_TYPE_ID": "crm",
        "MULTIPLE": "N",
        "EDIT_FORM_LABEL": {"ru": "Ответственный контакт"},
        "SETTINGS": {"LEAD": "N", "CONTACT": "Y", "COMPANY": "N", "DEAL": "N"},
    },
})["result"]

many = token.call_method("crm.deal.userfield.add", {
    "fields": {
        "FIELD_NAME": "BIND_MANY",
        "USER_TYPE_ID": "crm",
        "MULTIPLE": "Y",
        "EDIT_FORM_LABEL": {"ru": "Подрядчики"},
        "SETTINGS": {"LEAD": "N", "CONTACT": "N", "COMPANY": "Y", "DEAL": "N"},
    },
})["result"]

print(one, many)

require_once 'vendor/autoload.php';

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;

$serviceBuilder = (new ServiceBuilderFactory(new EventDispatcher(), $log))
    ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');

// Вызов через ядро SDK: типизированной обертки для пользовательских полей нет
$one = $serviceBuilder->core->call('crm.deal.userfield.add', ['fields' => [
    'FIELD_NAME' => 'BIND_ONE',
    'USER_TYPE_ID' => 'crm',
    'MULTIPLE' => 'N',
    'EDIT_FORM_LABEL' => ['ru' => 'Ответственный контакт'],
    'SETTINGS' => ['LEAD' => 'N', 'CONTACT' => 'Y', 'COMPANY' => 'N', 'DEAL' => 'N'],
]])->getResponseData()->getResult();

$many = $serviceBuilder->core->call('crm.deal.userfield.add', ['fields' => [
    'FIELD_NAME' => 'BIND_MANY',
    'USER_TYPE_ID' => 'crm',
    'MULTIPLE' => 'Y',
    'EDIT_FORM_LABEL' => ['ru' => 'Подрядчики'],
    'SETTINGS' => ['LEAD' => 'N', 'CONTACT' => 'N', 'COMPANY' => 'Y', 'DEAL' => 'N'],
]])->getResponseData()->getResult();

print_r([$one, $many]);

token.call_method("crm.item.update", {
    "entityTypeId": 2,
    "id": 10,
    "fields": {
        "ufCrmBindOne": "C_1",
        "ufCrmBindMany": ["CO_1", "CO_2"],
    },
})

$serviceBuilder->core->call('crm.item.update', [
    'entityTypeId' => 2,
    'id' => 10,
    'fields' => [
        'ufCrmBindOne' => 'C_1',
        'ufCrmBindMany' => ['CO_1', 'CO_2'],
    ],
]);

item = token.call_method("crm.item.get", {
    "entityTypeId": 2,
    "id": 10,
})["result"]["item"]

print(item["ufCrmBindOne"])   # 'C_1'
print(item["ufCrmBindMany"])  # ['CO_1', 'CO_2']

$item = $serviceBuilder->core->call('crm.item.get', [
    'entityTypeId' => 2,
    'id' => 10,
])->getResponseData()->getResult()['item'];

print_r($item['ufCrmBindOne']);   // 'C_1'
print_r($item['ufCrmBindMany']);  // ['CO_1', 'CO_2']

rows = token.call_method("crm.enum.ownertype")["result"]
codes = {r["SYMBOL_CODE_SHORT"]: {"entity_type_id": int(r["ID"]), "name": r["NAME"]} for r in rows}

values = [item["ufCrmBindOne"], *item["ufCrmBindMany"]]

for value in values:
    code, _, element_id = value.rpartition("_")
    entity_type = codes[code]

    element = token.call_method("crm.item.get", {
        "entityTypeId": entity_type["entity_type_id"],
        "id": int(element_id),
    })["result"]["item"]

    print(value, entity_type["name"], element)

$rows = $serviceBuilder->core->call('crm.enum.ownertype')
    ->getResponseData()->getResult();

$codes = [];
foreach ($rows as $row) {
    $codes[$row['SYMBOL_CODE_SHORT']] = ['entityTypeId' => (int)$row['ID'], 'name' => $row['NAME']];
}

$values = array_merge([$item['ufCrmBindOne']], $item['ufCrmBindMany']);

foreach ($values as $value) {
    $separator = strrpos($value, '_');
    $code = substr($value, 0, $separator);
    $elementId = (int)substr($value, $separator + 1);
    $type = $codes[$code];

    $element = $serviceBuilder->core->call('crm.item.get', [
        'entityTypeId' => $type['entityTypeId'],
        'id' => $elementId,
    ])->getResponseData()->getResult()['item'];

    echo $value . ' ' . $type['name'] . PHP_EOL;
    print_r($element);
}

from b24pysdk import BitrixWebhook

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

entity_type_id = 2
deal_id = 10

# 1. Создаем простое и множественное поля привязки
token.call_method("crm.deal.userfield.add", {"fields": {
    "FIELD_NAME": "BIND_ONE",
    "USER_TYPE_ID": "crm",
    "MULTIPLE": "N",
    "EDIT_FORM_LABEL": {"ru": "Ответственный контакт"},
    "SETTINGS": {"LEAD": "N", "CONTACT": "Y", "COMPANY": "N", "DEAL": "N"},
}})

token.call_method("crm.deal.userfield.add", {"fields": {
    "FIELD_NAME": "BIND_MANY",
    "USER_TYPE_ID": "crm",
    "MULTIPLE": "Y",
    "EDIT_FORM_LABEL": {"ru": "Подрядчики"},
    "SETTINGS": {"LEAD": "N", "CONTACT": "N", "COMPANY": "Y", "DEAL": "N"},
}})

# 2. Записываем значения: строку в простое поле, массив во множественное
token.call_method("crm.item.update", {
    "entityTypeId": entity_type_id,
    "id": deal_id,
    "fields": {"ufCrmBindOne": "C_1", "ufCrmBindMany": ["CO_1", "CO_2"]},
})

# 3. Читаем привязки
item = token.call_method("crm.item.get", {
    "entityTypeId": entity_type_id,
    "id": deal_id,
})["result"]["item"]

# 4. Разворачиваем значения в записи
rows = token.call_method("crm.enum.ownertype")["result"]
codes = {r["SYMBOL_CODE_SHORT"]: {"entity_type_id": int(r["ID"]), "name": r["NAME"]} for r in rows}

for value in [item["ufCrmBindOne"], *item["ufCrmBindMany"]]:
    code, _, element_id = value.rpartition("_")
    entity_type = codes.get(code)

    if not entity_type:
        print("Неизвестный код типа в значении", value)
        continue

    linked = token.call_method("crm.item.get", {
        "entityTypeId": entity_type["entity_type_id"],
        "id": int(element_id),
    })["result"]["item"]

    label = linked.get("title") or " ".join(filter(None, [linked.get("name"), linked.get("lastName")]))

    print(value, "->", entity_type["name"], label)

require_once 'vendor/autoload.php';

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;

$serviceBuilder = (new ServiceBuilderFactory(new EventDispatcher(), $log))
    ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');

$entityTypeId = 2;
$dealId = 10;

function call($serviceBuilder, $method, $params = [])
{
    return $serviceBuilder->core->call($method, $params)->getResponseData()->getResult();
}

// 1. Создаем простое и множественное поля привязки
call($serviceBuilder, 'crm.deal.userfield.add', ['fields' => [
    'FIELD_NAME' => 'BIND_ONE',
    'USER_TYPE_ID' => 'crm',
    'MULTIPLE' => 'N',
    'EDIT_FORM_LABEL' => ['ru' => 'Ответственный контакт'],
    'SETTINGS' => ['LEAD' => 'N', 'CONTACT' => 'Y', 'COMPANY' => 'N', 'DEAL' => 'N'],
]]);

call($serviceBuilder, 'crm.deal.userfield.add', ['fields' => [
    'FIELD_NAME' => 'BIND_MANY',
    'USER_TYPE_ID' => 'crm',
    'MULTIPLE' => 'Y',
    'EDIT_FORM_LABEL' => ['ru' => 'Подрядчики'],
    'SETTINGS' => ['LEAD' => 'N', 'CONTACT' => 'N', 'COMPANY' => 'Y', 'DEAL' => 'N'],
]]);

// 2. Записываем значения: строку в простое поле, массив во множественное
call($serviceBuilder, 'crm.item.update', [
    'entityTypeId' => $entityTypeId,
    'id' => $dealId,
    'fields' => ['ufCrmBindOne' => 'C_1', 'ufCrmBindMany' => ['CO_1', 'CO_2']],
]);

// 3. Читаем привязки
$item = call($serviceBuilder, 'crm.item.get', [
    'entityTypeId' => $entityTypeId,
    'id' => $dealId,
])['item'];

// 4. Разворачиваем значения в записи
$codes = [];
foreach (call($serviceBuilder, 'crm.enum.ownertype') as $row) {
    $codes[$row['SYMBOL_CODE_SHORT']] = ['entityTypeId' => (int)$row['ID'], 'name' => $row['NAME']];
}

foreach (array_merge([$item['ufCrmBindOne']], $item['ufCrmBindMany']) as $value) {
    $separator = strrpos($value, '_');
    $code = substr($value, 0, $separator);

    if (!isset($codes[$code])) {
        echo 'Неизвестный код типа в значении ' . $value . PHP_EOL;
        continue;
    }

    $linked = call($serviceBuilder, 'crm.item.get', [
        'entityTypeId' => $codes[$code]['entityTypeId'],
        'id' => (int)substr($value, $separator + 1),
    ])['item'];

    $label = $linked['title'] ?? trim(($linked['name'] ?? '') . ' ' . ($linked['lastName'] ?? ''));

    echo $value . ' -> ' . $codes[$code]['name'] . ' ' . $label . PHP_EOL;
}