CreateDepartment
к сведению
Вызов метода доступен только администраторам организации.
Создает подразделение организации.
POST /admin/CreateDepartment
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать данные для создания подразделения, представленные структурой DepartmentToCreate.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у организации с указанным идентификаторомboxIdзакончилась подписка на API.403— доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора.404— не найден ящик с указанным идентификатором, или указанное родительское подразделение отсутствует, удалено или принадлежит другому ящику.405— используется неподходящий HTTP-метод.409— подразделение с таким же КПП уже существует.415— тип содержимого запроса не поддерживается.429— превышено ограничение на количество запросов в единицу времени.500— при обработке запроса возникла непредвиденная ошибка.
Тело ответа
Тело ответа содержит доступные для администратора данные подразделения, представленные структурой Department.
Примеры использования
Пример HTTP-запроса:
POST /admin/CreateDepartment?boxid={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json
Пример тела запроса:
{
"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 — изменяет данные подразделения организации (доступно только администраторам ящика)