SPECIFICATIE-STUF “ENVELOPPE”
Gemeentelijk gegevensknooppunt
VISD is een programma van de VNG dat wordt uitgevoerd in samenwerking met KING
Opgesteld door Datum Versie
Johan Boer en Arjen Brienen 24 september 2014 1.0
Inhoud Inhoudsopgave REVISIES .......................................................................................................................... 4 1 INLEIDING ................................................................................................................ 5 1.1 REFERENTIEDOCUMENTEN EN BRONVERWIJZINGEN .............................................................. 5 2 3
INTERACTIEMODEL ................................................................................................... 6 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 0.1 0.2
Datum Auteurs 20-08-2014 Johan Boer 27-08-2014 Johan Boer
0.3
04-09-2014 Johan Boer
0.4
24-09-2014 Arjen Brienen
1.0
06-10-2014 Arjen Brienen
Status Concept Concept
Reden en aard wijziging Initiële opzet Commentaar M. vd Broek verwerkt, Vormgeving toegevoegd. Concept Wijzigingen doorgevoerd n.a.v. overleg transactiestandaard. Voorlopig Toegevoegd maximale Definitief berichtgrootte en gebruik ref.nrs 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/stuf301/standaard https://new.kinggemeenten.nl/gemma/stuf/stuf301/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.
(Zorg-)aanbieder
Gemeente 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 stuurgegevens.berichtcode Zender stuurgegevens.zender.organisatie
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 stuurgegevens.zender.applicatie Naam verzendende applicatie stuurgegevens.zender.administratie Naam verzendende administratie stuurgegevens.zender.gebruiker Naam verzendende gebruiker Ontvanger stuurgegevens. In de berichten van gemeente naar Aanbieder van ontvanger.organisatie (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 stuurgegevens. Naam ontvangende applicatie ontvanger.applicatie stuurgegevens. Naam ontvangende administratie ontvanger.administratie stuurgegevens. Naam ontvangende gebruiker ontvanger.gebruiker stuurgegevens.referentienummer 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. stuurgegevens.tijdstipbericht Tijdstip van aanmaken van dit StUF-bericht (enveloppe.) stuurgegevens.functie 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
WMO303 -0501 (Declaratie, versie 5, subversie 1) Inhoud parameters/bericht parameters.bericht.bestandsnaam
3.2
Flatfile formaat bericht (base64) Maximum grootte van de payload(voor conversie) is 10 MegaByte. bestandsnaam van het bestand dat als binary is opgenomen
Retour-bericht (ggs0301-Du01)
Berichttype: ggs0301-Du01 StUF-elementen Stuurgegevens stuurgegevens.berichtcode Zender stuurgegevens.zender.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 stuurgegevens.zender.applicatie Naam verzendende applicatie stuurgegevens.zender.administratie Naam verzendende administratie stuurgegevens.zender.gebruiker Naam verzendende gebruiker Ontvanger stuurgegevens. In de berichten van gemeente naar Aanbieder van ontvanger.organisatie (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 stuurgegevens. ontvanger.applicatie stuurgegevens. ontvanger.administratie stuurgegevens. ontvanger.gebruiker stuurgegevens.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
stuurgegevens.tijdstipbericht stuurgegevens.crossRefnummer
stuurgegevens.functie
Inhoud parameters/bericht parameters.bericht.bestandsnaam
3.3
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
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
<StUF:berichtcode>Di01 <StUF:zender> <StUF:organisatie>0484 <StUF:applicatie>WMO-applicatie gemeente <StUF:ontvanger> <StUF:organisatie>85960549 <StUF:applicatie>Applicatie zorg-aanbieder <StUF:referentienummer>123456789012 <StUF:tijdstipBericht>20140826090000 <StUF:functie>WMO301-0204 SGllciBrb210IGhldCBBU0NJSS1iZXJpY2h0IGluIA== NB: in het element bericht staat de base64 encoding van “Hier komt een ASCII-bericht in “
5.2
ggs0301_Du01
<StUF:berichtcode>Du01 <StUF:zender> <StUF:organisatie>85960549 <StUF:applicatie>Applicatie Zorgaanbieder
11
<StUF:ontvanger> <StUF:organisatie>0484 <StUF:applicatie>WMO-applicatie Gemeente <StUF:referentienummer>210987654321 <StUF:tijdstipBericht>20140827090000 <StUF:crossRefnummer>123456789012 <StUF:functie>WMO3034 SGllciBrb210IGhldCBBc2NpaSByZXRvdXJiZXJpY2h0 NB: in het element bericht staat de base64 encoding van “Hier komt het Ascii retourbericht”
12
