Specificatie StUF-envelop Gemeentelijk Gegevensknooppunt

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
<?xml version="1.0" encoding="UTF-8"?>

<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"?>

<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

Download Report