.. _Integration_IntegrationApi_SendingDocuments_PostSendingTasksEzz:

Постановка задач на отправку ЭЗЗ
################################

| Запрос: ``POST documents/ezz/send``
| HTTP-заголовки:

.. code-block::

    Authorization: Bearer access_token
    Content-Type: application/json
    Accept: application/json

Тело запроса:

.. code-block:: JSON

    {
        "OperatorId": "string",                     // идентификатор оператора ЭДО или EDI-провайдера
        "Documents": [                              // список документов для отправки
            {
                "Id": "guid",                       // идентификатор документа
                "MinTransId": "string",             // идентификатор в ГИС ЭПД
                "ContentFileName": "string",        // имя файла документа с расширением
                "ContentLinkId": "string",          // ссылка на контент документа в архиве
                "SignatureFileName": "string",      // имя файла подписи
                "SignatureLinkId": "string",        // ссылка на подпись в архиве
                "Commentary": "string",             // комментарий к документу
                "Number": "string",                 // наименование документа
                "Date": "YYYY-MM-DD",               // дата документа
                "PowerOfAttorney": {                // данные доверенности (МЧД)
                },                                  
                "CargoSender": {                    // сведения о грузоотправителе
                },
                "CargoTransporter": {               // сведения о грозоперевозчике
                }
            }
        ]
    }

Описание запроса
****************

Запрос позволяет поставить одну или несколько задач на отправку ЭЗЗ одному оператору ЭДО, который задается полем ``OperatorId``.

Для операторов ЭДО ``OperatorId`` - это код оператора, присвоенный ФНС (например, "2AL", "2AE", "2BM", и т.д.).

Адресация документа
*******************

Каждый документ содержит адресную информацию: от кого и кому он отправляется.

Отправитель задается идентификатором ящика в поле ``CargoSender`` и, опционально, идентификатором подразделения.
Структура ``CargoSender``:

.. code-block:: JSON

    {
        "BoxId": "string",          // идентификатор ящика отправителя
        "DepartmentId": "string"    // идентификатор подразделения отправителя
    }

Идентификатор подразделения указывается, если пакет нужно отправить из подразделения, а не из головной организации отправителя.
Ящик отправителя должен быть подключен и настроен в Продукте (см. :ref:`Setup_Integration_BasicSetup_Operators`).

Получатель задается в поле ``CargoTransporter`` соотвественно. Для задания каждого из полей необходимо заполнить структуру:

.. code-block:: JSON

    {
        "BoxId": "string",          // идентификатор ящика получателя
        "DepartmentId": "string"    // идентификатор подразделения получателя
        "FnsId": "string",          // ФНС-идентификатор получателя
        "Inn": "string",            // ИНН получателя
        "Kpp": "string"             // КПП получателя
    }

Для адресации получателя существует три способа:

* Указать идентификатор ящика получателя в поле ``BoxId`` и, опционально, идентификатор подразделения в поле ``DepartmentId``.
  Идентификатор подразделения указывается, если пакет нужно отправить в подразделение, а не в головную организацию получателя.
* Указать ФНС-идентификатор получателя в поле ``FnsId``.
* Указать ИНН и КПП получателя в полях ``Inn`` и ``Kpp``. КПП не указывается, если получатель - ИП.

.. note::
    Указывать адресную информацию получателя нужно одним из трех способов. Использовать более одного способа нельзя.

Идентификаторы ящиков, подразделений и ФНС-идентификаторы
=========================================================

Идентификатор ящика - это идентификатор учетной записи организации в сервисе оператора ЭДО.
Формат идентификаторов ящиков и подразделений зависит от выбранного оператора.

ФНС-идентификатор - это идентификатор участника ЭДО.
Он выдается оператором при подключении организации и указывается в атрибутах ``ИдФайл`` формализованных вложений.
Обычно ФНС-идентификатор - это строка вида "код оператора + guid".

В общем случае идентификатор ящика и ФНС-идентификатор - это разные данные. В частном случае они могут совпадать.

Структура данных документа
==========================

Для каждого документа в поле ``DocumentId`` задается его идентификатор в системе, которая выполняет отправку, имя файла с расширением и имя файла подписи.

.. note::
    Имя файла должно быть сформировано из значения атрибута ``ИдФайл`` плюс расширение ``xml``.

Содержимое документа передается по ссылке, которая указана в поле ``ContentLinkId``. Содержимое должно быть предварительно :ref:`сохранено <Integration_ArchiveApi_SavingFilesToArchive>` в архиве.

Для каждого документа нужно задать поле ``MinTransId`` - идентификатор документа в ГИС ЭПД Минтранса России.

Вместе с документом можно передать произвольный текстовый комментарий к нему в поле ``Comment``. Комментарий не должен быть длинее 2000 символов.
Он будет передан получателю, только если сервис выбранного оператора поддерживает передачу комментариев.
В противном случае значение поля будет проигнорировано.

Подпись передается по ссылке, которая указана в поле ``SignatureLinkId``. Подпись должна быть предварительно сохранена в архиве.

.. include:: ../_Include/SignerPowerOfAttorney.rst

Формирование подписей
---------------------

Продукт поддерживает два способа формирования подписей:

* Локальное подписание - в этом случае формирование ЭП выполняется с помощью сертификата, установленного на машине пользователя средствами, работающими на этой же машине.
* Серверное подписание - в этом случае формирование ЭП выполняется с помощью :ref:`Crypto API <Integration_CryptoApi_index>` Продукта.
  Сертификат для создания ЭП должен быть доступен для Crypto API.

В обоих случаях порядок отправки не меняется:

* :ref:`сформировать <Integration_CryptoApi_CreatingSignature>` подпись выбранным способом;
* :ref:`сохранить <Integration_ArchiveApi_SavingFilesToArchive>` контент документа в архиве;
* :ref:`сохранить <Integration_ArchiveApi_SavingFilesToArchive>` подпись в архиве;
* сформировать и выполнить запрос на отправку.

Ответ на запрос
***************

Запрос ставит задачи на отправку интеграционному модулю Продукта и возвращает идентификаторы поставленных задач в виде коллекции:

.. code-block:: JSON

    [
        1,
        2,
        3,  // и т. д.
    ]

Для каждого документа в запросе ставится отдельная задача на отправку.