Komunikační rozhraní SEP 1.6

STAPRO s. r. o., Pernštýnské náměstí 51, 530 02 Pardubice držitel certifikátu systému řízení kvality dle ISO 9001:2000 a certifikátu environmentálního systému řízení dle ISO 14001:2004

NEMOCNIČNÍ INFORMAČNÍ SYSTÉM

Komunikační rozhraní SEP 1.6

Petr Siblík

KOMPLEXNÍ

STAPRO s.r.o.,

Specifikace „Komunikační rozhraní SEP 1.3“

strana

1


Úvod ................................................................................................................................... 3 1.1. Nové vlastnosti v SEP 1.6 ........................................................................................... 3 1.1.1. Maximální úhrada ZP v okamžiku preskripce ..................................................... 3 1.1.2. Úhrada ZP a úhrada pacientem v okamžiku výdeje ............................................. 4 1.2. Nové vlastnosti v SEP 1.5 ........................................................................................... 4 1.2.1. Předepsaný lék je v pozitivním listu .................................................................... 4 1.3. Nové vlastnosti v SEP 1.4 ........................................................................................... 4 1.3.1. Předpis léčebného přípravku doporučil ................................................................ 4 1.4. Nové vlastnosti v SEP 1.3 ........................................................................................... 4 1.4.1. Opakovací recepty ................................................................................................ 4 1.4.2. Poukazy na zdravotní pomůcky (PZT) ................................................................. 4 2. Popis komunikačních toků ................................................................................................. 5 2.1. Komunikace modul medikací – SEP ........................................................................... 5 2.1.1. Vytvoření a uložení nového receptu ..................................................................... 5 2.1.2. Vytvoření a uložení nového poukazu na PZT ...................................................... 6 2.1.3. Zrušení receptu, poukazu ..................................................................................... 7 2.2. Komunikace lékárna – SEP ......................................................................................... 8 2.2.1. Načtení receptu či poukazu ze SEP ...................................................................... 8 2.2.2. Záznam výdeje ..................................................................................................... 9 2.2.3. Zrušení výdeje .................................................................................................... 10 Příloha A – vzory XML souborů.............................................................................................. 11 1. Žádost o přiřazení nových ID pro položky receptu ....................................................... 11 2. Odeslání receptu do SEP ............................................................................................... 11 3. Zrušení receptu v SEP ................................................................................................... 12 4. Načtení receptu ze SEP ................................................................................................. 12 5. Info o výdeji .................................................................................................................. 13 6. Zrušení výdeje ............................................................................................................... 13 7. Odeslání poukazu do SEP ............................................................................................. 13 Příloha B – varianty připojení klientů k systému SEP ............................................................. 15 1. JMS................................................................................................................................ 15 2. HTTP ............................................................................................................................. 15

KOMPLEXNÍ


1.


strana

2


1.

Úvod

Komunikace probíhá na úrovni protokolu http(s). Veškerá data se přenáší ve formátu XML. Nedílnou součástí tohoto popisu rozhraní je i definiční schéma XML SEP_1_6.xsd.

obr.1 - Schéma komunikací

1.1.

Nové vlastnosti v SEP 1.6

1.1.1.

Maximální úhrada ZP v okamžiku preskripce

V receptu v bloku <polozkarptype> a v poukazu v bloku <polozkapouktype> přibyl nový element <maxuhrzp> typu decimal, který udává maximální úhradu zdravotní pojišťovnou v okamžiku preskripce. Přesná specifikace elementu je v XML schematu SEP_1_6.xsd, který je nedílnou součástí tohoto popisu rozhraní SEP.


strana

3

KOMPLEXNÍ

Komunikační rozhraní konkrétně podporuje následující činnosti, datové toky mezi vyjmenovanými IS:  přenos receptu nebo poukazu z modulu medikací do SEP  načtení receptu nebo poukazu ze SEP na základě identifikačního kódu (ID) po příchodu pacienta do lékárny (ID je vytištěn ve formě čárového kódu na papírovém receptu nebo poukazu)  potvrzení výdeje z IS lékárny do SEP


Komunikační rozhraní SEP 1.6 zajišťuje komplexní přenos informací mezi systémem SEP (systém elektronické preskripce s centrálním úložištěm elektronických receptů a poukazů na prostředky zdravotní techniky), modulem medikací NIS (nemocniční informační systém) popřípadě ambulantního IS a IS lékárny (konkrétně modulu pokladna na kterém dochází k výdeji léků nebo prostředků zdravotní techniky).


1.1.2.

Úhrada ZP a úhrada pacientem v okamžiku výdeje


1.2.1.

Předepsaný lék je v pozitivním listu

V bloku <polozkarptype> přibyl nový element <pozitlist> typu boolean, který udává, jestli předepisovaný lék je v pozitivním listu nemocnice. Přesná specifikace elementu je v XML schematu SEP_1_5.xsd, který je nedílnou součástí tohoto popisu rozhraní SEP.

1.3.


1.3.1.

Předpis léčebného přípravku doporučil

V bloku přibyl nový blok <doporucil> v souladu s vyhláškou 54/2008 odstavec 2 a datovým rozhraním VZP ČR (Doplněk č. 6 k verzi 6.2 – září 2008). Přesná specifikace elementu je v XML schematu SEP_1_4.xsd, který je nedílnou součástí tohoto popisu rozhraní SEP.

1.4.


1.4.1.

Opakovací recepty

SEP ve verzi 1.3 podporuje svým rozhraním i vytváření tzv. opakovacích receptů (dle zákona 378/2007 a následné vyhlášky 54/2008). Do bloku byl vložen nový element . Tento element nepovinný, tedy pokud není, předpokládá se, že jde o klasický recept (s jedním opakováním). Hodnota elementu je číslo udávající počet opakování receptu. Element navíc obsahuje nepovinný atribut „realizovano“ znamenající počet provedených výdejů tohoto receptu (pokud není, předpokládá se, že nebyl realizován ani jeden výdej).

1.4.2.

Poukazy na zdravotní pomůcky (PZT)

Na žádost některých zákazníků byla funkcionalita SEP včetně rozhraní upravena o přenášení poukazů na zdravotní pomůcky. Popis v kapitole 2.1.2 Vytvoření a uložení nového poukazu na PZT. Vzorový XML dokument viz. příloha A.7.


strana

4

KOMPLEXNÍ

1.2.


Ve zprávě o výdeji v elementu přibyly nové atribyty a typu decimal, které udávají úhradu zdravotní pojišťovnou a úhradu pacientem v okamžiku výdeje na recept. Přesná specifikace elementu je v XML schematu SEP_1_6.xsd, který je nedílnou součástí tohoto popisu rozhraní SEP.


2.

Popis komunikačních toků 2.1.

Komunikace modul medikací – SEP

2.1.1.

Vytvoření a uložení nového receptu

Zde je popsán celý proces vytvoření receptu a odeslání nového receptu do systému SEP.

KOMPLEXNÍ

Celý proces se skládá z jednotlivých kroků:  vytvoření receptu ordinujícím lékařem  žádost o přiřazení nových ID pro položky receptu/poukazu – ID je vázána v SEP na položku (ne na celý recept), v rámci systému pak existuje mezi položkami receptu vazba, takže se s položkami receptu pracuje svázaně. Modul medikací musí tedy požádat o tolik ID položek, kolik je jich předepsáno. Žádost o přidělení ID položek může být i na víc jak 2 ID – v rámci modulu medikací může být připravováno a následně uloženo více receptů naráz (vzorový XML dokument viz příloha A.1)  uložení receptu v modulu medikací,  uložení těchto ID k receptům v modulu medikací  odeslání receptu do SEP (vzorový XML dokument viz příloha A.2)  tisk receptu i s čárovým kódem – vytiskne se pouze čárový kód jedné položky (polozka_ID), pro pozdější načtení celého receptu na straně lékárenského IS stačí ID jedné položka receptu, SEP automaticky vrací celý recept (obě položky, pokud má recept 2 položky)


