Search LE Reorganization Jobs (GraphQL)_UA

1 Ціль
2 Основні положення
3 Специфікація
4 Авторизація
5 Перевірити юридичну особу
6 Пошукові параметри
7 Сервісна логіка

Ціль

Даний сервіс (WS) дозволяє знайти задачі на реорганізацію юридичної особи в адмін панелі по пошуковим параметрам.

Основні положення

Це метод на graphQl використовується тільки в панелі адміністрування НСЗУ.
Тільки автентифіковані та авторизовані співробітники НСЗУ з відповідним скоупом можуть здійснити пошук задачі на реорганізацію юридичної особи.
Запит повертає список задач на реорганізацію LE профільтрованих за пошуковими параметрами.

Специфікація

  "Reads and enables pagination through a set of `LegalEntityReorganizationJob`."
  legalEntityReorganizationJobs(
    "A condition to be used in determining which values should be returned by the collection."
    filter: LegalEntityReorganizationJobFilter
    "The method to use when ordering collection items."
    orderBy: LegalEntityReorganizationJobOrderBy
    "Read all values in the set after (below) this cursor."
    after: String
    "Read all values in the set before (above) this cursor."
    before: String
    "Only read the first _n_ values of the set."
    first: Int
    "Only read the last _n_ values of the set."
    last: Int
  ): LegalEntityReorganizationJobConnection!
"""
Filter for Legal entity reorganization job.
"""
input LegalEntityReorganizationJobFilter {
  "Legal entity reorganization job status filters."
  status: JobStatus
  "Legal entity reorganization job type filters."
  type: LegalEntityReorganizationJobType
  "Reorganized Legal entity data filters."
  reorganizedLegalEntity: ReorganizedLegalEntityFilter 
}

Авторизація

Перевірити валідність токену доступу
- в разі помилки - повернути 401 (“Invalid access token”)
Перевірити, що токен дійсний
- в разі помилки - повернути 401 (“Invalid access token”)
Перевірити скоупи користувача на можливість виконання даної дії (scope = 'legal_entity_merge_job:read')
- в разі невалідних скоупів - повернути 403 (“Your scope does not allow to access this resource. Missing allowances: legal_entity_merge_job:read”)

Перевірити юридичну особу

Отримати client_id з токену.
Перевірити скоупи користувача на можливість виконання даної дії (scope = 'legal_entity_merge_job:read')
- в разі помилки - повернути 403 (“Your scope does not allow to access this resource. Missing allowances: legal_entity_merge_job:read”)
Перевірити статуси юридичної особи (status = ACTIVE)
- в разі помилки - повернути 409 ('client_id refers to legal entity that is not active')

Пошукові параметри

Пошук по декільком параметрам здійснюється за логічним правилом І.

status. Пошук по jobs.status
legalEntityReorganizationJobType. Пошук по jobs.meta.type (Тип реорганізації юридичної особи)
reorganizedLegalEntity. Пошук по jobs.meta.merged_from_legal_entity.edrpou (ЄДРПОУ реорганізованої юридичної особи)

Сервісна логіка

Отримати список всіх задач по реорганізації юридичної особи профільтрованих по
1. вказаних пошукових параметрів
2. тип задачі merge_legal_entities та reorganize_legal_entities
Відобразити список з задачами по реорганізації юридичих осіб з даними відповідно до схеми
Повернути кількість сутностей, які знайдені в блоці PageInfo