Недавно мы обновили логику работы контрагентов: добавили множественную привязку контактов. Поэтому мы расширили логику работы с программным интерфейсом приложения (API).
Создание
Как было раньше
Использовались поля:
- customer_id – для установки компании;
- contact_id – для установки контакта.
Поддерживалась привязка только двух контрагентов к сделке.
Стало
Добавлна конечная точка (эндпоинт) «crm/lead_accounts/create». Подробнее — в документации.
Конечная точка (эндпоинт) предназначена для установки связи контрагентов со сделкой. Ключевое отличие от предыдущей версии — поддержка множественной привязки контрагентов к одной сделке.
Запрос (Request)
|
Поле |
Обязательное |
Описание |
|
lead_id |
Да |
ID сделки, к которой привязывается контрагент |
|
account_id |
Да |
ID контрагента, который будет привязан к сделке |
|
account_type |
Да |
Тип контрагента:
|
|
created_at |
Нет |
Дата создания. Служебное поле, заполняется автоматически |
|
updated_at |
Нет |
Дата обновления. Служебное поле, заполняется автоматически |
Получение
Как было раньше
При получении сущности сделки в ответе возвращались поля:
- customer_id;
- contact_id.
Данный механизм позволял получить только двух контрагентов, связанных со сделкой: компанию и клиента.
Стало
Поля contact_id и customer_id больше не возвращаются в сущности сделки и не используются для получения связей с контрагентами.
Для получения информации о контрагентах, связанных со сделкой, необходимо использовать специализированные конечные точки (эндпоинты):
- crm/lead_accounts/get/{id} – получение конкретной связи сделки с контрагентом (см. документацию);
- crm/lead_accounts/list – получение списка всех контрагентов, связанных со сделкой (см. документацию).
