Загальні відомості про сервіс 0.3 - зміни порівняно з 0.2
(getCompositionRequest) Повернувся обʼєкт motherInfo - під ним агреговано опційні UNZR і DRFO
(getCompositionResponse) Додано обʼєкт Request, який повністю дублює дані вхідного запиту
(getCompositionResponse) Дані про адресу надання послуг обʼєднано в обʼєкт ChildAdressBirth
(getCompositionResponse) Додано placeOfBirthID - код КОАТУУ місця надання послуг
identityDocument опустився на один рівень вкладення і має бути частиною motherInfo
identityDocument став 0..1, а його атрибути documentNumber і passportTypeID - 1
Загальні відомості про сервіс 0.2 - зміни порівняно з 0.1
(getCompositionRequest) Прибрано IdentityDocument.no_tax_id - не використовується
(getCompositionRequest) Прибрано motherInfo.schema_birthDate - не використовується
(getCompositionResponse) Додано DocOfBirth.ChildDocOrgName - відповідає legalEntity.name
(getCompositionResponse) Додано набір параметрів стосовно місця надання сервісу ChildBirthState ChildBirthRegion ChildBirthDistrict ChildBirthLocalityType ChildBirthLocality
(getCompositionRequest) додано параметр UNZR
Загальні відомості про сервіс
Сервіс створюється на стороні системи єЗдоровʼя ЗСЗУ МОЗ України з метою одержання інформації про наявність медичного висновку про народження, виданого певній особі зазначеній у цьому висновку.
На стороні сервісів ДРАЦС і Дія створюється клієнт, за допомогую якого передається номер медвисновку і набір атрибутів, які характеризують за якими атрибутами і документами ідентифіковано особу, для якої виконується запит медвисновку.
Вхідні параметри сервісу
Вміст елементу getCompositionRequest
№ | Код параметру в системі єЗдоровʼя | Рівень вкладеності | Код параметру згідно WSDL | Спосіб, тип заповнення даних | Опис параметру | Обовʼязкове(так/ні) |
---|---|---|---|---|---|---|
1 | 1 | DocOfBirth | object | 1 | ||
2 | Composition.Title | 2 | ChildDocNumb | string | Ідентифікатор медичного висновку, що використовуються для ручних операцій визначення | 1 |
3 | motherInfo | object | Відомості про матір | 1 | ||
4 | tax_id | 2 | tax_RNOKPP | string | РНОКПП (за наявності) | 0..1 |
5 | unzr | 2 | UNZR | string | УНЗР | 0..1 |
6. | Composition.focus.person.document | 2 | IdentityDocument | object | 0..1 | |
7 | document.serial | 3 | documentSerial | string | серія документа (за наявності) | 0..1 |
8 | document.number | 3 | documentNumber | string | номер документа | 1 |
9 | document.type | 3 | passportTypeID | integer | Довідник ДРАЦС. | 1 |
Вихідні параметри сервісу
Вміст елементу getCompositionResponse
...
№ | Код параметру в системі єЗдоровʼя | Рівень вкладеності | Код параметру згідно WSDL | Спосіб, тип заповнення даних | Опис параметру | Обовʼязкове(так/ні) |
---|---|---|---|---|---|---|
1 | 1 | GetCompositionRequest | object | Копія обʼєкту запиту, який надійшов | 1 | |
2 | 2 | DocOfBirth | object | 1 | ||
3 | 3 | ChildDocNumb | string | Ідентифікатор медичного висновку, що використовуються для ручних операцій визначення | 1 | |
4 | 2 | motherInfo | object | Відомості про матір | 1 | |
5 | 3 | tax_RNOKPP | string | РНОКПП (за наявності) | 0..1 | |
6 | 3 | UNZR | string | УНЗР | 0..1 | |
7 | 3 | IdentityDocument | object | 0..1 | ||
8 | 4 | documentSerial | string | серія документа (за наявності) | 0..1 | |
9 | 4 | documentNumber | string | номер документа | 1 | |
10 | 4 | passportTypeID | integer | Довідник ДРАЦС. | 1 | |
11 | Composition | 1 | DocOfBirth | object | Ідентифікатор в системі медичний висновків | 1 |
12 | відповідає Type | 2 | ChildDocName | string | завжди константа “Медичне свідоцтво про народження дитини” | 1 |
13 | Title | 2 | ChildDocNumb | string | Номер документу | 1 |
14 | Date | 2 | ChildDocDate | date (рррр-мм-дд) | Дата видачі документу медичного висновку | 1 |
15 | legalEntity.name | 2 | ChildDocOrgName | string | Назва органу, що видав документ | 1 |
16 | Composition.subject | 1 | childInfo | object | M/F - медично визначена стать дитини при народженні | 1 |
17 | Person.gender | 2 | schema_gender | string | хлопчик має значення: дівчинка має значення: | 1 |
18 | 2 | ChildAddressBirth | object | Адреса місця надання медичних послуг | ||
19 | 3 | placeOfBirthID | string | код адміністративно-територіальної одиниці – код населеного пункту | 0..1 | |
20 | 3 | ChildBirthState | string | Назва країни | 0..1 | |
21 | division.addresses.area | 3 | ChildBirthRegion | string | Назва області | 0..1 |
22 | division.addresses.region | 3 | ChildBirthDistrict | string | Назва району | 0..1 |
23 | division.addresses.settlement_type | 3 | ChildBirthLocalityType | string | Тип населеного пункту | 0..1 |
24 | division.addresses.settlement | 3 | ChildBirthLocality | string | Назва населеного пункту (у тому числі м. Київ та м. Севастополь) | 0..1 |
25 | Person.birth_date | 2 | schema_birthDate | date (рррр-мм-дд) | Дата народження | 1 |
26 | 1 | ehealth:faultCode | int | Код статусу опрацювання системою єЗдоровʼя | 1 | |
27 | 1 | ehealth:Composition | bytes | Файловий p7s обʼєкт закодований base64, який відповідає документу медичного висновка, підписаний КЕП лікаря | 1 |
Коди помилок обробки запиту
№ | Код помилки | Опис помилки |
---|---|---|
1 | 404 | Медичний висновок не знайдено за параметрами наданими у запиті |
2 | 403 | У доступі до медичного висновку відмовлено за наданими параметрами матері |
3 | 400 | Помилка обробки вхідного запиту у випадку відсутності достатньої кількості обовʼязкових параметрів |
4 | 500 | Внутрішня помилка опрацювання на стороні сервісу медичних висновків |
5 | 200 | Висновок успішно знайдено і надано відповідний результат |
Опис структури обʼєкту Composition
Файл надається в полі eheatlh:Composition, закодований base64, контент представляє собою файловий конейнер p7s- файловий обʼєкт підписаний КЕП за методом внутрішнього підпису (дані і підпис в одному файлі).
...