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)

1. Validate request using JSON schemas:
   1. Return 422 with list of validation errors in case validation fails (422 EView)

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. For $.type = MEDICATION - 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:  For $.type = MEDICATION - Package_qty for container_dosage must have multiplicity package_min_qty.  Result (Mod or % operator) must = 0 .

1. For $.type = MEDICATION - 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 medication!")

Create new Medication

1. Create new record in Medications 
2. Fill data 

Prepare & return response data structure

1. Fill response WS data structure 
2. Validate response using JSON schemas (!!! TBD)
   1. Return 422 with list of validation errors in case validation fails (422 EView)