Introduction

Web service "Submit Activity Type Package" allows to transmit new or update existing activity type, its related data and legal entity licenses in e-Health system in one call. Activity types are created/updated one by one.

Specification

Apiary

Validation

Authorization

1. Verify the validity of access token
   1. in case of error return 401 ('Access denied')
2. Check user scope activity_type:write in order to perform this action
   1. in case of error generate 403 response ('Invalid scopes')

Request validation

Note: All IDs, submitted as PK, should be unique for eHealth when creating new record

Validate Owner

1. Check that one of token.user_id employees is an OWNER of current legal_entity 
   1. in case validation fails - generate 409 - "Only owner of legal entity can create or update activity types and(or) licenses for legal entity"

Validate digital signature

1. Validate signature 
2. Extract signer Certificate details

Validate encoded signed content according to JSON Schema

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

Validate Legal Entity

1. Check that legal_entities.is_active = true and legal_entities.status = active for current legal entity
   1. in case of error return 409 - "legal entity is not active"
2. token.Client_id must match current legal entity
   1. in case of error return 422 
3. EDRPOU for token.client_id must match EDRPOU $.legal_entity.edrpou
   1. in case of error return 422 

Validate Tax ID

1. Check that EDRPOU in Certificate details exists and not empty
   
   1. Check that EDRPOU in Certificate details is valid according to ^[0-9]{8,10}$
   2. Check that EDRPOU in Certificate details is equal to $.legal_entity.edrpou  
      1. In case validation fails - generate 422 error
2. If EDRPOU in Certificate details is empty check that DRFO exists and not empty
   1. Check that DRFO in Certificate details is valid according to ^[0-9]{9,10}$
   2. Check that DRFO in Certificate details is equal to $.legal_entity.edrpou 
      1. In case validation fails - generate 422 error
3. In case EDRPOU and DRFO is empty return error 422, msg "EDRPOU and DRFO is empty in digital sign"

Validate Licenses

1. Apply current validations which depends on license type
2. Check that legal entity has at least one kved which corresponds to license type according to the following table

   LICENSE_TYPE	Rule
   MSP	at least one KVED from KVEDS_ALLOWED_MSP
   PHARMACY	at least one KVED from KVEDS_ALLOWED_PHARMACY

3. Search for current legal entity license in prm.licenses.id = $.license.id
   1. If record is found then check that:
      1. prm.licenses.type = $.license.type 
         
         1. in case validation fails - generate 409 - "License type update is not allowed"
      2. prm.licenses.is_active = true
         1. in case validation fails - generate 409 - "Inactive license update is not allowed"
      3. prm.licenses.expiry_date is empty or more than today
         1. in case validation fails - generate 409 - "Activity type can not be linked to expired license"

Validate Activity Type

1. Validate that $.activity_type.id is unique
2. Search for current legal entity activity type in prm.activity_types where id = $.activity_type.id
   1. if record is found then check that
      1. prm.activity_types.type = $.activity_type.type
         1. in case validation fails - generate 409 - "Update of type for activity type is not allowed"
      2. prm.activity_types.is_active = true
         1. in case validation fails - generate 409 - "Inactive activity type update is not allowed"
3. Search for current legal entity activity type in prm.activity_types where is_active=true and type = $.activity_type.type
   1. If record is found then check that its id is equal to $.activity_type.id
      1. in case validation fails - generate 409 - "Active activity type with the same type already exists"
4. Check $.activity_type.type license obligation and license type needed (see table below) 
   1. If license is a must:
      1. check that $.activity_type.license_id is not empty
         1. in case validation fails - generate 422
      2. check that license with $.activity_type.license_id exists in payload 
         1. in case validation fails - generate 422
         2. check that $.license.type is of needed type
            1. in case validation fails - generate 409 - "Activity type does not correspont to its license type"
      3. if license with $.activity_type.license_id does not exist in payload then check search for license with $.activity_type.license_id in prm.licenses for current legal entity
         1. if record is not found - generate 422
         2. if record found check that lisense is not expired (prm.licenses.expiry_date is empty or more than today)
            1. if validation fails - generate 409 - "Adding activity type related to expired license is not allowed"
         3. Check that prm.licenses.type is of needed type
            1. in case validation fails - generate 409 - "Activity type does not correspont to its license type"

Activity types license obligation and types

Processing

1. Search for current legal entity license in prm.licenses where id = $.license.id
   1. if record is found update it 
   2. if record is not found create new record
   3. set nhs_verified = false
2. Search for current legal entity activity type in prm.activity_types where id = $.activity_type.id
   1. If record is found update it
      
      1. if prm.activity_types.status <> active then set prm.activity_types.status = active, write to audit_log
   2. if record is not found create new record with status = active
   3. set nhs_verified = false
3. Find contracts by contractor_legal_entity_id for current legal entity where status='VERIFIED' AND ops.contracts.type corresponding to activity_type (use ops.contracts.type to activity_type mapping described in https://zube.io/edenlabllc/e-health/c/5969: capitation_activity_types: PRIMARY_CARE, reimbursement_activity_types: PHARMACY)
   1. set ops.contracts.is_suspended=true
4. Save signed_content to Media Storage
   1. every version should be saved
5. Save data to corresponding collections in DBs
6. Save link to the signed content to the activity type