GetPowerOfAttorneyContent (V2)
Возвращает содержимое файлов машиночитаемой доверенности (МЧД) и родительских доверенностей.
GET /V2/GetPowerOfAttorneyContent
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.messageId— идентификатор сообщения.entityId— идентификатор сущности МЧД в сообщении.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Коды ответа
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) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»