Перейти к основному содержимому

GetPowerOfAttorneyContent (V2)

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

GET /V2/GetPowerOfAttorneyContent

Параметры запроса

  • boxId — идентификатор ящика организации в формате GUID.
  • messageId — идентификатор сообщения.
  • entityId — идентификатор сущности МЧД в сообщении.

Заголовки запроса

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у указанного ящика закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен.
  • 404 — не найдены документ или сообщение с указанным идентификатором, или у указанной сущности нет содержимого, или не удалось получить XML-файл МЧД с электронной подписью от сервиса ФНС.
  • 405 — используется неподходящий HTTP-метод.
  • 429 — превышено ограничение на количество запросов в единицу времени.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит бинарное представление файлов МЧД и родительских доверенностей, представленное структурой 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

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

{
"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) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года