Voorbeeld berichten van de communicatie

Dit is een statische kopie van het eerdere discussie.kinggemeenten.nl.
Nieuwe discussies kunnen in de GitHub repository 'StUF standaarden' als issue worden opgevoerd.

13 reacties / 0 nieuw
Eduard Witteveen
Voorbeeld berichten van de communicatie

Hallo,

Voor het aansluiten van ons KCC systeem ben ik opzoek naar verschillende soorten berichten mbt. het koppelvlak-zs-dms.
Ik heb gezocht naar representatieve berichten op het testplatform, maar hier wordt ik niet heel blij van.

Ik zoek een vraag bericht die op rsin of verstigingsnr zoekt in het zakenmagazijn, dus zoiets als bijgevoegde vraag bericht, maar dan voor een bedrijf. De toevoegingsberichten om een zaak met een bedrijf aan te maken zou ik ook heel graag willen hebben.

Voorbeeld berichten ter referentie zijn erg welkom en maken de leercurve een stuk minder stijl.

Michiel Verhoef

Hallo Eduard,

Bedankt voor je vraag. Op dit moment hebben we geen "cookbook" met kant en klare berichten klaarliggen. De wens hiertoe is er wel maar bij voorkeur zou dat cookbook gevuld worden met voorbeeldberichten uit de praktijk, aangeleverd door leveranciers en gemeenten dus. 

Om je op dit moment verder te kunnen helpen zal ik kijken of er bij StUF ZKN dergelijke berichten zijn. Deze zouden moeten passen in de Zaak- Documentservices.

Met vriendelijke groet,

Michiel Verhoef

Michiel Berkhof

Hallo Michiel,

We spraken elkaar hier dinsdagmiddag over. Heb je al meer informatie kunnen vinden

Met vriendelijke groet,

Michiel Berkhof

Michiel Verhoef

Hallo Michiel,

Helaas heb ik nog geen berichten hiervoor kunnen opsnorren, ik kom hier van de week op terug.

Groeten,

Michiel

 

Michiel Berkhof

Hallo Michiel (Verhoef),

Lukt het vandaag om wat aan te leveren. We beginnen uit te lopen in onze planning.

 

Alvast bedankt.

 

Michiel

Michiel Verhoef

Hallo Michiel,

Helaas nog niet. Mijn eigen planning is helaas ook uitgelopen en zoals ik al aangegeven heb, dit soort voorbeelden heb ik niet op de plank liggen.

 

Groeten, Michiel

Eduard Witteveen

Hallo Michiel,

Allereerst bedankt voor je reactie!
Mogelijk dat iemand anders me daar wel tijdig mee kan helpen?
Het lijkt me dat een hoop partijen die de standaard "spreken" dit bericht kunnen aanmaken.

offtopic:
Een cookbook lijkt mij een bruikbaar idee, om mij mag het ook iets wiki-achtigs zijn.
Persoonlijk vind ik het onhandig dat er geen voorbeeld berichten zijn, wanneer ik wil communiceren is het meestal makkelijker om met een referentie te beginnen dan een hele standaard te kennen vanuit de definitie/documentatie. 

Doordat meestal beide kanten van het koppelvlak geen bericht logging doen, heb ik ook al verscheidene keren wireshark/fiddler voor de bestaande communicatie gebruikt, maar voor de nieuwe functionaliteiten tast ik in het duister. Bij fouten in de communicatie heb je hierdoor ook altijd een uitdaging, en ook daar zijn referentie berichten erg waardevol.

Michiel Verhoef

Hallo Eduard,

Zoals ik Michiel al had aangegeven zijn er op dit moment bij ons geen kant en klare voorbeeldberichten. Mogelijk dat gemeenten en/of leveranciers hier wel in kunnen voorzien maar wij zullen ze moeten maken. Dat is meteen een begin voor een cookbook.

Hoewel ik goed begrijp dat een voorbeeld makkelijker is om te gebruiken is goede kennis van StUF belangrijk om te weten wat er wel of niet in een bericht hoort, mag en kan. Zeker omdat StUF een zekere leercurve kent is het goed te weten waar wat voor dient. Bij eventuele vragen of StUF en specifieke berichten mag je deze altijd stellen natuurlijk, dan kunnen wij meekijken en mogelijk tips ter verbetering geven.

Groeten,

Michiel

Eduard Witteveen

Hallo Michiel Verhoef,

Ik vraag dit juist omdat ik er inmiddels achter ben gekomen dat naast de definitie van StUF het defacto gebruik bepaald of de communicatie werkt, een voorbeeld hiervan is de prefix van 11 in mijn bovenstaande bevragingsbericht.

Ik kan berichten valideren en heb enige kennis van stuf (zie github), maar ik wil gewoon berichten uitwisselen!
Mijn beeld was dat de standaard is gemaakt om de communicatie van verschillende leveranciers tussen registraties centraal staat. Ik vind het ook belangrijk dat de communicatie aan de standaard voldoet, maar ik krijg het gevoel dat doel en middel hier worden omgedraaid.

Begrijp je mijn positie en kun je me aangeven hoe ik nu verder moet met mijn vraag?

Eduard Witteveen

Wellicht dat iemand anders mij kan aangeven hoe ik aan zo'n vraagbericht kan komen?

 

Eduard Witteveen

Ik vond nog wel de volgende opmerkingen bij het eerder genoemde voorbeeld:

...

In RSGB is de identificatie van het subject gedefinieerd als de combinatie van het subjecttype met de identificatie van de specialisatie. In het geval van een natuurlijk persoon is dat code 11, gevolgd door het BSN. Zie bijgaand voorbeeld van een vraagbericht waarin alle lopende zaken worden opgevraagd waarvan BSN 123456780 de initiator is.

...

Eduard Witteveen

Ik vond nog wel de volgende opmerkingen bij het eerder genoemde voorbeeld:

...

In RSGB is de identificatie van het subject gedefinieerd als de combinatie van het subjecttype met de identificatie van de specialisatie. In het geval van een natuurlijk persoon is dat code 11, gevolgd door het BSN. Zie bijgaand voorbeeld van een vraagbericht waarin alle lopende zaken worden opgevraagd waarvan BSN 123456780 de initiator is.

...

Eduard Witteveen

Voor de volledigheid, om dus de vraag te stellen voor een bepaald vestigingsnummer moet de prefix 31 gebruikt worden:

<ZKN:gelijk StUF:entiteittype="ZAK">
                <ZKN:heeftAlsInitiator StUF:entiteittype="ZAKBTRINI">
                               <ZKN:gerelateerde StUF:entiteittype="BTR">
                                               <ZKN:identificatie>31123456789012</ZKN:identificatie>
                               </ZKN:gerelateerde>
                </ZKN:heeftAlsInitiator>
</ZKN:gelijk>