Belscores. Gegevensstroom BEL_GS01 Push belscores

Transcriptie

1 Belscores Gegevensstroom BEL_GS01

2 Iedereen kan dit document vrij verspreiden met vermelding van de bron en URL Gegevensstroomspecificatie: Versie 1.3 Ter attentie van: "IT expert" die deze gegevensstroom willen integreren MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 2 / 10-8/02/2013

3 Inhoud 1 Doel van de gegevensstroom Beschrijving van de gegevensstroom Richting van de gegevensstroom Documentbeheer Historiek van het document Documentreferenties Doel van het document Beschrijving gegevensstroom Algemene informatie Beschrijving Versturen rapportgegevens Integratie digitaal platform Actie Businessvoorwaarden Foutafhandeling MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 3 / 10-8/02/2013

4 1 Doel van de gegevensstroom 1.1 Beschrijving van de gegevensstroom De gegevensstroom push belscores zal maandelijks de belscores doorsturen via het digitaal platform naar de verschillende zorgkassen gebruik makende van een push mechanisme. 1.2 Richting van de gegevensstroom Deze gegevensstroom wordt verstuurd naar een zorgkas. 2 Documentbeheer 2.1 Historiek van het document Versie Datum Auteur Beschrijving van de wijzigingen/opmerkingen /08/2012 G. Raeyen Eerste versie /01/2013 G. Raeyen Aanpassing b elscore rapport structuur, bijkomende cases /01/2013 G. Raeyen Verdere specificaties foutafhandeling /02/2013 G. Raeyen Herwerking opmerkingen meeting met zorgkassen, retry antwoord & namespace wijzigingen. 2.2 Documentreferenties ID Titel Versie Datum Auteur 1 DPZ_PR1_FAO_GS_00_Generieke_v_3_2.doc /07/2012 Smals 2 UC_500_-_Rapport_BEL-scores_v05.doc /01/2013 Smals 2.3 Doel van het document Dit document bevat functionele en technische informatie voor het gebruik van de gegevensstroom push belscores via het digitaal platform. In dit document geven we toelichting bij de structuur en de inhoudelijke aspecten van de mogelijke requests en reply s. Een voorbeeld illustreert elk van deze berichten. De werkwijze in geval van mogelijke foutmeldingen is eveneens opgenomen in dit document. MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 4 / 10-8/02/2013

5 Deze informatie zou (de IT-afdeling van) een organisatie de mogelijkheid moeten bieden om deze gegevensstroom te ontwikkelen en te gebruiken. Er zijn een aantal technische en wettelijke vereisten waaraan voldaan moet zijn om deze gegevensstroom te kunnen integreren in clienttoepassingen. Dit document werd geschreven om u een overzicht te geven van de vereisten waaraan voldaan moet zijn om deze gegevensstroom correct te integreren. Dit document is geen handleiding voor de ontwikkeling of programmering van interne toepassingen. Om met zoveel mogelijk partners te kunnen communiceren op een vlotte, homogene manier waarbij de risico's onder controle zijn, moeten de partners zich engageren om de specificaties, dataformaten en releaseprocessen te respecteren die in dit document beschreven worden. 3 Beschrijving gegevensstroom 3.1 Algemene informatie Synchroon/asynchroon Atomair/bulk Frequentie Maximum aantal Asynchroon bulk 1 keer per maand per zorgkas 1 rapport per zorgkas 3.2 Beschrijving Maandelijks worden de belscores die mogelijks moeten doorgegeven worden klaargezet voor iedere zorgkas. De bedoeling van deze gegevensstroom is deze belscores door te sturen naar de desbetreffende zorgkas via een maandelijkse push. Indien er geen belscores aanwezig zijn die moeten doorgegeven worden zal een rapport doorgestuurd worden met de melding dat er geen gegevens aanwezig waren. Indien er zich een technisch probleem heeft voorgedaan waardoor het niet mogelijk was de belscores op te halen zal er een rapport doorgestuurd worden met deze melding. Voor meer informatie met betrekking tot welke belscores in aanmerking komen verwijzen we naar UC 122. Aangezien op het moment van dit schrijven de zorgkassen enkel een webservice implementeren waarbij de inhoud van een request wordt doorgegeven via een attachment, zal deze werkwijze in eerste instantie gehandhaafd worden. Indien nodig, kan er afgesproken MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 5 / 10-8/02/2013

