Get Medical program provision list_UA

Ціль

Даний веб-сервіс дозволяє отримати наявні забезпечення по медичній программі в частині відділень юридичної особи відповідно до договорів. Також, даний список може бути профільтровано за пошуковими параметрами.

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

1. Тільки автентифіковані та авторизовані співробітники з відповідними скоупами можуть отримати перелік відділень по медичній програмі.

2. Метод повертає список відділень медичної програми тільки для користувачів юридичної особи.

3. Список може бути профільтровано по параметрам пошуку.

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

Apiary

Авторизація

• Перевірити валідність токену доступу

  • в разі неуспішної валідації - повернути помилку 401 “Invalid access token”

• Перевірити, що строк дії токену не сплинув

  • в разі помилки - повернути 401 “Invalid access token”

• Перевірити скоупи користувача на можливість виконання даної дії (scope = 'medical_program_provision:read')

  • в разі невалідних скоупів повернути 403 “Your scope does not allow to access this resource. Missing allowances: medical_program_provision:read”

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

• Отримати client_id з токену.

• Перевірити скоупи користувача на можливість виконання даної дії (scope = 'medical_program_provision:read')

  • в разі помилки - повернути 403 “Your scope does not allow to access this resource. Missing allowances: medical_program_provision:read”

• Перевірити статус юридичної особи (status = ACTIVE, SUSPENDED)

  • в разі помилки - повернути 422 “Legal entity is not active”

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

Всі пошукові параметри не обов'язкові. Пошук по декількох параметрах виконується у відповідності до логіки ТА правил.

• contract_number

  • Якщо вказано, профільтрувати по medical_program_provision.contract_number

• medical_program_id

  • Якщо вказано, профільтрувати список по medical_program_provision.medical_program_id

• division_id

  • Якщо вказано, профільтрувати список по medical_program_provision.division_id

• is_active

  • Якщо вказано, профільтрувати список по medical_program_provision.is_active

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

1. Отримати client_id з токену як ідентифікатор юридичної особи

2. Визначити всі відділення юридичної особи

3. Отримати та розподілити всі записи по визначених відділеннях з таблиці medical_program_provision профільтрованих по пошукових параметрах.