Purpose

The service is designed to upload a new medication registry. The process uses the Jabba service. Upon execution of the request, a job is created, on the basis of which tasks are created. Each task is one request to create an entity from the registry.

Key points

1. NHS admin user downloads file with fields according to its structure.

2. The file should be in .csv format and is converted to base64.

Specification

Logic

1. Decode base64 file.

2. Validate input according to schema.

3. Validate existing and create new entities of medications registry:

   1. Extract medications with type = INNM_DOSAGE, is_active = TRUE, innm_dosage.name, innm_dosage.form and innm_dosage.ingredients.dosage, innm_dosage.ingredients.is_primary):

      1. in case found extract connected medications with type = BRAND, is_active = TRUE, brand.name, brand.form, brand.package_qty, brand.package_min_qty, brand.certificate, brand.container and brand.ingredients.dosage, brand.ingredients.is_primary):

         1. in case found extract connected program medication by medication_id and program_medications.medical_program_id and insert program medication with brand according to Create medication registry | program_medications in case program medication not found.

      2. in case innm_dosage not found insert it according to Create medication registry | medications (type = INNM_DOSAGE) and its ingredients Create medication registry | ingredients (for INNM_DOSAGE), Create medication registry | innms (skip innms creation in case it exist).

      3. in case brand not found insert brand according to Create medication registry | medications (type = BRAND) and its ingredient Create medication registry | ingredients (for BRAND).

         1. insert program medication with brand according to Create medication registry | program_medications.

      4. in case brand and program medication found return 422 error with msg ('Such medication already exist').

4. Return job identifier with result.

innms

...

API paragraph not found

Request data validation

1. Check that request using schema

   1. Return 422 with the list of validation errors in case validation fails.

2. Check that registerType = 'FULL_MEDICATIONS_REGISTRY'

   1. Return 422 with the list of validation errors in case validation fails.

3. Check that reasonDescription filled

   1. Return 422 with the list of validation errors in case validation fails.

4. Check decoded and encoded input file according to file structure

   1. Return 422 with the list of validation errors in case validation fails.

File example:

...