Oppgjørsmodul. Import. Pasienttransport. 05.oktober 2010

Transkript

1 Oppgjørsmodul Import Pasienttransport 05.oktober 2010 Leif Weldingsvei 20. Postboks 2087, 3202 Sandefjord Tel Fax

2 Innholdsfortegnelse 1 PasientTransport og oppgjør Xml Layout ORGSENDER OG ORGRECEIVER MSG Msg MsgFirst MsgLast ORDERDATAREPORT Order agreement ordertime route Tilkobling INNLEVERING AV OPPGJØR Kontaktpersoner Eksempel på oppgjørs XML OPPGJØR MED ÉN TUR, MED ÉN PASSASJER

3 Versjonskontroll Dato Versjon Retting Signatur Nytt Dokument TH Oppdatering etter intern gjennomgang TH Korrigerte feilstaving TH La inn liste med oppgjørskontor TH Kun SUTI turer skal med (s.4) BLS Nye oppgjørskontor lagt til i tabell (s.5) TH Korrigerte skrivefeil i forbindelse med TH frikort og la inn informasjon vedrørende skjema La inn beskrivelse av filstørrelse begrensning. TH - 3 -

4 1 PasientTransport og oppgjør I IKT-løsningen for PasientTransport er det gjort et utvalg på hvilke SUTI meldinger det er behov for å bruke. Disse meldingene benyttes for å sende ut bestilling av reiser og få svar tilbake fra taxi sentral. Oppgjørs XML er basert på tilsvarende terminologi med nødvendige tillegg. Oppgjørs XML skal sendes inn til PasientTransport via den kommunikasjonskanal som er bestemt av prosjektet. Det er laget en skjemafil som alle oppgjør vil bli valert mot ved mottak. Nåværende versjon av skjemafilen heter PT_revI.xsd. Det er kun de turene som er mottatt via SUTI link som skal utgjøre innholdet i oppgjørsfilen. Et oppgjør kan bestå av mer enn én XML fil. For å knytte disse sammen skal de nummereres fortløpende (gjøres i attributtet i tag Msg se beskrivelse nedenfor). Det er først når alle XML filer som tilhører samme oppgjør er sendt inn at oppgjørsdata vil ble generert i PasientTransport. Begrensning: En XML fil må være mindre enn 16MB. Dersom oppgjøret består av data som utgjør mer enn 16 MB, så må xml deles opp i flere selvstendige XML filer, og nummereres som angitt i 2.2 msg

5 2 Xml Layout 2.1 orgsender og orgreceiver Tag orgsender angir den part som sender inn oppgjøret, altså transportøren, og orgreceiver er den part som skal motta oppgjøret, altså PasientTransport. <orgsender name="acme Taxi"> <Org src="111111" ="systemleverandør-eier-link" /> </orgsender> Org src Avsenders organisasjonsnummer SUTI link navnet i riktig format <orgreceiver name="patienttransport"> <Org src="71" ="Locus_PasientTransport_0001" /> </orgreceiver> I feltet src under orgreceiver, skal man legge inn nøkkelverdien til det oppgjørskontor som man ønsker å sende oppgjøret til: Nkl Oppgjørskontor Helse Finnmark HF Oppgjørskontor Helse Mt Oppgjerskontoret Helse Førde HF Oppgjørskontor helse fonna Oppgjørskontoret Helse Stavanger Oppgjørskontor Mosjøen Oppgjørskontor Rjukan Oppgjørskontor UNN HF Oppgjørskontoret - NLSH HF Oppgjørskontoret Buskerud Oppgjørskontoret Helse Bergen HF Oppgjørskontoret Lørenskog Pasientreiser Sørlandet Sykehus PasientreiserTelemark & Vestfold 2.2 msg Dette er den største og viktigste meldingen. Det inneholder hele oppgjøret. Meldingen begynner med å angi meldingstype. <msg msgtype="6999" msgname="orderdatareport"> - 5 -

