Koppelingen

Algemeen

De volgende koppelingen kunnen beheerd worden vanuit het zaaksysteem:

• Key2Finance
• Key2Burgerzaken
• KvK-Import
• Bag-Import
• GBA-Import

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.

Bestand:Koppelingen transactieoverzicht.png

Configuratie

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)

&&&afbeelding

Afnemerindicaties

&&&aanvullen

Koppelingen

Key2Financien

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

Configuratie

Maak een export profiel aan via Beheer > Koppelingen. Kies het type 'key2finance'

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.

Vervolgens moet de veldconfiguratie ingesteld worden. In dit Google doc staan de velden. Er kunnen kenmerken gebruikt worden of bestaande velden.

Uitvoer

Om te testen heb je het interfaceID nodig. Dit kan je achterhalen door in Chrome je Developer tools te openen, en dan het koppelingen profiel op te slaan. Je ziet dan een update request met het interfaceID.

Het export proces bestaat uit vier stappen:
Stap 1: Transactie klaarzetten:
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>

Als je in Chrome “JSON Viewer” installeert wordt het resultaat netter weergegeven. Helemaal onderaan staat het ‘transaction_id’, welke nodig is in de volgende stappen.

Stap 2: 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>

Stap 3: 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>

Stap 4: 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.