V této kapitole jsou detailně popsány veškeré komunikační toky probíhající mezi modulem medikací v NIS a systémem SEP, včetně vzorových XML souborů.


strana

5

STAPRO s. r. o., Pernštýnské náměstí 51, 530 02 Pardubice

obr. 2 - sekvenční diagram vytvoření a uložení receptu

2.1.2.

Vytvoření a uložení nového poukazu na PZT

Zde je popsán celý proces vytvoření poukazu a odeslání nového poukazu do systému SEP. Celý proces je v podstatě shodný s procesem vytvoření a uložení receptu a je následující:  vytvoření poukazu ordinujícím lékařem  žádost o přiřazení nového ID pro položku poukazu (poukaz na rozdíl od receptu může obsahovat pouze jednu položku). Systém medikací musí tedy požádat o tolik ID položek, kolik je předepsáno poukazů. Žádost o přidělení ID položek – vzorový XML dokument viz. příloha A.1)  uložení poukazu v modulu medikací,  uložení těchto ID k poukazům v modulu medikací  odeslání poukazu do SEP (vzorový XML dokument viz příloha A.7)  tisk poukazu i s čárovým kódem – vytiskne se čárový kód položky (polozka_ID), pro pozdější načtení poukazu na straně lékárenského IS.


strana

6

KOMPLEXNÍ


držitel certifikátu systému řízení kvality dle ISO 9001:2000 a certifikátu environmentálního systému řízení dle ISO 14001:2004


2.1.3.

Zrušení receptu, poukazu

Zde popisovaný proces řeší zrušení receptu či poukazu původním lékařem, který medikaci předepsal. Vzorová XML zpráva viz příloha A.3. Zpráva musí obsahovat tolik elementů s atributem delid, kolik položek se má zrušit (pomocí této zprávy tedy lze smazat pouze jednu položku receptu, všechny položky receptu, položky více receptů naráz, poukaz, více poukazů nebo dokonce kombinaci několika poukazů a položek receptů).


strana

7

KOMPLEXNÍ

obr. 3 - sekvenční diagram vytvoření a uložení poukazu




obr. 4 – sekvenční diagram zrušení receptu

2.2.

Komunikace lékárna – SEP

2.2.1.

Načtení receptu či poukazu ze SEP

KOMPLEXNÍ

V modulu pokladna na lékárně se po přečtení čárového kódu z dokladu (receptu či poukazu) toto načtené ID položky odešle na server SEP za účelem načtení odpovídajícího receptu (viz. vzorový XML dokument v příloze A.4). Server SEP načte odpovídající doklad (recept či poukaz) a vrátí ho zpět do lékárny, popřípadě pokud doklad s položkou daného ID neexistuje, pošle prázdnou odpověď. Žádost o vydání dokladu obsahuje pouze jednou ID položky receptu, SEP vrací ve zprávě vždy celý recept (tedy případně s oběma položkami) nebo poukaz.




strana

8


obr. 5 – sekvenční diagram načtení receptu ze SEP

2.2.2.

Záznam výdeje

KOMPLEXNÍ

Po záznamu výdeje na elektronický recept či poukaz (nebo i více dokladů) se do SEP může odesílat potvrzení výdeje na daný doklad (příklad zprávy – info o výdeji viz příloha A.5.). V této verzi lze pouze zaznamenat příznak, že doklad (jeho položka) byl vydán (+ informace o datu/času vydání a zaplacení regulačního poplatku).



obr. 6 – sekvenční diagram uložení výdeje


strana

9


Zrušení výdeje