6 Meldingstype skal allt være 6999 ved innsending av oppgjør. msg msgtype Meldingstype skal allt være msgname Skal allt ha verdien OrderDataReport Msg <Msg src="locus_transporter_0002" =" " /> Msg Src Id SUTI link navnet i riktig format Et unikt oppgjørs MsgFirst <MsgFirst src="locus_transporter_0002" =" " /> MsgFirst Src SUTI link navnet i riktig format Et unikt oppgjørs. Denne benyttes for å angi hvilken ID som ligger på den XML som er den første i serien MsgLast <MsgLast src="locus_transporter_0002" =" " /> MsgLast Src SUTI link navnet i riktig format Et unikt oppgjørs. Denne benyttes for å angi hvilken ID som ligger på den XML som er den siste i serien. I eksempelet over kan man se at oppgjøret består av 3 XML filer, der første har , den andre har , og den tredje har Eksemplet er hentet fra den andre XML filen. Det er viktig når oppgjørs XML sendes inn, så skal de nummereres i stigende rekkefølge. Formatet som skal benyttes er YYYYMMDDnnnnnnnn., altså dagens dato og deretter et 8 sifret løpenummer.xml filer som sendes inn i serie, må være nummerert i rekkefølge. Det må ikke være noen huller i denne rekkefølgen. Eksempel: Dersom 3 oppgjørs XML sendes inn så skal disse være nummerert: Dette er gyldig. Dersom man derimot deler oppgjøret opp i 3 XML filer og gir disse nummer:

7 Så er dette ikke godkjent, for da vil oppgjøret vente på at en xml fil med nummer skal bli sendt inn

8 2.3 orderdatareport Hver tur ligger innfor en orderdatareport tag Order Nå kommer informasjon om den enkelte turen. Order er turens TurId. Dette er den TurId som ble sendt ut til transportøren via SUTI da bestillingen ble mottatt. Verdien kan bli opptil 8 tegn lang <orderdatareport> <Order src="locus_transporter_0001" ="25001" unique="true" /> Order src unique SUTI link navnet i riktig format Turnummer(TurId). Unikt for turen. Turnummeret er et løpenummer som genereres av PasientTransport. Tallet kan bli større enn de 5 sifre som er vist i eksepler her. Systemet må kunne håndtere tall med opptil 8 sifre. Skal ha verdien true for å angi at turnummeret er unikt agreement Mellom PasientTransport og transportør skal det eksistere en avtale. I PasientTransport benyttes en unik avtale kode som knyter transportør og kjørekontor sammen. Avtalekoden hentes fra avtaleregisteret i PasientTransport systemet og baseres på området turen går i. <agreement> <Agreement src="locus_transporter_0001" ="THX-001" /> </agreement> agreement Agreement Id SUTI link navnet i riktig format Avtalekoden ordertime Dato og klokkeslett for når bestillingen ble bekreftet av transportør legges inn i ordertime <ordertime> <time time=" t14:08:08" /> </ordertime> time time Tspunktet da bestillingen ble bekreftet. Legg merke til formatet: YYYY-MM- DDTHH:mm:SS - 8 -

9 2.3.4 route Noden route inneholder alle nodene som er en del av turen. Innenfor route finner man nodene invoice, resourceorder, node; invoice <invoice invoicenumber=" "> <invoicetime> <time time=" t00:00:00" /> </invoicetime> <invoiceprice priceresponsible="client" fixedprice="" totalsocialservicefeereceived="120" totalamount=" "> <invoiceattributes> <Attribute src="200" ="117967" unique="true" /> <Attribute src="201" ="7740" unique="true" /> </invoiceattributes> <manualdescriptionprice sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="other costs get specified here" vehicleconfirmation="" /> </invoiceprice> </invoice> invoice invoicenumber invoice/invoicetime/time Time invoice/invoiceprice priceresponsible fixedprice totalsocialservicefeereceived totalamount Fakturanummer Fakturadato Legg merke til formatet: YYYY-MM- DDTHH:mm:SS Skal allt ha verdien prover Er true dersom prisen er fast, ellers. Summen av alle egenandeler mottatt på denne turen. Total sum med egenandeler fratrukket

