AddEmployeePowerOfAttorney

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

POST /AddEmployeePowerOfAttorney

Query Parameters:

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

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

• registrationNumber – регистрационный номер МЧД.

• issuerInn – ИНН доверителя.

Request Headers:

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

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 /AddEmployeePowerOfAttorney?boxId={{boxId}}&userId={{userId}}&registrationNumber={{regNumber}}&issuerInn={{issuerInn}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

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

{
    "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) — изменяет параметр машиночитаемой доверенности «Использовать по умолчанию»