GetEmployeePowersOfAttorney
Возвращает список машиночитаемых доверенностей (МЧД), привязанных к сотруднику: как действующих, так и истекших.
GET /GetEmployeePowersOfAttorney
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.userId— идентификатор сотрудника. Если не указан, то метод вернет МЧД пользователя, от имени которого вызывается метод.onlyActual— признак того, что нужно возвращать только действующие МЧД. По умолчанию имеет значениеfalse.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у указанного ящика закончилась подписка на API.403— доступ к ящику с предоставленным авторизационным токеном запрещен или запрос выполнен не от имени администратора или пользователя, для которого необходимо получить МЧД.404— не найден ящик или пользователь с указанными идентификаторами или не найден сотрудник в ящике для данного пользователя.405— используется неподходящий HTTP-метод.429— превышено ограничение на количество запросов в единицу времени.500— при обработке запроса возникла непредвиденная ошибка.
Тело ответа
Тело ответа содержит список МЧД, представленный структурой EmployeePowerOfAttorneyList:
message EmployeePowerOfAttorneyList {
repeated EmployeePowerOfAttorney PowersOfAttorney = 1;
}
PowersOfAttorney— список МЧД, привязанных к сотруднику, представленных структурой EmployeePowerOfAttorney.
Получить МЧД сотрудника может он сам или администратор ящика.
Если у сотрудника нет привязанных МЧД, то метод вернет код 200 (OK) и пустой список PowersOfAttorney.
Примеры использования
Пример HTTP-запроса:
GET /GetEmployeePowersOfAttorney?boxid={{boxId}}&userid={{userid}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json
Пример тела ответа:
{
"PowersOfAttorney": [
{
"PowerOfAttorney": {
"FullId": {
"RegistrationNumber": "c8a8949a-4907-4c36-9f48-7efb2fba1382",
"IssuerInn": "8633661933",
"RepresentativeInn": "329553466601"
},
"Issuer": {
"Type": "LegalEntity",
"LegalEntity": {
"Inn": "8633661933",
"Kpp": "381201001",
"OrganizationName": "ООО \"Пример\""
}
},
"Confidant": {
"PersonName": {
"LastName": "Антонов",
"FirstName": "Антон",
"MiddleName": "Антонович"
},
"Inn": "329553466601"
},
"StartAt": {
"Ticks": 638553780000000000
},
"ExpireAt": {
"Ticks": 641709971990000000
},
"System": "https://m4d.nalog.gov.ru/EMCHD/check-status?guid=c8a8949a-4907-4c36-9f48-7efb2fba1382",
"IdFile": "ON_EMCHD_20240710_c8a8949a-4907-4c36-9f48-7efb2fba1382",
"DelegationChain": [],
"PermissionsInfo": {
"Permissions": [
{
"Type": "text",
"TextPermission": "Полномочия",
"MachineReadablePermission": []
}
],
"TransferPermissionLoss": "",
"JointPermissions": "personal"
},
"Representatives": [
{
"Type": "RepresentativePhysicalEntity",
"PhysicalEntity": {
"Inn": "329553466601",
"PersonName": {
"LastName": "Антонов",
"FirstName": "Антон",
"MiddleName": "Антонович"
}
}
}
]
},
"IsDefault": true
}
]
}
См. также
Инструкции:
Методы для работы с МЧД:
- AddEmployeePowerOfAttorney (V2) — привязывает машиночитаемую доверенность к сотруднику
- DeleteEmployeePowerOfAttorney (V2) — отвязывает машиночитаемую доверенность от сотрудника
- GetEmployeePowersOfAttorney — возвращает список машиночитаемых доверенностей, привязанных к сотруднику
- GetPowerOfAttorneyContent (V2) — возвращает содержимое файлов машиночитаемой доверенности и родительских доверенностей
- GetPowerOfAttorneyInfo — возвращает информацию о машиночитаемой доверенности, отправленной с документом
- PrevalidatePowerOfAttorney (V2) — выполняет предварительную проверку машиночитаемой доверенности
- RegisterPowerOfAttorney — отправляет запрос на регистрацию машиночитаемой доверенности
- RegisterPowerOfAttorneyResult — возвращает результат регистрации машиночитаемой доверенности
- UpdateEmployeePowerOfAttorney (V2) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»