10 invoice/invoiceprice/invoiceattributes/attribute/attribute src Angir type kostnad. Attribute gjentas for hver kostnadstype. Følgende kostnadstyper benyttes: 200 Reisens distanse fra første pasient ble hentet til siste pasient ble satt av. Distansen angis i meter. 201 Reisens tsforbruk fra første pasient ble hentet til siste pasient ble satt av. Tsforbruket angis i sekunder. 202 Turens startpris 203 Ventepris 205 Parkering 206 Bompenger 207 Trafikale ventekostnader Angir beløpet for kostnaden. unique Angir om attributten er unik på turen invoice/invoiceprice/manualdescriptionprice sendtoinvoice sendtovehicle sendtooperator manualtext vehicleconfirmation Brukes foreløpig ikke skal være tom streng. False

11 resourceorder Tag resourceorder inneholder informasjon om sjåføren og kjøretøyet. <resourceorder> <vehicle> <Vehicle src="locus_transporter_0002" ="TL-404" unique="true" /> </vehicle> <driver name="hansen, Per"> <Driver src="102" =" " unique="" /> <Driver src="103" ="123-11" unique="" /> </driver> <manualdescriptionresource sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="transporter information" vehicleconfirmation="" /> </resourceorder> resourceorder/vehicle/vehicle Id unique resourceorder/driver name resourceorder/driver/driver src resourceorder/manualdescriptionresource sendtoinvoice sendtovehicle sendtooperator manualtext vehicleconfirmation Løyvenummer Skal allt ha verdien true sen løyvenummer er unikt i Norge Navn på sjåføren 102 angir at verdien i er sjåførens personnummer. 103 angir at verdien i er sjåførens unike. Verdien avhenger av koden i src. False False False Beskrivelse av kjøretøyet. False

12 node Det er 3 typer noder: Passasjer hentet, passasjer framme og passasjer møtte ikke. <node nodeseqno="1" nodetype="1701" =" "> node nodeseqno nodetype Id Nodens nummer. Starter med 1 for den første noden. Angir om noden er en pickup (1701) en destinasjon (1702) eller en bomtur (1703) Rekvisisjonsnummer. Det er ulik informasjon som for de ulike node typene derfor blir de nedenfor beskrevet separat:

13 NodeType pickup (1701) Denne nodetypen benyttes for å angi når passasjeren ble plukket opp. <node nodeseqno="1" nodetype="1701" =" "> <addressnode street="storgaten" streetno="23" streetnoletter="b" location="sandefjord" community="sandefjord" postalno="3210"> <manualdescriptionaddress sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation="" />  </addressnode> <timesnode> <time time=" t14:03:10" /> </timesnode> <contents> <content contenttype="1001" name="hansen, Arne"> <attributecontent> <Attribute src="pt" =="1631"/> <Attribute src="pt" =="100"/> </attributecontent> <manualdescriptioncontent sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation="" /> </content> </contents> </node> node/addressnode street streetno streetnoletter location community postalno Henteadressens gatenavn Henteadressens husnummer Henteadressen undernummer Henteadressens poststed Henteadressens kommune Henteadressens postnummer

14 node/addressnode/manualdescriptionaddress sendtoinvoice sendtovehicle sendtooperator manualtext Tilleggs informasjon vedrørende henteadresse. vehicleconfirmation Noden attribute gjentas for hver adresse attributt som eksisterer. node/addressnode/attributeaddress/attribute/attrbute src Denne har verdien pt for å indikere at koden er laget av PasientTransport. Denne kan ha følgende verdier: 2015 Angir at adressen er et behandlingssted. node/timesnode/time time Klokkeslett da passasjer ble hentet Legg merke til formatet: YYYY-MM- DDTHH:mm:SS node/contents/content contenttype name Har verdien 1001 for å angi at det som ligger i name attribute er passasjer navnet Navnet på passasjeren

15 Noden attribute gjentas for hver transport attributt som eksisterer. contents/content/attributecontent/attribute/attrbute src Denne har verdien pt for å indikere at koden er laget av PasientTransport. Denne kan ha følgende verdier: 100 Angir at pasienten har fritt sykehusvalg 1501 Må bæres 1506 Kvinnelig sjåfør 1507 Mannlig sjåfør 1601 Stasjonsvogn 1606 Barnesete 1611 Manuell rullestol 1612 Liten/lav bil/innstigningshøyde 1614 Rullestolrampe 1615 Rullestolheis 1616 Trappeklatrer 1617 Allergi 1628 Sitte foran 1629 Ligge bak 1630 Ligge foran 1631 Alenebil 1632 Rullestolbil 2314 Ledsager. Det skal finnes ett attribute element for hver ledsager. contents/content/manualdescriptioncontent sendtoinvoice sendtovehicle sendtooperator manualtext vehicleconfirmation Informasjon om passasjer. Leses inn og lagres som transportør informasjon

16 NodeType destination (1702) Denne nodetypen benyttes for å angi når passasjeren var fremme. <node nodeseqno="2" nodetype="1702" =" "> <addressnode addressname="oslo klinikken" street="hegdehaugsv" streetno="5" location="oslo" community="oslo" postalno="0352"> <manualdescriptionaddress sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation=""/> <attributeaddress> <Attribute src="pt" ="2015"/> </attributeaddress> </addressnode> <timesnode> <time time=" t14:03:22"/> </timesnode> <contents> <content contenttype="1001" name="hansen, Tone"> <economycontent> <price priceresponsible="client" fixedprice="" vatincluded="true" price="255"> <taximeter activate="true"> <Taxa src="locus_transporter_0002" =" " unique="true"/> </taximeter> </price> <formofpayment> <payment paymenttype="1307" amount="0"> <Payment src="locus_pasienttransport_0001" =" " unique="true"/> <Currency src="iso4217" ="NOK" unique="true"/> </payment> </formofpayment> </economycontent> </content> </contents> </node>

17 node/addressnode street streetno streetnoletter location community postalno Leveringsadressens gatenavn Leveringsadressens husnummer Leveringsadressen undernummer Leveringsadressens poststed Leveringsadressens kommune Leveringsadressens postnummer node/addressnode/manualdescriptionaddress sendtoinvoice False sendtovehicle False sendtooperator False manualtext Tilleggs informasjon vedrørende henteadresse. vehicleconfirmation False Noden attribute gjentas for hver adresse attributt som eksisterer. node/addressnode/attributeaddress/attribute/attrbute src Denne har verdien pt for å indikere at koden er laget av PasientTransport. Denne kan ha følgende verdier: 2015 Angir at adressen er et behandlingssted. node/timesnode/time time Klokkeslett da passasjer var fremme. Legg merke til formatet: YYYY-MM- DDTHH:mm:SS node/contents/content contenttype name Har verdien 1001 for å angi at det som ligger i name attribute er passasjer navnet Navnet på passasjeren. node/contents/content/economycontent/price priceresponsible fixedprice vatincluded price Skal allt ha verdien prover Angir om rekvisisjonen er basert på en fastpris. Angir om moms er inkludert i prisen Pris for denne passasjeren. node/contents/content/economycontent/price/taximeter activate Denne skal være true for å angi at taksameter kvittering sendes inn

