GetPowerOfAttorneyContent (V2)

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

GET /V2/GetPowerOfAttorneyContent

Query Parameters:

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

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

• entityId – идентификатор сущности МЧД в сообщении.

Request Headers:

• Authorization – данные, необходимые для авторизации.

Status Codes:

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

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

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

• 402 Payment Required – у указанного ящика закончилась подписка на API.

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

• 404 Not Found – не найдены документ или сообщение с указанным идентификатором, или у указанной сущности нет содержимого, или не удалось получить 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 — подпись под МЧД.

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

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

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

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

Примеры использования

Пример HTTP-запроса:

GET /V2/GetPowerOfAttorneyContent?myBoxId={{boxId}}&messageId={{messageId}}&entityId={{entityId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

Пример тела ответа:

{
    "Content": {
        "Content": "77u/PD94bWwgdmVyc2lvbj0...0YHRgtGMPg==",        // содержимое XML-файла в кодировке base-64
        "Signature": "MIIMzAYJKoZIhvcNAQcCoII...1xcOAtlXUA=="         // содержимое файла подписи в кодировке base-64
        "FullId": {
            "RegistrationNumber": "c8a8949a-4907-4c36-9f48-7efb2fba1382",
            "IssuerInn": "0127560437",
            "RepresentativeInn": "144602155208"
        }
    },
    "DelegationChain": []
}

---

См. также

Инструкции:

• Работа с машиночитаемой доверенностью

Методы для работы с МЧД:

• AddEmployeePowerOfAttorney (V2) — привязывает машиночитаемую доверенность к сотруднику

• DeleteEmployeePowerOfAttorney (V2) — отвязывает машиночитаемую доверенность от сотрудника

• GetEmployeePowersOfAttorney — возвращает список машиночитаемых доверенностей, привязанных к сотруднику

• GetPowerOfAttorneyContent (V2) — возвращает содержимое файлов машиночитаемой доверенности и родительских доверенностей

• GetPowerOfAttorneyInfo — возвращает информацию о машиночитаемой доверенности, отправленной с документом

• PrevalidatePowerOfAttorney (V2) — выполняет предварительную проверку машиночитаемой доверенности

• RegisterPowerOfAttorney — отправляет запрос на регистрацию машиночитаемой доверенности

• RegisterPowerOfAttorneyResult — возвращает результат регистрации машиночитаемой доверенности

• UpdateEmployeePowerOfAttorney (V2) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»

Устаревшие версии метода:

• GetPowerOfAttorneyContent