Page Comparison

Table of Contents

maxLevel	7
minLevel	1

...

Page Properties

Link	https://uaehealthapi.docs.apiary.io/#reference/public.-reimbursement/medication-request-requests/create-medication-request-request	Посилання на Apiary або Swagger
Resource	/api/medication_request_requests	Посилання на ресурс, наприклад: /api/persons/create
Scope	medication_request_request:write	Scope для доступу
Components	ePrescription	Зазначається перелік бізнес компонентів, які використовують цей метод, наприклад: ePrescription
Microservices	Немає даних	Перелік мікросервісів, які використовує метод API, наприклад: Auth, ABAC
Protocol type	REST	Тип протоколу, який використовується запитом, наприклад: SOAP \| REST
Request type	POST	Тип запиту API, наприклад: GET, POST, PATCH…
Sync/Async	Sync	Метод є синхронним чи асинхронним?

Логіка

Технічний опис бізнес-процесу виписування рецепту в ЕСОЗ (загальний процес для усіх рецептурних ЛЗ, в т.ч. і тих, які підлягають реімбурсації)

...

Expand

Code Block

{
  "medication_request_request": {
    "person_id": "585044f5-1272-4bca-8d41-8440eefe7d26",
    "employee_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "division_id": "881d6dee-dd3d-43f3-8983-922354c0e6ce",
    "created_at": "2017-08-17",
    "started_at": "2017-08-17",
    "ended_at": "2017-09-16",
    "medication_id": "1349a693-4db1-4a3f-9ac6-8c2f9e541982",
    "medication_qty": 10.34,
    "medical_program_id": "59781de0-2e64-4359-b716-bcc05a32c10f",
    "intent": "plan",
    "category": "community",
    "based_on": [
      {
        "identifier": {
          "type": {
            "coding": [
              {
                "system": "eHealth/resources",
                "code": "care_plan"
              }
            ]
          },
          "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
        }
      },
      {
        "identifier": {
          "type": {
            "coding": [
              {
                "system": "eHealth/resources",
                "code": "activity"
              }
            ]
          },
          "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
        }
      }
    ],
    "context": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "encounter"
            }
          ]
        },
        "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
      }
    },
    "dosage_instruction": [
      {
        "sequence": 1,
        "text": "0.25mg PO every 6-12 hours as needed for menses from Jan 15-20, 2015.  Do not exceed more than 4mg per day",
        "additional_instruction": [
          {
            "coding": [
              {
                "system": "eHealth/SNOMED/additional_dosage_instructions",
                "code": "311504000"
              }
            ]
          }
        ],
        "patient_instruction": "0.25mg PO every 6-12 hours as needed for menses from Jan 15-20, 2015.  Do not exceed more than 4mg per day",
        "timing": {
          "event": [
            "2017-04-20T19:14:13Z"
          ],
          "repeat": {
            "bounds_duration": {
              "value": 10,
              "unit": "days",
              "system": "eHealth/ucum/units",
              "code": "d"
            },
            "count": 2,
            "count_max": 4,
            "duration": 4,
            "duration_max": 6,
            "duration_unit": "d",
            "frequency": 1,
            "frequency_max": 2,
            "period": 4,
            "period_max": 6,
            "period_unit": "d",
            "day_of_week": [
              "mon"
            ],
            "time_of_day": [
              "2017-04-20T19:14:13Z"
            ],
            "when": [
              "WAKE"
            ],
            "offset": 4
          },
          "code": {
            "coding": [
              {
                "system": "TIMING_ABBREVIATIONS",
                "code": "patient"
              }
            ]
          }
        },
        "as_needed_boolean": true,
        "site": {
          "coding": [
            {
              "system": "eHealth/SNOMED/anatomical_structure_administration_site_codes",
              "code": "344001"
            }
          ]
        },
        "route": {
          "coding": [
            {
              "system": "eHealth/SNOMED/route_codes",
              "code": "46713006"
            }
          ]
        },
        "method": {
          "coding": [
            {
              "system": "eHealth/SNOMED/administration_methods",
              "code": "419747000"
            }
          ]
        },
        "dose_and_rate": {
          "type": {
            "coding": [
              {
                "system": "eHealth/dose_and_rate",
                "code": "'ordered'"
              }
            ]
          },
          "dose_range": {
            "low": {
              "value": 0,
              "unit": "mg",
              "system": "eHealth/ucum/units",
              "code": "mg"
            },
            "high": {
              "value": 0,
              "unit": "mg",
              "system": "eHealth/ucum/units",
              "code": "mg"
            }
          },
          "rate_ratio": {
            "numerator": {
              "value": 0,
              "unit": "mg",
              "system": "eHealth/ucum/units",
              "code": "mg"
            },
            "denominator": {
              "value": 0,
              "unit": "mg",
              "system": "eHealth/ucum/units",
              "code": "mg"
            }
          }
        },
        "max_dose_per_period": {
          "numerator": {
            "value": 0,
            "unit": "mg",
            "system": "eHealth/ucum/units",
            "code": "mg"
          },
          "denominator": {
            "value": 0,
            "unit": "mg",
            "system": "eHealth/ucum/units",
            "code": "mg"
          }
        },
        "max_dose_per_administration": {
          "value": 0,
          "unit": "mg",
          "system": "eHealth/ucum/units",
          "code": "mg"
        },
        "max_dose_per_lifetime": {
          "value": 0,
          "unit": "mg",
          "system": "eHealth/ucum/units",
          "code": "mg"
        }
      }
    ],
    "priority": "routine",
    "prior_prescription": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "medication_request"
            }
          ]
        },
        "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
      }
    },
    "container_dosage": {
      "system": "MEDICATION_UNIT",
      "code": "ML",
      "value": 4
    }
  }
}

