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

Создать отдел

POST 
/api/v1/clients/:clientId/departments

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

Создаёт новый отдел клиента.

Поле externalId опциональное — заполните его, чтобы в других методах API обращаться к отделу по IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, а не по HRlink-IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях.. Внешний IDexternalIdВнешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. хранится как строка, ограничений на длину нет.

IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. родительского отдела нужно передать через parentDepartmentId или parentDepartmentExternalId. Если переданы оба, приоритет у parentDepartmentId.

IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица (legalEntityId/legalEntityExternalId) и руководителя (headManagerId/headManagerExternalId) необязательны. Если переданы оба варианта IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. одного поля, приоритет у legalEntityId/headManagerId.

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

  • Тело запроса задано.
  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • Пользователь клиента имеет право DEPARTMENTS_CREATE.
  • Название отдела задано.
  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. родительского отдела задан корректно; родительский отдел существует и принадлежит клиенту.
  • Пользователь имеет доступ к заданному родительскому отделу.
  • Если задан externalId — такой IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. в клиенте ещё не занят.
  • Если задано юрлицо — оно существует и принадлежит клиенту.
  • Если задан руководитель — сотрудник существует и не уволен.
  • Склонения названия отдела заданы корректно (без null-элементов, без дубликатов по типу падежа).

Request​

Responses​

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