Перейти к основному содержимому

Создать оргструктуру

POST 
/api/v1/clients/:clientId/orgStructures

Описание метода​

Создаёт черновик управленческой оргструктуры — только метаданные, без элементов дерева. Возвращает полную карточку созданной записи: формат идентичен ответу GET карточки оргструктуры. Для новой записи: status = DRAFT, main = false, basedOnId = null, hasActiveDraft = false, currentEditor = null (режим редактирования свободен), version = 1, elements = [], все счётчики равны 0.

Валидации запроса​

  • Тело запроса задано.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID, клиент существует, не удалён, к нему относится пользователь, выполняющий операцию.

  • У пользователя клиента есть право ORG_STRUCTURES_CREATE.

  • name не пустое после trim, не длиннее 500 символов, не начинается с символа * (зарезервирован для копий-черновиков опубликованных оргструктур), не совпадает (без учёта регистра, после trim) с зарезервированным именем Юридической оргструктуры, уникально в клиенте среди оргструктур любого статуса (включая черновики и архив).

  • Если description задано — не длиннее 1000 символов.

  • Если purpose задано — не длиннее 500 символов.

  • Если externalId задан — уникален в клиенте.

  • accessType задан.

  • colourSchema задана и входит в список разрешённых цветовых схем (конфиг ekd.orgStructure.permittedColourSchemas).

  • Функционал оргструктур включён в настройках клиента (org_structures_enabled_date задан).

Request​

Responses​

Успешная операция.