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 succesvolle verwerking: resultaat invullen
• Bij succesvolle verwerking: zaak afhandelen
• BAG-adres gebruiken

Koppelprofiel

Een uitleg voor het instellen van deze koppeling.

Configuratie

Instelling	Omschrijving
URL Key2Burgerzaken	Bijvoorbeeld: http://key2burgerzaken.centric.nl/BOKoppelvlakPIV/PROD/Versie2_0/Service.asmx
Verhuizingsoort	Binnengemeentelijk, Buitengemeentelijk
Actie op verwerkte aanvraag	Geen actie, Zaak afhandelen Let op: De inrichting van het geselecteerde zaaktype moet zo zijn dat aan alle voorwaarden van de Faseovergang voldaan is.
Zaakresultaat op verwerkte aanvraag	Let op: Moet overeenkomen met een resultaatmogelijkheid van het geselecteerde zaaktype
Gebruik BAG voor adres verhuizing	Wanneer het gekoppelde adreskenmerk aan de BAG moet voldoen

Zaaktype interface

Het zaaktype waar verhuizingen op geregistreerd worden.

Let op: Voor het versturen van het bericht 'Verhuizing geregistreerd' aan de key2burgerzaken applicatie moet in het zaaktype ook een Extern systeembericht ingericht zijn.

Kenmerken koppelen

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

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

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

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.

</ol>
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.

Voorbeeldbestanden

= Overige documentatie =