Koppelprofiel Key2Burgerzaken: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Inleiding)
(Koppelprofiel)
Regel 12: Regel 12:
  
 
= Koppelprofiel =
 
= Koppelprofiel =
Een uitleg voor het instellen van deze koppeling:<br>
+
Een uitleg voor het instellen van deze koppeling.
<ol>
+
 
<li>In de configuratie van de koppeling moet een URL worden ingevoerd bij 'Url key2burgerzaken' voor het aansluiten op de key2burgerzaken omgeving.<br>
+
=== Configuratie ===
[[bestand:Koppeling verhuizing voorbeeld url.png]]<br>
+
{| class="wikitable"
Voorbeeld URL, testomgeving Centric<br>
+
|-
<pre>
+
!Instelling
http://key2burgerzaken.centric.nl/BOKoppelvlakPIV/PROD/Versie2_0/Service.asmx
+
!Omschrijving
</pre>
+
|-
<br>
+
|URL Key2Burgerzaken
 +
|Bijvoorbeeld: <i><nowiki>http://key2burgerzaken.centric.nl/BOKoppelvlakPIV/PROD/Versie2_0/Service.asmx</nowiki></i>
 +
|-
 +
|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 [http://wiki.zaaksysteem.nl/Zaakdossier_fase_afronden 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 [http://wiki.zaaksysteem.nl/Zaaktypebeheer_Regels#Verstuur_extern_systeembericht Extern systeembericht] ingericht zijn.
 +
 
 +
=== Kenmerken koppelen ===
 +
 
 +
 
 +
 
 
<li>Op basis van de invoer voor kenmerken in de registratiefase worden kenmerken in de rest van de zaak ingevoerd:<br>
 
<li>Op basis van de invoer voor kenmerken in de registratiefase worden kenmerken in de rest van de zaak ingevoerd:<br>
 
<ul>
 
<ul>

Versie van 11 mei 2016 om 09:15


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.

    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 =