MediRund Technische aspecten data aanlevering. Arnold Harbers

Transcriptie

1 MediRund Technische aspecten data aanlevering Arnold Harbers

2 Programma toelichting webservice dia 3-15 foutafhandeling dia 16 technische vragen dia 17 testtraject dia 18

3 Toelichting webservice Webservice rscustomer operatie listexchangepermissionparticipant doel: Opvragen van de veehouders die een dierenarts toestemming hebben gegeven om gegevens uit te wisselen Webservice rshealth operatie addmedicinetransaction doel: Opslag van 1 of meer medicijntransacties van één bedrijf.

4 Operatie - Algemeen Input contextmessage (algemeen, autorisatie) requestmessage (specifiek, functionaliteit) Output responsemessage (specifiek, functionaliteit) servicemessage (algemeen, resultaat verwerking)

5 contextmessage <heal:contextmessage> <com:sessionid>?</com:sessionid> <com:processid>?</com:processid> <com:instanceid>?</com:instanceid> <com:username>?</com:username> <com:usertype>?</com:usertype> <com:password>?</com:password> <com1:organisation> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:organisation> <com1:provider> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:provider> <com1:customer> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:customer> <com1:keeper> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:keeper> <com1:animal> <anim:animalnumber>?</anim:animalnumber> <anim:animalnumbertype>?</anim:animalnumbertype> </com1:animal> <com:processcode>?</com:processcode> <com:messagesource>?</com:messagesource> <com:languagecode>?</com:languagecode> <com:timezone>?</com:timezone> <com1:contextmessagedetail> <com:contextcode>?</com:contextcode> <com:contextvalue>?</com:contextvalue> </com1:contextmessagedetail> <heal:contextmessage> Totale contextmessage noodzakelijke velden voor huidige 2 operaties

6 Vulling contextmessage <com:username> verplicht gebruikersnaam van de dierenarts (UDN..), krijgt de dierenarts via PVV <com:usertype> verplicht vaste vulling, waarde C <com:password> verplicht wachtwoord van de dierenarts welke ook geldt voor de webapplicatie, krijgt de dierenarts via PVV. Let op: als dierenarts in de webapplicatie zijn wachtwoord wijzigt zal dit dus ook doorwerken in de webservice <com1:customer> verplicht <par:participantcode> relatienummer dierenarts, UDN nummer <par:participantcodetype> vaste vulling, waarde UDN

7 Vulling contextmessage <com1:keeper> <par:participantcode> verplicht bij addmedicinetransaction relatienummer veehouder, UBN nummer <par:participantcodetype> vaste vulling, waarde UBN <com:languagecode> niet verplicht taalcode, als je nederlandstalige meldingen wilt hebben dan veld vullen met de waarde nld. Als veld leeg gelaten wordt of met iets anders dan nld gevuld wordt dan krijg je engelstalige meldingen <com:contextcode> verplicht vaste vulling, waarde organisation <com:contextvalue> vaste vulling, waarde crv.nl verplicht

8 servicemessage Algemeen bericht, geeft resultaat van de verwerking <heal:servicemessage> <com:servicestatus>?</com:servicestatus> <com:messagecode>?</com:messagecode> <com:messagetext>?</com:messagetext> <com:messagetype>?</com:messagetype> <com:sourcetype>?</com:sourcetype> <com:sourcecode>?</com:sourcecode> <com1:servicemessagedetail> <com:servicestatus>?</com:servicestatus> <com1:codedetail> <com:keyid>?</com:keyid> <com:keyvalue>?</com:keyvalue> </com1:codedetail> <com:messagecode>?</com:messagecode> <com:messagetext>?</com:messagetext> <com:messagetype>?</com:messagetype> </com1:servicemessagedetail> </heal:servicemessage> Belangrijkste veld Ook van belang

9 servicemessage <com:servicestatus> 0 succesvol <0 technische fout >0 functionele fout <com:messagetext> Melding behorend bij de servicestatus Indien servicestatus > 0 <com1:codedetail> uit servicemessagedetail bevat identificatie van het record wat de fout veroorzaakt

