GetPowerOfAttorneyContent

Метод GetPowerOfAttorneyContent возвращает содержимое файлов машиночитаемой доверенности (МЧД) и родительских МЧД.

Версии метода:

  • v2 — возвращает файлы передоверенной МЧД и родительских МЧД.

  • v1 — метод устарел.

v2

GET /V2/GetPowerOfAttorneyContent
Query Parameters:

  • boxId – идентификатор ящика организации.

  • messageid – идентификатор сообщения.

  • entityid – идентификатор МЧД.

Request Headers:
Status Codes:

  • 200 OK – операция успешно завершена.

  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

  • 402 Payment Required – у организации с указанным идентификатором boxId закончилась подписка на API.

  • 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

  • 404 Not Found – в указанном ящике нет сообщения с идентификатором messageId или в указанном сообщении нет сущности с идентификатором entityId, или у указанной сущности нет содержимого, или не удалось получить XML-файл МЧД с электронной подписью от сервиса ФНС.

  • 405 Method Not Allowed – используется неподходящий HTTP-метод.

  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит структуру PowerOfAttorneyContentResponse:

message PowerOfAttorneyContentResponse {
    required PowerOfAttorneyContentV2 Content = 1;
    repeated PowerOfAttorneyContentV2 DelegationChain = 2;
}

message PowerOfAttorneyContentV2 {
    required bytes Content = 1;
    required bytes Signature = 2;
    required PowerOfAttorneyFullId FullId = 3;
}

  • Content — содержимое файла МЧД. Представлено структурой PowerOfAttorneyContentV2 с полями:

    • Content — содержимое файла МЧД

    • Signature — подпись под МЧД.

    • PowerOfAttorneyFullId — идентификатор МЧД. Представлен структурой PowerOfAttorneyFullId.

  • DelegationChain — список предыдущих МЧД для доверенности, выпущенной в порядке передоверия. Каждая МЧД представлена структурой PowerOfAttorneyContentV2. Список хранится в порядке от корневой МЧД (элемент с индексом 0) к дочерней, сама конечная МЧД в список не включена. Заполняется только в случаях:

    • если при отправке документов в поле Contents структуры PowerOfAttorneyToPost была указана цепочка файлов МЧД;

    • если по идентификатору FullId удалось получить цепочку доверенностей из сервиса ФНС.

v1

GET /GetPowerOfAttorneyContent
Query Parameters:

  • boxId – идентификатор ящика организации.

  • messageid – идентификатор сообщения.

  • entityid – идентификатор МЧД.

Request Headers:
Status Codes:

  • 200 OK – операция успешно завершена.

  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

  • 402 Payment Required – у организации с указанным идентификатором boxId закончилась подписка на API.

  • 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

  • 404 Not Found – в указанном ящике нет сообщения с идентификатором messageId или в указанном сообщении нет сущности с идентификатором entityId, или у указанной сущности нет содержимого, или не удалось получить XML-файл МЧД с электронной подписью от сервиса ФНС.

  • 405 Method Not Allowed – используется неподходящий HTTP-метод.

  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит структуру PowerOfAttorneyContent:

message PowerOfAttorneyContent {
    required bytes Content = 1;
    required bytes Signature = 2;
}

  • Content — содержимое файла МЧД.

  • Signature — подпись под МЧД.

См. также

Руководства:
Другие методы для работы с МЧД: