UpdateEmployeePowerOfAttorney (V2)

Изменяет параметр машиночитаемой доверенности (МЧД) «Использовать по умолчанию».

С помощью этого метода можно установить для сотрудника МЧД по умолчанию или снять с МЧД признак по умолчанию.

POST /V2/UpdateEmployeePowerOfAttorney

Query Parameters:

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

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

Request Headers:

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

Request Body:

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

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.

Метод устанавливает указанный в структуре EmployeePowerOfAttorneyToUpdateV2 признак IsDefault для МЧД.

Метод работает по следующим правилам:

• Если указан признак IsDefault = true, то указанная МЧД станет доверенностью по умолчанию. Если при этом у сотрудника уже настроена другая МЧД по умолчанию, то старые настройки будут сброшены. Если указанная МЧД уже является доверенностью по умолчанию, то метод завершится успешно и вернет информацию об этой МЧД.

• Если указан признак IsDefault = false, то выбранная МЧД перестанет быть доверенностью по умолчанию. Если указанная МЧД не является доверенностью по умолчанию, то метод завершится успешно и вернет информацию об этой доверенности.

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

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

POST /V2/UpdateEmployeePowerOfAttorney?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

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

{
    "PowerOfAttorneyFullId": {
        "RegistrationNumber": "{{regNumber}}",
        "IssuerInn": "{{issuerInn}}",
        "RepresentativeInn": "{{representativeInn}}"
    },
    "IsDefaultPatch": {
        "IsDefault": "true"
    }
}

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

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

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

• UpdateEmployeePowerOfAttorney