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

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

Примечание

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

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

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

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

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

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

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

  • при отправке контента титула документа или квитанции в теле запроса на отправку.

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

  • при загрузке истории статусов в данных подписи;

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

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

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

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

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

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

Внимание

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

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

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

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

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

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

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

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

Примечание

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

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

См. также:
История статусов документов
Обновление исходящих документов

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

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

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

  • была зарегистрирована с помощью Продукта;

  • была зарегистрирована другим способом, например, через веб-кабинет оператора узла распределенного реестра ФНС;

  • была получена от контрагента вместе с документом.