Versie van 1 mrt 2014 om 17:50

Inhoud

1 Algemeen
2 Koppelingen

Algemeen

De volgende koppelingen kunnen beheerd worden vanuit het zaaksysteem:

BAG import via CSV
Key2Finance
Key2Burgerzaken
StUF Koppeling Configuratie
StUF Koppeling (PRS)
StUF Koppeling (NNP)
StUF Koppeling (ADR)
StUF Koppeling (VBO)

Transactieoverzicht

In dit overzicht worden alle transacties en basisgegevens weergegeven. Er kan gefilterd worden per koppeling en op fouten, zodat de beheerder eventuele problemen snel kan ontdekken en actie ondernemen. Door op de transactie te klikken kan deze in meer detail worden bekeken.

Configuratiescherm

Op het configuratiescherm worden de instellingen van de koppelingen beheerd en kunnen nieuwe koppelingen worden aangemaakt.

Instellingen die elke koppeling heeft zijn:

API
Zaaktype
Gegevensmapping
Status (actief / niet actief)

Afnemerindicaties

&&&aanvullen

Screenshots

Koppelingen transactieoverzicht.png

Transactieoverzicht
Koppelingen configuratiescherm.png

Configuratiescherm
Koppelingen afnemerindicaties.png

Afnemerindicaties

Koppelingen

Koppelingen
#	Naam	Versie	Status	Toelichting
1	Active directory
2	BAG-import
3	Buiten Beter
4	DigiD
5	eHerkenning
6	Key2Burgerzaken
7	Key2Financien
8	KVK-import
9	Ogone
10	Qmatic
11	StuF-PRS
12	StuF-ADR
13	StuF-VBO
14	StuF-NNP
15	Telefooncentrale
16	Scanstraat
17	WOZ-import
18	Zaakinformatie bevragen
19	Zoekopdracht als kaart publiceren

Active Directory

Usergegevens worden door de beheerserver opgehaald met een readonly account. Deze heeft enkel leesrechten nodig op de Active Directory. Hiermee worden alle gebruikers opgehaald uit de Users OU of applicatiegroep. Dit gebeurt om de vijf minuten. De data van de gebruikers worden d.m.v. de Windows Service ‘Password synchronization for Unix systems’ gesynchroniseerd met de OpenLDAP van het zaaksysteem. Zodra een gebruiker wordt aangemaakt, zijn wachtwoord wijzigt of wordt verwijderd wordt deze actie ook verstuurd naar de beheerserver. Wijzigingen m.b.t. wachtwoorden zullen live worden gepushed naar de beheerserver op port 6677. De wachtwoorden worden direct gehashed opgeslagen voor verwerking.

Deze worden ‘gemerged’ met de wachtwoorden, en worden direct in een beveiligde XML verstuurd naar de omgeving in de overheidscloud. De beheerserver maakt gebruik van een HTTPS verbinding die alleen met behulp van een API-Key kan worden opgezet.

BAG-import

Maak eerst een koppeling aan:

Ga naar het configuratiescherm en klik op de plusknop
Selecteer het type 'Key2Finance'
Geef eventueel een eigen naam op

Activeer vervolgens de koppeling.

Nu kunnen CSV bestanden op twee manieren worden toegevoegd:

Op het transactieoverzicht via de plusknop
Op het configuratiescherm door bij de naam van de koppeling op het tandwieltje te klikken en 'handmatige upload' te selecteren

Selecteer de BAG-koppeling en voeg een bestand toe via de upload knop.

Een voorbeeld CSV kan gedownload worden vanuit het configuratiescherm van de koppeling. De inhoud van dit bestand is:

