ЕСОЗ - публічна документація

MC - Параметри сервісу PublicGetComposition

Owned by Yevhen Batura NHSU
Last updated: Jun 28, 2024 by Kateryna Haleta (SoE eHealth)
2 min read

 

Загальні відомості про сервіс

Сервіс створюється на стороні ЕСОЗ з метою одержання інформації про наявність медичного висновку (далі - МВ) будь-якого типу, виданого певній особі зазначеній у цьому МВ.

На стороні сервісів Дія створюється клієнт, за допомогою якого передається номер МВ і набір атрибутів, які характеризують за якими атрибутами і документами ідентифіковано особу, для якої виконується запит МВ.

Загальний спосіб використання (приклад): співробітник університету хоче перевірити, чи справді студенту виписувалась довідка (висновок) про тимчасову непрацездатність.

 

Вхідні параметри сервісу

Вміст елементу PublicGetCompositionRequest

№

Код параметру в ЕСОЗ

Рівень вкладеності

Код параметру згідно WSDL
(із зазначенням простору імен)

Спосіб, тип заповнення даних

Опис параметру

Обовʼязкове(так/ні)

1

 

1

MedicalDocument

object

 

1

2

Composition.Title

2

DocNumb

string

Ідентифікатор медичного висновку, що використовуються для ручних операцій визначення

1

3

focus or subject

1

IdentificationInfo

object

Відомості про субʼєкта, якому видано довідку або в деяких випадках пов'язану особу

1

4

tax_id

2

tax_RNOKPP

string

РНОКПП (за наявності)

0..1

5

unzr

2

UNZR

string

УНЗР

0..1

6.

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

Вихідні параметри сервісу

Вміст елементу PublicGetCompositionResponse

 

№

Код параметру в ЕСОЗ

Рівень вкладеності

Код параметру згідно WSDL
(із зазначенням простору імен)

Спосіб, тип заповнення даних

Опис параметру

Обовʼязкове(так/ні)

1

 

1

PublicGetCompositionRequest

object

Копія обʼєкту запиту, який надійшов

1

2

 

2

MedicalDocument

object

 

1

3

 

3

DocNumb

string

Ідентифікатор медичного висновку, що використовуються для ручних операцій визначення

1

4

 

2

IdentificationInfo

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

MedicalDocument

object

Ідентифікатор в системі медичний висновків

1

12

відповідає Type

2

Type

string

значення зі словника типів

1

13

відповідає Category

2

Category

string

значення зі словника категорій

1

13

Title

2

DocNumb

string

Номер документу

1

14

Date

2

DocDate

date (рррр-мм-дд)

Дата видачі документу медичного висновку

1

15

legalEntity.name

2

DocOrgName

string

Назва органу, що видав документ

1

16

event.period.start

2

ValidityPeriodStart

date (рррр-мм-дд)

Початок періоду дії МВ

1

17

event.period.end

2

ValidityPeriodEnd

date (рррр-мм-дд)

Кінець періоду дії МВ

1

18

 

1

ehealth:faultCode

 int

Код статусу опрацювання ЕСОЗ

1

 

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

 

№

Код помилки

Опис помилки

№

Код помилки

Опис помилки

1

404

МВ не знайдено за параметрами наданими у запиті

2

400

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

3

500

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

4

200

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

5

10910

Недостатньо даних авторизації для надання доступу

6

10911

РНОКПП надано для авторизації доступу, але відсутнє в реєстрі пацієнтів

7

10912

РНОКПП надано для авторизації доступу, але не відповідає значенню в реєстрі пацієнтів

8

10913

УНЗР надано для авторизації доступу, але відсутнє в реєстрі пацієнтів

9

10914

УНЗР надано для авторизації доступу, але не відповідає значенню в реєстрі пацієнтів

10

10915

Документ наданий для авторизації доступу не дозволено для авторизації

11

10916

Документ наданий для авторизації, але документ такого типу відсутній в реєстрі пацієнтів

12

10917

Документ наданий для авторизації, але його номер не відповідає даним в реєстрі пацієнтів

 

 

 

ЕСОЗ - публічна документація