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

Создать ЛНА

POST 
/api/v1/clients/:clientId/normativeActs

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

Создаёт нормативный акт (ЛНАЛНА Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов.) в указанном клиенте. За один вызов создаётся ровно один акт, привязанный к одному юрлицу. Сервер валидирует тело запроса, проверяет права пользователя, привязки к отделам и должностям, шаблон маршрута подписания и руководителя-подписанта. Файл акта должен быть заранее загружен; после создания сервер конвертирует его в PDF/A в пределах лимита тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов..

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

Клиент и пользователь

  • Тело запроса задано.
  • clientId в пути соответствует формату UUID, клиент с таким IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует и не удалён.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • У пользователя клиента есть право NORMATIVE_ACTS_CREATE на уровне клиента или на уровне сотрудника клиента в указанном юрлице (с учётом активных замещенийSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА. в режиме кадровика).

Основные поля акта

  • Название акта задано.
  • Дата вступления в силу задана.
  • Если задана дата окончания действия, она позже даты вступления в силу.
  • Если задан externalIdexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID., он уникален в пределах клиента.

Файл акта

  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. файла задан, файл с таким IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует.
  • Файл не находится в «чёрном» списке (конвертация в PDF/A не прерывалась).
  • Файл имеет допустимое расширение.
  • Лимит на конвертацию файлов в PDF/A для тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен (если включены облачные операции).

Тип документа

  • Задан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. типа документа в системе HR-Link или IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. типа документа во внешней системе.
  • Тип документа с указанным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует.
  • Пользователь клиента имеет доступ к указанному типу документов.

Юрлица

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

Отделы

  • Если задан один из списков IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов (приоритет у IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. в системе HR-Link), он не содержит null-элементов, все отделы существуют и относятся к клиенту, пользователь имеет доступ ко всем отделам списка.
  • Если оба списка не заданы, пользователь имеет доступ к корневому отделу.

Должности сотрудников

  • Если задан список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должностей в системе HR-Link или externalIdexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. должностей, все должности существуют и относятся к клиенту.

Триггерные типы документов

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

Шаблон маршрута подписания

  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. шаблона маршрута задан.
  • Шаблон с указанным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует, относится к указанному клиенту и не деактивирован.
  • Шаблон применим для типа подписываемого объекта DOCUMENT.
  • Шаблон относится к типу MANAGER_ONLY.
  • Среди участников маршрута есть участник типа EMPLOYER со способом подписания QES (КЭП).
  • Среди участников маршрута нет участников типа EMPLOYEE.

Руководитель-подписант

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

Request​

Responses​

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