Specification

APIARY

Method The method is used to register new employee or to update an existing one. There is 2 are two different flows of registration depend depending on whether the employee has tax_id or doesn't have one.

...

Authorize user

1. 1. Validate MIS API Key

   2. Check MIS scopes employee_request:write in order to perform this action

      1. In case error - generate 401 response

...

Decode content that is encrypted in an electronic digital signature.
Use Digital signature WS. Method checks digital signature and returns result.
See service specification

Validate DRFO

1. Check that DRFO in Certificate details exists and not empty

2. Check that DRFO in Certificate details is equal to DRFO of the user that creates employee_request in Party

   1. Get party.tax_id using user_id from employee request payload

   2. Compare DRFO in Certificate with party.tax_id

      1. Convert DRFO and TAX_ID to uppercase

      2. Compare DRFO and TAX_ID as Cyrillic letters

      3. Convert DRFO to Cyrillic and compare as Cyrillic letters

   3. In case validation fails - generate 422 error

...

1. 1. Validate request using JSON schema

      1. In case validation fails - generate 422 error

new_employee_request_schema.json

Validate request (Logic)

1. Check employee_type: Employee configurable validation rules and dictionaries

2. If employee_id is passed in the payload:

   1. search employees by employee_id

      1. if not found - return error 404

      2. else check * employee_type and (* tax_id or passport_id)

         1. If dosn't match, return error 409

         2. If match, check that employee is active

            for (employee_type = OWNER or PHARMACY_OWNER), status = APPROVED and is_active = false

            for (employee_type not OWNER and not PHARMACY_OWNER), status = DISMISSED and is_active = true

            1. if employee is active - create employee request

            2. if employee is not active - return error 409

3. Check allowed employee types for legal_entity type: Legal_Entity_Type vs Employee_Type validation rules

   1. if not found - return error 404

4. Validate legal entity type status for current legal entity: status should be active or suspended

5. Validate party

   1. first_name, last_name, second_name have the same validation pattern - `^(?!.*[ЫЪЭЁыъэё@%&$^#])[А-ЯҐЇІЄа-яґїіє’\\'\\- ]+$` 

      1. if doesn't match, return error 422 "string does not match pattern ..."

   2. validate birth_date

      1. birth_date > 1900-01-01 and birth_date < current date

         1. otherwise return error 422 "invalid birth_date value"

      2. birth_date has validation pattern - `^(\\d{4}(?!\\d{2}\\b))((-?)((0[1-9]|1[0-2])(\\3([12]\\d|0[1-9]|3[01]))?|W([0-4]\\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\\d|[12]\\d{2}|3([0-5]\\d|6[1-6])))?)?$`

         1. if doesn't match, return error 422 "expected 'birth_date' to be a valid ISO 8601 date"

   3. gender has one of the following values - "FEMALE", "MALE"

      1. otherwise return error 422 "value is not allowed in enum"

   4. validate tax_id

      1. tax_id has validation pattern - `^([0-9]{9,10}|[А-ЯЁЇIЄҐ]{2}\\d{6})$`

         1. if doesn't match, return error 422 "string does not match pattern ..."

   5. email has validation pattern - `^[\\w!#$%&'*+/=?`{|}~^-]+(?:\\.[\\w!#$%&'*+/=?`{|}~^-]+)*@(?:[A-Z0-9-]+\\.)+[A-Z]{2,6}$`

      1. if doesn't match, return error 422 "expected 'email' to be an email address"

   6. validate documents

      1. documents.type has one of the following values:

         1. "BIRTH_CERTIFICATE"

         2. "BIRTH_CERTIFICATE_FOREIGN"

            Jira Legacy
            server System Jira serverId d9171809-9c5e-36f7-ab17-a56a875b6d19 key BAT-1392

         3. "COMPLEMENTARY_PROTECTION_CERTIFICATE"

         4. "NATIONAL_ID"

         5. "PASSPORT"

         6. "PERMANENT_RESIDENCE_PERMIT"

         7. "REFUGEE_CERTIFICATE"

         8. "TEMPORARY_CERTIFICATE"

         9. "TEMPORARY_PASSPORT"

            1. otherwise return error 422 "value is not allowed in enum"

      2. documents.number has validation pattern according to documents.type

         1. BIRTH_CERTIFICATE - `^((?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\/()-]){2,25}$`

         2. COMPLEMENTARY_PROTECTION_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`

         3. NATIONAL_ID - `^[0-9]{9}$`

         4. PASSPORT - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`

         5. PERMANENT_RESIDENCE_PERMIT - `^(((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{4,6}|[0-9]{9}|((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{5}\\/[0-9]{5})$`

         6. REFUGEE_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`

         7. TEMPORARY_CERTIFICATE - `^(((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{4,6}|[0-9]{9}|((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{5}\\/[0-9]{5})$`

         8. TEMPORARY_PASSPORT - `^((?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\/()-]){2,25}$`

      3. validate documents.issued_at 

         1. documents.issued_at has validation pattern - `^(\\d{4}(?!\\d{2}\\b))((-?)((0[1-9]|1[0-2])(\\3([12]\\d|0[1-9]|3[01]))?|W([0-4]\\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\\d|[12]\\d{2}|3([0-5]\\d|6[1-6])))?)?$`

            1. if doesn't match, return error 422 "expected 'issued_at' to be a valid ISO 8601 date"

   7. validate phones

      1. phones.type has one of the following values - "LAND_LINE", "MOBILE"

         1. otherwise return error 422 "value is not allowed in enum"

      2. phones.number has validation pattern - `^\\+38[0-9]{10}$`

         1. if doesn't match, return error 422 "string does not match pattern ..."

...