18 node/contents/content/economycontent/price/taximeter/taxa src Suti link riktig format. Taksameter kvittering. unique Allt true. node/contents/content/economycontent/formofpayment/payment paymenttype paymenttype kan være: 1306 Egenandel 1307 Frikort amount Dersom paymenttype = 1306, så lagres egenandels beløpet i amount. Dersom paymenttype = 1307, så vil amount normalt bli 0, men ved fritt sykehusvalg kan vi allikevel få et beløp her selv om passasjeren har frikort. node/contents/content/economycontent/formofpayment/payment/payment src Payment benyttes kun når paymenttype = Src er SUTI link navnet i riktig format unique Frikortnummer Har allt verdien unique node/ contents/content/economycontent/formofpayment/payment/currency src Valutakodestandard Valutakode unique Har allt verdien unique

19 NodeType (bomtur ) Denne nodetypen benyttes for å angi at passasjeren ikke dukket opp og dermed ikke kunne transporteres (bomtur) er helt lik <node nodeseqno="1" nodetype="1703" =" "> <addressnode street="storgaten" streetno="23" streetnoletter="b" location="sandefjord" community="sandefjord" postalno="3210"> <manualdescriptionaddress sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation="" />  </addressnode> <timesnode> <time time=" t14:03:10" /> </timesnode> <contents> <content contenttype="1001" name="hansen, Arne"> <attributecontent> <Attribute src="pt" =="1631"/> <Attribute src="pt" =="100"/> </attributecontent> <manualdescriptioncontent sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation="" /> </content> </contents> </node>

20 node/addressnode street streetno streetnoletter location community postalno Henteadressens gatenavn Henteadressens husnummer Henteadressen undernummer Henteadressens poststed Henteadressens kommune Henteadressens postnummer node/addressnode/manualdescriptionaddress sendtoinvoice sendtovehicle sendtooperator manualtext Tilleggs informasjon vedrørende henteadresse. vehicleconfirmation Noden attribute gjentas for hver adresse attributt som eksisterer. node/addressnode/attributeaddress/attribute/attrbute src Denne har verdien pt for å indikere at koden er laget av PasientTransport. Denne kan ha følgende verdier: 2015 Angir at adressen er et behandlingssted. node/timesnode/time time Klokkeslett da taxi møtte opp for å hente passasjer. Legg merke til formatet: YYYY-MM- DDTHH:mm:SS node/contents/content contenttype name Har verdien 1001 for å angi at det som ligger i name attribute er passasjer navnet Navnet på passasjeren

21 Noden attribute gjentas for hver transport attributt som eksisterer. contents/content/attributecontent/attribute/attrbute src Denne har verdien pt for å indikere at koden er laget av PasientTransport. Denne kan ha følgende verdier: 100 Angir at pasienten har fritt sykehusvalg 1501 Må bæres 1506 Kvinnelig sjåfør 1507 Mannlig sjåfør 1601 Stasjonsvogn 1606 Barnesete 1611 Manuell rullestol 1612 Liten/lav bil/innstigningshøyde 1614 Rullestolrampe 1615 Rullestolheis 1616 Trappeklatrer 1617 Allergi 1628 Sitte foran 1629 Ligge bak 1630 Ligge foran 1631 Alenebil 1632 Rullestolbil 2314 Ledsager. Det skal fines ett attribute element for hver ledsager. contents/content/manualdescriptioncontent sendtoinvoice sendtovehicle sendtooperator manualtext vehicleconfirmation Informasjon om passasjer

22 3 Tilkobling 3.1 Innlevering av oppgjør Det er laget en egen beskrivelse av hvordan oppgjørs XML skal leveres inn til PasientTransport. Denne løsningen er beskrevet på NISSY forumet. 4 Kontaktpersoner Kontaktperson hos Locus er: Tone Hansen Senior Systemutvikler Produkt Leif Weldingsvei 20 Postboks Sandefjord e-post: th@locus.no (sentralbord) (direkte) (telefaks)

