Koppelprofiel Key2Burgerzaken: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Koppelprofiel)
(Kenmerken koppelen)
Regel 44: Regel 44:
  
 
=== Kenmerken koppelen ===
 
=== Kenmerken koppelen ===
 +
De volgende kenmerken moeten gekoppeld worden:
  
 
 
<li>Op basis van de invoer voor kenmerken in de registratiefase worden kenmerken in de rest van de zaak ingevoerd:<br>
 
<ul>
 
<li>De volgende kenmerken moeten in het verhuiszaaktype aanwezig zijn:<br>
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Regel 161: Regel 157:
 
|}
 
|}
 
<i>* 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: </i><nowiki>[[kenmerk1]],[[kenmerk2]],[[kenmerk3]],etc</nowiki><i>. Koppel dit kenmerk. Bij de export zullen de magicstrings eerst verwerkt worden, zodat de BSN-nummers in de export worden opgenomen.</i>
 
<i>* 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: </i><nowiki>[[kenmerk1]],[[kenmerk2]],[[kenmerk3]],etc</nowiki><i>. Koppel dit kenmerk. Bij de export zullen de magicstrings eerst verwerkt worden, zodat de BSN-nummers in de export worden opgenomen.</i>
</li>
+
 
<li>Vervolgens kunnen de kenmerken worden opgegeven in de configuratie van de koppeling, onder kenmerkmapping:<br>
 
<br>
 
[[bestand:Koppeling verhuizing gegevensmapping.png]]</li>
 
<br>
 
<li>Bij het registreren van de zaak zullen de kenmerken worden ingevuld:<br>
 
<br>
 
[[bestand:Koppeling verhuizing voorbeeld fase2.png]]</li>
 
<br>
 
</ul>
 
<li>In sommige situaties zal bovenstaand kenmerk 'statuscode' worden ingevuld met BVH07. Ingesteld kan worden dat de zaak in dit geval automatisch wordt afgehandeld.<br>
 
<br>
 
[[bestand:Koppeling verhuizing voorbeeld afhandelen.png]]</li>
 
<br>
 
<li>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.<br>
 
<br>
 
[[bestand:Koppeling verhuizing voorbeeld resultaat.png]]</li>
 
<br>
 
<li>Er kan een keuze gemaakt worden in welk adres wordt gebruikt als verhuisadres.<br>
 
<ul>
 
<li>Het adres van de aanvrager</li>
 
<li>Een adreskenmerk</li>
 
</ul>
 
[[bestand:Koppeling verhuizing voorbeeld bag.png]]<br>
 
Zie ook de tabel bij 2.</li>
 
</ol>
 
<br>
 
 
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.<br>
 
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.<br>
  

Versie van 11 mei 2016 om 09:18


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

De volgende kenmerken moeten gekoppeld worden:

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.

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.

Testscenario

Koppelprofiel beheren

Meldingen behandelen

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