Реестр ЛНА
POST/api/v1/clients/:clientId/normativeActs/getRegistry
Описание метода
Возвращает реестр нормативных актов.
Валидации запроса
- Тело запроса задано.
- Данные для постраничного получения корректны.
- Количество возвращаемых при запросе элементов задано корректно.
- Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
- У пользователя клиента должно быть право
NORMATIVE_ACTSна уровне клиента или правоNORMATIVE_ACTSна уровне сотрудника клиента. - Заданные списки IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. корректны.
- Период начала действия нормативного акта задан корректно.
- Период окончания действия нормативного акта задан корректно.
- Период создания нормативного акта задан корректно.
- Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов задан, то он корректен.
- Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлиц задан, то он корректен.
- Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов задан, то он корректен.
- Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должностей сотрудников задан, то он корректен.
- Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. создателей нормативных актов задан, то он корректен.
- Проверяет, что количество элементов, которое нужно пропустить при выборке с пагинацией, корректно.
- Проверяет, что заданное количество возвращаемых при запросе элементов корректно.
- IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
- По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
- Пользователь, выполняющий операцию, относится к клиенту.
- Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
- Проверяет, что период начала действия нормативного акта задан корректно.
- Проверяет, что период окончания действия нормативного акта задан корректно.
- Проверяет, что период создания нормативного акта задан корректно.
- Список не содержит null элементов.
- Все указанные нормативные акты существуют.
- Все указанные нормативные акты относятся к заданному клиенту.
- У пользователя клиента есть доступ хотя бы к одному из отделов каждого нормативного акта.
- У пользователя клиента есть доступ к юрлицу каждого нормативного акта.
- У пользователя клиента есть доступ к типу документа каждого нормативного акта.
- Все указанные юрлица существуют.
- Все указанные юрлица относятся к заданному клиенту.
- У пользователя клиента есть доступ ко всем указанным юрлицам.
- Все указанные отделы существуют.
- Все указанные отделы относятся к заданному клиенту.
- Пользователь клиента должен иметь доступ ко всем заданным отделам.
- Все указанные должности сотрудников существуют.
- Все указанные должности сотрудников относятся к заданному клиенту.
- По всем заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. создателей нормативных актов существуют пользователи клиентов.
- Все найденные пользователи клиента относятся к заданному клиенту.
- Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
- Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
- Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
- Проверяет, что клиент не удален.
- Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта не является пустым.
- Проверяет, что список нормативных актов задан.
- Проверяет, что каждый нормативный акт из указанной коллекции относится к заданному клиенту.
- Проверяет, что пользователь клиента имеет доступ хотя бы к одному отделу клиента, на которые распространяется заданный нормативный акт.
- В метод должен быть передан список разрешённых отделов, который включает в себя все дочерние и родительские отделы разрешённых отделов.
- Это нужно из-за бизнес-правила: нормативный акт, который распространяется на выбранный отдел, должен быть доступен и сотруднику, который имеет доступ только к дочерним отделам выбранного отдела.
- Проверяет, что пользователь клиента имеет доступ ко всем юрлицам в заданном списке.
- Проверяет, что пользователь клиента имеет доступ ко всем заданным типам документов.
- Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица не является пустым.
- Проверяет существование всех юрлиц клиента по заданному списку IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
- Проверяет, что заданное юрлицо относится к заданному клиенту.
- Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отдела клиента не является пустым.
- Проверяет, что все UUID, заданные в списке, соответствуют существующим отделам клиента и возвращает список отделов клиента.
- Проверяет, что заданный отдел клиента относится к заданному клиенту.
- Проверяет, что каждый из отделов с указанными IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. разрешён пользователю клиента с учётом контекста текущей операции или имеет отдела-потомка, разрешённого пользователю клиента.
- Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должности сотрудника не является пустым.
- Проверяет, что все UUID, заданные в списке, соответствуют существующим должностям сотрудников и возвращает список должностей сотрудников.
- Проверяет, что заданная должность сотрудника относится к заданному клиенту.
- Проверяет, что пользователи клиента существуют по всем заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., и возвращает список пользователей клиента.
- Проверяет, что заданный пользователь клиента принадлежит клиенту с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
- Проверяет, что каждый отдел с IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. из указанного множества имеет потомка из указанного множества IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов, разрешённых пользователю.
- Сначала находим высоты указанных отделов в полном дереве отделов, сортируем отделы по убыванию их высоты, затем проверяем каждый отдел на наличие доступного пользователю потомка.
- Если для некоторого отдела A выяснилось, что у него есть/нет доступного пользователю потомка, то в дальнейшем при проверке отдела B, который является предком A, мы не будем повторно обходить поддерево A.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Успешная операция.
Ошибка при валидации данных запроса.
Запрос не аутенифицирован.
Для заданного пользователя доступ к ресурсу запрещен.
Превышен разрешенный лимит запросов за период.