Add Medication

Status

• Specification SPECS
• Apiary SPECS

Purpose

This WS is designed to create new medication (post).

APIary 

create-medication

Input parameters 

• name
• type
• manufacturer (object)
• code_atc
• form
• container info
• package_qty
• package_min_qty
• certificate
• expired_certificate_at
• ingredients (array)
  • id
  • dosage info
  • is_active_substance

Authorize

1. Verify the validity of access token
2. Check user scope (scope = 'medication:write') in order to perform this action
   1. In case error - generate 401 response

Validate request (JSON schema)

Validate request using JSON schemas:

Validate FK 

Purpose validation: Check on existing Substance/Innm in ingredients 

1. For $.type = INNM - Check exist `Substance` by $.ingredients[].id.

   1. if invalid - return 422 error (message: "Substance in ingredients is not found!")

2. For $.type = MEDICATION - Check exist `Medications` by $.ingredients[].id.

   1. if invalid - return 422 error (message: "INNM in ingredients is not found!")

Validate Equal Dosage & Container

Purpose validation: For $.type = MEDICATION - Denumerator unit from Ingredients.dosage  must be equal Numerator unit from Container. See examples: Medications model  

1. Check exist any  ($.ingredients[].dosage.denumerator_unit != $.container.numerator_unit).

   1. if invalid - return 422 error (message: "Denumerator unit from Dosage ingredients must be equal Numerator unit from Container medication!")

Validate multiplicity

Purpose validation:  Package_qty for container_dosage must have multiplicity package_min_qty.  Result (Mod or % operator) must = 0 .

1. Vaildate multiplicity (Mod == 0) $.package_qty Mod $.package_min_qty == 0

1. 1. if result NOT 0 - return 409 eror (message: "Only a multiplicity package quantity for the minimum package quantity !")

Create new Medication

1. Create new record in Medications 
2. Fill data 

1. Save temp variable from medication.id
2. Create new records in Ingredients (array)
   
   

Return data structure

1. Fill response data structure (Similar input parametrs)
2. Additional  
   • id
   • container_dosage.description
   • ingredients.dosage.description
   • ingredients.innm info