CreateDepartment

Примечание

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

Создает подразделение организации.

POST /admin/CreateDepartment

Query Parameters:

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

Request Headers:

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

Request Body:

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

Status Codes:

200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
402 Payment Required – у организации с указанным идентификатором boxId закончилась подписка на API.
403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора.
404 Not Found – не найден ящик с указанным идентификатором.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

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

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

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

POST /admin/CreateDepartment?boxid={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

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

{
    "Name": "Бухгалтерия",
    "Abbreviation": "Б",
    "Kpp": "456701001",
    "Routing": {
        "kpp": "true"
    }
}

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

{
    "Id": "79b8d436-b650-43f6-b1bb-f1f9eac05c92",
    "ParentDepartmentId": "00000000-0000-0000-0000-000000000000",
    "Name": "Бухгалтерия",
    "Abbreviation": "Б",
    "Kpp": "456701001",
    "Routing": {
        "Kpp": true,
        "Address": false
    },
    "CreationTimestamp": {
        "Ticks": 638833410546481606
    }
}

См. также

Инструкции:

Работа с подразделениями

Методы для работы с подразделениями:

CreateDepartment — создает подразделение организации (доступно только администраторам ящика)
DeleteDepartment — удаляет подразделение организации (доступно только администраторам ящика)
GetDepartment (V2) — возвращает данные подразделения организации по указанному идентификатору
GetDepartments — возвращает список подразделений организации (доступно только администраторам ящика)
UpdateDepartment — изменяет данные подразделения организации (доступно только администраторам ящика)