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

Аннулировать документ

POST 
/api/v1/clients/:clientId/documents/:documentId/annul

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

Метод создает новый документ

  • акт об аннулировании в статусе «Черновик», который связан с аннулируемым документом. Таким образом, запуская процесс аннулирования документа.

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

  • Тело запроса задано.
  • Причина аннулирования документа задана корректно.
  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. документа указан корректно.
  • Документ не является черновиком.
  • Документ не является аннулированным.
  • У пользователя клиента есть право на аннулирование документов.
  • У пользователя клиента есть общий доступ к документу.
  • Подписанты документа находятся в корректном состоянии для запуска процесса аннулирования.
  • Руководитель задан корректно.
  • Документ не создан на основании ЛНАЛНА Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов..
  • Документ не связан с актом об аннулировании.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. документа указан корректно и возвращает документ, если он существует.
  • Причина аннулирования документа не является пустой строкой и не состоит только из пробельных символов.
  • Максимально допустимая длина причины аннулирования документа не превышена.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Проверяет, что документ не является черновиком.
  • Проверяет, что документ не является аннулированным.
  • У пользователя есть право аннулирования документов на уровне ролей пользователя клиента.
  • Если документ не связан ни с каким юрлицом, то аннулировать документ может создатель документа, который при этом имеет право аннулирования документов на уровне сотрудника клиента.
  • Если документ связан с юрлицом, то аннулировать документ может сотрудник этого юрлица, который имеет право на аннулирование документов на уровне ролей сотрудника клиента.
  • Среди подписантов документа есть руководитель-подписант.
  • Среди подписантов документа есть сотрудник-подписант.
  • Документ подписан обоими подписантами.
  • Сотрудник подписант не уволен.
  • Руководитель из аннулируемого документа активен.
  • Для юрлица, к которому относится аннулируемый документ, существует хотя бы один активный руководитель.
  • Проверяет, что документ не создан на основании ЛНАЛНА Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов..
  • Для документа нет связи с актом об аннулировании.
  • Для документа отсутствует черновик акта об аннулировании.
  • Черновик акта об аннулировании находится в статусе удален.
  • Для документа нет актов об аннулировании, в которых в качестве сотрудника-подписанта выступает сотрудник-подписант документа.
  • Тип документа, выступающего в качестве акта об аннулировании, не является «Акт об аннулировании».
  • Акт об аннулировании находится в статусе «Удален».
  • Акт об аннулировании находится в статусе «Отклонен».
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.
  • Пользователь является наблюдателем документа.
  • Проверяет, что среди подписантов документа есть руководитель-подписант.
  • Проверяет, что среди подписантов документа есть сотрудник-подписант.
  • Проверяет, что документ подписан заданным подписантом.
  • Проверяет, что данный сотрудник работает.

Request​

Responses​

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