{"type":"doc","content":[{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"291e117b-5bf1-4608-b33f-d21261f48cee"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"afb40913-d678-4290-980b-a9f9fa07c21b"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Purpose","type":"text"}]},{"type":"paragraph","content":[{"text":"This method is designed to create or update Person Request (as part of the process of creating a Person without a Declaration)","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Specification","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fbe16fad-f4ca-4953-badc-d86bceff2fe9"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Link","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/person-requests/create/update-person-request"}},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Resource","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"/api/person_requests","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Scope","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"person_request:write","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Components","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"Patient registry","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Microservices","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"il/api","type":"text"}]},{"type":"paragraph","content":[{"text":"fe/admin-web","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Protocol type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"REST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Request type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Sync/Async","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"Sync","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[209.0]},"content":[{"type":"paragraph","content":[{"text":"Public/Private/Internal","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[551.0]},"content":[{"type":"paragraph","content":[{"text":"Public","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Logic","type":"text"}]},{"type":"paragraph","content":[{"text":"Patient creation request statuses","type":"text","marks":[{"type":"link","attrs":{"href":"https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/1459453963"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Global and configuration parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"Invoke Global parameters to get following parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"phone_number_auth_limit","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Check if in table person_authentication_methods with type = ","type":"text"},{"text":"OTP","type":"text","marks":[{"type":"code"}]},{"text":" > N, then ","type":"text"},{"text":"error 422, such a phone already exists more N times","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"third_person_limit","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In table person_auth_methods with type = third_person > N, then error 422","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"person_request_expiration and person_request_term_unit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"person_with_third_person_limit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"no_self_auth_age ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"cURL example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"curl -X GET \\\n {:host}/prm/api/global_parameters","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Dictionaries","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GENDER","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DOCUMENT_TYPE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ADDRESS_TYPE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COUNTRY","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SETTLEMENT_TYPE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"STREET_TYPE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PHONE_TYPE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AUTHENTICATION_METHOD","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CONFIDANT_PERSON_TYPE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PREFERRED_WAY_COMMUNICATION","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DOCUMENT_RELATIONSHIP_TYPE","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Request structure","type":"text"}]},{"type":"paragraph","content":[{"text":"See on Apiary","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/person-requests/create/update-person-request"}}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"expand","attrs":{"title":"Request example"},"content":[{"type":"codeBlock","content":[{"text":"{\n \"person\": {\n \"id\": \"13001c60-45a0-4b5a-b425-9505e1de18bd\",\n \"first_name\": \"Петро\",\n \"last_name\": \"Іванов\",\n \"second_name\": \"Миколайович\",\n \"birth_date\": \"2009-07-05\",\n \"birth_country\": \"Україна\",\n \"birth_settlement\": \"Вінниця\",\n \"gender\": \"MALE\",\n \"email\": \"email@example.com\",\n \"no_tax_id\": false,\n \"tax_id\": \"3999869394\",\n \"secret\": \"secret\",\n \"documents\": [\n {\n \"type\": \"BIRTH_CERTIFICATE\",\n \"number\": \"АА120518\",\n \"issued_by\": \"Рокитнянським РВ ГУ МВС Київської області\",\n \"issued_at\": \"2017-02-28\",\n \"expiration_date\": \"2027-02-28\"\n }\n ],\n \"addresses\": [\n {\n \"type\": \"RESIDENCE\",\n \"country\": \"UA\",\n \"area\": \"Житомирська\",\n \"region\": \"Бердичівський\",\n \"settlement\": \"Київ\",\n \"settlement_type\": \"CITY\",\n \"settlement_id\": \"b075f148\",\n \"street_type\": \"STREET\",\n \"street\": \"вул. Ніжинська\",\n \"building\": \"15\",\n \"apartment\": \"23\",\n \"zip\": \"02090\"\n }\n ],\n \"phones\": [\n {\n \"type\": \"MOBILE\",\n \"number\": \"+380503410870\"\n }\n ],\n \"authentication_methods\": [\n {\n \"type\": \"THIRD_PERSON\",\n \"phone_number\": \"+380508887700\",\n \"value\": \"c282f8a9-e709-40aa-94b4-dde1402bf4b6\",\n \"alias\": \"husband\"\n }\n ],\n \"unzr\": \"20090705-00011\",\n \"emergency_contact\": {\n \"first_name\": \"Петро\",\n \"last_name\": \"Іванов\",\n \"second_name\": \"Миколайович\",\n \"phones\": [\n {\n \"type\": \"MOBILE\",\n \"number\": \"+380503410870\"\n }\n ]\n },\n \"confidant_person\": [\n {\n \"relation_type\": \"PRIMARY\",\n \"first_name\": \"Петро\",\n \"last_name\": \"Іванов\",\n \"second_name\": \"Миколайович\",\n \"birth_date\": \"1972-10-26\",\n \"birth_country\": \"Україна\",\n \"birth_settlement\": \"Вінниця\",\n \"gender\": \"MALE\",\n \"tax_id\": \"2659719350\",\n \"secret\": \"secret\",\n \"unzr\": \"19900101-00099\",\n \"preferred_way_communication\": \"email\",\n \"documents_person\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"АА120518\",\n \"expiration_date\": \"2021-02-28\",\n \"issued_by\": \"Рокитнянським РВ ГУ МВС Київської області\",\n \"issued_at\": \"2017-02-28\"\n }\n ],\n \"documents_relationship\": [\n {\n \"type\": \"BIRTH_CERTIFICATE\",\n \"number\": \"АА120518\",\n \"issued_by\": \"Рокитнянським РВ ГУ МВС Київської області\",\n \"issued_at\": \"2017-02-28\"\n }\n ],\n \"phones\": [\n {\n \"type\": \"MOBILE\",\n \"number\": \"+380503410870\"\n }\n ],\n \"email\": \"emaill@example.com\"\n }\n ],\n \"preferred_way_communication\": \"email\"\n },\n \"patient_signed\": false,\n \"process_disclosure_data_consent\": true,\n \"authorize_with\": \"cc949559-5dfe-420f-ac05-065e443b2cc6\"\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Authorize","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify the validity of access token","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return (401, 'Invalid access token') in case of validation fails","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that token is not expired","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case of error - return (401, 'Invalid access token')","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check user scopes in order to perform this action (scope = '","type":"text"},{"text":"person_request:write","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"')","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return (403, 'Your scope does not allow to access this resource. Missing allowances: person_request:write') in case of invalid scope(s)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate client_id belongs to legal_entity with type in ('MSP', 'OUTPATIENT', 'EMERGENCY', 'PRIMARY_CARE')","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return (401, 'Invalid legal entity type') in case of validation fails","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If BLOCK_UNVERIFIED_PARTY_USERS is true, then check party's data match following condition: verification_status != NOT_VERIFIED or (verification_status = NOT_VERIFIED and updated_at <= current_date - UNVERIFIED_PARTY_PERIOD_DAYS_ALLOWED):","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case not match - return 403 (\"Access denied. Party is not verified\")","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If BLOCK_DECEASED_PARTY_USERS is true, check that party is not deceased (party_verification record does not equal to: dracs_death_verification_status = VERIFIED and dracs_death_verification_reason = MANUAL_CONFIRMED):","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case of error - return 403 (\"Access denied. Party is deceased\")","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate user belongs to employee with type in \"Doctor, Specialist, Receptionist, Assistant\"","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 409","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Headers","type":"text"}]},{"type":"paragraph","content":[{"text":"Content-Type:application/json","type":"text"}]},{"type":"paragraph","content":[{"text":"Authorization:Bearer {{access_token}}","type":"text"}]},{"type":"paragraph","content":[{"text":"api-key:{{secret}}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Request data validation","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate request ","type":"text"}]},{"type":"paragraph","content":[{"text":"Validate request using JSON schema","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check presence of extra parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In case of error - return 422 ('schema does not allow additional properties')","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check presence of required parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In case of error - return 422 ('required property %{property} was not present')","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"JSON Schema"},"content":[{"type":"codeBlock","content":[{"text":"{\n \"$schema\": \"http://json-schema.org/person_request/schema#\",\n \"definitions\": {\n \"phone\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: PHONE_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^\\\\+38[0-9]{10}$\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"name\": {\n \"type\": \"string\",\n \"pattern\": \"^(?!.*[ЫЪЭЁыъэё@%&$^#])[a-zA-ZА-ЯҐЇІЄа-яґїіє0-9№\\\\\\\"!\\\\^\\\\*)\\\\]\\\\[(._-].*$\"\n },\n \"person_name\": {\n \"type\": \"string\",\n \"pattern\": \"^(?!.*[ЫЪЭЁыъэё@%&$^#])[А-ЯҐЇІЄа-яґїіє\\\\'\\\\-]+(\\\\s(?!.*[ЫЪЭЁыъэё@%&$^#])[А-ЯҐЇІЄа-яґїіє\\\\'\\\\-]+)*$\",\n \"minLength\": 1,\n \"maxLength\": 255\n },\n \"unzr\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{8}-[0-9]{5}$\"\n },\n \"tax_id\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{10}$\",\n \"minLength\": 10,\n \"maxLength\": 255\n },\n \"no_tax_id\": {\n \"type\": \"boolean\",\n \"description\": \"Status person refused tax_id\"\n },\n \"gender\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: GENDER\",\n \"maxLength\": 255\n },\n \"address\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: ADDRESS_TYPE\"\n },\n \"country\": {\n \"type\": \"string\"\n },\n \"area\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"region\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"settlement\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"settlement_type\": {\n \"type\": \"string\",\n \"description\": \"settlement type Dictionary: SETTLEMENT_TYPE\"\n },\n \"settlement_id\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$\"\n },\n \"street_type\": {\n \"type\": \"string\",\n \"description\": \"street type Dictionary: STREET_TYPE\"\n },\n \"street\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"building\": {\n \"type\": \"string\",\n \"pattern\": \"^[1-9]((?![ЫЪЭЁыъэё])()([А-ЯҐЇІЄа-яґїіє \\\\/\\\\'\\\\-0-9])){0,20}$\"\n },\n \"apartment\": {\n \"type\": \"string\"\n },\n \"zip\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{5}$\"\n },\n \"inserted_by\": {\n \"type\": \"string\"\n },\n \"updated_by\": {\n \"type\": \"string\"\n },\n \"inserted_at\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"type\",\n \"country\",\n \"area\",\n \"settlement\",\n \"settlement_type\",\n \"settlement_id\",\n \"inserted_by\",\n \"updated_by\"\n ],\n \"additionalProperties\": false\n },\n \"series_number_document\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"PASSPORT\",\n \"COMPLEMENTARY_PROTECTION_CERTIFICATE\",\n \"REFUGEE_CERTIFICATE\",\n \"TEMPORARY_CERTIFICATE\"\n ],\n \"description\": \"Dictionary: DOCUMENT_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$\"\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"number_document\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"BIRTH_CERTIFICATE\",\n \"TEMPORARY_PASSPORT\"\n ],\n \"description\": \"Dictionary: DOCUMENT_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^(?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\\\/()-]+$\",\n \"minLength\": 1,\n \"maxLength\": 255\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"id_card\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"NATIONAL_ID\"\n ],\n \"description\": \"Dictionary: DOCUMENT_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{9}$\"\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"document_relationship\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: DOCUMENT_RELATIONSHIP_TYPE\",\n \"minLength\": 1\n },\n \"number\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"person\": {\n \"type\": \"object\",\n \"properties\": {\n \"first_name\": {\n \"type\": \"string\"\n },\n \"last_name\": {\n \"type\": \"string\"\n },\n \"second_name\": {\n \"type\": \"string\"\n },\n \"birth_date\": {\n \"type\": \"string\"\n },\n \"birth_country\": {\n \"type\": \"string\"\n },\n \"birth_settlement\": {\n \"type\": \"string\"\n },\n \"gender\": {\n \"enum\": [\n \"MALE\",\n \"FEMALE\"\n ]\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"no_tax_id\": {\n \"type\": \"boolean\"\n },\n \"tax_id\": {\n \"type\": \"string\"\n },\n \"secret\": {\n \"type\": \"string\"\n },\n \"documents\": {\n \"type\": \"array\"\n },\n \"addresses\": {\n \"type\": \"array\"\n },\n \"phones\": {\n \"type\": \"array\"\n },\n \"authentication_methods\": {\n \"type\": \"array\"\n },\n \"unzr\": {\n \"type\": \"string\"\n },\n \"emergency_contact\": {\n \"type\": \"object\",\n \"properties\": {\n \"first_name\": {\n \"type\": \"string\"\n },\n \"last_name\": {\n \"type\": \"string\"\n },\n \"second_name\": {\n \"type\": \"string\"\n },\n \"phones\": {\n \"type\": \"array\"\n }\n },\n \"required\": [\n \"first_name\",\n \"last_name\",\n \"phones\"\n ]\n },\n \"confidant_person\": {\n \"type\": \"array\"\n },\n \"preferred_way_communication\": {\n \"enum\": [\n \"email\",\n \"phone\"\n ]\n }\n },\n \"required\": [\n \"first_name\",\n \"last_name\",\n \"birth_date\",\n \"birth_country\",\n \"birth_settlement\",\n \"gender\",\n \"no_tax_id\",\n \"tax_id\",\n \"secret\",\n \"documents\",\n \"addresses\",\n \"emergency_contact\"\n ]\n },\n \"patient_signed\": {\n \"type\": \"boolean\"\n },\n \"process_disclosure_data_consent\": {\n \"type\": \"boolean\"\n }\n },\n \"required\": [\n \"person\",\n \"patient_signed\",\n \"process_disclosure_data_consent\"\n ]\n}\n","type":"text"}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate confidant person","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that person age < prm.global_parameters.no_self_auth_age check existence of confidant_person","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return (422, 'Confidant person is mandatory for children') in case of validation fails","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate confidant person age >= prm.global_parameters.no_self_auth_age","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return (422, 'Incorrect person age for such an action') in case of validation fails","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate \"tax_id\"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tax_id","type":"text","marks":[{"type":"strong"}]},{"text":" has validation pattern - `^[0-9]{10}$`","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if doesn't match, return error 422 \"string does not match pattern ...\"","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Check \"no_tax_id\" flag","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If \"no_tax_id\"= true, tax_id field should be empty, in case error return 422","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If \"no_tax_id\"=false and age>14, tax_id should be present, in case error return 422","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Check \"patient_signed\" flag","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If \"patient_signed\" is not present in request, return 422 (\"required property patient_signed was not present\")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If \"patient_signed\"=true in request, return 422 (\"value is not allowed in enum\")","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate person documents","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issued_at, issued_by is mandatory for documents","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate dates","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issued_at <= now() and issued_at => birth_date","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" in case `issued_at > now()` show error 422, \"Document issued date should be in the past\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" in case `issued_at < person.birth_date` show error 422, \"Document issued date should greater than person.birth_date \"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"expiration_date > now()","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" in case error show 422, \"Document expiration_date should be in future\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"expiration_date is mandatory for document_type","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NATIONAL_ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COMPLEMENTARY_PROTECTION_CERTIFICATE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PERMANENT_RESIDENCE_PERMIT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REFUGEE_CERTIFICATE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TEMPORARY_CERTIFICATE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TEMPORARY_PASSPORT","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, \"expiration_date is mandatory for document_type $.documents.type\"","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate documents_type.number according to json schema ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PASSPORT - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NATIONAL_ID - `^[0-9]{9}$`","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BIRTH_CERTIFICATE - `^((?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\\\/()-]){2,25}$`","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"COMPLEMENTARY_PROTECTION_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REFUGEE_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TEMPORARY_CERTIFICATE - `^(((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{4,6}|[0-9]{9}|((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{5}\\\\/[0-9]{5})$`","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TEMPORARY_PASSPORT - `^((?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\\\/()-]){2,25}$`","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]},{"text":"unzr","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}},{"type":"strong"}]},{"text":" exists and is not null, check pattern match ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]},{"text":"\"^[0-9]{8}-[0-9]{5}$\"","type":"text","marks":[{"type":"code"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, msg 'string does not match pattern \\\"%{pattern}\\\"'","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if documents.type=NATIONAL_ID","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"check if unzr exists in request, in case error return 422, msg \"unzr is mandatory for document type NATIONAL_ID\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Document numbersmaxLength < 25 ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Search pending person requests","type":"text"}]},{"type":"paragraph","content":[{"text":"Search persons request in ","type":"text"},{"text":"IL_DB.person_requests","type":"text","marks":[{"type":"strong"}]},{"text":" to prevent requests duplication:","type":"text"}]},{"type":"codeBlock","content":[{"text":"WHERE IL_DB.person_requests.data.person.tax_id = :($.person_requests.person.tax_id)\n AND IL_DB.person_requests.data.person.documents.number = :($.person_requests.person.documents.number)\n AND IL_DB.person_requests.status IN ('NEW', 'APPROVED')","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if tax_id is null","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"WHERE IL_DB.person_requests.data.person.documents.number = :($.person_requests.person.documents.number)\n AND IL_DB.person_requests.data.person.first_name = :($.person_requests.person.first_name)\n AND IL_DB.person_requests.data.person.last_name = :($.person_requests.person.last_name)\n AND IL_DB.person_requests.status IN ('NEW', 'APPROVED')","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Cancel person request","type":"text"}]},{"type":"paragraph","content":[{"text":"Change status of all found person requests:","type":"text"}]},{"type":"codeBlock","content":[{"text":"SET IL_DB.person_requests.status = 'CANCELED'\nWHERE IL_DB.person_requests.id IN (:LIST)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Search pending declaration requests","type":"text"}]},{"type":"paragraph","content":[{"text":"Search declarations in ","type":"text"},{"text":"IL_DB.declaration_requests","type":"text","marks":[{"type":"strong"}]},{"text":" to prevent requests duplication:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if tax_id is not null","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"WHERE IL_DB.declaration_requests.data.person.tax_id = :($.person_requests.person.tax_id)\n AND IL_DB.declaration_requests.status IN ('NEW', 'APPROVED')","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if tax_id is null","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"WHERE IL_DB.declaration_requests.data.person.documents.number = :($.person_requests.person.documents.number)\n AND IL_DB.declaration_requests.status IN ('NEW', 'APPROVED')\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If found declaration request - don't create person request. Return error \"This person already has a declaration request\"","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Search person","type":"text"}]},{"type":"paragraph","content":[{"text":"We are looking for a person to prevent duplication of a person:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We create pairs of new person with people from clusters(tax_id, phone_number and number of the document) and send to the model.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case deduplication model gave score < PERSON_ONLINE_DEDUPLICATION_MATCH_SCORE, create new person","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"else return error 409, \"such person exists. Update this person.","type":"text"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate phone number limit","type":"text"}]},{"type":"paragraph","content":[{"text":"USE_PHONE_NUMBER_AUTH_LIMIT is a flag in ehealth.charts that shows whether we count phones or not.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case person is found, person_id will be saved to person_request, and person has the same authentication_methods.phone_number, we do not count phone numbers and do not compare the phone number with global_parameters.phone_number_auth_limit. So that we can update person, but still can not use phone over limit.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In case person is not found","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check if (SELECT count(*) from persons where authentication_methods::json->0->>'phone_number'='$.phone_number' and persons.status='active' and is_active=true)= prm.global_parameters.no_self_auth_age years","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, msg \"Incorrect person age for such an action\"","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Person.auth_methods.type = third_persont.id. But on get ","type":"text"},{"text":"Person request","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"Person","type":"text","marks":[{"type":"code"}]},{"text":" display third_person.auth_method.phone_number.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If person > prm.global_parameters.no_self_auth_age and he must have one of auth.method.type (OTP OR OFFLINE). Also person may use new endpoint ","type":"text"},{"text":"Append auth methods","type":"text","marks":[{"type":"code"}]},{"text":" to add additional auth_methods.type = ","type":"text"},{"text":"third_person.","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Don't validate auth_method.phone_number exists in verification.verified_phone.","type":"text"}]},{"type":"paragraph","content":[{"text":"Save person request","type":"text"}]},{"type":"paragraph","content":[{"text":"Insert record to IL.person_requests in status ","type":"text"},{"text":"'NEW'","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Processing","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generate upload URL","type":"text"}]},{"type":"paragraph","content":[{"text":"Depending on the payload system generates list of ","type":"text"},{"text":"signed","type":"text","marks":[{"type":"link","attrs":{"href":"https://cloud.google.com/storage/docs/access-control/signing-urls-manually"}}]},{"text":" urls for document scan-copies upload.","type":"text"}]},{"type":"paragraph","content":[{"text":"Signed URLs to be expired after some period of time","type":"text"},{"text":" (","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4d995a41-8f20-45f7-baa1-f0c0bc2f1ded"}}]},{"text":"configurable","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"5ef02694-ccc3-4f40-9571-f9a3c87e4df6"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4d995a41-8f20-45f7-baa1-f0c0bc2f1ded"}}]},{"text":" `","type":"text"},{"text":"SECRETS_TTL","type":"text","marks":[{"type":"strong"}]},{"text":"`). If it has been expired - new person request should be created.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each link is generated for one one-page document in .pdf, .jpg, .png, .bmp format. Document should be no more than 20 MB. For each type of documents, if couple of rules worked - only one single link is generated.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate flag no_tax_id, if $.person_request.person.no_tax_id = true:","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.no_tax_id","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate if $.person_request.person.tax_id is not empty and $.person_request.person.no_tax_id = false then","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If (GetBirthDateFromTaxId($.tax_id) != $.birth_date) or (GetGenderFromTaxId($.tax_id) != $.gender) or CheckValidity($.tax_id) = false (i.e. invalid checksum) then","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.tax_id","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate block confidant person. If person.confidant is not null:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL's with type confidant_person.{confidant_person.type}.{$.person_request.person.confidant_person.[:].documents_relationship.[:].type}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL's with type confidant_person.{confidant_person.type}.{$.person_request.person.confidant_person.[:].documents_person.[:].type}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate block of person documents. If one of the documents has document.type = BIRTH_CERTIFICATE_FOREIGN and there is no same document in {$.person_request.person.confidant_person.[:].documents_relationship.[:]}","type":"text"}]},{"type":"paragraph","content":[{"text":"and age < no_self_auth_age then ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.{$.person_request.person.documents.[with type BIRTH_CERTIFICATE_FOREIGN].type}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate block of person documents. If one of the documents has document.type = PERMANENT_RESIDENCE_PERMIT and age >= no_self_auth_age then","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.{$.person_request.person.documents.[with type PERMANENT_RESIDENCE_PERMIT].type}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate authentication_method. If authentication method = OFFLINE or third_person (and this third_person.auth_method = OFFLINE) - ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL's with type person.{$.person_request.person.documents.[:].type} (or Generate URL's with type third_person.{$.third_person.documents.[:].type})","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate unzr. If $.person_request.person.unzr is not empty and first 8 digits of $.person_request.person.unzr != $.person_request.person.birth_date then","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.{$.person_request.person.unzr}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Invoke ","type":"text"},{"text":"Media Content Storage","type":"text","marks":[{"type":"link","attrs":{"href":"https://aelapi.docs.apiary.io/#reference/media-content-storage/secrets/request-a-secret"}}]},{"text":" to generate upload URL for each document obtained by executing logic above","type":"text"}]},{"type":"paragraph","content":[{"text":"IL.person_request.documents structure:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"documents\":[\n {\n \"type\":\"person.no_tax_id\",\n \"url\": \"https://storage.googleapis.com/...\"\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Save documents to DB.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generate verification code","type":"text"}]},{"type":"paragraph","content":[{"text":"Invoke ","type":"text"},{"text":"Initialize OTP","type":"text","marks":[{"type":"link","attrs":{"href":"https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/otp-verification/initialize-otp-verification"}}]},{"text":" to generate one time password and send it to client number. At this stage, the person receives an SMS message to confirm this phone and the consent to create a person.","type":"text"}]},{"type":"paragraph","content":[{"text":"Phone_number: ILperson_request.authentication_method_current.$.authentication_number","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"cURL example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"curl -X POST \\\n http://localhost:4000/verifications \\\n -H 'content-type: application/json' \\\n -d '{\n \"phone_number\": \"+380936235985\"\n}'","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Response structure","type":"text"}]},{"type":"paragraph","content":[{"text":"See on Apiary","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/person-requests/create/update-person-request"}}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"expand","attrs":{"title":"Response example (code: 201)"},"content":[{"type":"codeBlock","content":[{"text":"{\n \"meta\": {\n \"code\": 201,\n \"url\": \"https://example.com/resource\",\n \"type\": \"object\",\n \"request_id\": \"6617aeec-15e2-4d6f-b9bd-53559c358f97#17810\"\n },\n \"data\": {\n \"status\": \"SIGNED\",\n \"id\": \"eeebb86d-5cba-43c9-885b-6482ecaf826b\",\n \"person\": {\n \"id\": \"13001c60-45a0-4b5a-b425-9505e1de18bd\",\n \"first_name\": \"Петро\",\n \"last_name\": \"Іванов\",\n \"second_name\": \"Миколайович\",\n \"birth_date\": \"2009-07-05\",\n \"birth_country\": \"Україна\",\n \"birth_settlement\": \"Вінниця\",\n \"gender\": \"MALE\",\n \"email\": \"email@example.com\",\n \"no_tax_id\": false,\n \"tax_id\": \"3999869394\",\n \"secret\": \"secret\",\n \"documents\": [\n {\n \"type\": \"BIRTH_CERTIFICATE\",\n \"number\": \"АА120518\",\n \"issued_by\": \"Рокитнянським РВ ГУ МВС Київської області\",\n \"issued_at\": \"2017-02-28\",\n \"expiration_date\": \"2027-02-28\"\n }\n ],\n \"addresses\": [\n {\n \"type\": \"RESIDENCE\",\n \"country\": \"UA\",\n \"area\": \"Житомирська\",\n \"region\": \"Бердичівський\",\n \"settlement\": \"Київ\",\n \"settlement_type\": \"CITY\",\n \"settlement_id\": \"b075f148\",\n \"street_type\": \"STREET\",\n \"street\": \"вул. Ніжинська\",\n \"building\": \"15\",\n \"apartment\": \"23\",\n \"zip\": \"02090\"\n }\n ],\n \"phones\": [\n {\n \"type\": \"MOBILE\",\n \"number\": \"+380503410870\"\n }\n ],\n \"authentication_methods\": [\n {\n \"type\": \"THIRD_PERSON\",\n \"phone_number\": \"+380508887700\",\n \"value\": \"c282f8a9-e709-40aa-94b4-dde1402bf4b6\",\n \"alias\": \"husband\"\n }\n ],\n \"unzr\": \"20090705-00011\",\n \"emergency_contact\": {\n \"first_name\": \"Петро\",\n \"last_name\": \"Іванов\",\n \"second_name\": \"Миколайович\",\n \"phones\": [\n {\n \"type\": \"MOBILE\",\n \"number\": \"+380503410870\"\n }\n ]\n },\n \"confidant_person\": [\n {\n \"relation_type\": \"PRIMARY\",\n \"first_name\": \"Петро\",\n \"last_name\": \"Іванов\",\n \"second_name\": \"Миколайович\",\n \"birth_date\": \"1972-10-26\",\n \"birth_country\": \"Україна\",\n \"birth_settlement\": \"Вінниця\",\n \"gender\": \"MALE\",\n \"tax_id\": \"2659719350\",\n \"secret\": \"secret\",\n \"unzr\": \"19900101-00099\",\n \"preferred_way_communication\": \"email\",\n \"documents_person\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"АА120518\",\n \"expiration_date\": \"2021-02-28\",\n \"issued_by\": \"Рокитнянським РВ ГУ МВС Київської області\",\n \"issued_at\": \"2017-02-28\"\n }\n ],\n \"documents_relationship\": [\n {\n \"type\": \"BIRTH_CERTIFICATE\",\n \"number\": \"АА120518\",\n \"issued_by\": \"Рокитнянським РВ ГУ МВС Київської області\",\n \"issued_at\": \"2017-02-28\"\n }\n ],\n \"phones\": [\n {\n \"type\": \"MOBILE\",\n \"number\": \"+380503410870\"\n }\n ],\n \"email\": \"emaill@example.com\"\n }\n ],\n \"preferred_way_communication\": \"email\"\n },\n \"patient_signed\": false,\n \"process_disclosure_data_consent\": true,\n \"channel\": \"MIS\",\n \"authorize_with\": \"cc949559-5dfe-420f-ac05-065e443b2cc6\"\n },\n \"urgent\": {\n \"authentication_method_current\": [\n {\n \"type\": \"OTP\",\n \"phone_number\": \"+38093*****85\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"PASSPORT\",\n \"url\": \"https://storage.ehealth.world\"\n }\n ]\n }\n}","type":"text"}]}]},{"type":"expand","attrs":{"title":"Response example (code: 422)"},"content":[{"type":"codeBlock","content":[{"text":"{\n \"meta\": {\n \"code\": \"422\",\n \"url\": \"https://example.com/resource\",\n \"type\": \"object\",\n \"request_id\": \"6617aeec-15e2-4d6f-b9bd-53559c358f97#17810\"\n },\n \"error\": {\n \"type\": \"unverified\",\n \"message\": \"Unverified phone number\"\n }\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Update person request","type":"text"}]},{"type":"paragraph","content":[{"text":"To update the data of an existing person use an endpoint `","type":"text"},{"text":"Create/Update person request","type":"text","marks":[{"type":"link","attrs":{"href":"https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/person-requests"}}]},{"text":"`.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is necessary to transfer the same json as when creating person, only to transfer the id of an existing person and do not transfer the block with the authentication methods.","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"person.id","type":"text","marks":[{"type":"code"}]},{"text":" is in request then ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate person.id is UUID","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"search person by person.id in MPI ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, \"such person doesn't exist\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"search persons in mpi (","type":"text"},{"text":"Пошук персон. Версія 3","type":"text","marks":[{"type":"link","attrs":{"href":"http://e-health-ua.atlassian.net/wiki/spaces/EH/pages/583404050"}}]},{"text":")","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate person be deduplication model (if score > PERSON_ONLINE_DEDUPLICATION_UPDATE_SCORE, then add mpi_id to person request)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"else return error 409, \"Such person can't be updated. New person should be created instead\" ","type":"text"}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Update person’s data with empty value of the ","type":"text"},{"text":"second name","type":"text","marks":[{"type":"em"}]},{"text":" is possible by setting ","type":"text"},{"text":"second_name = null","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Authorize","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify the validity of access token","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check user scope ","type":"text"},{"text":"person_request:write","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" in order to perform this action","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Request data validation","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate request","type":"text"}]},{"type":"paragraph","content":[{"text":"Validate request using JSON schema","type":"text"}]},{"type":"expand","attrs":{"title":"JSON Schema"},"content":[{"type":"codeBlock","content":[{"text":"{\n \"$schema\": \"http://json-schema.org/person_request/schema#\",\n \"definitions\": {\n \"phone\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: PHONE_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^\\\\+38[0-9]{10}$\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"name\": {\n \"type\": \"string\",\n \"pattern\": \"^(?!.*[ЫЪЭЁыъэё@%&$^#])[a-zA-ZА-ЯҐЇІЄа-яґїіє0-9№\\\\\\\"!\\\\^\\\\*)\\\\]\\\\[(._-].*$\"\n },\n \"person_name\": {\n \"type\": \"string\",\n \"pattern\": \"^(?!.*[ЫЪЭЁыъэё@%&$^#])[А-ЯҐЇІЄа-яґїіє\\\\'\\\\-]+(\\\\s(?!.*[ЫЪЭЁыъэё@%&$^#])[А-ЯҐЇІЄа-яґїіє\\\\'\\\\-]+)*$\",\n \"minLength\": 1,\n \"maxLength\": 255\n },\n \"unzr\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{8}-[0-9]{5}$\"\n },\n \"tax_id\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{10}$\",\n \"minLength\": 10,\n \"maxLength\": 255\n },\n \"no_tax_id\": {\n \"type\": \"boolean\",\n \"description\": \"Status person refused tax_id\"\n },\n \"gender\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: GENDER\",\n \"maxLength\": 255\n },\n \"address\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: ADDRESS_TYPE\"\n },\n \"country\": {\n \"type\": \"string\"\n },\n \"area\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"region\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"settlement\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"settlement_type\": {\n \"type\": \"string\",\n \"description\": \"settlement type Dictionary: SETTLEMENT_TYPE\"\n },\n \"settlement_id\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$\"\n },\n \"street_type\": {\n \"type\": \"string\",\n \"description\": \"street type Dictionary: STREET_TYPE\"\n },\n \"street\": {\n \"$ref\": \"#/definitions/name\"\n },\n \"building\": {\n \"type\": \"string\",\n \"pattern\": \"^[1-9]((?![ЫЪЭЁыъэё])()([А-ЯҐЇІЄа-яґїіє \\\\/\\\\'\\\\-0-9])){0,20}$\"\n },\n \"apartment\": {\n \"type\": \"string\"\n },\n \"zip\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{5}$\"\n },\n \"inserted_by\": {\n \"type\": \"string\"\n },\n \"updated_by\": {\n \"type\": \"string\"\n },\n \"inserted_at\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"type\",\n \"country\",\n \"area\",\n \"settlement\",\n \"settlement_type\",\n \"settlement_id\",\n \"inserted_by\",\n \"updated_by\"\n ],\n \"additionalProperties\": false\n },\n \"series_number_document\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"PASSPORT\",\n \"COMPLEMENTARY_PROTECTION_CERTIFICATE\",\n \"REFUGEE_CERTIFICATE\",\n \"TEMPORARY_CERTIFICATE\"\n ],\n \"description\": \"Dictionary: DOCUMENT_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$\"\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"number_document\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"BIRTH_CERTIFICATE\",\n \"TEMPORARY_PASSPORT\"\n ],\n \"description\": \"Dictionary: DOCUMENT_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^(?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\\\/()-]+$\",\n \"minLength\": 1,\n \"maxLength\": 255\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"id_card\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"NATIONAL_ID\"\n ],\n \"description\": \"Dictionary: DOCUMENT_TYPE\"\n },\n \"number\": {\n \"type\": \"string\",\n \"pattern\": \"^[0-9]{9}$\"\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n },\n \"document_relationship\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"description\": \"Dictionary: DOCUMENT_RELATIONSHIP_TYPE\",\n \"minLength\": 1\n },\n \"number\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_by\": {\n \"type\": \"string\",\n \"minLength\": 1\n },\n \"issued_at\": {\n \"type\": \"string\",\n \"format\": \"date\"\n }\n },\n \"required\": [\n \"type\",\n \"number\"\n ],\n \"additionalProperties\": false\n }\n },\n \"type\": \"object\",\n \"properties\": {\n \"person\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"first_name\": {\n \"type\": \"string\"\n },\n \"last_name\": {\n \"type\": \"string\"\n },\n \"second_name\": {\n \"type\": \"string\"\n },\n \"birth_date\": {\n \"type\": \"string\"\n },\n \"birth_country\": {\n \"type\": \"string\"\n },\n \"birth_settlement\": {\n \"type\": \"string\"\n },\n \"gender\": {\n \"enum\": [\n \"MALE\",\n \"FEMALE\"\n ]\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"no_tax_id\": {\n \"type\": \"boolean\"\n },\n \"tax_id\": {\n \"type\": \"string\"\n },\n \"secret\": {\n \"type\": \"string\"\n },\n \"documents\": {\n \"type\": \"array\"\n },\n \"addresses\": {\n \"type\": \"array\"\n },\n \"phones\": {\n \"type\": \"array\"\n },\n \"unzr\": {\n \"type\": \"string\"\n },\n \"emergency_contact\": {\n \"type\": \"object\",\n \"properties\": {\n \"first_name\": {\n \"type\": \"string\"\n },\n \"last_name\": {\n \"type\": \"string\"\n },\n \"second_name\": {\n \"type\": \"string\"\n },\n \"phones\": {\n \"type\": \"array\"\n }\n },\n \"required\": [\n \"first_name\",\n \"last_name\",\n \"phones\"\n ]\n },\n \"confidant_person\": {\n \"type\": \"array\"\n },\n \"preferred_way_communication\": {\n \"enum\": [\n \"email\",\n \"phone\"\n ]\n }\n },\n \"required\": [\n \"first_name\",\n \"last_name\",\n \"birth_date\",\n \"birth_country\",\n \"birth_settlement\",\n \"gender\",\n \"no_tax_id\",\n \"tax_id\",\n \"secret\",\n \"documents\",\n \"addresses\",\n \"emergency_contact\"\n ]\n },\n \"patient_signed\": {\n \"type\": \"boolean\"\n },\n \"process_disclosure_data_consent\": {\n \"type\": \"boolean\"\n }\n },\n \"required\": [\n \"person\",\n \"patient_signed\",\n \"process_disclosure_data_consent\"\n ]\n}\n","type":"text"}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate documents, confidant_person, flag ","type":"text"},{"text":"no_tax_id","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Validate ","type":"text"},{"text":"documents","type":"text","marks":[{"type":"link","attrs":{"href":"https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/589266986#IL.Createpatientrequest(w/odeclaration)-Validatepersondocuments"}}]},{"text":", ","type":"text"},{"text":"flag","type":"text","marks":[{"type":"link","attrs":{"href":"https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/589266986/Create+Update+person+request#Check-%22no_tax_id%22-flag"}}]},{"text":" `no_tax_id`, ","type":"text"},{"text":"confidant_person","type":"text","marks":[{"type":"link","attrs":{"href":"https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/589266986#IL.Createpatientrequest(w/odeclaration)-Validateconfidantperson"}}]},{"text":" as on Create person request ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate authorize_with","type":"text"}]},{"type":"paragraph","content":[{"text":"The person can pass the id of his auth_method which he wants to confirm the update of the request. The necessary auth method can be found by making ","type":"text"},{"text":"Get person's auth methods","type":"text","marks":[{"type":"link","attrs":{"href":"https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/persons/get-person-authentication-methods"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate auth_method.id is UUID","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"search auth method in MPI.person_authentication_method","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, \"such authentication method doesn't exist\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"search auth method of this person where MPI.person_authentication_method.person_id = $.person.id","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, \"such authentication method does not belong to this person\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate that auth_method.type = NA","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in case error return 422, \"Сannot be confirmed by a method with type= NA. Use a different method.\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"validate that this method is active ( authentication_method.ended_at > now() and is_active = true)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This field is optional and set in il.person_reques.authentication_method_current.","type":"text"}]},{"type":"paragraph","content":[{"text":"If person request doesn't have this field, then choose that method which is returned from mpi as ","type":"text"},{"text":"person's default method","type":"text","marks":[{"type":"link","attrs":{"href":"https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/622133300/Determination+of+a+default+authentication+method"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Save person request","type":"text"}]},{"type":"paragraph","content":[{"text":"Insert record to IL.person_request in status ","type":"text"},{"text":"'NEW'. ","type":"text","marks":[{"type":"strong"}]},{"text":"Person_id from request save in field ","type":"text"},{"text":"mpi_id","type":"text","marks":[{"type":"code"}]},{"text":" in IL.person_request","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Search pending person requests","type":"text"}]},{"type":"paragraph","content":[{"text":"Search persons request in ","type":"text"},{"text":"IL_DB.person_requests","type":"text","marks":[{"type":"strong"}]},{"text":" to prevent requests duplication:","type":"text"}]},{"type":"codeBlock","content":[{"text":"WHERE IL_DB.person_requests.data.person.id = :($.person_requests.person.id)\n AND IL_DB.person_requests.status IN ('NEW', 'APPROVED')","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Cancel person requests","type":"text"}]},{"type":"paragraph","content":[{"text":"Change status of all found person requests:","type":"text"}]},{"type":"codeBlock","content":[{"text":"SET IL_DB.person_requests.status = 'CANCELED'\nWHERE IL_DB.person_requests.id IN (:LIST)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"Person can't update tax_id. (He can update tax_id from null to tax_id or from null to null).","type":"text"}]},{"type":"paragraph","content":[{"text":"Also person can update birth_date ","type":"text"},{"text":"if it validates with tax_id","type":"text","marks":[{"type":"strike"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validate auth_method_current","type":"text"}]},{"type":"paragraph","content":[{"text":"Set default auth method of person on IL.auth_method_request.auth_method_current - use ","type":"text"},{"text":"function","type":"text","marks":[{"type":"link","attrs":{"href":"https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/622133300/Determination+of+a+default+authentication+method"}}]},{"text":" in mpi, that return default auth method","type":"text"}]},{"type":"paragraph","content":[{"text":"Validate that auth_method_current !=NA","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Processing","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generate upload URL","type":"text"}]},{"type":"paragraph","content":[{"text":"Depending on the payload system generates list of ","type":"text"},{"text":"signed","type":"text","marks":[{"type":"link","attrs":{"href":"https://cloud.google.com/storage/docs/access-control/signing-urls-manually"}}]},{"text":" urls for document scan-copies upload.","type":"text"}]},{"type":"paragraph","content":[{"text":"Signed URLs to be expired after some period of time (","type":"text"},{"text":"configurable","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/edenlabllc/ael.api/blob/develop/docs/ENVIRONMENT.md"}}]},{"text":" `","type":"text"},{"text":"SECRETS_TTL","type":"text","marks":[{"type":"strong"}]},{"text":"`). If it has been expired - new person request should be created.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each link is generated for one one-page document in jpeg format. Document should be no more than 10MB. For each type of documents only one single link is generated.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate flag no_tax_id, if $.person_request.person.no_tax_id = true:","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.no_tax_id","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate if $.person_request.person.tax_id is not empty and $.person_request.person.no_tax_id = false then","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If (GetBirthDateFromTaxId($.tax_id) != $.birth_date) or (GetGenderFromTaxId($.tax_id) != $.gender) or CheckValidity($.tax_id) = false (i.e. invalid checksum) then","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.tax_id","type":"text","marks":[{"type":"strike"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate block confidant person. If person.confidant is not null:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URLs with type confidant_person.{confidant_person.type}.{$.person_request.person.confidant_person.[:].documents_relationship.[:].type}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URLs with type confidant_person.{confidant_person.type}.{$.person_request.person.confidant_person.[:].documents_person.[:].type}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate block of person documents. If one of the documents has document.type = BIRTH_CERTIFICATE_FOREIGN and there is no same document in {$.person_request.person.confidant_person.[:].documents_relationship.[:]}","type":"text"}]},{"type":"paragraph","content":[{"text":"and age < no_self_auth_age then ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.{$.person_request.person.documents.[with type BIRTH_CERTIFICATE_FOREIGN].type}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate block of person documents. If one of the documents has document.type = PERMANENT_RESIDENCE_PERMIT and age >= no_self_auth_age then","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.{$.person_request.person.documents.[with type PERMANENT_RESIDENCE_PERMIT].type}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate authentication_method. If authentication method = OFFLINE or third_person (and this third_person.auth_method = OFFLINE) - ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URLs with type person.{$.person_request.person.documents.[:].type} (or Generate URL's with type third_person.{$.third_person.documents.[:].type})","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validate unzr. If $.person_request.person.unzr is not empty and first 8 digits of $.person_request.person.unzr != $.person_request.person.birth_date then","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate URL with type person.{$.person_request.person.unzr}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]}]}]}]}]}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"{\n \"documents\":[\n {\n \"type\":\"person.no_tax_id\",\n \"url\": \"https://storage.googleapis.com/...\"\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Save documents to DB.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generate verification code","type":"text"}]},{"type":"paragraph","content":[{"text":"Invoke ","type":"text"},{"text":"Initialize OTP","type":"text","marks":[{"type":"link","attrs":{"href":"https://uaehealthapi.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/otp-verification/initialize-otp-verification"}}]},{"text":" to generate one time password and send it to client number. At this stage, the person receives an SMS message to confirm updating a person's data.","type":"text"}]},{"type":"paragraph","content":[{"text":"Phone_number: MPI.person_authentication_method where person_id = $person_request.persin_id and is_primary = True","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"cURL example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"curl -X POST \\\n http://localhost:4000/verifications \\\n -H 'content-type: application/json' \\\n -d '{\n \"phone_number\": \"+380958697084\"\n}'","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"HTTP status codes","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"87eccf3c-f09b-4043-b177-a980078e6934"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP status code","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[272.0]},"content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"What caused the error","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.0]},"content":[{"type":"paragraph","content":[{"text":"201","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[272.0]},"content":[{"type":"paragraph","content":[{"text":" Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.0]},"content":[{"type":"paragraph","content":[{"text":"409","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[272.0]},"content":[{"type":"paragraph","content":[{"text":"Invalid legal entity type","type":"text"}]},{"type":"paragraph","content":[{"text":"Such person exists. Update this person","type":"text"}]},{"type":"paragraph","content":[{"text":"Such person can't be updated. Deduplication update score is lower than system value (less changes should be made)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.0]},"content":[{"type":"paragraph","content":[{"text":"422","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[272.0]},"content":[{"type":"paragraph","content":[{"text":"Unverified phone number","type":"text"}]},{"type":"paragraph","content":[{"text":"Such a phone already exists more N times","type":"text"}]},{"type":"paragraph","content":[{"text":"Confidant person is mandatory for children","type":"text"}]},{"type":"paragraph","content":[{"text":"Incorrect person age for such an action","type":"text"}]},{"type":"paragraph","content":[{"text":"String does not match pattern ...","type":"text"}]},{"type":"paragraph","content":[{"text":"Required property patient_signed was not present","type":"text"}]},{"type":"paragraph","content":[{"text":"Value is not allowed in enum","type":"text"}]},{"type":"paragraph","content":[{"text":"Document issued date should be in the past","type":"text"}]},{"type":"paragraph","content":[{"text":"Document issued date should greater than person.birth_date","type":"text"}]},{"type":"paragraph","content":[{"text":"Document expiration_date should be in future","type":"text"}]},{"type":"paragraph","content":[{"text":"Expiration_date is mandatory for document_type $.documents.type","type":"text"}]},{"type":"paragraph","content":[{"text":"Unzr or birthdate are not correct","type":"text"}]},{"type":"paragraph","content":[{"text":"Unzr is mandatory for document type NATIONAL_ID","type":"text"}]},{"type":"paragraph","content":[{"text":"This phone number is present more then $.global_parameters.phone_number_auth_limit times in the system","type":"text"}]},{"type":"paragraph","content":[{"text":"Such person doesn't exist","type":"text"}]},{"type":"paragraph","content":[{"text":"Such authentication method doesn't exist","type":"text"}]},{"type":"paragraph","content":[{"text":"Cannot be confirmed by a method with type= NA. Use a different method.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported