.. _Integration_IntegrationApi_DocumentActions_EzzReceivingAccepting_GeneratingAttachments:

Генерация вложений
##################

| Запрос: ``POST /document/ezz/receiver/accept/cargo/content``
| HTTP-заголовки:

.. code-block::

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

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

.. code-block:: JSON

    {
        "DocumentId": "guid",                   // идентификатор документа
        "Signer": {                             // подписант
        },
        "SignerStatuses": [                     // статусы подписанта
        ],
        "Parameters": [                         // параметры генерации титула грузоперевозчика
        ],
        "Certificate": "base64"                 // открытая часть сертификата подписанта в Base64
    }

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

Запрос ставит задачу на генерацию файла обмена информации грузоперевозчика.

Статусы подписантов
===================

Статусы подписантов нужны для титулов ЭЗЗ:

.. code-block:: JSON

    {
        "DocumentId": "guid",                       // идентификатор документа
        "SignerStatus": 0                           // статус подписанта
    }

Статусы передаются в разрезе документов: если в пакете несколько документов, то для каждого документа могут быть заданы свои значения.
Если статусы для документа не переданы, то используются значения по умолчанию.

Значение поля ``SignerStatus`` является перечислением и определяется приказом ФНС.

.. note::
    Статус подписанта передается в XML-элементе ``Подписант``.

.. note::
    В качестве значения по умолчанию используется статус, описывающий лицо, действующее от имени компании без доверенности.

Параметры генерации титула грузоперевозчика
===========================================

Параметры генерации титула грузоперевозчика нужны для заполнения обязательных элементов содержимого файла:

.. code-block:: JSON

    {
        "DocumentId": "guid",                    // идентификатор документа
        "IsAccepted": true,                      // признак того, что информация грузоотправителя принята
        "RejectReason": "string",                // причина отклонения
        "FinancialSubject": "string",            // наименование экономического субъекта
        "IsFinancialSubjectTransporter": true,   // признак того, что экономический субъект - грузоперевозчик
        "TransportationCost": "string",          // стоимость перевозки без налога
        "TaxRate": "string",                     // налоговая ставка перевозки
        "DocumentParticulars": {                 // сведения о реквизитах сторон титула грузоперевозчика
        },
        "ResponsibleTransporter": {              // сведения о лице, ответственном за организацию перевозки со стороны перевозчика
        },
        "Driver": {                              // сведения о водителе
        },
        "Vehicle": {                             // сведения о транспортном средстве
        }
    }

.. note::
    Сведения о реквизитах сторон титула грузоперевозчика заполняются, если грузоперевозчик не является экономическим субъектом (значение ``IsFinancialSubjectTransporter`` равно ``false``).

Сведения о реквизитах сторон титула грузоперевозчика:

.. code-block:: JSON

    {
        "DocumentNumber": "string",            // идентификатор документа
        "DocumentParties": [                   // список сторон документа
        ] 
    }

Список сторон титула грузоперевозчика:

.. code-block:: JSON

    {
        "Inn": "string",                      // ИНН стороны документа
        "IsLegalEntity": true                 // признак того, что сторона документа является ЮЛ
    }

Сведения о лице, ответственном за организацию перевозки со стороны перевозчика:

.. code-block:: JSON

    {
        "Surname": "string",     // фамилия
        "FirstName": "string",   // имя
        "MiddleName": "string",  // отчество
        "Telephone": "string",   // номер телефона
        "Inn": "string"          // ИНН
    }

Сведения о водителе:   

.. code-block:: JSON

    {
        "LisenseNumber": "string",    // номер водительского удостоверения
        "LisenseSeries": "string",    // серия водительского удостоверения
        "LisenseDate": "YYYY-MM-DD",  // дата выдачи водительского удостоверения
        "Surname": "string",          // фамилия
        "FirstName": "string",        // имя
        "MiddleName": "string",       // отчество
        "Telephone": "string",        // номер телефона
        "Inn": "string"               // ИНН
    }

Сведения о транспортном средстве:

.. code-block:: JSON

    {
        "RegistrationNumber": "string",   // регистрационный номер
        "OwnershipType": 0,               // тип владения
        "Type": "string",                 // тип транспортного средства
        "Mark": "string",                 // марка транспортного средства
        "LoadCapacity": 0,                // грузоподъемность, в тоннах
        "Capacity": 0                     // вместимость, в кубических метрах
    }

Параметры передаются в разрезе документов: если в пакете несколько ЭЗЗ, то для каждого документа должны быть заданы свои значения.

Если значение ``IsAccepted`` установлено в ``true``, то обязательны к заполнению все поля, кроме ``RejectReason``: если они не переданы для каждого ЭЗЗ, то генерация завершится с ошибкой.
Если значение ``IsAccepted`` установлено в ``false``, то обязательны к заполнению ``RejectReason`` и ``DocumentParticulars``.

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

Генерация вложений выполняется асинхронно.
В случае успешного выполнения запроса ставится задача на генерацию и возвращается ее идентификатор.