.. _Integration_IntegrationApi_DocumentActions_EtrnSenderFinancialCondition_GeneratingAttachments:

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

| Запрос: ``POST /document/waybill/sender/financial-condition/cargo/content``
| HTTP-заголовки:

.. code-block::

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

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

.. code-block:: JSON

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

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

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

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

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

.. code-block:: JSON

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

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

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

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

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

Параметры генерации титула подтверждения изменения ФС
=====================================================

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

.. code-block:: JSON

    {
        "DocumentId": "guid",                   // идентификатор документа
        "FinancialSubject": "string",           // наименование экономического субъекта
        "IsFinancialSubjectCargoSender": true,  // признак того, что экономический субъект - грузоотправитель
        "DocumentParticulars": [                // сведения о реквизитах сторон титула грузоотправителя
        ]
    }

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

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

.. code-block:: JSON

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

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

.. code-block:: JSON

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

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

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

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