AddEmployeePowerOfAttorney (V2)

Привязывает машиночитаемую доверенность (МЧД) к сотруднику.

POST /V2/AddEmployeePowerOfAttorney

Query Parameters:

boxId – идентификатор ящика организации.
userId – идентификатор сотрудника, к которому требуется привязывать МЧД. Если не указан, то МЧД будет привязана к пользователю, от имени которого вызывается метод.

Request Headers:

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

Request Body:

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

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-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит данные МЧД сотрудника, представленные структурой EmployeePowerOfAttorney.

Привязать МЧД к сотруднику может только он сам или администратор ящика.

К сотруднику можно привязать не больше 100 действующих или не вступивших в силу МЧД. В сутки можно привязать не больше 50 МЧД.

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

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

POST /V2/AddEmployeePowerOfAttorney?boxId={{boxId}}&userId={{userId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: DiadocAuth ddauth_api_client_id={{client_id}}, ddauth_token={{auth_token}}
Accept: application/json; charset=utf-8
Content-Type: application/json

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

{
    "RegistrationNumber": "{{regNumber}}",
    "IssuerInn": "{{issuerInn}}",
    "RepresentativeInn": "{{representativeInn}}"
}

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

{
    "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 — привязывает машиночитаемую доверенность к сотруднику
AddEmployeePowerOfAttorney (V2) — привязывает машиночитаемую доверенность к сотруднику
DeleteEmployeePowerOfAttorney — отвязывает машиночитаемую доверенность от сотрудника
DeleteEmployeePowerOfAttorney (V2) — отвязывает машиночитаемую доверенность от сотрудника
GetEmployeePowersOfAttorney — возвращает список машиночитаемых доверенностей, привязанных к сотруднику
GetPowerOfAttorneyContent (V2) — возвращает содержимое файлов машиночитаемой доверенности и родительских доверенностей
GetPowerOfAttorneyInfo — возвращает информацию о машиночитаемой доверенности, отправленной с документом
PrevalidatePowerOfAttorney — выполняет предварительную проверку машиночитаемой доверенности
PrevalidatePowerOfAttorney (V2) — выполняет предварительную проверку машиночитаемой доверенности
RegisterPowerOfAttorney — отправляет запрос на регистрацию машиночитаемой доверенности
RegisterPowerOfAttorneyResult — возвращает результат регистрации машиночитаемой доверенности
UpdateEmployeePowerOfAttorney — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»
UpdateEmployeePowerOfAttorney (V2) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»

Предыдущии версии метода:

AddEmployeePowerOfAttorney