23 5 Eksempel på oppgjørs XML 5.1 Oppgjør med én tur, med én passasjer <?xml version="1.0" encoding="utf-8"?> <PT xmlns:xsi=" xsi:nonamespaceschemalocation="file:///c:/j2ee/eclipse_devel/workspace/patienttransportserver_utvikling/settlementxmlinput/pt_reve.xsd"> <orgsender name="transporter"> <Org src="111111" ="Locus_Transporter_0002"/> </orgsender> <orgreceiver name="patienttransport"> <Org src="71" ="Locus_PasientTransport_0001"/> </orgreceiver> <msg msgtype="6999" msgname="orderdatareport"> <Msg src="locus_transporter_0002" =" "/> <MsgFirst src="locus_transporter_0002" =" "/> <MsgLast src="locus_transporter_0002" =" "/> <orderdatareport> <Order src="locus_transporter_0002" ="404" unique="true"/> <agreement> <Agreement src="locus_transporter_0002" ="OT lang"/> </agreement> <ordertime> <time time=" t14:08:08"/> </ordertime> <route> <invoice invoicenumber=" "> <invoicetime> <time time=" t00:00:00"/> </invoicetime> <invoiceprice priceresponsible="client" fixedprice="" totalsocialservicefeereceived="120" totalamount=" ">

24 <invoiceattributes> <Attribute src="200" ="117967" unique="true"/> <Attribute src="201" ="7740" unique="true"/> <Attribute src="202" ="0" unique="true"/> <Attribute src="203" ="10" unique="true"/> <Attribute src="205" ="0" unique="true"/> <Attribute src="206" ="0" unique="true"/> <Attribute src="207" ="0" unique="true"/> </invoiceattributes> <manualdescriptionprice sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="other types of costs get specified here" vehicleconfirmation=""/> </invoiceprice> </invoice>  <resourceorder> <vehicle>  <Vehicle src="locus_transporter_0002" ="TL-404" unique="true"/> </vehicle> <driver name="hansen, Per"> <! is SSN --> <Driver src="102" =" " unique=""/> <! is drivers unique --> <Driver src="103" ="123-11" unique=""/> </driver>  <manualdescriptionresource sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="transporter information" vehicleconfirmation=""/> </resourceorder> <!-- first passenger. is requisition number for passenger

25 1701 is for passenger pickup 1703 is for passenger no show is requisition number --> <node nodeseqno="1" nodetype="1701" =" ">  <addressnode street="storgaten" streetno="23" streetnoletter="b" location="sandefjord" community="sandefjord" postalno="3210">  <manualdescriptionaddress sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation=""/> </addressnode>  <timesnode> <time time=" t14:03:10"/> </timesnode> <contents> <! is for passenger and name is the name of the passenger --> <content contenttype="1001" name="hansen, Arne">  <attributecontent> <Attribute src="pt" ="1501"/> <Attribute src="pt" ="1506"/> </attributecontent> can be used for extra information about passenger. --> <manualdescriptioncontent sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation=""/> </content> </contents> </node> <! is for passenger dropped. is requisition number --> <node nodeseqno="2" nodetype="1702" =" ">  <manualdescriptionaddress sendtoinvoice="" sendtovehicle="" sendtooperator="" manualtext="" vehicleconfirmation=""/> <! indicates that the above address is a treatment center --> <attributeaddress> <Attribute src="pt" ="2015"/>

26 </attributeaddress> </addressnode>  <timesnode> <time time=" t14:03:22"/> </timesnode> <contents> <! is for passenger and name is the name of the passenger --> <content contenttype="1001" name="hansen, Tone">  <economycontent>  <price priceresponsible="client" fixedprice="" vatincluded="true" price="255">  <taximeter activate="true">  <Taxa src="locus_transporter_0002" =" " unique="true"/> </taximeter> </price> <formofpayment>   <payment paymenttype="1307" amount="0"> <Payment src="locus_pasienttransport_0001" =" " unique="true"/>  <Currency src="iso4217" ="NOK" unique="true"/> </payment> </formofpayment> </economycontent> </content> </contents>

27 </node> </route> </orderdatareport> </msg> </PT>