.. _Integration_IntegrationApi_PowerOfAttorney_PowerOfAttorneyConcept:

Как работать с доверенностями
#############################

В этом разделе описаны принципы работы с машиночитаемыми доверенностями (МЧД) при использовании Integration API.

.. note::

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

Когда используются доверенности
*******************************

Доверенности нужны для подписания документа или квитанции УКЭП уполномоченного представителя, например, УКЭП физического лица.

Продукт работает с B2B-доверенностями, зарегистрированными в распределенном реестре ФНС.

.. _Integration_IntegrationApi_PowerOfAttorney_PowerOfAttorneyConcept_SendingAndReceiving:

Передача и получение сведений о доверенности
********************************************

Сведения о доверенности могут быть переданы:

* при генерации контента титула документа или квитанции в теле запроса на генерацию;
* при отправке контента титула документа или квитанции в теле запроса на отправку.

Сведения о доверенности могут быть получены:

* при загрузке истории статусов в данных подписи;
* при получении расширенной информации о документе в данных подписи.

Сведения о доверенности передаются и получаются в виде структуры ``PowerOfAttorney``:

.. code-block:: JSON

    {
        // ...
        "PowerOfAttorney": {            // данные доверенности (МЧД)
            "Id": "guid",               // идентификатор доверенности в реестре ФНС
            "IssuerInn": "string",      // ИНН доверителя
            "LinkId": "string",         // ссылка на файл доверенности в архиве
            "SignatureLinkId": "string" // ссылка на файл подписи под доверенностью в архиве
        }
    }

| В поле ``Id`` указывается идентификатор доверенности в распределенном реестре ФНС.
| В поле ``IssuerInn`` указывается ИНН доверителя.
| В поле ``LinkId`` указывается ссылка на файл доверенности в архиве.
| В поле ``SignatureLinkId`` указывается ссылка на файл подписи под доверенностью в архиве.


Передача сведений о доверенности
================================

При передаче сведений о доверенности нужно указывать либо идентификационную информацию (поля ``Id`` и ``IssuerInn``), 
либо ссылки на файлы (поля ``LinkId`` и ``SignatureLinkId``).

Для передачи ссылок на файлы они должны быть предварительно сохранены в архиве.

.. attention::

    Передавать идентификационную информацию **и** ссылки на файлы нельзя.
    Такой запрос приведет к ошибке.

Получение сведений о доверенности
=================================

Если контрагент передал файлы доверенности и подписи под ней, то при получении сведений о доверенности будут заполнены поля ``LinkId`` и ``SignatureLinkId``.
По ссылкам, заданным в ``LinkId`` и ``SignatureLinkId``, можно загрузить содержимое файлов из архива.

Опционально, если XML-файл доверенности получилось разобрать, будут заполнены поля ``Id`` и ``IssuerInn``. 

Если отправитель передал идентификационную информацию доверенности, то при получении сведений о доверенности будут заполнены поля ``Id`` и ``IssuerInn``.
Поля ``LinkId`` и ``SignatureLinkId`` будут пустыми.


Документооборот доверенностей
*****************************

Кроме передачи сведений о доверенности, Продукт позволяет регистрировать и отзывать доверенности.
Для этого интеграционный модуль Продукта взаимодействует с операторами узлов распределенного реестра ФНС.

С этой точки зрения доверенность - это еще один тип документов, который поддерживается Продуктом.

.. note::

    Доверенность - это всегда исходящий документ.

Регистрация и отзыв доверенности приводят к созданию документа с типом ``50`` (``Доверенность``).
Для документа создаются события и вложения, которые публикуются в истории статусов так же, как и для остальных типов документов.

| См. также:
| :ref:`Integration_IntegrationApi_StatusesHistory`
| :ref:`Integration_IntegrationApi_CreatingAndUpdatingDocuments_UpdatingOutputDocuments`

Валидация доверенностей
***********************

Продукт позволяет выполнить валидацию доверенности в распределенном реестре ФНС.

Это может быть доверенность, которая: 

* была зарегистрирована с помощью Продукта;
* была зарегистрирована другим способом, например, через веб-кабинет оператора узла распределенного реестра ФНС;
* была получена от контрагента вместе с документом.