Zrušení výdeje – je zde možno poslat jeden nebo více elementů s atributem novydid (no vydané id). Tím je možno zrušit:  jeden řádek výdeje  výdej celého receptu  výdej více položek z více receptů Příklad zprávy je v příloze A.6.

KOMPLEXNÍ

obr. 7 – sekvenční diagram zrušení výdeje


2.2.3.


strana

10


Příloha A – vzory XML souborů


Žádost o přiřazení nových ID pro položky receptu nebo poukazu

žádost o nová ID (numid) <med v="1.6">

nová ID (newid) <med v="1.6">

2.

Odeslání receptu do SEP

uložení receptu (recept) <med v="1.6"> 2007-05-16 10:21:00 <ean>FM12346

<mistorv> false 5

111 <pacient> 7512255344 <jmenopac>Josef Vonásek Svážná 56, Kunratice 123 00 731535302 false false 72931087 <jmenolek>MUDr. Jaroslav Bolíto 501 541556897 3222111


strana

11

KOMPLEXNÍ

1.


<pracoviste>Chirurgie I. Ambulance 501 12345678 Nemocnice na kraji města 001234 <polozka_rp> 10871 I 0013359 R03CC13 SPIROPENT <mnoz>1 0.02MG TBL NOB 0-0-1 P92.4 1 <prekrocmaxdav> true <pozn> <stav>P <pozitlist>true <maxuhrzp>0

Medikační SW nečeká na odpověď.

3.

Zrušení receptu v SEP

zrušení receptu (delid)

KOMPLEXNÍ

<med v=„1.6“>

Medikační SW nečeká na odpověď.

4.

Načtení receptu ze SEP

žádost o data receptu (id) <med v=„1.6“>

odpověď recept Zpráva s receptem, která je poslána na SEP je stejná jako zpráva recept odesílaná medikačním SW k uložení do SEP (příloha A.2). recept nenalezen – SEP vrací prázdný element med: <med v="1.6" />




strana

12


5.

Info o výdeji

6.

Zrušení výdeje

zpráva zrušení výdeje (novydid) <med v="1.6">

7.

Odeslání poukazu do SEP

uložení poukazu <med v="1.6"> <poukaz> 2008-07-05 12:31:00 <ean>FM12347

false 210 <pacient> 7005293141 <jmenopac>Pavel Kudlička 12345678 <jmenolek>MUDr. Voštěp 501 32221111 501 87654321 <polozka_pouk> 10972 I 0062950 04 ORTÉZA KOLENNÍ S BOČNÍMI DLAHAMI RHENA <doplnek>BEZ NASTAVENÍ FLEXE, ROZEPÍNACÍ VEL.S-XXL <mnoz>1


strana

13

KOMPLEXNÍ

<med v="1.6">


zpráva info o výdeji (vydid)


KOMPLEXNÍ


P92.4 true true 24 <poznámka> text poznámky, například u některých pomůcek upřesnění rozměrů či co <maxuhrzp>0


strana

14


Příloha B – varianty připojení klientů k systému SEP

Pro komunikaci mezi klienty a serverem byl využit software SonicMQ verze 7.5, který zajišťuje messaging mezi klienty a serverem SEPu na bázi protokolu JMS verze 1.1. SonicMQ 7.5 umožňuje přenos dat po šifrovaném SSL/TLS kanálu, navíc slouží jako datová sběrnice pro SonicESB, lze jej tedy dále rozšířit o webservices založené na protokolu SOAP. Software nutný pro funkci elektronické komunikace - stanice: Progress 9.1D  Client networking

2. HTTP

KOMPLEXNÍ

Systém SEP ve verzi 1.6 umožňuje také výměnu XML dokumentů (dle výše uvedeného popisu) pomocí protokolu HTTP. V těle zprávy je tak odesílán XML dokument <med v="1.6">…


1. JMS


strana

15

Komunikační rozhraní SEP 1.6

Recommend Documents