Koppelprofiel Key2Burgerzaken

Inleiding

Dit is een feature die enkele acties uitvoert ten behoeve van verhuizingzaaktypen. De volgende acties kunnen vervolgens automatisch worden uitgevoerd:

• Kenmerken in het zaakdossier invullen
• Bij status BVH07: resultaat invullen
• Bij status BVH07: zaak afhandelen
• BAG-adres gebruiken

Koppelprofiel

Een uitleg voor het instellen van deze koppeling:

1. In de configuratie van de koppeling moet een URL worden ingevoerd bij 'Url key2burgerzaken' voor het aansluiten op de key2burgerzaken omgeving.
   Bestand:Koppeling verhuizing voorbeeld url.png
   Voorbeeld URL, testomgeving Centric
   

   http://key2burgerzaken.centric.nl/BOKoppelvlakPIV/PROD/Versie2_0/Service.asmx
   

   
   

2. Op basis van de invoer voor kenmerken in de registratiefase worden kenmerken in de rest van de zaak ingevoerd:
   
   • De volgende kenmerken moeten in het verhuiszaaktype aanwezig zijn:
     

     Titel	Registratiefase	Fase 2+	Type	Toelichting
     Verhuisdatum	X		Datumkenmerk	-
     IndicatieInwonend	X		-	-
     Meeverhuizers.BurgerservicenummersMeeverhuizers	X		Opplusbaar tekstveld (of meerdere tekstvelden*)	Verplicht 8 of 9 cijfers
     Statuscode		X	Tekstveld	-
     Statusomschrijving		X	Groot tekstveld	-
     IndicatieMeldenAanBurger		X	Groot tekstveld	-
     BackOfficeID		X	Tekstveld	-
     Contactgegevens.Emailadres	X		Tekstveld	Verplicht
     Contactgegevens.TelefoonnummerPrive	X		Tekstveld	Verplicht
     Contactgegevens.TelefoonnummerMobiel	X		Tekstveld of systeemkenmerk	Verplicht als 'TelefoonnummerPrive' niet verplicht
     'Gebruik BAG voor adres verhuizing' = uit (zie optie 5)
     Adresgegevens.Postcode	X		Tekstveld of systeemkenmerk	Verplicht
     Adresgegevens.Huisnummer	X		Tekstveld of systeemkenmerk	Verplicht
     Adresgegevens.Huisletter	X		Tekstveld of systeemkenmerk	-
     Adresgegevens.Huisaanduiding	X		Tekstveld of systeemkenmerk	-
     Adresgegevens.Huistoevoeging	X		Tekstveld of systeemkenmerk	-
     'Gebruik BAG voor adres verhuizing' = aan (zie optie 5)
     Bagadres	X		Bag-kenmerk (adres)	Verplicht

     * Het is mogelijk om voor het opvragen van de BSN-nummers van de meeverhuizers met afzonderlijke kenmerken te werken ondanks dat deze niet allemaal gekoppeld kunnen worden aan de betreffende CSV-categorie. Neem een extra kenmerk op van het type (groot) tekstveld en vul met voorinvulling of een regel 'vul waarde in' de volgende string in: [[kenmerk1]],[[kenmerk2]],[[kenmerk3]],etc. Koppel dit kenmerk. Bij de export zullen de magicstrings eerst verwerkt worden, zodat de BSN-nummers in de export worden opgenomen.

   • Vervolgens kunnen de kenmerken worden opgegeven in de configuratie van de koppeling, onder kenmerkmapping:
     
     Bestand:Koppeling verhuizing gegevensmapping.png

   
   

   • Bij het registreren van de zaak zullen de kenmerken worden ingevuld:
     
     Bestand:Koppeling verhuizing voorbeeld fase2.png

   
   

3. In sommige situaties zal bovenstaand kenmerk 'statuscode' worden ingevuld met BVH07. Ingesteld kan worden dat de zaak in dit geval automatisch wordt afgehandeld.
   
   Bestand:Koppeling verhuizing voorbeeld afhandelen.png




4. In sommige situaties zal bovenstaand kenmerk 'statuscode' worden ingevuld met BVH07. Ingesteld kan worden dat het resultaat van de zaak in dit geval automatisch wordt ingevoerd.
   
   Bestand:Koppeling verhuizing voorbeeld resultaat.png




5. Er kan een keuze gemaakt worden in welk adres wordt gebruikt als verhuisadres.
   
   • Het adres van de aanvrager
   • Een adreskenmerk

   Bestand:Koppeling verhuizing voorbeeld bag.png
   

   Zie ook de tabel bij 2.

Let op: Een transactie die wordt verstuurd na een periode van inactiviteit zal falen doordat Centric dit bericht niet goed zal ontvangen. De transactie wordt vervolgens voor 10min in de toekomst ingepland en zal dan wel goed worden ontvangen. Het is niet bekend hoe lang de periode van inactiviteit is wil dit zich voordoen.

Inrichting extern systeem

De inrichting van het externe systeem dient door de gemeente of de leverancier te worden uitgevoerd. Neem voor de zekerheid contact op met uw leverancier voor actuele informatie en mogelijkheden.

Beheer en onderhoud

Indien uw gemeente een beheeroverkomst heeft voor het zaaksysteem, dan valt het beheer van het koppelprofiel binnen de overeenkomst. Het beheer van de koppeling aan de kant van het externe systeem dient geregeld te worden met de leverancier.