Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Загальні відомості про сервіс 0.3 - зміни порівняно з 0.2

  1. (getCompositionRequest) Повернувся обʼєкт motherInfo - під ним агреговано опційні UNZR і DRFO

  2. (getCompositionResponse) Додано обʼєкт Request, який повністю дублює дані вхідного запиту

  3. (getCompositionResponse) Дані про адресу надання послуг обʼєднано в обʼєкт ChildAdressBirth

  4. (getCompositionResponse) Додано placeOfBirthID - код КОАТУУ місця надання послуг

  5. identityDocument опустився на один рівень вкладення і має бути частиною motherInfo

  6. identityDocument став 0..1, а його атрибути documentNumber і passportTypeID - 1

Загальні відомості про сервіс 0.2 - зміни порівняно з 0.1

  1. (getCompositionRequest) Прибрано IdentityDocument.no_tax_id - не використовується

  2. (getCompositionRequest) Прибрано motherInfo.schema_birthDate - не використовується

  3. (getCompositionResponse) Додано DocOfBirth.ChildDocOrgName - відповідає legalEntity.name

  4. (getCompositionResponse) Додано набір параметрів стосовно місця надання сервісу ChildBirthState ChildBirthRegion ChildBirthDistrict ChildBirthLocalityType ChildBirthLocality

  5. (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 - Паспорт громадянина України;
2 - Дипломатичний паспорт України;
4 - Посвідчення особи моряка;
5 - Посвідчення особи на повернення в Україну;
6 - Посвідчення члена екіпажу;
7 - Тимчасове посвідчення громадянина України;
8 - Інший документ;
9 - Службовий паспорт України;
10 - Свідоцтво про народження.

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 - Паспорт громадянина України;
2 - Дипломатичний паспорт України;
4 - Посвідчення особи моряка;
5 - Посвідчення особи на повернення в Україну;
6 - Посвідчення члена екіпажу;
7 - Тимчасове посвідчення громадянина України;
8 - Інший документ;
9 - Службовий паспорт України;
10 - Свідоцтво про народження.

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

хлопчик має значення:
«http://purl.org/linked-data/sdmx/2009/code#sex-M»

дівчинка має значення:
«http://purl.org/linked-data/sdmx/2009/code#sex-F»

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
base64

Файловий p7s обʼєкт закодований base64, який відповідає документу медичного висновка, підписаний КЕП лікаря

1

Коди помилок обробки запиту

Код помилки

Опис помилки

1

404

Медичний висновок не знайдено за параметрами наданими у запиті

2

403

У доступі до медичного висновку відмовлено за наданими параметрами матері

3

400

Помилка обробки вхідного запиту у випадку відсутності достатньої кількості обовʼязкових параметрів

4

500

Внутрішня помилка опрацювання на стороні сервісу медичних висновків

5

200

Висновок успішно знайдено і надано відповідний результат

Опис структури обʼєкту Composition

Файл надається в полі eheatlh:Composition, закодований base64, контент представляє собою файловий конейнер p7s- файловий обʼєкт підписаний КЕП за методом внутрішнього підпису (дані і підпис в одному файлі).

...