GetEmployeePowersOfAttorney

Возвращает список машиночитаемых доверенностей (МЧД), привязанных к сотруднику: как действующих, так и истекших.

GET /GetEmployeePowersOfAttorney

Query Parameters:

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

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

• onlyActual – признак того, что нужно возвращать только действующие МЧД. По умолчанию имеет значение false.

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:

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

message EmployeePowerOfAttorneyList {
    repeated EmployeePowerOfAttorney PowersOfAttorney = 1;
}

• PowersOfAttorney — список МЧД, привязанных к сотруднику, представленных структурой EmployeePowerOfAttorney.

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

Если у сотрудника нет привязанных МЧД, то метод вернет код 200 (OK) и пустой список PowersOfAttorney.

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

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

GET /GetEmployee?boxid={{boxId}}&userid={{userid}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

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

{
    "PowersOfAttorney": [
        {
            "PowerOfAttorney": {
                "FullId": {
                    "RegistrationNumber": "c8a8949a-4907-4c36-9f48-7efb2fba1382",
                    "IssuerInn": "8633661933",
                    "RepresentativeInn": "329553466601"
                },
                "Issuer": {
                    "Type": "LegalEntity",
                    "LegalEntity": {
                        "Inn": "8633661933",
                        "Kpp": "381201001",
                        "OrganizationName": "ООО \"Пример\""
                    }
                },
                "Confidant": {
                    "PersonName": {
                        "LastName": "Антонов",
                        "FirstName": "Антон",
                        "MiddleName": "Антонович"
                    },
                    "Inn": "329553466601"
                },
                "StartAt": {
                    "Ticks": 638553780000000000
                },
                "ExpireAt": {
                    "Ticks": 641709971990000000
                },
                "System": "https://m4d.nalog.gov.ru/EMCHD/check-status?guid=c8a8949a-4907-4c36-9f48-7efb2fba1382",
                "IdFile": "ON_EMCHD_20240710_c8a8949a-4907-4c36-9f48-7efb2fba1382",
                "DelegationChain": [],
                "PermissionsInfo": {
                    "Permissions": [
                        {
                            "Type": "text",
                            "TextPermission": "Полномочия",
                            "MachineReadablePermission": []
                        }
                    ],
                    "TransferPermissionLoss": "",
                    "JointPermissions": "personal"
                },
                "Representatives": [
                    {
                        "Type": "RepresentativePhysicalEntity",
                        "PhysicalEntity": {
                            "Inn": "329553466601",
                            "PersonName": {
                                "LastName": "Антонов",
                                "FirstName": "Антон",
                                "MiddleName": "Антонович"
                            }
                        }
                    }
                ]
            },
            "IsDefault": true
        }
    ]
}

---

См. также

Инструкции:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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