UpdateEmployee

Примечание

Вызов метода доступен только администраторам организации.

Метод UpdateEmployee изменяет данные сотрудника организации.

POST /UpdateEmployee

Query Parameters:

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

• userId – идентификатор пользователя.

Request Headers:

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

Request Body:

Тело запроса должно содержать структуру EmployeeToUpdate.

Status Codes:

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

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

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

• 402 Payment Required – у организации с указанным идентификатором boxId закончилась подписка на API.

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

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

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

Response Body:

Тело ответа содержит измененные данные сотрудника, представленные структурой Employee.

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

Пример 1

Изменение уровня доступа к документам, списка доступных подразделений и должности

Пример запроса

POST /UpdateEmployee?boxId=994cf191-8322-40eb-8d79-f1196f8ec357&userId=fccbb0a6-0700-4401-81a6-8a6a083e12e6 HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: DiadocAuth ddauth_api_client_id=key, ddauth_token=token
Content-Type: application/json; charset=utf-8

{
    "Permissions": {
        "DocumentAccessLevel": {
            "DocumentAccessLevel": "SelectedDepartments"
        },
        "SelectedDepartments": {
            "SelectedDepartmentIds": [
                "7e49e042-8a0f-478d-a4e0-5e9273c47b20",
                "2f2f67bc-b5fe-4662-9e4f-b09348b44582"
            ]
        },
    },
    "Position": {
        "Position": "Бухгалтер"
    }
}

С использованием C# SDK

var employee = api.UpdateEmployee(
    token,
    boxId,
    userId,
    new EmployeeToUpdate
    {
        Permissions = new EmployeePermissionsPatch
        {
            DocumentAccessLevel = new EmployeeDocumentAccessLevelPatch
            {
                DocumentAccessLevel = DocumentAccessLevel.SelectedDepartments
            },
            SelectedDepartments = new EmployeeSelectedDepartmentsPatch
            {
                SelectedDepartmentIds =
                {
                    "7e49e042-8a0f-478d-a4e0-5e9273c47b20",
                    "2f2f67bc-b5fe-4662-9e4f-b09348b44582"
                }
            }
        },
        Position = new EmployeePositionPatch
        {
            Position = "Бухгалтер"
        }
    });

Пример 2

Изменение подразделения, права администрировать организацию, доступных действий и необходимости показывать в списке получателей Сообщений

Пример запроса

POST /UpdateEmployee?boxId=994cf191-8322-40eb-8d79-f1196f8ec357&userId=fccbb0a6-0700-4401-81a6-8a6a083e12e6 HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: DiadocAuth ddauth_api_client_id=key, ddauth_token=token
Content-Type: application/json; charset=utf-8

{
    "Permissions": {
        "Department": {
            "DepartmentId": "11c8276b-815f-4191-adea-c0f884429624"
        },
        "IsAdministrator": {
            "IsAdministrator": true
        },
        "Actions": [
            { "Name": "ManageCounteragents", "IsAllowed": true },
            { "Name": "SignDocuments", "IsAllowed": false }
        ]
    },
    "CanBeInvitedForChat": {
        "CanBeInvitedForChat": true
    }
}

С использованием C# SDK

var employee = api.UpdateEmployee(
    token,
    boxId,
    userId,
    new EmployeeToUpdate
    {
        Permissions = new EmployeePermissionsPatch
        {
            Department = new EmployeeDepartmentPatch
            {
                DepartmentId = "11c8276b-815f-4191-adea-c0f884429624"
            },
            IsAdministrator = new EmployeeIsAdministratorPatch
            {
                IsAdministrator = true
            },
            Actions =
            {
                new EmployeeAction
                {
                    Name = "ManageCounteragents",
                    IsAllowed = true
                },
                new EmployeeAction
                {
                    Name = "SignDocuments",
                    IsAllowed = false
                }
            }
        },
        CanBeInvitedForChat = new EmployeeCanBeInvitedForChatPatch
        {
            CanBeInvitedForChat = true
        }
    });