6 worden om een 2 de webservice te implementeren die toelaat een request toe te sturen zonder gebruik te maken van een attachment. 3.3 Versturen rapportgegevens Request message: pushbelscorereportrequest Een PushBelScoreReportRequest element vormt het root element voor de belscore gegevens, en ook het root element van het attachment. Dit request element zal bevatten: Een lijst van belscores indien deze beschikbaar zijn. Of Een boodschap wanneer er geen belscores aanwezig zijn of er een technisch probleem was om deze op te halen. Deze request zal meegestuurd worden als inhoud van een gezipped bestand (gzip). Hieronder wordt een overzicht gegeven van de structuur van deze request. MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 6 / 10-8/02/2013

7 De structuur van een belscore record, gebruikt indien er belscores gevonden werden. MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 7 / 10-8/02/2013

8 Een voorbeeld van een mogelijke request met belscores. <?xml version="1.0" encoding="utf-8"?> <PushBelScoreReportRequest xmlns=" xmlns:xsi=" > <reportdate> </reportdate> <careunit>180</careunit> <belscorerecords> <belscorerecord> <SSIN> </SSIN> <Department> <nr>110</nr> <name>gezinszorg</name> </Department> <belscore>38</belscore> <homevisitdate> </homevisitdate> </belscorerecord> <belscorerecord> <SSIN> </SSIN> <Department> <nr>102</nr> <name>familiehulp</name> </Department> <belscore>40</belscore> <homevisitdate> </homevisitdate> </belscorerecord> </belscorerecords> </PushBelScoreReportRequest> Voorbeeld van een request waarbij geen resultaten gevonden zijn. <?xml version="1.0" encoding="utf-8"?> <PushBelScoreReportRequest xmlns=" xmlns:xsi=" > <reportdate> </reportdate> <careunit>180</careunit> <message>belscores_not_available</message> </PushBelScoreReportRequest> Voorbeeld van een request waarbij er een (technisch) probleem was om de belscores op te halen. <?xml version="1.0" encoding="utf-8"?> <PushBelScoreReportRequest xmlns=" xmlns:xsi=" > <reportdate> </reportdate> <careunit>180</careunit> <message>service_failure_error</message> </PushBelScoreReportRequest> MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 8 / 10-8/02/2013

9 3.3.2 Response message: PushBelScoreReportResponse De webservice bij de zorgkas zal antwoorden met een PushBelScoreReportResponse bij het versturen van de belscore request om aan te geven dat de doorgestuurde informatie al dan niet succesvol werd geregistreerd. Een voorbeeld van een succes antwoord, hier zal retry = false meegegeven worden: <?xml version="1.0" encoding="utf-8"?> <PushBelScoreReportResponse xmlns=" xmlns:common=" xmlns:xsi=" > <common:retry>false</common:retry> </PushBelScoreReportResponse> In geval van een SOAP fault of retry = true zal het bericht opnieuw gestuurd worden. 4 Integratie digitaal platform Voor de communicatie met de zorgkassen wordt gebruik gemaakt van het digitaal platform. Voor het opsturen van de push wordt de AsyncGenericRequest gebruikt die reeds voorzien wordt als webservice bij de zorgkassen. MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 9 / 10-8/02/2013

10 Voor meer informatie: zie document DPZ_PR1_FAO_GS_00_Generieke_v_3_2.doc (6.3.3 Asynchrone request). 4.1 Actie DP zal actie Maftz.pushBelScoreReport gebruiken voor deze gegevensstroom. 5 Businessvoorwaarden De gegevensstroom bevat persoonlijke gegevens. Het doorgeven van deze persoonlijke gegevens vereist toestemming van de Commissie voor de bescherming van de persoonlijke levenssfeer (CBPL), Sectoraal comité van de Sociale Zekerheid en van de Gezondheid. 6 Foutafhandeling Bij vastgesteld problemen en/of fouten kunnen tickets aangemaakt worden via jira om deze te rapporteren. MAFTZ_PR1_FAO_BEL_GS01_push_belscores v 1.3.doc - 10 / 10-8/02/2013