.. _Integration_IntegrationApi_PowerOfAttorney_RegisteringPowerOfAttorney_GeneratingPowerOfAttorney:

Генерация доверенности
######################

| Запрос: ``POST /powerofattorney/register/content``
| HTTP-заголовки:

.. code-block::

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

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

.. code-block:: JSON

    {
        "BoxId": "string",                      // идентификатор ящика юр. лица-доверителя
        "FormatType": "string",                 // формат файла доверенности
        "DocumentId": "guid",                   // идентификатор доверенности
        "InnerDocumentId": "string",            // внутренний идентификатор доверенности
        "DateFrom": "YYYY-MM-DD",               // дата начала действия доверенности
        "DateTo": "YYYY-MM-DD",                 // дата окончания действия доверенности
        "CanDelegate": false,                   // можно ли передоверить полномочия
        "RootPowerOfAttorney": {                // сведения первоначальной доверенности для передоверия
        },
        "ParentPowerOfAttorney":{               // сведения доверенности, на основании которой осуществляется передоверие 
        },
        "Principal": {                          // доверитель
        },
        "Trustees": [                           // уполномоченные представители
            {
                "LegalEntity": {                // юридическое лицо
                },
                "IndividualEntrepreneur": {     // индивидуальный предприниматель
                },
                "Individual": {                 // физическое лицо
                }
            }
        ],
        "TrusteePowers": [                      // полномочия представителей
            {
                "Code": "string",               // код полномочий из классификатора
                "Description": "string",        // текстовое описание полномочий
                "Content": "string"             // содержание полномочий
            }
        ]
    }

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

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

Довереность генерируется от имени российского юридического лица.
Ящик доверителя в сервисе оператора узла распределенного реестра ФНС задается в поле ``BoxId``.

| Формат файла доверенности задается в поле ``FormatType``.
| В данный момент поддерживается два формата: ``ФНС2`` и ``ФНС3``.

Идентификатор доверенности задается в поле ``DocumentId``.
Он генерируется вызывающей системой, так же как и для прочих типов документов.
Под этим идентификатором доверенность будет зарегистрирована в реестре ФНС.
Этот же идентификатор будет использован как идентификатор документооборота в Продукте, если доверенность будет отправлена на регистрацию.

В поле ``InnerDocumentId`` задается внутренний номер доверенности. Если значение не передано, 
то в качестве внутреннего номера доверенности будет использоваться значение из поля ``DocumentId``.

В поле ``DateFrom`` задается дата начала действия доверенности. 
В поле ``DateTo`` задается дата окончания действия доверенности.
Поле ``DateTo`` можно не указывать. В этом случае доверенность будет выдана на один год.

Поле ``CanDelegate`` определяет, можно ли передоверить полномочия.
Если передано значение ``true``, то передоверие возможно. Если передано значение ``false``, то передоверие невозможно.

Поля ``RootPowerOfAttorney`` и ``ParentPowerOfAttorney`` заполняются в случае генерации передоверия.

.. note::

    | Для генерации передоверия от первоначальной доверенности заполняется только поле ``RootPowerOfAttorney``.
    | Для генерации передоверия от другой передоверенной доверенности заполняются оба поля: ``RootPowerOfAttorney`` и ``ParentPowerOfAttorney``.
    | Передоверие поддерживается только для формата ``ФНС3``.

.. include:: ../_Include/RootPowerOfAttorney.rst

.. include:: ../_Include/ParentPowerOfAttorney.rst

.. include:: ../_Include/Principal.rst

Уполномоченные представители
============================

В поле ``Trustees`` передаются сведения об уполномоченных представителях.

Каждый элемент в ``Trustees`` содержит сведения либо о юридическом лице, либо об индивидуальном предпринимателе, либо о физическом лице.

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

Юридическое лицо
----------------

Ниже приведена структура данных для указания юридического лица в качестве уполномоченного представителя.
Она совпадает со структурой данных юридического лица-доверителя.

.. include:: ../_Include/LegalEntity.rst

Индивидуальный предприниматель
------------------------------

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

.. include:: ../_Include/IndividualEntrepreneur.rst

Физическое лицо
---------------

Ниже приведена структура данных для указания физического лица в качестве уполномоченного представителя.

.. include:: ../_Include/Individual.rst

Полномочия представителей
=========================

В поле ``TrusteePowers`` передаются полномочия представителей.

В каждом элементе ``TrusteePowers`` задается либо код полномочий из классификатора в поле ``Code``, либо текстовое описание полномочий в поле ``Description``.
``Description`` должно заполняться в случае, если в классификаторе не найдено подходящее значение для ``Code``.

Если задано поле ``Code``, то дополнительно требуется указать содержание полномочий в поле ``Content``.

Документ, удостоверяющий личность
=================================

Ниже приведена структура данных для указания документа, удостоверяющего личность.

.. include:: ../_Include/IdentityDocument.rst

.. note::

    Заполняется только для формата ``ФНС3``.

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

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

.. note::

    Генерация файла доверенности **не** запускает процедуру регистрации доверенности.