.. _Integration_IntegrationApi_WorkingWithContractors_WorkingWithContractorsConcept:

Как работать с контрагентами
############################

Integration API Продукта позволяет:

* искать контрагентов;
* запрашивать данные контрагентов и их подразделений;
* использовать механизм обмена приглашениями к ЭДО.

Поиск контрагентов
******************

Поиск контрагентов выполняется в сервисах подключенных операторов ЭДО.

Результатом поиска будут данные о подключении контрагента к сервисам того или иного оператора.
Эти данные могут использоваться для последующей отправки приглашения к ЭДО.

Запрос данных контрагентов
**************************

Данные контрагентов появляются в Продукте в двух случаях:

* в результате обмена документами: при отправке или получении документов данные контрагента подгружаются от оператора ЭДО или EDI-провайдера;
* в результате обмена приглашениями к ЭДО с контрагентами.

В части работы с контрагентами Продукт является ведомой системой.
Предполагается, что основной источник данных о контрагентах - это внешняя система (ERP или СЭД).
Сначала контрагент появляется во внешней системе, затем - в Продукте: либо после обмена приглашениями, либо после обмена документами.

Запрос данных контрагентов со стороны внешней системы должен использоваться не для *наполнения* ее перечня контрагентов,
а для *синхронизации данных* по существующим контрагентам.

Контрагенты-подразделения
=========================

В сервисах операторов ЭДО для одной организации может быть определено несколько подразделений.
Каждое подразделение с точки зрения Продукта - это отдельный контрагент.

Данные контрагентов-подразделений появляются в Продукте при отправке документов в подразделения либо при получении документов из подразделений.

Внешняя система может использовать запрос данных подразделений контрагента для определения идентификатора подразделения перед отправкой документов:
этот идентификатор указывается в запросе на отправку.

Хранение данных контрагентов
============================

Данные контрагентов хранятся в Продукте в разрезе операторов ЭДО или EDI-провайдеров.
Одна и та же организация может быть сохранена более одного раза, с привязкой к разным операторам.

Синхронизация данных контрагентов
=================================

Интеграционный модуль синхронизирует сохраненные данные контрагентов, обновляя их из сервисов операторов ЭДО.

Синхронизация выполняется, если с контрагентом ведется документооборот или если есть активность в части обмена приглашениями.
В этих случаях, если данные контрагента были сохранены более часа назад, они повторно загружаются из сервиса оператора.

Это позволяет актуализировать данные контрагентов при смене реквизитов (КПП, адреса и т. д.).

Обмен приглашениями к ЭДО
*************************

Обмен приглашениями к ЭДО используется для управлениями отношениями партнерства между организациями и последующего обмена электронными документами.

Integration API позволяет отправлять, отзывать, принимать, отклонять приглашения и прекращать установленные отношения партнерства.
Возможности обмена приглашениями зависят от функциональных особенностей операторов ЭДО.

Если у оператора нет полноценного обмена приглашениями или он недоступен извне, Integration API позволяет имитировать урезанный функционал обмена приглашениями:
отправка приглашения приведет к запросу сведений о контрагенте в сервисе оператора ЭДО. Если контрагент будет найден, то его данные будут сохранены в Продукте.

Если функционал обмена приглашениями не используется или в Продукте нет данных о контрагенте, это не мешает документообороту с контрагентом.
В этом случае важно, чтобы возможность обмена документами была настроена на уровне сервиса оператора ЭДО.

| См. также:
| :ref:`Integration_IntegrationApi_Helpers_WorkingWithReferences_GettingOperatorFeatures`