SPECIFICATIE-STUF ENVELOPPE Gemeentelijk gegevensknooppunt VISD is een programma van de VNG dat wordt uitgevoerd in samenwerking met KING
Opgesteld door Johan Boer en Arjen Brienen Datum 24 september 2014 Versie 1.0
Inhoud Inhoudsopgave REVISIES... 4 1 INLEIDING... 5 1.1 REFERENTIEDOCUMENTEN EN BRONVERWIJZINGEN... 5 2 INTERACTIEMODEL... 6 3 BERICHTSPECIFICATIES... 7 3.1 INITIËREND BERICHT (GGS0301-DI01)... 7 3.2 RETOUR-BERICHT (GGS0301-DI01)... 8 4 BIJLAGE: VOORBEELDBERICHTEN... 9 4.1 GGS0301_DI01... 11 4.2 GGS0301_DU01... 11 3
Revisies Versie Datum Auteurs Status Reden en aard wijziging 0.1 20-08-2014 Johan Boer Concept Initiële opzet 0.2 27-08-2014 Johan Boer Concept Commentaar M. vd Broek verwerkt, Vormgeving toegevoegd. 0.3 04-09-2014 Johan Boer Concept Wijzigingen doorgevoerd n.a.v. overleg transactiestandaard. 0.4 24-09-2014 Arjen Brienen Voorlopig Definitief Toegevoegd maximale berichtgrootte en gebruik ref.nrs 1.0 06-10-2014 Arjen Brienen Definitief Laatste consultatieronde Wijnand Heijnen, Johan Boer, Ton Monasso en Toine Beunes 4
1 Inleiding Binnen het programma VISD is een aantal projecten gedefinieerd. Eén van die projecten is het inrichten van een gemeentelijk gegevensknooppunt. In het kader van dit project is er een berichtspecificatie opgesteld van een StUF enveloppe. Om het berichten verkeer in de keten Rinis-Inlichtingenbureau-Gemeente plaats te laten vinden op basis van de vigerende berichtstandaarden is ervoor gekozen om de iwmo-berichten, die als flatfile-format in Ascii formaat worden opgesteld, te verpakken in een StUF bericht. Hiermee is voorzien in de functionaliteit zoals die beschreven is in de ketenkaart IWMO versie 1.0 dd 28 mei 2014 van het programma VISD 2014. De in de ketenkaart beschreven Routering (adressering) en Berichttransformatie worden ingevuld met deze berichtspecificaties. De StUF-envelop is toepasbaar voor alle asynchrone berichtuitwisseling via het GGk, en is op dit moment uitgewerkt voor de standaarden iwmo en ijw. Bij toepassing van andere standaarden wordt dit document aangevuld met aanwijzingen voor het gebruik. 1.1 Referentiedocumenten en bronverwijzingen Referentiedocument StUF 3.01 StUF protocolbindingen 3.02 BEP-model WMO (iwmo versie 1.0) Ketenkaart iwmo 1.0 Bronverwijzing https://new.kinggemeenten.nl/gemma/stuf/stuf- 301/standaard https://new.kinggemeenten.nl/gemma/stuf/stuf- 301/standaard https://www.zorgregistratie.nl/bep/wmo10/html/ aa_reportstart.html 28052014 Ketenkaart VISD iwmo v1.0.docx 5
2 Interactiemodel In de eerste versie van deze specificaties is er sprake van 4 interacties. Zoals in bijgevoegd interactiemodel te zien is wisselt de initiërende rol per interactie. Deze interacties dienen als voorbeeld voor het gebruik en zijn ook toepasbar voor andere berichtenstromen naast de Wmo. Bij de Toewijzing initieert de gemeente de interactie terwijl bij de Declaratie, de AanvangOndersteuning en de BeëindigingOndersteuning de (Zorg-aanbieder) de interactie initieert. Conclusie is dat beide partijen voor beide StUF-berichten zowel de consumer- als de provider-rol hebben. Gemeente (Zorg-)aanbieder WMO-Toewijzing (WMO0301) Wmo-Toewijzing-Retour (WMO0302) Wmo-Declaratie (WMO0303) Wmo-Declaratie-Retour (WMO0304) Wmo-AanvangOndersteuning (WMO0305) Wmo-AanvangOndersteuning-Retour (WMO0306) Wmo-BeeindigingOndersteuning (WMO0307) Wmo-BeeindigingOndersteuning-Retour (WMO0308) 6
3 Berichtspecificaties 3.1 Initiërend bericht (ggs0301-di01) Berichttype: ggs0301-di01 StUF-elementen Stuurgegevens berichtcode Zender zender.organisatie zender.applicatie zender.administratie zender.gebruiker Ontvanger ontvanger.organisatie ontvanger.applicatie ontvanger.administratie ontvanger.gebruiker referentienummer tijdstipbericht functie Vaste waarde = Di01 In de berichten van gemeente naar Aanbieder van (jeugd)zorg en ondersteuning wordt de CBSgemeentecode voor identificatie van de gemeente gebruikt. In de berichten van Aanbieder van (jeugd)zorg en ondersteuning naar gemeente wordt de WMO-specifieke AGB-code voor identificatie van de Aanbieder van (jeugd)zorg en ondersteuning of jeugdzorgaanbieder gebruikt Naam verzendende applicatie Naam verzendende administratie Naam verzendende gebruiker In de berichten van gemeente naar Aanbieder van (jeugd)zorg en ondersteuning wordt de WMO-specifieke AGB-code voor identificatie van de Aanbieder van (jeugd)zorg en ondersteuning of jeugdzorgaanbieder gebruikt In de berichten van Aanbieder van (jeugd)zorg en ondersteuning naar gemeente wordt de CBSgemeentecode voor identificatie van de gemeente gebruikt Naam ontvangende applicatie Naam ontvangende administratie Naam ontvangende gebruiker Bij de WMO0301 wordt het Referentienummer gevuld met de "IDENTIFICATIE HEENBERICHT" uit het voorlooprecord. Bij de WMO0303 wordt het Referentienummer gevuld met het FACTUURNUMMER uit het voorlooprecord. Tijdstip van aanmaken van dit StUF-bericht (enveloppe.) Berichttype dat aangeleverd wordt, uitgebreid met het VERSIE en SUBVERSIE uit het voorlooprecord voorafgegaan door een hyphen (streepje), Bv. WMO301-0204 (Toewijzing, versie 2, subversie 4) en 7
Inhoud parameters/bericht parameters.bericht.bestandsnaam WMO303-0501 (Declaratie, versie 5, subversie 1) Flatfile formaat bericht (base64) Maximum grootte van de payload(voor conversie) is 10 MegaByte. bestandsnaam van het bestand dat als binary is opgenomen 3.2 Retour-bericht (ggs0301-du01) Berichttype: ggs0301-du01 StUF-elementen Stuurgegevens berichtcode Zender zender.organisatie zender.applicatie zender.administratie zender.gebruiker Ontvanger ontvanger.organisatie Vaste waarde = Du01 In de berichten van gemeente naar Aanbieder van (jeugd)zorg en ondersteuning wordt de CBSgemeentecode voor identificatie van de gemeente gebruikt. In de berichten van Aanbieder van (jeugd)zorg en ondersteuning naar gemeente wordt de WMO-specifieke AGB-code voor identificatie van de Aanbieder van (jeugd)zorg en ondersteuning of jeugdzorgaanbieder gebruikt Naam verzendende applicatie Naam verzendende administratie Naam verzendende gebruiker In de berichten van gemeente naar Aanbieder van (jeugd)zorg en ondersteuning wordt de WMO-specifieke AGB-code voor identificatie van de Aanbieder van (jeugd)zorg en ondersteuning of jeugdzorgaanbieder gebruikt In de berichten van Aanbieder van (jeugd)zorg en ondersteuning naar gemeente wordt de CBSgemeentecode voor identificatie van de gemeente gebruikt ontvanger.applicatie ontvanger.administratie ontvanger.gebruiker referentienummer Naam ontvangende applicatie Naam ontvangende administratie Naam ontvangende gebruiker Bij de WMO302 wordt het referentienummer gevuld met de "IDENTIFICATIE RETOURBERICHT" uit het voorlooprecord. Bij de WMO304 wordt het referentienummer gevuld met de "FACTUURNUMMER DECLARANT" uit het 8
tijdstipbericht crossrefnummer functie Inhoud parameters/bericht parameters.bericht.bestandsnaam Voorlooprecord. Tijdstip van aanmaken van dit StUF-bericht (enveloppe.) Het crossrefnummer wordt gevuld met de "FACTUURNUMMER DECLARANT" uit het Voorlooprecord Berichttype dat aangeleverd wordt, uitgebreid met het VERSIE en SUBVERSIE uit het voorlooprecord voorafgegaan door een hyphen (streepje), Bv. WMO302-0204 (Toewijzing-retour, versie 2, subversie 4) en WMO304-0501 (Declaratie-retour, versie 5, subversie 1) Flatfile formaat bericht (base64). Maximum grootte van de payload(voor conversie) is 10 MegaByte. bestandsnaam van het bestand dat als binary is opgenomen 3.3 Aanvullende eisen aan de berichtuitwisseling De volgende aanvullende eisen voor de berichtuitwisseling worden gehanteerd: 1. De maximale grootte van parameters/bericht is 10Mb. Deze dient bij verzending en ontvangst te worden gecontroleerd. 9
4 Berichtenlogistiek en Foutafhandeling Zowel de foutafhandeling als het bevestigen van de ontvangst van een bericht vindt plaats conform de StUF-standaard. Het betreft hier asynchrone berichtenuitwisseling. Er wordt gebruik gemaakt van het bevestigingsbericht Bv01 en het foutbericht Fo01. Dit is beschreven in 4.4 van de StUF 0301. (Standaard Uitwisseling Formaat). De beschrijving van deze standaard is te vinden op de Gemma community (https://new.kinggemeenten.nl/gemma/stuf/stuf-301/standaard) Tabblad Bibliotheek ). 10
5 Bijlage: Voorbeeldberichten 5.1 ggs0301_di01 <?xml version="1.0" encoding="utf-8"?> <!--Sample XML file generated by XMLSpy v2011 sp1 (http://www.altova.com)--> <GGS:ggs_Di01 xsi:schemalocation="http://www.egem.nl/stuf/sector/wbg/0310 ggs0301_msg.xsd" xmlns:stuf="http://www.egem.nl/stuf/stuf0301" xmlns:ggs="http://www.egem.nl/stuf/sector/wbg/0310" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <GGS:stuurgegevens> <StUF:berichtcode>Di01</StUF:berichtcode> <StUF:zender> <StUF:organisatie>0484</StUF:organisatie> <StUF:applicatie>WMO-applicatie gemeente</stuf:applicatie> </StUF:zender> <StUF:ontvanger> <StUF:organisatie>85960549</StUF:organisatie> <StUF:applicatie>Applicatie zorg-aanbieder</stuf:applicatie> </StUF:ontvanger> <StUF:referentienummer>123456789012</StUF:referentienummer> <StUF:tijdstipBericht>20140826090000</StUF:tijdstipBericht> <StUF:functie>WMO301-0204</StUF:functie> </GGS:stuurgegevens> <GGS:parameters> <GGS:bericht StUF:bestandsnaam="bestand.txt" >SGllciBrb210IGhldCBBU0NJSS1iZXJpY2h0IGluIA==</GGS:bericht> </GGS:parameters> </GGS:ggs_Di01> NB: in het element bericht staat de base64 encoding van Hier komt een ASCII-bericht in 5.2 ggs0301_du01 <?xml version="1.0" encoding="utf-8"?> <!--Sample XML file generated by XMLSpy v2011 sp1 (http://www.altova.com)--> <GGS:ggs_Du01 xsi:schemalocation="http://www.egem.nl/stuf/sector/wbg/0310 ggs0301_msg.xsd" xmlns:stuf="http://www.egem.nl/stuf/stuf0301" xmlns:ggs="http://www.egem.nl/stuf/sector/wbg/0310" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <GGS:stuurgegevens> <StUF:berichtcode>Du01</StUF:berichtcode> <StUF:zender> <StUF:organisatie>85960549</StUF:organisatie> <StUF:applicatie>Applicatie Zorgaanbieder</StUF:applicatie> 11
</StUF:zender> <StUF:ontvanger> <StUF:organisatie>0484</StUF:organisatie> <StUF:applicatie>WMO-applicatie Gemeente</StUF:applicatie> </StUF:ontvanger> <StUF:referentienummer>210987654321</StUF:referentienummer> <StUF:tijdstipBericht>20140827090000</StUF:tijdstipBericht> <StUF:crossRefnummer>123456789012</StUF:crossRefnummer> <StUF:functie>WMO3034</StUF:functie> </GGS:stuurgegevens> <GGS:parameters> <GGS:bericht StUF:bestandsnaam="bestand.txt" >SGllciBrb210IGhldCBBc2NpaSByZXRvdXJiZXJpY2h0</GGS:bericht> </GGS:parameters> </GGS:ggs_Du01> NB: in het element bericht staat de base64 encoding van Hier komt het Ascii retourbericht 12