<p> Недавно мы обновили логику работы контрагентов: добавили множественную привязку контактов. Поэтому мы расширили логику работы с программным интерфейсом приложения (API). </p> <div class="alert alert-info" role="alert"> <b>Кого это касается:</b>&nbsp;всех пользователей, которые использовали в своей работе программный интерфейс&nbsp;приложения (API)&nbsp;для интеграции с внешними сервисами. У функционала нет обратной совместимости, так что мы рекомендуем воспользоваться новой логикой для настройки. </div> <h2 id="anchor_1">Создание</h2> <h3>Как было раньше</h3> <p> Использовались поля: </p> <ul> <li> customer_id – для установки компании; </li> <li> contact_id – для установки контакта. </li> </ul> <p> Поддерживалась привязка <b>только двух контрагентов</b> к сделке. </p> <h3>Стало</h3> <p> Добавлна&nbsp;конечная точка (эндпоинт) «crm/lead_accounts/create». Подробнее — <a href="https://aspro.cloud/api/#tag/Svyaz-sdelki-s-kontragentami"><b>в документации</b></a>. </p> <p> Конечная точка (эндпоинт) предназначена для установки связи контрагентов со сделкой. Ключевое отличие от предыдущей версии — поддержка множественной привязки контрагентов к одной сделке. </p> <h2 id="anchor_2">Запрос (Request)</h2> <div class="table-wrap mt-9"> <table> <colgroup><col><col><col></colgroup> <tbody> <tr> <td> <p> <b>Поле</b> </p> </td> <td> <p> <b>Обязательное</b> </p> </td> <td> <p> <b>Описание</b> </p> </td> </tr> <tr> <td> <p> lead_id </p> </td> <td> <p> Да </p> </td> <td> <p> ID сделки, к которой привязывается контрагент </p> </td> </tr> <tr> <td> <p> account_id </p> </td> <td> <p> Да </p> </td> <td> <p> ID контрагента, который будет привязан к сделке </p> </td> </tr> <tr> <td> <p> account_type </p> </td> <td> <p> Да </p> </td> <td> <p> Тип контрагента: </p> <ul> <li> <p> 1 — юридическое лицо </p> </li> <li> <p> 2 — физическое лицо </p> </li> </ul> </td> </tr> <tr> <td> <p> created_at </p> </td> <td> <p> Нет </p> </td> <td> <p> Дата создания. Служебное поле, заполняется автоматически </p> </td> </tr> <tr> <td> <p> updated_at </p> </td> <td> <p> Нет </p> </td> <td> <p> Дата обновления. Служебное поле, заполняется автоматически </p> </td> </tr> </tbody> </table> </div> <h2 id="anchor_3">Получение</h2> <h3>Как было раньше</h3> <p> При получении сущности сделки в ответе возвращались поля: </p> <ul> <li> customer_id; </li> <li> contact_id. </li> </ul> <p> Данный механизм позволял получить только двух контрагентов, связанных со сделкой: компанию и клиента. </p> <h3>Стало</h3> <p> Поля contact_id и customer_id больше не возвращаются в сущности сделки и не используются для получения связей с контрагентами. </p> <p> Для получения информации о контрагентах, связанных со сделкой, необходимо использовать специализированные&nbsp;конечные точки (эндпоинты): </p> <ul> <li> crm/lead_accounts/get/{id} – получение конкретной связи сделки с контрагентом (<a href="https://aspro.cloud/api/#tag/Svyaz-sdelki-s-kontragentami/paths/~1crm~1lead_accounts~1get~1%7Bid%7D/get">см. документацию</a>); </li> <li> crm/lead_accounts/list – получение списка всех контрагентов, связанных со сделкой (<a href="https://aspro.cloud/api/#tag/Svyaz-sdelki-s-kontragentami/paths/~1crm~1lead_accounts~1list/get">см. документацию</a>). </li> </ul> <div class="alert alert-info" role="alert"> Такой подход поддерживает множественную привязку и является актуальным способом получения данных. </div> <br>