RegisterPowerOfAttorney

Отправляет запрос на регистрацию машиночитаемой доверенности (МЧД).

POST /RegisterPowerOfAttorney

Query Parameters:

• boxId – идентификатор ящика организации в формате GUID.

Request Headers:

• Authorization – данные, необходимые для авторизации.

Request Body:

Тело запроса должно содержать данные для регистрации МЧД, представленные структурой PowerOfAttorneyToRegister.

Status Codes:

• 200 OK – операция успешно завершена.

• 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

• 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

• 402 Payment Required – у указанного ящика закончилась подписка на API.

• 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

• 404 Not Found – не найден ящик с указанным идентификатором.

• 405 Method Not Allowed – используется неподходящий HTTP-метод.

• 409 Conflict – не удалось выполнить запрос на регистрацию.

• 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит идентификатор операции taskId в структуре AsyncMethodResult. По этому идентификатору с помощью метода RegisterPowerOfAttorneyResult можно узнать результат обработки запроса.

Примеры использования

Пример HTTP-запроса:

POST /RegisterPowerOfAttorney?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8
Content-Type: application/json

Пример тела запроса:

{
    "FullId": {
        "RegistrationNumber": "{{poaRegNumber}}",
        "IssuerInn": "{{poaIssuerInn}}",
        "RepresentativeInn": "{{poaRepresentativeInn}}"
    },
    "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0...NC50Ls+",        // содержимое XML-файла в кодировке base-64
}

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

{
    "TaskId": "import:019cd268-4ccd-7225-afe8-e52f70febe30"
}

---

См. также

Инструкции:

• Работа с машиночитаемой доверенностью

Методы для работы с МЧД:

• AddEmployeePowerOfAttorney (V2) — привязывает машиночитаемую доверенность к сотруднику

• DeleteEmployeePowerOfAttorney (V2) — отвязывает машиночитаемую доверенность от сотрудника

• GetEmployeePowersOfAttorney — возвращает список машиночитаемых доверенностей, привязанных к сотруднику

• GetPowerOfAttorneyContent (V2) — возвращает содержимое файлов машиночитаемой доверенности и родительских доверенностей

• GetPowerOfAttorneyInfo — возвращает информацию о машиночитаемой доверенности, отправленной с документом

• PrevalidatePowerOfAttorney (V2) — выполняет предварительную проверку машиночитаемой доверенности

• RegisterPowerOfAttorney — отправляет запрос на регистрацию машиночитаемой доверенности

• RegisterPowerOfAttorneyResult — возвращает результат регистрации машиночитаемой доверенности

• UpdateEmployeePowerOfAttorney (V2) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»