Vefþjónustur SFR - Komureikningur
Total Page：16
File Type：pdf, Size：1020Kb
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: <rafr tegund="11" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="C:\doc_reikningur_komugjalda.xsd"> doc_reikningur_komugjalda.xsd innihéldi þá skema-skrána sem er birt hér að neðan. Xml skrá með tilbúnum gildum og skýringum: Xml-tög Skýringar <?xml version='1.0' encoding='ISO-8859-1'?> <rafr tegund='12'> Tegund 12 .. reyndar ónotað enn ( 06.12.2010 ) <sjuklingur> Sjúklingur hefst -- einn sjúklingur tilgreindur í skeyti <laeknir1>412</laeknir1> Læknisnúmer skv. númerakerfi landlæknis. <kt>1213129999</kt> Kennitala sjúklings <gjaldflokkur>1</gjaldflokkur> Sjá raðnúmer gjaldflokks í töflunni: 'Staða sjúklings' <afslattarkort>false</afslattarkort> Ef korti framvísað, þá true annars false, eða 1 annars 0 <medferd_dags>2010-02-09</medferd_dags> Meðferðardagsetning (form YYYY-MM-DD) <nrKvittunar>SED23422</nrKvittunar> Einkvæmt númer úr kerfi sendanda <tilvisun_bakfaerslu></tilvisun_bakfaerslu> Ef ætlunin er að bakfæra reikning, verða öll viðeigandi gildi (fjöldi,komur,krónur) 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 <heildarverdsum>16160.625</heildarverdsum> Heildarverð á reikningi (kvittun) <afslattursum>6000</afslattursum> Afsláttur sem sjúklingi er veittur vegna kortaréttinda <serstakurafslattursum>410</serstakurafslattursum> Annar afsláttur sem sjúklingi er veittur (t.d. námundun læknis/ vinagreiði annað ) <hlutisjuklingssum>9750.625</hlutisjuklingssum> Raunhluti sjúklings sem hann greiðir úr eigin vasa <lina> Upplýsingar um meðferð <thjonustuflokkur>024</thjonustuflokkur> Þjónustuflokkur (sjá töflu) Ef gjaldaliður á ekki við kort, þá 000 <medferdserfraedings>1</medferdserfraedings> Ef meðferð sérfræðings = 1, annars 0, eða true/false <TR_code>62600</TR_code> Vísun í númer hjá TR ef sérfræðimeðferð <heiti>Mjaðmagrind</heiti> Heiti gjaldaliðar <fjoldi_koma>1</fjoldi_koma> Fjöldi koma (alltaf 1 ennþá) <fjoldi_eininga>21.00</ fjoldi_eininga > Fjöldi eininga <einingaverd>180.25</einingaverd> Krónuverðið á bak við hverja einingu <samtals>3785.25</samtals> Heildarverð þessa þjónustuflokks </lina> </sjuklingur> </rafr> 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