.. _edi:

**Обмен EDI-сообщениями (Контур.EDI)**
======================================

EDI-сообщения - стандартизированные форматы сообщений для передачи коммерческой информации между организациями.

Функционал предоставляет возможность отправки исходящих и получения входящих EDI-сообщений за счет интеграции 
с EDI-провайдером (сервисом Контур.EDI компании АО «ПФ «СКБ Контур»). Обмен EDI-сообщениями может осуществляться 
непосредственно из интерфейса учетной системы SAP ERP.


.. important:: 

    Функционал обмена EDI-сообщениями лицензируется отдельно от основного функционала. 
    Лицензия, примененная для интеграционного модуля, должна содержать соответствующий компонент – `KED`.

Для работы функционала обмена EDI-сообщениями необходимо использовать специализированную схему взаимодействия с ИМ посредством веб-сервиса.
Для ее подключения нужно в настройке ``GET_DOC_STS_NEW`` установить значение "X". 
Настройка ``GET_DOC_STS_NEW`` находится в таблице ``/TRL/XDE_CUST``, которую можно просмотреть через транзакцию ``sm30``.
Подробнее см. :ref:`settings-integration-type-pf`.

Также необходимо создать отдельный код оператора, для которого указать, что данный оператор работает с EDI-сообщениями.
Для этого нужно установить флаг в поле "Опер EDI" (``EDI``).

.. image:: media/image1.png
   :scale: 85   
   :align: center
   :name: image146
   :alt: Ракурс ведения

Для обеспечения возможности обмена EDI-сообщениями реализован специальный вид документа оператора ЭДО - **EDI message**. 
Для начала работы с функционалом требуется самостоятельно в настроечной таблице видов документов SAP завести конкретные виды 
необходимых EDI-сообщений, например, **ORDERS**, **ORDERSP** и т.д. и указать соответствие настраиваемых видов EDI-сообщений 
виду оператора ЭДО **EDI message**. 

Настройка видов документов SAP ведется в таблице ``/TRL/XDE_SHIP_TY`` при помощи транзакции ``SM30``.

На основных экранах транзакций просмотра списков исходящих и входящих документов ``/TRL/XDE_OUTBOX`` и ``/TRL/XDE_INBOX`` 
для EDI-сообщений в поле «Вид документа OED» будет указано значение **EDI Message**, а в поле «Вид документа SAP» - вид, 
созданный в таблице ``/TRL/XDE_SHIP_TY``.  
Подробнее о настройке см. :ref:`docflowsap`.

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

Для создания отправки через транзакцию ``VF03`` нужно указать необходимую фактуру и через вызов GOS-меню выбрать необходимый тип документа, прикрепив к нему вложение
аналогично отправке неформализованого документа. Подробнее см. :ref:`outboxsending`.

Для создания отправки не через транзакцию ``VF03`` (реализовано в продукте xDE) следует использовать функциональный модуль ``/TRL/XDE_API_SHIPM_OUT_ADD``.
При заполнении данных для вызова данного ФМ необходимо учитывать, что EDI-сообщение не требует подписания.

Статусная схема для EDI-сообщений включает в себя только получение документа и его отправку, без возможности согласования/отклонения. 
Ознакомиться с ней можно в разделах:

* :ref:`Статусная схема для исходящих EDI <outbox_status_schemes_edi>`
* :ref:`Статусная схема для входящих EDI <inbox_status_schemes_edi>`