Configuration¶
Before the Catalogi Importer can be used we need to setup credentials for the backend services. If you just need to add a new catalog in a pre-configured Open Zaak installation, skip to Add a catalog.
Configure Open Zaak¶
To be able to connect from Catalogi Importer to Open Zaak we need to create API credentials in Open Zaak:
Navigate to API Autorisaties > Applicaties
Click Applicatie toevoegen.
Fill out the form:
Label: For example:
Catalogi Importer
Client ID: For example:
catalogi-importer
Secret: Some random string. You will need this later on!
Click Opslaan en opnieuw bewerken.
Click Beheer autorisaties.
Select component Catalogi API and scopes catalogi.lezen en catalogi.schrijven.
Click Opslaan
Configure Catalogi Importer¶
Next, we need to add these credentials to the Catalogi Importer:
Navigate to Importer > Services
Click Add Service.
Fill out the form:
Label: For example:
Open Zaak Productie
Type:
ZTC (Zaaktypen)
API Root URL: For example:
https://openzaak.gemeente.nl/catalogi/api/v1/
Client id:: Same as above
Secret:: Same as above
Authorization type::
ZGW Client id and secret
OAS:
https://openzaak.gemeente.nl/catalogi/api/v1/schema/openapi.yaml
Click Save.
The Catalogi Importer uses the VNG Selectielijst (such as the one provided by Open Zaak):
Navigate to Importer > Services
Click Add Service.
Fill out the form:
Label: For example:
Selectielijst
Type:
ORC (overige)
API Root URL:
https://selectielijst.openzaak.nl/api/v1/
Authorization type::
No authorisation
OAS:
https://selectielijst.openzaak.nl/api/v1/schema/openapi.yaml
Click Save.
Navigate to Importer > Selectielijst configuration
In the pull-down menu select the record with the label we just created.
Click Save.
Add a catalog¶
We need to retrieve the UUID of the Open Zaak Catalog we want to import to from the Open Zaak admin:
Navigate to Gegevens > Catalogi
Select the Catalogus we want to import to, or create a new one for testing purposes.
Copy the UUID value from the form.
Then we configure this Catalog in Catalogi Importer:
Navigate to Importer > Catalog configurations
Click Add Catalog configuration.
Fill out the form:
Select the Service that with the label we configured earlier.
Paste the UUID we copied from Open Zaak.
Enter a descriptive Label, ideally matching the Catalog in Open Zaak.
Click Save.
The system will validate the UUID at the selected Service.
If the details are correct the RSIN and domain will be retrieved and printed
This catalog is now configured in Catalogi Importer to accept one or more Import Jobs.
This is a one-time configuration that is valid for all catalogs in this Open Zaak installation.
Additional Open Zaak installations like a testing or acceptation environment can be added following the same pattern.