woonplaats_identificatie,woonplaats_begindatum,woonplaats_einddatum,woonplaats_naam,woonplaats_status,woonplaats_inonderzoek,openbareruimte_identificatie,openbareruimte_begindatum,openbareruimte_einddatum,openbareruimte_naam,openbareruimte_type,openbareruimte_inonderzoek,openbareruimte_status,nummeraanduiding_identificatie,nummeraanduiding_begindatum,nummeraanduiding_einddatum,nummeraanduiding_huisnummer,nummeraanduiding_huisletter,nummeraanduiding_huisnummertoevoeging,nummeraanduiding_postcode,nummeraanduiding_inonderzoek,nummeraanduiding_type,nummeraanduiding_status,verblijfsobject_identificatie,verblijfsobject_begindatum,verblijfsobject_einddatum,verblijfsobject_oppervlakte,verblijfsobject_status,verblijfsobject_inonderzoek,verblijfsobject_gebruiksdoel,pand_identificatie,pand_begindatum,pand_einddatum,pand_status,pand_inonderzoek,pand_bouwjaar
1331,2007-11-13,,Bussum,Woonplaats aangewezen,N,0381300000100001,2009-07-01,,Aaltje Noordewierlaan,Weg,N,Naamgeving uitgegeven,0381200000100500,1992-03-24,,1,A,1-R,1403JA,J,Verblijfsobject,Naamgeving uitgegeven,0381010000020398,1994-03-17,,67,Verblijfsobject in gebruik,N,woonfunctie,0381100000118244,1994-03-17,,Pand in gebruik,N,1992
1331,2007-11-13,,Bussum,Woonplaats aangewezen,N,0381300000100002,2009-07-02,,dr. Abraham Kuyperlaan,Weg,N,Naamgeving uitgegeven,0381200000105490,2010-09-21,,124,,,1402HR,N,Verblijfsobject,Naamgeving uitgegeven,0381010000024346,2002-12-27,,89,Verblijfsobject in gebruik,N,woonfunctie,0381100000117125,2002-12-27,,Pand in gebruik,N,2004
1331,2007-11-13,,Bussum,Woonplaats aangewezen,N,0381300000100003,2009-07-03,,Achtermeulenlaan,Weg,N,Naamgeving uitgegeven,0381200000100308,2010-09-21,,17,,,1402SW,N,Verblijfsobject,Naamgeving uitgegeven,0381010000020282,2010-05-12,,92,Verblijfsobject in gebruik,N,kantoorfunctie,0381100000105985,2010-05-12,,Pand in gebruik,N,1904
1331,2007-11-13,,Bussum,Woonplaats aangewezen,N,0381300000100233,2009-07-01,,Hooftlaan,Weg,N,Naamgeving uitgegeven,0381200000105209,1994-03-28,,30,,WS3,1401EE,N,Ligplaats,Naamgeving uitgegeven,0381020000100003,2010-10-05,,,Plaats aangewezen,N,woonfunctie,,,,,,
1331,2007-11-13,,Bussum,Woonplaats aangewezen,N,0381300000100308,2009-07-01,,Zanderijweg,Weg,N,Naamgeving uitgegeven,0381200000117616,1982-04-21,,7,,,1403XW,N,Standplaats,Naamgeving uitgegeven,0381030000100001,2010-10-05,,,Plaats aangewezen,N,woonfunctie,,,,,,

BuitenBeter

DigiD

Algemeen

Een burger kan via DigiD inloggen op het zaaksysteem om:

Een zaak aan te vragen

De burger wordt bij het starten van de aanvraag omgeleid naar de inlogpagina van digid en wordt vervolgens (bij succesvolle inlog) omgeleid naar het webformulier
Het zaaksysteem ontvangt hierbij enkel het BSN-nummer van DigiD. Wanneer deze burger reeds als contact in het zaaksysteem aanwezig is zal het systeem de gegevens van de burger weergeven op de contactgegevenspagina van het webformulier. Wanneer deze burger nog niet als contact in het zaaksysteem aanwezig is verplicht het systeem de burger om deze gegevens zelf in te vullen op de contactgegevenspagina van het webformulier.

De persoonlijke internetpagina in te zien

