Koppelprofiel Key2Burgerzaken: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Koppelprofiel)
(Kenmerken koppelen)
 
(7 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 23: Regel 23:
 
|Geen actie, Zaak afhandelen
 
|Geen actie, Zaak afhandelen
  
Let op: De inrichting van het geselecteerde zaaktype moet zo zijn dat aan alle voorwaarden van de [http://wiki.zaaksysteem.nl/Zaakdossier_fase_afronden Faseovergang] voldaan is.
+
Let op: De inrichting van het geselecteerde zaaktype moet zo zijn dat aan alle voorwaarden van de [[Zaakdossier_fase_afronden|Faseovergang]] voldaan is.
 
|-
 
|-
 
|Zaakresultaat op verwerkte aanvraag
 
|Zaakresultaat op verwerkte aanvraag
Regel 35: Regel 35:
 
Het zaaktype waar verhuizingen op geregistreerd worden.
 
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 [http://wiki.zaaksysteem.nl/Zaaktypebeheer_Regels#Verstuur_extern_systeembericht Extern systeembericht] ingericht zijn.
+
Let op: Voor het versturen van het bericht 'Verhuizing geregistreerd' aan de key2burgerzaken applicatie moet in het zaaktype ook een [[Zaaktypebeheer_Regels#Verstuur_extern_systeembericht|Extern systeembericht]] ingericht zijn.
  
 
=== Kenmerken koppelen ===
 
=== Kenmerken koppelen ===
Regel 46: Regel 46:
 
!style="width:100px;"|Fase 2+
 
!style="width:100px;"|Fase 2+
 
!style="width:180px;"|Type
 
!style="width:180px;"|Type
!style="width:180px;"|Toelichting
+
!style="width:200px;"|Toelichting
 
|-
 
|-
 
|Verhuisdatum
 
|Verhuisdatum
Regel 64: Regel 64:
 
|
 
|
 
|Opplusbaar tekstveld
 
|Opplusbaar tekstveld
|Verplicht 8 of 9 cijfers
+
|Verplicht 8 of 9 cijfers<br>
 +
<br>
 +
<nowiki>*Zie ook onderstaande toelichting</nowiki>
 +
|-
 +
|Meeverhuizers.OmschrijvingAangifte
 +
!X
 +
|
 +
|Tekstveld
 +
|*Zie onderstaande toelichting
 
|-
 
|-
 
|Statuscode
 
|Statuscode
Regel 116: Regel 124:
 
|style="width:100px;"|
 
|style="width:100px;"|
 
|style="width:180px;"|Bag-kenmerk (adres)
 
|style="width:180px;"|Bag-kenmerk (adres)
|style="width:180px;"|Verplicht
+
|style="width:200px;"|Verplicht
 
|}
 
|}
  
Regel 127: Regel 135:
 
|style="width:100px;"|
 
|style="width:100px;"|
 
|style="width:180px;"|Tekstveld of systeemkenmerk
 
|style="width:180px;"|Tekstveld of systeemkenmerk
|style="width:180px;"|Verplicht
+
|style="width:200px;"|Verplicht
 
|-
 
|-
 
|Adresgegevens.Huisnummer
 
|Adresgegevens.Huisnummer
Regel 151: Regel 159:
 
|
 
|
 
|Tekstveld of systeemkenmerk
 
|Tekstveld of systeemkenmerk
 +
|<nowiki>-</nowiki>
 +
|}
 +
 +
{| class="wikitable"
 +
|-
 +
!style="width:350px;"|Titel
 +
!style="width:100px;"|Registratiefase
 +
!style="width:100px;"|Fase 2+
 +
!style="width:180px;"|Type
 +
!style="width:200px;"|Toelichting
 +
|-
 +
|Adresgegevens.FunctieAdres
 +
!X
 +
|
 +
|Tekstveld
 
|<nowiki>-</nowiki>
 
|<nowiki>-</nowiki>
 
|}
 
|}
  
 
===== Meeverhuizers in meerdere kenmerken =====
 
===== Meeverhuizers in meerdere kenmerken =====
Het opvragen van de BSN's van de meeverhuizers kan desgewenst met afzonderlijke kenmerken ingericht worden, ondanks dat in het koppelprofiel slechts één kenmerk gekoppeld kan worden. Dit vereist een extra kenmerk van het type tekstveld, waar doormiddel van een regel de magicstrings van de desbetreffende kenmerken kommagescheiden in opgenomen worden. Bijvoorbeeld: [[meeverhuizer1]],[[meeverhuizer2]],[[meeverhuizer3],etc. Op moment van de export zullen de magicstrings verwerkt worden, zodat de opgegeven BSN's kommagescheiden geëxporteerd worden.
+
De BSN's van meeverhuizers moeten kommagescheiden opgegeven worden voor Meeverhuizers.BurgerservicenummersMeeverhuizers. Dit kan op twee manieren:
 +
<ol>
 +
<li>Alle informatie in één opplusbaar kenmerk</li>
 +
<li>De informatie in losse kenmerken
 +
<br>Plus één systeemkenmerk waarin de informatie met magicstring kommagescheiden worden opgebouwd
 +
<br>Plus één systeemkenmerk waarin de betekenis van de informatie wordt opgegeven
 +
</li>
 +
</ol>
 +
 
 +
De laatste optie heeft de voorkeur. Het is hiermee mogelijk om zelf te beheren welke informatie in de export wordt opgenomen, en zelfs om dit dynamisch te maken middels regels.
 +
 
 +
Voorbeeld:
 +
 
 +
{| class="wikitable"
 +
|-
 +
!style="width:200px;"|Kenmerk
 +
!style="width:200px;"|Kenmerktype
 +
!style="width:200px;"|Voorbeeld invulling
 +
!Toelichting
 +
|-
 +
|BSN partner
 +
|Numeriek
 +
|123456789
 +
|
 +
|-
 +
|BSN kind 1
 +
|Numeriek
 +
|111111111
 +
|
 +
|-
 +
|BSN kind 2
 +
|Numeriek
 +
|222222222
 +
|
 +
|-
 +
|BSN kind 3
 +
|Numeriek
 +
|333333333
 +
|
 +
|-
 +
|BSN kind 4
 +
|Numeriek
 +
|444444444
 +
|
 +
|-
 +
|BSN kind 5
 +
|Numeriek
 +
|555555555
 +
|
 +
|-
 +
|BSN gemachtigde
 +
|Numeriek
 +
|121212121
 +
|
 +
|-
 +
|BSN gezaghouder
 +
|Numeriek
 +
|131313131
 +
|
 +
|-
 +
|BSN inwonende ouder
 +
|Numeriek
 +
|141414141
 +
|
 +
|-
 +
|BSN inwonende ouder
 +
|Numeriek
 +
|151515151
 +
|
 +
|-
 +
|OmschrijvingAangifte
 +
|Tekstveld
 +
|P,K,K,K,K,K,G,O,O
 +
|Ingesteld als systeemkenmerk, ingevuld middels voorinvulling of regel.<br>
 +
<br>
 +
Mogelijke aanduidingen:<br>
 +
P = Partner,<br>
 +
K = Meerderjarig inwonend kind (voor ouders),<br>
 +
M = Meerderjarige gemachtigde,<br>
 +
G = Gezaghouder,<br>
 +
O = Inwonende ouder (voor kind)<br>
 +
|-
 +
|BurgerservicenummersMeeverhuizers
 +
|Tekstveld
 +
|<nowiki>[[bsn_partner]],[[bsn_kind_1]],[[bsn_kind_2]],[[bsn_kind_3]],[[bsn_kind_4]],[[bsn_kind_5]],[[bsn_gemachtigde]],[[bsn_ouder1]],[[bsn_ouder2]]</nowiki>
 +
|Ingesteld als systeemkenmerk, ingevuld middels voorinvulling of regel.<br>
 +
<br>
 +
Let op: Waarden mogen leeg zijn.
 +
|}
  
 
= Transacties =
 
= Transacties =

Huidige versie van 11 sep 2017 om 13:33


Algemeen

Het koppelprofiel key2burgerzaken stelt in staat om verhuizingen die in zaaksysteem geregistreerd worden direct in de key2burgerzaken applicatie te registreren, en wanneer deze afgehandeld worden in de applicatie de geregistreerde zaken in zaaksysteem te laten afhandelen.

Koppelprofiel

Instellingen voor 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 Met deze optie aan kan voor het adres gebruik gemaakt worden van één BAG-kenmerk (aanbevolen). Met deze optie uit moet voor het adres gebruik gemaakt worden van losse tekstkenmerken.

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 Verplicht 8 of 9 cijfers


*Zie ook onderstaande toelichting

Meeverhuizers.OmschrijvingAangifte X Tekstveld *Zie onderstaande toelichting
Statuscode X Tekstveld -
Statusomschrijving X Groot tekstveld -
IndicatieMeldenAanBurger X Groot tekstveld -
BackOfficeID X Tekstveld -
Contactgegevens.Emailadres X Tekstveld of systeemkenmerk Verplicht
Contactgegevens.TelefoonnummerPrive X Tekstveld of systeemkenmerk Eén van beide verplicht
Contactgegevens.TelefoonnummerMobiel X Tekstveld of systeemkenmerk
Gebruik BAG voor adres verhuizing = aan (aanbevolen)
Bagadres X Bag-kenmerk (adres) Verplicht
Gebruik BAG voor adres verhuizing = uit
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 -
Titel Registratiefase Fase 2+ Type Toelichting
Adresgegevens.FunctieAdres X Tekstveld -
Meeverhuizers in meerdere kenmerken

De BSN's van meeverhuizers moeten kommagescheiden opgegeven worden voor Meeverhuizers.BurgerservicenummersMeeverhuizers. Dit kan op twee manieren:

  1. Alle informatie in één opplusbaar kenmerk
  2. De informatie in losse kenmerken
    Plus één systeemkenmerk waarin de informatie met magicstring kommagescheiden worden opgebouwd
    Plus één systeemkenmerk waarin de betekenis van de informatie wordt opgegeven

De laatste optie heeft de voorkeur. Het is hiermee mogelijk om zelf te beheren welke informatie in de export wordt opgenomen, en zelfs om dit dynamisch te maken middels regels.

Voorbeeld:

Kenmerk Kenmerktype Voorbeeld invulling Toelichting
BSN partner Numeriek 123456789
BSN kind 1 Numeriek 111111111
BSN kind 2 Numeriek 222222222
BSN kind 3 Numeriek 333333333
BSN kind 4 Numeriek 444444444
BSN kind 5 Numeriek 555555555
BSN gemachtigde Numeriek 121212121
BSN gezaghouder Numeriek 131313131
BSN inwonende ouder Numeriek 141414141
BSN inwonende ouder Numeriek 151515151
OmschrijvingAangifte Tekstveld P,K,K,K,K,K,G,O,O Ingesteld als systeemkenmerk, ingevuld middels voorinvulling of regel.


Mogelijke aanduidingen:
P = Partner,
K = Meerderjarig inwonend kind (voor ouders),
M = Meerderjarige gemachtigde,
G = Gezaghouder,
O = Inwonende ouder (voor kind)

BurgerservicenummersMeeverhuizers Tekstveld [[bsn_partner]],[[bsn_kind_1]],[[bsn_kind_2]],[[bsn_kind_3]],[[bsn_kind_4]],[[bsn_kind_5]],[[bsn_gemachtigde]],[[bsn_ouder1]],[[bsn_ouder2]] Ingesteld als systeemkenmerk, ingevuld middels voorinvulling of regel.


Let op: Waarden mogen leeg zijn.

Transacties

Alle transacties zijn inzichtelijk via het transactieoverzicht.

Let op: Een transactie die verstuurd wordt 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 ontvangen worden. Het is niet bekend hoe lang de periode van inactiviteit is wil dit zich voordoen.