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

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

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

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

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

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

Відмінність від сервісу PublicGetComposition

В сервіс PublicGetCompositionV2 в порівнянні із сервісом PublicGetComposition:

  • додано інформацію про статус медичного висновку до вихідних параметрів на PublicGetCompositionResponse;

  • змінено фільтрацію за статусом при пошуку медичного висновка: виконується пошук МВ в усіх статусах (AMENDED, ENTERED_IN_ERROR, FINAL), окрім PRELIMINARY.

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

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

№

Код параметру в системі єЗдоровʼя

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

Код параметру згідно 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

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

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

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

№

Код параметру в системі єЗдоровʼя

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

Код параметру згідно 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

status

2

Status

string

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

1

19

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

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

  • No labels

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