10 listexchangepermissionparticipant requestmessage: exchangepermissionrequest <cus:customer> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> </cus:customer> <cus1:productcode>?</cus1:productcode> <cus:referenceperiod> <com:begindate>?</com:begindate> <com:enddate>?</com:enddate> </cus:referenceperiod> <cus1:participantevent>?</cus1:participantevent> <cus:customer> relatienummer veearts: idem aan <customer> uit contextmessage <cus1:productcode> vaste vulling, waarde DURDD <com:begindate> filter op begindatum van de machtiging optioneel, niet gevuld dan datum vandaag <cus1:participantevent> vaste vulling, waarde 1

11 listexchangepermissionparticipant responsemessage: exchangepermissionparticipant <par1:participant> UBN nummer veehouder <cus1:permissionbegindate> begindatum machtiging <cus1:permissionenddate> einddatum machtiging indien leeg dan is machtiging nog actief <cus1:exchangelastdate> datum laatste succesvolle uitwisseling met MediRund Bedrijven waarvan de begindatum op of voor vandaag ligt en de einddatum leeg of op of na vandaag ligt hebben een machtiging aan de veearts gegeven voor uitwisseling met MediRund.

12 addmedicinetransaction requestmessage: medicinetransaction <heal1:keeper> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> </heal1:keeper> <heal2:animalspeciescd>?</heal2:animalspeciescd> <heal1:veterinarian> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> </heal1:veterinarian> <heal2:medicinetransactiontype>?</heal2:medicinetransactiontype> <heal1:transactiondate>?</heal1:transactiondate> <heal2:eancode>?</heal2:eancode> <heal1:nrofmedicine>?</heal1:nrofmedicine> <heal2:batch>?</heal2:batch> <heal2:cascade></heal2:cascade> <heal2:animalagegroup>?</heal2:animalagegroup> <heal2:remarks>?</heal2:remarks>

13 addmedicinetransaction <keeper> verplicht idem aan contextmessage <animalspeciescd> verplicht diersoort waarde: D (melkvee) of B (vleesvee) <veterinarian> verplicht idem aan contextmessage <medicinetransactiontype> verplicht soort transactie waarde: ADD (bij), COR (correctie, af) <transactiondate> verplicht datum, format eejjmmdd

14 addmedicinetransaction <EANCode> verplicht Code uit de BCT van de FIDIN <nrofmedicine> verplicht & BELANGRIJK aantal eenheden van deze EAN altijd positief getal, inclusief decimalen voorbeeld ter verduidelijking van de werking: EAN (Rimadyl smakelijke tabletten) heeft volgens de BCT van de FIDIN een verpakkingsvorm van 20 tabletten Een bericht met <EANCode> <medicinetransactiontype> ADD en <nrofmedicine> 5 betekent dat er 5 maal een verpakking van 20 tabletten geleverd is 5*20 = 100 tabletten. Leverantie van 1 tablet <nrofmedicine>0.05

15 addmedicinetransaction <batch> niet verplicht batchcode medicijn <cascade> niet verplicht cascade regeling toegepast waarde: F (default) of T <animalagegroup> verplicht leeftijdsgroep waarde: 8WK, 1YR, 2YR, OLD <remarks> niet verplicht Antwoord is alleen een servicemessage

16 Foutafhandeling Aan de voordeur controle tegen de XSD response middels SOAP fault element <faultcode>env:esbmessageprocessingfailed</faultcode> <faultstring>esb Couldn't process message due to unhandled exception</faultstring> mag in productie niet voorkomen fouttekst is niet voor de gebruiker Backoffice controle tegen business rules response middels servicemessage kan in productie voorkomen fouttekst kan aan de gebruiker getoond worden

17 Technische vragen MediRund Technische Support

18 Testtraject Acceptatieomgeving MediRund acceptatie.medirund.nl Testdata EANs uit BCT worden allemaal geladen test UDN s, test UBN s, machtigingen, etc. aanvragen via MediRund supportdesk Controle op ontvangst data via webapplicatie leverantieoverzicht opvragen