Vefþjónustur SFR - komureikningur
Vefþjónustur SÍ - SFR
Föll sem viðskiptavinir geta sent SÍ eru móttekin í gegnum SOAP-umslag.
Umslag sfr Umslag fyrir upplýsingar tengdar ýmsum lækniskostnaði og útreikningi á komugjöldum. Upplýsingar sem fara á milli grunnkerfa SÍ og kerfa viðskiptavina SÍ.
Prófunarumhverfi : https://huld.sjukra.is/p/sfr Schema skilgreining : https://huld.sjukra.is/p/sfr?wsdl
Ath:.
Tegund gilda eru annað hvort N = númer S=strengur D=Dagsetning. Tala innan sviga eftir tegund segir til um mögulega hámarksstærð þeirra. ( dæmi: N(10) er allt að 10 stafa tala).
Dagsetningasvæði eru á forminu yyyy-mm-dd
[ ] utan um tegundarskilgreiningu svæði merkir að svæði sé valkvætt.
Efnisyfirlit
Vefþjónustur SÍ - SFR Efnisyfirlit 1. Umslag : sfr 1.1. profun 1.2. stadasjuklings 1.3. vistaskjal 2. Schema: Reikningur komugjalda 3. Skýringar við xml-tög 4. Skema 5. Stoðgögn 5.1. Villulisti 5.2. Staða sjúklings : tafla 5.3. Þjónustuflokkar sjúkrahúsa 5.4. Þjónustflokkar heilsugæslu (hér bætist oft nýtt við með nýjum sendendum) 5.5. TR-kóði: 6. SFR-soap köll 6.1. SFR-profun 6.2. SFR-stadasjuklings 6.3. SFR-vistaskjal 6.4. profun: 6.5. stadasjuklings: 6.6. vistaskjal: 6.7. Skema:
1. Umslag : sfr
Sjá: http://huld.sjukra.is:8887/sfr?wsdl (fá prófunarslóð staðfesta hjá SÍ)
1.1. profun
Prófunarfall til að prófa hvort samskipti eru í lagi
Heiti Tegund Skýring svæðis
Inntak sendandi S(100) Einkenni raunverulegs sendanda ef verið er að senda gögn fyrir hönd einhvers annars annars autt/sleppt.
starfsmadur S(50) Einkenni starfsmanns sendanda ef sendandi er útfylltur annars autt/sleppt.
Úttak
tokst N(1) 1 ef móttaka tókst, 0 annars
villulysing S(1000) Lýsing á villu ef móttaka tókst ekki. Geta verið kerfisvillur innan kerfa SÍ eða athugasemd á inntak skeytis.
radnumer_si N(10) Einkvæmt raðnúmer sem SÍ gefur sendingunni. (Í tilviki þ.s. tokst = 0 og radnumer hefur gildið \-1 þá hefur SÍ ekki náð að gefa skeyti raðnúmeri).
1.2. stadasjuklings
Fall sem svarar til um greiðsluþátttöku SÍ vegna sjúklings gagnvart lækniskostnaði eða komugjalda.
Heiti svæðis Tegund Skýring
Heiti svæðis Tegund Skýring
Inntak
sendandi S(100) Einkenni raunverulegs sendanda ef verið er að senda gögn fyrir hönd einhvers annars annars autt/sleppt.
kennitala S(10) Kennitala sjúklings.
dagsetning D Dagsetning afgreiðslu. ATH. Ekki notað þar sem skeytið skilar aðeins nýjustu upplýsingum.
Úttak
tokst N(1) 1 ef móttaka tókst, 0 annars
villulysing S(1000) Lýsing á villu ef móttaka tókst ekki. Geta verið kerfisvillur innan kerfa SÍ eða athugasemd á inntak skeytis.
radnumer_si N(10) Einkvæmt raðnúmer sem SÍ gefur sendingunni. (Í tilviki þ.s. tokst = 0 og radnumer hefur gildið \-1 þá hefur SÍ ekki náð að gefa skeyti raðnúmer).
inniliggjandi N(1) 1=Sjúklingur er skráður inniliggjandi á afgreiðsludegi, 0 annars.
sjukratryggdur N(1) Svarar til um hvort sjúklingur sé sjúkratryggður á Íslandi á afgreiðsludegi. 1= já, 0=nei.
skyringsjukratryggdur S(100) Ef sjukratryggdur inniheldur gildið 0=nei þá er nánar útskýrt í orðum hversvegna sjúklingur er ekki sjúkratryggður.
afslattarkort N(10) 0 = Á ekki afsláttarkort sem gildir á afgreiðsludegi annars inniheldur númer afsláttakorts sem gildir á afgreiðsludegi.
stada S(4) Staða einstaklings vegna greiðsluþátttöku SÍ.
ALM Almenn staða.
ATVL Atvinnulaus.
BARN Barn yngri en 18 ára.
BAUM Börn með umönnunarkort.
EL67 Aldraðir I. 67-69 með skertan eða engan lífeyrir.
ELLI Aldraðir II. 70 ára og eldri.
GRAT* 60-69 ára sem njóta óskerts ellilífeyris, þ.m.t. sjómenn eða 67-69 ára sem voru örorkulífeyrisþegar fram til 67 ára aldurs.
OROR Örorkulífeyrisþegar.
1.3. vistaskjal
Vistar SÍ skjal af ákveðinni tegund.
Heiti svæðis Tegund Skýring Inntak
sendandi S(100) Einkenni raunverulegs sendanda/afgreiðslustöð. Má vera textastrengur eða númer viðskiptamanns.
Númer viðskiptamanns fæst uppgefið hjá SÍ. Ef sendur er textastrengur þá þarf hann að vera forskráður
hjá SÍ (sem mappar strenginn yfir í viðskiptamannanúmer í töflum SÍ). Ef sent er númer, þá þarf það að vera til hjá SÍ.
tegundskjals N(4) Tegund af SÍ skjali samkvæmt skilgreiningu SÍ.
Komureikningar eru nr. 473
470 = sérfræðireikningur.
skjal skjal-xml SÍ skjal samkvæmt skilgreiningu SÍ.
Úttak
tokst N(1) 1 ef móttaka tókst, 0 annars. Ef 0 er vistun hafnað.
villulysing S(1000) Lýsing á villu ef móttaka tókst ekki. Geta verið kerfisvillur innan kerfa SÍ eða athugasemd á inntak skeytis.
radnumer_si N(10) Einkvæmt raðnúmer sem SÍ úthlutar sendingunni. (ef tókst = 0 og SÍ náði ekki að úthluta númer þá hefur gildið \-1).
skjalanumer_si N(10) Einkvæmt skjalanúmer sem skjali er úthlutað ef vistun tókst.
villulisti Fylki Fylki af villum ef villur eru gögnum í innsendu xml skjali (Ef tokst = 0).
-- linunumer N(4) raðnúmer á villum þ.e. frá 1..n
-- villa N(1) 1=villa
-- Tegundvillu S(20) fasti tegundar af villu sem SÍ gefur villunni.
-- villulysing S(1000) Lýsing á villu.
2. Schema: Reikningur komugjalda
Hér fyrir neðan er lýsing (WSDL) á reikningi komugjalda, eins og senda á xml-skjal í fallinu vistaskjal. 3. Skýringar við xml-tög
Hér fyrir neðan er xml-skrá með tilbúnum gildum sýnd ásamt skýringum. Athugið að sendandi getur með viðeigandi hugbúnaði sannreynt xml-snið á skeyti ÁÐUR en það er sent til SÍ með því að vísa í viðeigandi skema skrá. Dæmi um vísun sem er þá sett í haus xml-skeytis:
Xml-tög Skýringar
að vera skráð í mínus og vísun í fyrri reikning kemur hér.
Ef t.d. draga á SED23422 til baka, þá er tilvisun_bakfaerslu = SED23422 og nrKvittunar gæti þá t.d. verið SED23423
4. Skema
Upplýsingar um skema þurfa að fylgja þessu skjali: Subversion\SKJ\trunk\Ytri_skil\documentxml\doc_reikningur_komugjalda.xsd
5. Stoðgögn
5.1. Villulisti
Auk þess að athugað er með schemu eru gerðar nokkrar fleiri athuganir á gögnum áður en móttaka á þeim eru samþykktar. Ef í ljós kemur að um villu er að ræða er þeim skilað í villulista.
Tegund villu Villuskýring
c_skjt473_kerfi Villa í kerfum SÍ c_skjt473_xml_r Villa við lestur úr xml-skeyti
c_skjt473_xml_w Villa við skráningu gagna skv. xml-skeyti
c_skjt473_raf_w Villa við skráningu skjals skv. xml-skeyti
c_skjt473_raf_a Villa við að skrifa haus reiknings
c_skjt473_raf_b Villa við að skrifa línur reiknings
c_skjt473_kennt Villa við kennitölu
c_skjt473_bakf Villa við móttöku bakfærslu
5.2. Staða sjúklings : tafla
Raðnúmer gjaldflokks Staða sjúklings -- kóði Lýsing
102 UTL1 Útlendingur m/afsl
103 UTL2 Útlendingur m.m./afsl (börn, ellilífeyrisþegi)
1 ALM Almenn koma
2 ELLI Ellilífeyrisþegi
3 BARN Barn
4 STFM Starfsmaður
5 OROR Örorkulífeyrisþegi
6 OSJU Ósjúkratryggður
101 VIST Vistmaður á annari sjúkrastofnun
8 ATVL Atvinnulaus
10 EL67 Aldraður 67-69 ára
11 BAUM Barn með umönnunarkort
12 GRAT Einstaklingur framvísar gráa kortinu
5.3. Þjónustuflokkar sjúkrahúsa
Þjónustu-flokkur Heiti Gildir frá Gildir til Raðnúmer LSH-númer Gjaldaliður skv. gjaldskrá SÍ
021 Hlutur sjúklings í reikningi sérfræðings 01.01.2008 31.12.2010 16 -2 1000000
022 Nýkomugjald/bráðamóttaka/slysastofugjald 01.01.2008 31.12.2010 17 1 1000103
023 Rannsóknargjald 01.01.2008 31.12.2010 18 3 1100101
024 Röntgengjald 01.01.2008 31.12.2010 19 4 2200101
025 Læknisþjónusta í Neyðarbíl 01.01.2008 31.12.2010 20 7 1000103
026 Hjúkrunarmóttaka 01.01.2008 31.12.2010 21 121 1000104
027 Koma á göngudeild vegna þjónustu annarra 01.01.2008 31.12.2010 22 181 1000104 en lækna
028 Koma til Iðjuþjálfara 01.01.2008 31.12.2010 23 381 1000104
029 Innöndun 01.01.2008 31.12.2010 24 402 1000104
030 Heyrnarmæling 01.01.2008 31.12.2010 25 404 1000104
031 Kransæða\- og hjartaþræðing 01.01.2008 31.12.2010 26 741 1000303 032 Keiluskurðaðgerð 01.01.2008 31.12.2010 27 743 1000302
033 Koma til sálfræðings 01.01.2008 31.12.2010 28 921 1000104
034 Beinþéttnimæling 01.01.2008 31.12.2010 29 1001 1000105
035 Lyfjagjöf 01.01.2008 31.12.2010 30 1067 1000104
5.4. Þjónustflokkar heilsugæslu (hér bætist oft nýtt við með nýjum sendendum)
Þjónustuflokkur Heiti Gildir frá Gildir til Gjaldaliður SÍ Á við
121 Hlutur sjúklings í reikningi sérfræðings 01.01.2010 31.12.2100 1000000 Heilsugæslu
122 Komugjald 01.01.2010 31.12.2100 1000101 Heilsugæslu
125 Koma utan dagvinnutíma 01.01.2010 31.12.2100 1000201 Heilsugæslu
126 Vitjun 01.01.2010 31.12.2100 1000102 Heilsugæslu
127 Vitjun utan dagvinnutíma 01.01.2010 31.12.2100 1000202 Heilsugæslu
123 Rannsókn 01.01.2010 31.12.2100 1100101 Heilsugæslu
124 Röntgen 01.01.2010 31.12.2100 2200101 Heilsugæslu
5.5. TR-kóði:
Dæmi um það hvernig sendendur geta nýtt sér TR_code
TR_code Heiti Athugasemdir við þessi 4 dæmi:
3 Rannsóknargjald Finnst ekki hjá SÍ
32000 Lungu Finnst ekki hjá TR
5400301 Geðlækning, 1/2 klst. hvert skipti Finnst
1 Komugjald á Slysa\- og bráðadeild Finnst ekki hjá TR
6. SFR-soap köll
Hægt er að nota Wget hugbúnaðinn til að prófa skeytin. Sjá: http://www.gnu.org/software/wget/ http://gnuwin32.sourceforge.net/packages/wget.htm
6.1. SFR-profun
$ wget -o reply.log -O reply.html --post-file sfr-profun.xml https://huld.sjukra.is/p/sfr -v --no-check-certificate $ cat reply.html
$ wget -o reply.log -O reply.html --post-file sfr-stadasjuklings.xml [https://huld.sjukra.is/p/sfr -v \ --no-check-certificate; $ cat reply.html
6.3. SFR-vistaskjal
$ wget -o reply.log -O reply.html --post-file sfr-vistaskjal.xml [https://huld.sjukra.is/p/sfr -v --no-check-certificate; $ cat reply.html
ATH:wget póstar XML skjölin á vefþjónustuna, no-check-certificate er til þess að þurfa ekki að setja inn certificate-ið huld.sjukra.issfr-profun.xml inniheldur sýnidæmið fyrir prófunar falliðsfr-stadasjuklings.xml inniheldur sýnidæmið fyrir stadasjulkings falliðsfr-vistaskjal.xml inniheldur sýnidæmið fyrir vistaskjal fallið
Um upplýsingar varðandi aðgang (lykill1, lykill2 o.s.frv.) þá vinsamlegast snúið ykkur til þjónustumiðstöðvar SÍ.
6.4. profun:
6.5. stadasjuklings:
6.6. vistaskjal:
[ Skref sem voru tekin í XmlSPy hugbúnaðarforritinu til að prófa þessa skrá:
-> þessa slóð þarf að fá staðfesta hjá SÍ: http://huld.sjukra.is:8887/sfr?wsdl c) Kóðinn hér að neðan skráður inn d) Valrönd -> SOAP -> Send request to server
Þetta skema var í gildi 28.júní 2011: