.. _Integration_IntegrationApi_DocumentActions_EtrnDriverChanging_GeneratingAttachments:

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

| Запрос: ``POST /document/waybill/transporter/driver-changing/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",
        "ChangingDateTime": "2022-11-25T13:38:24.371Z",
        "ChangeReason": "string",
        "Drivers": [
        ],
        "Vehicles": [
        ]
    }

Информация о водителях:

.. code-block:: JSON

    {
        "LicenseNumber": "string",
        "LicenseSeries": "string",
        "LicenseDate": "2022-11-25T13:38:24.371Z",
        "Surname": "string",
        "FirstName": "string",
        "MiddleName": "string"
        "Telephone": "string"
    }

Информация о транспортном средстве:

.. code-block:: JSON

    {
        "RegistrationNumber": "string",
        "OwnershipType": 0,
        "Type": "string",
        "Mark": "string",
        "LoadCapacity": 0,
        "Capacity": 0,
        "Trailers": [
        ]
    }

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

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

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