DeleteEmployeePowerOfAttorney (V2)
Отвязывает машиночитаемую доверенность (МЧД) от сотрудника.
POST /V2/DeleteEmployeePowerOfAttorney
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.userId— идентификатор сотрудника, от которого требуется отвязать МЧД. Если не указан, то МЧД будет отвязана от пользователя, от имени которого вызывается метод.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать данные МЧД, которую нужно отвязать от сотрудника, представленные структурой PowerOfAttorneyFullId.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у указанного ящика закончилась подписка на API.403— доступ к ящику с предоставленным авторизационным токеном запрещен или запрос выполнен не от имени администратора или пользователя, от которого необходимо отвязать МЧД.404— не найден ящик или пользователь с указанными идентификаторами, или не найден сотрудник в ящике для данного пользователя, или не найдена МЧД для сотрудника.405— используется неподходящий HTTP-метод.415— тип содержимого запроса не поддерживается.429— превышено ограничение на количество запросов в единицу времени.500— при обработке запроса возникла непредвиденная ошибка.
Отвязать МЧД от сотрудника может он сам или администратор ящика.
Метод работает по следующим правилам:
- Если указанная МЧД была привязана и отвязана от сотрудника раньше, то метод вернет код
200 (OK). - Если указанная МЧД никогда не была привязана к сотруднику, то метод вернет ошибку
404 (Not Found).
Примеры использования
Пример HTTP-запроса:
POST /V2/DeleteEmployeePowerOfAttorney?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
Пример тела запроса:
{
"RegistrationNumber": "{{regNumber}}",
"IssuerInn": "{{issuerInn}}",
"RepresentativeInn": "{{representativeInn}}"
}
См. также
Инструкции:
Методы для работы с МЧД:
- AddEmployeePowerOfAttorney (V2) — привязывает машиночитаемую доверенность к сотруднику
- DeleteEmployeePowerOfAttorney (V2) — отвязывает машиночитаемую доверенность от сотрудника
- GetEmployeePowersOfAttorney — возвращает список машиночитаемых доверенностей, привязанных к сотруднику
- GetPowerOfAttorneyContent (V2) — возвращает содержимое файлов машиночитаемой доверенности и родительских доверенностей
- GetPowerOfAttorneyInfo — возвращает информацию о машиночитаемой доверенности, отправленной с документом
- PrevalidatePowerOfAttorney (V2) — выполняет предварительную проверку машиночитаемой доверенности
- RegisterPowerOfAttorney — отправляет запрос на регистрацию машиночитаемой доверенности
- RegisterPowerOfAttorneyResult — возвращает результат регистрации машиночитаемой доверенности
- UpdateEmployeePowerOfAttorney (V2) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»