De Zaak- en Documentservices (ZDS) wijken af van de Zaakgericht werken (ZGW) APIs, maar er is ook overlap. De belangrijkste verschillen en overeenkomsten op een rij:
| Zaak-Documentservices | ZGW APIs* |
|---|---|
| SOAP/XML gebaseerd | REST/JSON gebaseerd |
| Gebaseerd op het informatiemodel RGBZ1 | Gebaseerd op informatiemodel RGBZ2 waar van toepassing |
| Verdere invulling/uitwerking van de basisberichten uit StUF ZKN | Aparte calls voor aparte resources |
| Uitwisselen van informatie inclusief gerelateerde gegevens, gestructureerd volgens het informatiemodel RGBZ 1 | Uitwisselen van informatie op basis van atomische resources, waarbij er gerefereerd wordt naar een resource in een component in plaats van deze te embedden. |
| Ondersteunen van de functies van een zaaksysteem zoals beschreven in GEMMA 1 | Ondersteunen van functies van de referentiecomponenten zoals beschreven in GEMMA 2 |
| Kent alleen de functionele acties die uitgewerkt zijn in de standaard. | Alle functionele acties die mogelijk zijn met de CRUD functionaliteit zijn mogelijk. De ZGW API’s zijn microservices die gecombineerd kunnen worden om een functionele behoefte in te vullen. |
| Betrokkenen en/of gerelateerde objecten kunnen geheel of gedeeltelijk, in ieder geval met matchinggegevens doorgegeven worden. Deze worden veelal in het zaaksysteem opgeslagen. | Een relatie naar een andere resource is een verwijzing naar die resource. Die resource wordt opgeslagen in de betreffende registratie. Dat kan een zaakregistratie (ZRC) zijn maar ook een andere (met een eigen API). |
| Bestaan voornamelijk uit a-synchrone services | Bestaan uit alleen maar synchrone services |
| Een GEMMA 1 Zaaksysteem bevat ook (generieke) zaakafhandelfunctionaliteit. Deze hoeft niet per se via ZDS te communiceren met het eigen zakenmagazijn | Een GEMMA 2 Zaken API registreert alleen zaken en (verwijzingen naar) gerelateerden. Afhandelen gebeurt in een zaakafhandelcomponent (ZAC). Communicatie vindt plaats via de ZGW API’s |
| Zaak- Documentservices is gemaakt om taakspecifieke applicaties te koppelen aan een zaaksysteem. | ZGW API’s zijn gemaakt om zaakgericht werken te ondersteunen |
| Zaak- Documentservices beschrijven alleen hoe zaken, documenten en besluiten in een zaaksysteem vastgelegd kunnen worden. Er wordt niet beschreven hoe een ZTC bevraagd moet worden etc. | ZGW API’s ondersteunen alle onderdelen van het zaakgericht werken, ook het bevragen van een ZTC etc. |
| De Zaak- Documentservices standaard bestaat uit een specificatiedocument, xsd schema’s en documentatie van de onderliggende StUF en CMIS standaarden. | ZGW API standaard bestaat per API uit een OpenAPI 3 specificatie (OAS), functionele en technische documentatie en referentie-implementaties |
| Beheer van de Zaak- Documentservices gebeurt in de werkgroep Beheer Zaak- Documentservices. Daarnaast volgt de standaard de ontwikkelingen in de StUF standaard (voor zover van toepassing). | Beheer van de ZGW API standaard zal (open source) plaatsvinden onder regie van VNG-Realisatie. Belanghebbenden kunnen wensen, bevindingen of zelfs wijzigingsvoorstellen indienen via issues en pull requests. |
| Zaak- Documentservices kent extraElementen, label-value combinaties voor gegevens die niet in het RGBZ 1 opgenomen zijn. | ZGW API’s werken op resources. Wanneer een attribuut of zelfs een resource niet bekend is moet deze toegevoegd worden aan de API die bij de juiste registratie hoort. |
Alle ZGW APIs zitten nu* op versie 1.0.0
| ZDS 1.2 | ZGW APIs* |
|---|---|
Geef Zaakstatus (geefZaakstatus_ZakLv01) |
Zaken API GET /statussen?zaak=<ID> |
Geef Zaakdetails (geefZaakdetails_ZakLv01) |
Zaken API GET /zaken/<ID> |
Actualiseer Zaakstatus (actualiseerZaakstatus_ZakLk01) |
Zaken API POST /statussen/ |
Creëer Zaak (creeerZaak_ZakLk01) |
Zaken API POST /zaken |
Update Zaak (updateZaak_ZakLk01) |
Zaken API PUT /zaken/<ID> |
Genereer Zaakidentificatie (genereerZaakIdentificatie_Di02) |
niet geïmplementeerd, in overweging 1 |
Geef lijst Zaakdocumenten (geefLijstZaakdocumenten_ZakLv01) |
Documenten API GET /objectinformatieobjecten |
Geef Zaakdocument lezen (geefZaakdocumentLezen_EdcLv01) |
Documenten API GET /enkelvoudiginformatieobjecten/<ID> |
Geef Zaakdocument bewerken (geefZaakdocumentbewerken_Di02) |
Documenten API POST /enkelvoudiginformatieobjecten/<ID>/lock |
Voeg Zaakdocument toe (voegZaakdocumentToe_EdcLk01) |
Documenten API POST /enkelvoudiginformatieobjecten |
Maak Zaakdocument (maakZaakdocument_EdcLk01) |
niet geïmplementeerd, in overweging 2 |
Update Zaakdocument (updateZaakdocument_Di02) |
Documenten API POST /enkelvoudiginformatieobjecten |
Genereer Documentidentificatie (genereerDocumentIdentificatie_Di02) |
niet geïmplementeerd, in overweging 1 |
Cancel CheckOut (cancelCheckout_Di02) |
Documenten API POST /enkelvoudiginformatieobjecten/<ID>/unlock |
| CMIS-integratieservice (geen operatie) | n.v.t. |
| Koppel Zaakdocument aan Zaak (bestaat niet) | Documenten API POST /objectinformatieobjecten |
Ontkoppel Zaakdocument (ontkoppelZaakdocument_Di02) |
Documenten API DELETE /objectinformatieobjecten |
Voeg besluit toe (voegBesluitToe_Di01) |
Besluiten API POST /besluiten |
Update Besluit (updateBesluit_BslLk01) |
Besluiten API PUT /besluiten |
Genereer Besluit Identificatie (genereerBesluitIdentificatie_Di02) |
niet geïmplementeerd, in overweging 1 |
Geef Besluitdetails (geefBesluitDetails_BslLv01) |
Besluiten API GET /besluiten/<ID> |
Geef lijst Besluiten (geefLijstBesluiten_ZakLv01) |
Besluiten API GET /besluiten |
Overdragen te behandelen Zaak (overdragenZaak_Di01) |
n.v.t. |
* Op het moment van publicatie.
Zie voortgang (tijdelijke oplossing).