RC_(MC-1191)_[NEW] Resend SMS on Composition Create

Purpose

This WS is designed to resend SMS to the patient(or confidant person) with composition number in case it wasn’t delivered the first time.

Specification

Apiary

Key points

1. Only authenticated and authorized user with appropriate scope can resend SMS.

2. SMS with composition number can be resent only to person with auth_method with type OTP.

3. SMS with composition number can be resent only for Composition in FINAL status.

Authorization

1. Verify the validity of access token

   1. in case of error - return 401 (“Invalid access token”) in case of validation fails

2. Verify that token is not expired

   1. in case of error - return 401 (“Invalid access token”)

3. Check user scopes in order to perform this action (scope = 'composition:resend_sms')

   1. return 403 (“Your scope does not allow to access this resource. Missing allowances: composition:resend_sms”) in case of invalid scope(s)

Validations

1. Validate person

   1. Check if person with patient_id from request exists

      1. in case of error - return 404 (“Not found”)

   2. Check if person with patient_id from request is not preperson

      1. in case of validation fails skip all steps below

2. Check if Composition with composition_id from request is exist

   1. in case of error - return 404 (“Not found”) in case of validation fails

3. Validate Composition

   1. Check that status is not 'entered_in_error'

      1. in case of error - return 409 error ('You can not resend SMS for Composition in status %status%')

4. Validate legal entity

   1. Check that legal_entity_type is included in chart variables ME_ALLOWED_TRANSACTIONS_LE_TYPES config parameter

      1. in case of error return 409 "Action is not allowed for the legal entity"

   2. Check that legal_entity has status = active

      1. in case of error return 409 "Action is not allowed for the legal entity" 

Processing

1. Call SMS timeout procedure to check if resending is allowed using:

   • COMPOSITION_MAX_ATTEMPTS_COUNT as MAX_ATTEMPTS_COUNT

   • COMPOSITION_SEND_TIMEOUT as SEND_TIMEOUT

   • "composition" as entity_name

   • composition_id as entity_id

   in case of error - return 429 ("Sending SMS timeout. Try later. Next attempt will be available at <attempts.oldest.value + SEND_TIMEOUT>")

2. Get person's authentication_method according to logic:

   1. If authorize_withinform_with exists in Composition and is not empty, check:

      1. Authentication method exists in person_authentication_methods table in MPI DB (with is_active=true), is active (ended_at > now() or null)

      2. Get value of THIRD_PERSON_CONFIDANT_PERSON_RELATIONSHIP_CHECK config parameter

         1. if it is set to true - for authentication method with type = THIRD_PERSON check that person from value is an approved confidant for a person from Composition:

            1. exists active and approved confidant person relationship between patient from the Composition and confidant_person_id from authentication method value (using following logic: Check confidant person relationship with person_id = person from request and confidant_person_id = value from auth method - expected :ok, :approved response)

         2. in case any validation failed - return 409 ('Authentication method doesn't exist or is inactive')

         3. else - get authentication_method from authorize_withinform_with

   2. If authentication_method == OTP or THIRD_PERSON (with OTP) 

      1. Generate text SMS with template CREATE_{{COMPOSITION_TYPE}}_COMPOSITION_SMS_TEMPLATE.

      2. Send SMS

      3. else, if authentication_method is not OTP or THIRD_PERSON (with OTP) return an error

         1. return 409 ('Authentication method doesn't exist or is inactive')