De burger wordt bij het inloggen op de PIP omgeleid naar de inlogpagina van digid en wordt vervolgens (bij succesvolle inlog) omgeleid naar zijn/haar PIP
Het zaaksysteem ontvangt hierbij enkel het BSN-nummer van DigiD. Wanneer deze burger als contact in het zaaksysteem aanwezig is zal het systeem de gegevens van de burger weergeven. Wanneer deze burger nog niet als contact in het zaaksysteem aanwezig is verplicht het systeem de burger om deze gegevens zelf in te vullen alvorens de PIP te tonen.

Beheer

Voor deze koppeling zijn drie instellingen aanwezig:

Authentication level - Hier kan je als beheerder het beveiligingsniveau voor de koppeling kiezen: Password of Password+sms
SAML Metadata URL - Deze URL zorgt ervoor dat de communicatie met Logius mogelijk is en zal worden beheerd door Mintlab
Certificaat CA van IDP (Digid/E-Herkenning/Etc) - Dit certificaat zorgt voor de beveiligde verbinding met Logius en zal worden beheerd door Mintlab

eHerkenning

Key2Burgerzaken

Algemeen

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

Uitleg

Een uitleg voor het instellen van deze koppeling:

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
```

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.

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.

Key2Financien

Dit is een export feature die zaken met financiele informatie exporteert, en na een complete export de zaken sluit.

Configuratie

Maak eerst een exportprofiel aan:

Ga naar het configuratiescherm en klik op de plusknop
Selecteer het type 'Key2Finance'
Geef een naam op, bijvoorbeeld die van het product in kwestie

Stel nu de volgende instellingen in:

Geef een API key op, met de key kan een externe partij authenticeren.
Een goede method om een key te genereren is een GUID tool zoals http://www.guidgenerator.com
Kies een zaaktype waarop gefilterd moet worden. De exportmodule zal alle zaken selecteren van dat zaaktype die klaar staan om afgerond te worden. Dat wil o.a. zeggen dat een resultaat ingevuld is, alle verplichte velden aanstaan en de zaak in de laatste fase is.
Stel vervolgens de gegevensmapping in. Een uitgebreide beschrijving hiervan volgt hieronder.
Activeer de koppeling

In de gegevensmapping worden twee kolommen getoond. De linkerkolom toont de namen van de 'kolommen' van het CSV bestand. De rechterkolom moet ingevuld worden met de (systeem)kenmerken. Bij de export wordt de data uit die kenmerken geplaatst in de kolommen van het CSV bestand.

Handmatige uitvoer

Het uitvoeren van de export bestaat uit 4 stappen. Elke stap is het invoeren van een URL in de navigatiebalk van de browser. In de URL's moeten verschillende variabele handmatig worden ingevoerd. Vervang hiervoor simpewel '<dit>' gedeelte door de variabele, bijvoorbeeld: '52'

Variabele	Locatie
<omgeving>	De gemeentenaam uit de zaaksysteem-URL: gemeentenaam.zaaksysteem.nl
<interface_id>	Het cijfer dat achter de naam van de koppeling wordt weergegeven, in het configuratiescherm
<api_key>	De opgegeven tekst in het API-veld de koppeling, in het configuratiescherm
<transactionID>	Deze is terug te vinden onderaan de pagina die getoond wordt na het invoeren van de eerste URL

Transactie klaarzetten:
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>

Helemaal onderaan staat het ‘transaction_id’, welke nodig is in de volgende stappen.

STDDEB.csv downloaden
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>

STDNAW.csv downloaden
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>

Transactie afsluiten
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/close_cases?transaction_id=<transactionID>&api_key=<api_key>

Dit maakt de transactie af, en sluit de geexporteerde zaken.
Let op: Fase acties worden niet uitgevoerd. De zaak wordt afgesloten dmv. de vroegtijdig afsluiten methode.

https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/close_cases?transaction_id=<transactionID>&api_key=<api_key>

Gegevens uit gerelateerde zaken

Gegevens uit gerelateerde zaken kunnen opgehaald worden door gebruik te maken van de iteratie-functie, die specifiek voor deze export mogelijk gemaakt is.

Door in een groot tekstveld dezelfde iteratie-syntax te gebruiken als bij e-mailsjablonen worden de magicstrings verwerkt voor de gerelateerde zaken, i.p.v. voor de zaak zelf.

{{ itereer over zaak_relaties
<willekeurige tekst>
}}

Bijvoorbeeld:

{{ itereer over zaak_relaties
[[zaak_bedrag]]
}}

Geautomatiseerde uitvoer

Er is ook een pythonscript beschikbaar om de bovenstaande handelingen geautomatiseerd uit te voeren: Download Pythonscript

Eenmalig: Installeer python
Eenmalig: Voeg de URL naar de programmamap toe in Path (zie screenshot 1)
Open het bestand in een tekstverwerker, zoals kladblok of notepad++
Vervang '<base_url> <interface_id> <api_key>' met de juiste gegevens (gescheiden door spatie) (zie screenshot 2)
Roep het bestand aan door in cmd.exe naar de juiste folder te browsen en in te typen: 'python' <bestandsnaam> (zie screenshot 3)

Instelling voor pythonscript
Variabele pythonscript in Notepad++
Pythonscript aanroepen

KVK-import

De KvK-bestanden kunnen worden toegevoegd via de volgende URL:
https://<omgeving>.zaaksysteem.nl/beheer/import/manual

Ogone

Qmatic

StUF-PRS

StUF-PRS attributes

    'required'      => [qw/
        straatnaam
        huisnummer
        postcode

        burgerservicenummer
        geslachtsnaam
        geslachtsaanduiding
        geboortedatum
    /],
    'optional'      => [qw/
        voornamen
        huisnummertoevoeging
        huisletter
        woonplaats
        geboorteplaats
        geboorteland
        a_nummer
[...]

StUF-PRS example message

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
  <BG:kennisgevingsBericht xmlns:BG="http://www.egem.nl/StUF/sector/bg/0204" xmlns:StUF="http://www.egem.nl/StUF/StUF0204" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <StUF:stuurgegevens xmlns="http://www.egem.nl/StUF/StUF0204">
   <StUF:berichtsoort>Lk01</StUF:berichtsoort>
   <StUF:entiteittype>PRS</StUF:entiteittype>
   <StUF:sectormodel>BG</StUF:sectormodel>
   <StUF:versieStUF>0204</StUF:versieStUF>
   <StUF:versieSectormodel>0204</StUF:versieSectormodel>
   <StUF:zender>
    <StUF:applicatie>CMODIS</StUF:applicatie>
   </StUF:zender>
   <StUF:ontvanger>
    <StUF:applicatie>ZSNL</StUF:applicatie>
   </StUF:ontvanger>
   <StUF:referentienummer>MK0000229154</StUF:referentienummer>
   <StUF:tijdstipBericht>2012110209011458</StUF:tijdstipBericht>
   <StUF:kennisgeving>
    <StUF:mutatiesoort>T</StUF:mutatiesoort>
    <StUF:indicatorOvername>V</StUF:indicatorOvername>
   </StUF:kennisgeving>
  </StUF:stuurgegevens>
  <BG:body xmlns="http://www.egem.nl/StUF/sector/bg/0204">
   <BG:PRS StUF:sleutelGegevensbeheer="1243796" StUF:sleutelVerzendend="1243796" StUF:verwerkingssoort="T" soortEntiteit="F">
    <BG:a-nummer>1234567890</BG:a-nummer>
    <BG:bsn-nummer>987654321</BG:bsn-nummer>
    <BG:voornamen>Tinues</BG:voornamen>
    <BG:voorletters>V</BG:voorletters>
    <BG:geslachtsnaam>Testpersoon</BG:geslachtsnaam>
    <BG:geboortedatum>19620529</BG:geboortedatum>
    <BG:geslachtsaanduiding>M</BG:geslachtsaanduiding>
    <BG:tijdvakGeldigheid>
     <StUF:begindatumTijdvakGeldigheid>19620529</StUF:begindatumTijdvakGeldigheid>
     <StUF:einddatumTijdvakGeldigheid StUF:noValue="geenWaarde" xsi:nil="true"/>
    </BG:tijdvakGeldigheid>
    <BG:PRSADRVBL StUF:sleutelGegevensbeheer="1243798" StUF:sleutelVerzendend="1243798" StUF:verwerkingssoort="T" soortEntiteit="R">
     <BG:tijdvakRelatie>
      <StUF:begindatumRelatie>20121030</StUF:begindatumRelatie>
      <StUF:einddatumRelatie StUF:noValue="geenWaarde" xsi:nil="true"/>
     </BG:tijdvakRelatie>
     <BG:extraElementen>
      <StUF:extraElement naam="aanduidingGegevensInOnderzoek">N</StUF:extraElement>
     </BG:extraElementen>
     <BG:ADR StUF:sleutelGegevensbeheer="22628" StUF:sleutelVerzendend="22628" StUF:verwerkingssoort="T" soortEntiteit="F">
      <BG:postcode>1015JL</BG:postcode>
      <BG:woonplaatsnaam>Amsterdam</BG:woonplaatsnaam>
      <BG:straatnaam>Donker Curtiusstraat</BG:straatnaam>
      <BG:huisnummer>7</BG:huisnummer>
      <BG:ingangsdatum>19511115</BG:ingangsdatum>
      <BG:einddatum StUF:noValue="geenWaarde" xsi:nil="true"/>
      <BG:extraElementen>
       <StUF:extraElement naam="officieleStraatnaam">Donker Curtiusstraat</StUF:extraElement>
       <StUF:extraElement naam="identificatieNummerAanduiding">0716200000762034</StUF:extraElement>
       <StUF:extraElement naam="authentiekeWoonplaatsnaam">Amsterdam</StUF:extraElement>
       <StUF:extraElement naam="identificatiecodeVerblijfplaats">0716010000028347</StUF:extraElement>
       <StUF:extraElement naam="identificatieTGO">0716010000028347</StUF:extraElement>
       <StUF:extraElement naam="openbareRuimteNaam">Donker Curtiusstraatt</StUF:extraElement>
       <StUF:extraElement naam="identificatieAOA">0716200000762034</StUF:extraElement>
       <StUF:extraElement naam="woonplaatsNaamBAG">Amsterdam</StUF:extraElement>
      </BG:extraElementen>
     </BG:ADR>
    </BG:PRSADRVBL>
   </BG:PRS>
  </BG:body>
 </BG:kennisgevingsBericht>
</soapenv:Body></soapenv:Envelope>

LET OP: Bovenstaande gegevens zijn geen reflectie van de werkelijkheid

StUF-ADR

StUF-ADR attributes

        required    => [qw/
            identificatie
            woonplaats
            openbareruimte
            postcode
            huisnummer
            status
            inonderzoek
        /],
        optional    => [qw/
            huisletter
            huisnummertoevoeging

            correctie
            documentnummer
            documentdatum
            type
            einddatum
            gebruiksobject_id
            woonplaats_naam
            straatnaam
            officieel
            begindatum
        /],

StUF-ADR example message

    <BG:kennisgevingsBericht xmlns:BG="http://www.egem.nl/StUF/sector/bg/0204" xmlns:StUF="http://www.egem.nl/StUF/StUF0204" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <StUF:stuurgegevens xmlns="http://www.egem.nl/StUF/StUF0204">
        <StUF:berichtsoort>Lk01</StUF:berichtsoort>
        <StUF:entiteittype>ADR</StUF:entiteittype>
        <StUF:sectormodel>BG</StUF:sectormodel>
        <StUF:versieStUF>0204</StUF:versieStUF>
        <StUF:versieSectormodel>0204</StUF:versieSectormodel>
        <StUF:zender>
          <StUF:applicatie>ZNDAPP</StUF:applicatie>
        </StUF:zender>
        <StUF:ontvanger>
          <StUF:applicatie>ONTVAPP</StUF:applicatie>
        </StUF:ontvanger>
        <StUF:referentienummer>ZS0000000001</StUF:referentienummer>
        <StUF:tijdstipBericht>2012112316002368</StUF:tijdstipBericht>
        <StUF:kennisgeving>
          <StUF:mutatiesoort>T</StUF:mutatiesoort>
          <StUF:indicatorOvername>V</StUF:indicatorOvername>
        </StUF:kennisgeving>
      </StUF:stuurgegevens>
      <BG:body xmlns="http://www.egem.nl/StUF/sector/bg/0204">
        <BG:ADR StUF:sleutelGegevensbeheer="27178" StUF:sleutelVerzendend="27178" StUF:verwerkingssoort="T" soortEntiteit="F">
          <BG:postcode>1015XK</BG:postcode>
          <BG:woonplaatsnaam>Amsterdam</BG:woonplaatsnaam>
          <BG:straatnaam>Donker Curtiusstraat</BG:straatnaam>
          <BG:huisnummer>7</BG:huisnummer>
          <BG:huisletter></BG:huisletter>
          <BG:huisnummertoevoeging>414</BG:huisnummertoevoeging>
          <BG:aanduidingBijHuisnummer StUF:noValue="geenWaarde" xsi:nil="true"/>
          <BG:locatieomschrijving StUF:noValue="nietGeautoriseerd" xsi:nil="true"/>
          <BG:locatieadresnummer StUF:noValue="nietGeautoriseerd" xsi:nil="true"/>
          <BG:ingangsdatum>20070403</BG:ingangsdatum>
          <BG:einddatum StUF:noValue="geenWaarde" xsi:nil="true"/>
          <BG:straatcode>9999</BG:straatcode>
          <BG:buurtcode>0</BG:buurtcode>
          <BG:wijkcode>0</BG:wijkcode>
          <BG:gemeentecode>363</BG:gemeentecode>
          <BG:tijdvakGeldigheid>
            <StUF:begindatumTijdvakGeldigheid>20100302</StUF:begindatumTijdvakGeldigheid>
            <StUF:einddatumTijdvakGeldigheid StUF:noValue="geenWaarde" xsi:nil="true"/>
          </BG:tijdvakGeldigheid>
          <BG:extraElementen>
            <StUF:extraElement naam="officieleStraatnaam">Donker Curtiusstraat</StUF:extraElement>
            <StUF:extraElement naam="aanduidingGegevensInOnderzoek">N</StUF:extraElement>
            <StUF:extraElement naam="identificatieNummerAanduiding">0363200000756684</StUF:extraElement>
            <StUF:extraElement naam="authentiekeIdentificatieOpenbareRuimte">0363300000000059</StUF:extraElement>
            <StUF:extraElement naam="authentiekeIdentificatieWoonplaats">1024</StUF:extraElement>
            <StUF:extraElement naam="authentiekeWoonplaatsnaam">Amsterdam</StUF:extraElement>
            <StUF:extraElement naam="statusCodeOmschrijving">Naamgeving uitgegeven</StUF:extraElement>
            <StUF:extraElement naam="identificatiecodeVerblijfplaats">0363010000032757</StUF:extraElement>
            <StUF:extraElement naam="status">Naamgeving uitgegeven</StUF:extraElement>
            <StUF:extraElement naam="identificatieTGO">0363010000032757</StUF:extraElement>
            <StUF:extraElement naam="identificatieWoonplaats">1024</StUF:extraElement>
            <StUF:extraElement naam="openbareRuimteNaam">Donker Curtiusstraat</StUF:extraElement>
            <StUF:extraElement naam="identificatieAOA">0363200000756684</StUF:extraElement>
            <StUF:extraElement naam="identificatieOpenbareRuimte">0363300000000059</StUF:extraElement>
            <StUF:extraElement naam="woonplaatsNaamBAG">Amsterdam</StUF:extraElement>
          </BG:extraElementen>
        </BG:ADR>
      </BG:body>
    </BG:kennisgevingsBericht>

LET OP: Bovenstaande gegevens zijn geen reflectie van de werkelijkheid

StUF-VBO

StUF-NNP

Telefooncentrale

Scanstraat

Wanneer deze koppeling actief is kunnen ingescande documenten in het zaaksysteem worden weergegeven in de documentintake. Vanuit de documentintake kunnen deze vervolgens in zaken geplaatst worden.

Elke minuut zal het zaaksysteem alle documenten die zich in een toegewezen map op de beheerbox van de gemeente bevinden kopiëren naar de documentintake in het zaaksysteem. De gemeente kan de scanners dusdanig configureren dat er een optie op de scanners aanwezig is waardoor gescande documenten direct in deze map zullen worden geplaatst.

Let op: De documentintake is enkel zichtbaar voor medewerkers met de rollen: Administrator, zaaksysteembeheerder en zaakbeheerder.

WOZ-import

Zaakinformatie bevragen

Korte uitleg (Zaken obv JSON)

Zaaksysteem biedt een mogelijk om zaakinformatie op te vragen van zaken die door middel van een publieke zoekopdracht te benaderen. De resultaten (zaakinformtie) van deze zoekopdracht worden terug gegeven in JSON-formaat en kunnen daarna gepresenteerd worden bijvoorbeeld door een CMS.

Welke data kan opgevraagd worden?

De resultaten van zaken in een (publiek gepubliceerde) zoekopdracht. Hierbij is een set van gegevens op te vragen, namelijk:

Zaaknummer (zaak.id)
Zaaktype (zaaktype.naam)
Registratiedatum
Afhandeldatum
Status (zaak.status)
Fase (naam)
Extra informatie (zaak.onderwerp)
Resultaat (zaak.resultaat)

Hoe wordt de data ontvangen?

De data wordt gerouterneerd in JSON formaat. De zaken zelf staan in de property 'result', wat altijd een array is. In het geval van een foutmelding is het eerste object in de 'result' array een foutmeldingobject. In principe wordt de HTTP status code in dit geval ook op 500 gezet. Deze status code zit ook in het antwoord in de property 'status_code'. In de properties 'next' en 'prev' staan de URLs waarmee volgende en vorige pagina's kunnen worden opgevraagd, 'at' is de huidige pagina, 'num_rows' het totaal aantal zaken wat aan de zoekopdrachten voldoet, en 'rows' is het aantal zaken wat in dit antwoord wordt teruggegeven.

Hoe kan data worden bevraagd?

De url van de call is {host}/public/search_case/?search_query_id={id}, waarbij {host} bijvoorbeeld 'https://mintlab.zaalsysteem.nl' is, en {id} het id van de gepubliceerde zoekopdracht.

Hoe moet data worden verwerkt?

De data komt terug in een JSON string, die geparsed moet worden. De hashes met de kenmerken van de gevonden zaken staan in de property 'result' in een array.

Voorbeeldvraag

https://quarterly.zaaksysteem.nl/public/search_case/?search_query_id=1

Voorbeeldantwoord

{
	"next": null,
	"comment": "This is not a DBIx::Class::ResultSet and does NOT support paging.",
	"prev": null,
	"at": null,
	"num_rows": 1,
	"rows": null,
	"result": [
		[
			{
				"afhandeldatum": null,
				"zaaktype": "bagtest",
				"status": "new",
				"fase": "Naam van Fase komt hier",
				"onderwerp": null,
				"registratiedatum": "2013-09-05T12:33:57",
				"resultaat": null,
				"id": 155
			}
		]
	]
}

Zoekopdracht als kaart publiceren

Wanneer in de instellingen wordt opgegeven dat de zoekopdracht gepubliceerd moet kunnen worden, kan ook de kaart gepubliceerd worden.

Bestand:Zoekopdracht instellingen.png

Gebruik hiervoor de volgende link: http://<omgeving>/search/<id>/results/public_map

Variabele	Locatie
<omgeving>	De gemeentenaam uit de zaaksysteem-URL: gemeentenaam.zaaksysteem.nl
<id>	Dit cijfer is terug te vinden in de URL wanneer de zoekopdracht intern bekeken wordt Bestand:Zoekopdracht URL.png

@@ Regel 60: / Regel 60: @@
 |
 |
+|-
 |3
 |Buiten Beter
@@ Regel 65: / Regel 66: @@
 |
 |
+|-
 |4
 |DigiD
@@ Regel 70: / Regel 72: @@
 |
 |
+|-
 |5
 |eHerkenning
@@ Regel 75: / Regel 78: @@
 |
 |
+|-
 |6
 |Key2Burgerzaken
@@ Regel 80: / Regel 84: @@
 |
 |
+|-
 |7
 |Key2Financien
@@ Regel 85: / Regel 90: @@
 |
 |
+|-
 |8
 |KVK-import
@@ Regel 90: / Regel 96: @@
 |
 |
+|-
 |9
 |Ogone
@@ Regel 95: / Regel 102: @@
 |
 |
+|-
 |10
 |Qmatic
@@ Regel 100: / Regel 108: @@
 |
 |
+|-
 |11
 |StuF-PRS
@@ Regel 105: / Regel 114: @@
 |
 |
+|-
 |12
 |StuF-ADR
@@ Regel 110: / Regel 120: @@
 |
 |
+|-
 |13
 |StuF-VBO
@@ Regel 115: / Regel 126: @@
 |
 |
+|-
 |14
 |StuF-NNP
@@ Regel 120: / Regel 132: @@
 |
 |
+|-
 |15
 |Telefooncentrale
@@ Regel 125: / Regel 138: @@
 |
 |
+|-
 |16
 |Scanstraat
@@ Regel 130: / Regel 144: @@
 |
 |
+|-
 |17
 |WOZ-import
@@ Regel 135: / Regel 150: @@
 |
 |
+|-
 |18
 |Zaakinformatie bevragen
@@ Regel 140: / Regel 156: @@
 |
 |
+|-
 |19
 |Zoekopdracht als kaart publiceren

Koppelingen: verschil tussen versies

Versie van 1 mrt 2014 om 17:50

Inhoud

Algemeen

Transactieoverzicht

Configuratiescherm

Afnemerindicaties

Screenshots

Koppelingen

Active Directory

BAG-import

BuitenBeter

DigiD

Algemeen

Beheer

eHerkenning

Key2Burgerzaken

Algemeen

Uitleg

Key2Financien

Configuratie

Handmatige uitvoer

Gegevens uit gerelateerde zaken

Geautomatiseerde uitvoer

KVK-import

Ogone

Qmatic

StUF-PRS

StUF-PRS attributes

StUF-PRS example message

StUF-ADR

StUF-ADR attributes

StUF-ADR example message

StUF-VBO

StUF-NNP

Telefooncentrale

Scanstraat

WOZ-import

Zaakinformatie bevragen

Korte uitleg (Zaken obv JSON)

Welke data kan opgevraagd worden?

Hoe wordt de data ontvangen?

Hoe kan data worden bevraagd?

Hoe moet data worden verwerkt?

Voorbeeldvraag

Voorbeeldantwoord

Zoekopdracht als kaart publiceren

Navigatiemenu

Zoeken