Загальні відомості про сервіс
Сервіс створюється на стороні системи єЗдоровʼя ЗСЗУ МОЗ України з метою одержання інформації про наявність медичного висновку(далі - МВ) будь-якого типу, виданого певній особі зазначеній у цьому МВ.
На стороні сервісів Дія створюється клієнт, за допомогою якого передається номер МВ і набір атрибутів, які характеризують за якими атрибутами і документами ідентифіковано особу, для якої виконується запит МВ.
Загальний спосіб використання(приклад): співробітник університету хоче перевірити, чи справді студенту виписувалась довідка(висновок) про тимчасову непрацездатність.
Вхідні параметри сервісу
Вміст елементу 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 |
Вихідні параметри сервісу
Вміст елементу 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 | |
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 | Документ наданий для авторизації, але його номер не відповідає даним в реєстрі пацієнтів |