ЕСОЗ - публічна документація

Reimbursement Report for NHS admin

Owned by Bogdana Konovalenko (Unlicensed)
Last updated: Feb 08, 2023 by Oleksandr Zhuk (SoE eHealth) (Unlicensed)
3 min read

Purpose

This method is designed to create reimbursement report which is based on Medication request and Medication dispense data for NHS admin

Specification

Link

https://ehealthmisapi1.docs.apiary.io/#reference/public.-reimbursement/reimbursement-report/get-reimbursement-report

Посилання на Apiary або Swagger

Resource

/api/reimbursement_report_download

Посилання на ресурс, наприклад: /api/persons/create

Scope

reimbursement_report:download

Scope для доступу

Components

ePrescription

Зазначається перелік бізнес компонентів, які використовують цей метод, наприклад: ePrescription

Microservices

API paragraph not found

Перелік мікросервісів, які використовує метод API, наприклад: Auth, ABAC

Protocol type

REST

Тип протоколу, який використовується запитом, наприклад: SOAP | REST

Request type

GET

Тип запиту API, наприклад: GET, POST, PATCH…

Sync/Async

API paragraph not found

Метод є синхронним чи асинхронним?

Public/Private/Internal

Internal

Потрібно зазначити тип методу за ступенем доступності

Logic

The access and ability to create and get the report have NHS admin.

To get the report the creator must input requested period (date_from_request, date_to_request, date_from_dispense, date_to based on date of dispense or request). In response will be received the json with data.

Filters

See on Apiary

Authorize

  1. Verify the validity of access token

    1. Return 401 in case validation fails

  2. Check user scopes in order to perform this action (scope = 'reimbursement_report:download')

    1. Return 403 in case invalid scope(s)

Request data validation

Validate input dates

  1. There is 2 available dates for the filtering: date_from_dispense and date_to_dispense. Both of them must be filled.

          In case of error show 422 error with message must be shown ( "Input dates must be filled")

  1. Validate input date_from and date_to

    • if date_from_request is not null then: date_from_dispense<=date_to_dispense and date_to_dispense must be filled

      in case of error - return 422 error:

      {:error, [{%{
              description: "Input dates are not valid",
              params: [],
              rule: :invalid
            }, "$.date_from_dispense"}]}

      Input dates filter the field: 

      • date_from_dispense/date_to_dispense comparing to field medication_dispenses.dispensed_at

If there is no data available for the requested period of time in response must be sent empty file, no error is shown. 

Processing

Prepare response

Output format -  text/csv

Response example

  1. Prepare response with fields described below and conditions described below:

  • first row is for headers (REQUESTED_FIELD which is below)

  • NHS admin will receive all Medication Dispenses and corresponding Medication Requests.

  • in case there is no Medication Dispenses for Medication Requests, Medication Requests won't be shown in the report

  • for Medication Dispense: status='PROCESSED'

 

REQUESTED_FIELD

REPORT_FIELD

SOURCE

COMMENT

REQUESTED_FIELD

REPORT_FIELD

SOURCE

COMMENT

Назва суб’єкту господарювання (аптека)

pharmacy_name

medication_dispense.legal_entity.name

 

Код ЄДРПОУ суб'єкту господарювання (аптека)

pharmacy_edrpou

medication_dispense.legal_entity.edrpou

 

Назва закладу охорони здоров’я

msp_name

medication_request.legal_entity.name 

 

Код ЄДРПОУ закладу охорони здоров’я

msp_edrpou

medication_request.legal_entity.edrpou

 

Лікар, що виписав рецепт (ПІБ)

doctor_name

medication_request.employee.party.last_name&first_name&second_name

 

Лікар, що виписав рецепт (ID)

doctor_id

medication_request.employee.id

 

№ Номер рецепта

request_number

medication_request.request_number

 

Дата створення рецепта

created_at

medication_request.created_at

 

Дата відпуску рецепта

dispensed_at

medication_dispense.dispensed_at

 

Міжнародна непатентована назва лікарського засобу (словник реєстру)

innm_name

select i.namefrom ingredients ing inner join innms i on ing.innm_child_id=i.id where ing.parent_id=$medication_dispense.innm_dosage.id and is_primary=true

 

Лікарська форма

innm_dosage_name

medication_request.medication.name

innm_dosage

Торгова назва лікарського засобу

medication_name

medication_dispense.details.medication.name

 

Сила дії (дозування)

-----

 

do not show

Форма випуску (словник реєстру)

form

medication_dispense.details.medication.form

 

Кількість одиниць лікарської форми відповідної дози в упаковці, од.

package_qty

medication_dispense.details.medication.package_qty

 

Кількість відпущених упаковок, упак

/Кількість відпущених ліків, одиниць

medication_qty

medication_dispense_details.medication_qty

units, not packages

Фактична роздрібна ціна реалізації упаковки, грн

sell_amount

medication_dispense_details.sell_amount

 

Розмір відшкодування вартості лікарського засобу за упаковку, грн

reimbursement_amount

medication_dispense_details.reimbursement_amount

 

Сума відшкодування, грн

discount_amount

medication_dispense_details.discount_amount

 

Сума доплати за упаковку ЛЗ, грн

/ Фактична роздрібна ціна за одиницю, грн

sell_price

medication_dispense_details.sell_price

instead we show all fields to be able to calculate this value

Номер фіксального чеку

payment_id

medication_dispense.payment_id

 

Сума транзакції

payment_amount

medication_dispense.payment_amount

 

HTTP status codes

HTTP status code

Message

What caused the error

HTTP status code

Message

What caused the error

 401

 

 Access token validation failed

 403

 

 Invalid scope(s)

422

 

Validation error





ЕСОЗ - публічна документація