Авторизація

...

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

Авторизація

Перевірити валідність токену доступу
- в разі помилки - повернути 401 (“Invalid access token”) в разі невалідних валідацій
Перевірити, що токен дійсний
- в разі помилки - повернути 401 (“Invalid access token”)
Перевірити скоупи користувача (scope = 'medication_request_request:write') на можливість виконання даної дії
- в разі помилки - надіслати у відповіді код 401
Якщо BLOCK_UNVERIFIED_PARTY_USERS є true, тоді перевірити дані співробітника на свіпадіння наступним умовам: verification_status != NOT_VERIFIED або (verification_status = NOT_VERIFIED та updated_at <= current_date - UNVERIFIED_PARTY_PERIOD_DAYS_ALLOWED):
- в разі неспівпадіння - повернути 403 ("Access denied. Party is not verified")

Headers

Content-Type:application/json

...

Забрати employee_id з запиту
Перевірити співробітника
1. На існування
  1. в разі помилки повернути код 422 з повідомленням ("Employee not found")
2. Перевірити, що $.employees.status == APPROVED
  1. в разі помилки повернути код 409 з повідомленням ("Employee is not active")
3. Перевірити, що $.employees.legal_entity_id == client_id from token
  1. в разі помилки повернути код 422 з повідомленням ("Employee does not belong to legal entity from token")
4. Перевірити, що $.employees.employee_type == <employee_type>
  1. якщо medical_program_id є в запиті перевірити medical_program_settings.skip_employee_validation == false (або відсутня)
    1. перевірити <employee_type>
      1. отримати $.medical_programs.medical_program_setting по medical_program_id з запиту
        перевірити, що employee_type наявна в параметрі employee_types_for_create_medication_request
        в разі помилки повернути код 422 з повідомленням ("Employee type can't create medication request with medical program from request")
        якщо employee_type = DOCTOR
        отримати $.declarations by employee_id, person_id, status=ACTIVE або перевірити параметр MEDICATION_REQUEST_DECLARATION_VERIFY (який дозволяє створити запит на рецепт для будь-якого лікаря в LE де персона має декларацію)
        якщо не знайдено - повернути код 422 (повідомлення: "Employee must have an active declaration with the patient to create medication request!")
        якщо employee_type = SPECIALIST
        отримати $.employees.speciality.speciality(speciality_officio == true)
        перевірити, що вказана спеціальність in$.medical_programs.medical_program_setting.speciality_types_allowed variable
        в разі помилки повернути код 422 з повідомленням ("Employee's specialty doesn't allow create medication request with medical program from request")
        у випадку, якщо Employee_type = MED_COORDINATOR
        і. пропустити перевірку спеціальності в змінній $.medical_programs.medical_program_setting.speciality_types_allowed
  2. якщо medical_program_settings.skip_employee_validation == true або відсутня medical_program_id в запиті, будь-який користувач, який має скоуп може створити запит на рецепт

