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

Удалить документы

DELETE 
/api/v1/clients/:clientId/documents

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

При удалении документ лишь помечается как удаленный, а не удаляется целиком из системы. Рекомендованное количество удаляемых документов в списке

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

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

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

Request​

Responses​

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