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