...

Перевірити План лікування:
1. Від повинен належати тій же персоні, що і набір в MRR
  1. в разі помилки повернути код 422 з повідомленням ("Care plan not found")
2. Від повинен бути в статусі active
Перевірити вказану активність:
1. Вона відповідає Плану лікування.
  1. в разі помилки повернути код 422 з повідомленням ("Activity not found")
2. Вона має activity.detail.kind=medication_request; activity.detail.product_reference=medication_id.
  1. в разі помилки повернути код 422 з повідомленням ("Invalid activity kind")
3. Вона має статус scheduled, in_progress status
  1. у випадку помилки повернути 422 з повідомленням ("Invalid activity status")
Якщо вона має quantity порахувати remaining quantity:
1. вибрати всі MRR в статусі NEW які створені на основі даної активності
2. вибрати всі MR в статусах ACTIVE, COMPLETED які створені на основі даної активності
3. порахувати зарезервовану на сьогодні кількість, як суму medication_qty у профільтрованому MRR та MR списку, включаючи medication_qty з поточного MRR
4. порахувати вказану кількість шляхом віднімання зарезервованої кількості з кількості активностей
5. Перевірити remaining quantity більше або дорівнює 0
  1. в разі помилки повернути код 409 "The total amount of the prescribed medication quantity exceeds quantity in care plan activity"
1. перевірити, що medical_program_id дорівнює $.activity[].program
  1. в разі помилки повернути код 422 з повідомленням ("Medical program from activity should be equal to medical program from request")
Перевірити started_at/ended_at для запиту рецепту:
1. Якщо активність плану лікування має detail.scheduled_timing.repeat.bounds_period - перевірити started_at/ended_at включаючи bounds_period
2. Якщо план активності має detail.scheduled_period - перевірити started_at/ended_at включаючи scheduled_period
3. в іншому випадку - перевірити started_at/ended_at включаючи care_plan.period
  1. у випадку якщо started_at/ended_at не в межах care_plan.period повернути код 422 з повідомленням ("Invalid care plan period")

...

Згенерувати номер для рецепту (See specs)

Code Block

Structure number XXXX-1234-5678-9012-345-C , where:
- XXXX - series: numbers + only some letters (A, E, H, K, M, P, T, X)
- 1234-5678-9012-345 - randomly generated numbers
- C - checksum: Should be calculated using the Damn algorithm or Verhoeff algorithm
After new Request number was generated we should check that it is unique in the DB (entity: medication_request + medication_request_request

Згенерувати verification_code для MPI.person_authentication_methods == OTP або OFFLINE
Code Block
Structure code 1234, where: - 1234 - randomly generated numbers

...

Згенерувати структуру даних відповіді для веб-сервісу
- Встановити структуру для IL.medication_request_requests
якщо відповідь VALID доповнити відповідь urgent_data:
- отримати authetification_method по person_id та повернути зашифрований номер (в будь-якому випадку)

Code Block
"urgent": { "authentication_method_current": { "type": "OTP", "number": "+38093*****85" } }

Структура відповіді

Дивись на Apiary

...

Подальша обробка

Немає

HTTP статус коди

HTTP статус код	Повідомлення	Що викликало помилку
201	Відповідь
401

Помилка

	Перевірку scope не пройдено
409		Помилка валідації
422		Помилка

валідації

Зворотна сумісність

Немає даних

...

Versions Compared

Old Version 18

New Version Current

Key

Логіка

Авторизація

Авторизація

Headers

Структура відповіді

Подальша обробка

HTTP статус коди

Зворотна сумісність