--- title: "Werk een ZAAK deels bij." method: PATCH path: "/zaken/{uuid}" tags: ["zaken"] --- # Werk een ZAAK deels bij. `PATCH /zaken/{uuid}` **Er wordt gevalideerd op** - `identificatie` mag niet gewijzigd worden. - `laatsteBetaaldatum` mag niet in de toekomst liggen. - `laatsteBetaaldatum` mag niet gezet worden als de betalingsindicatie "nvt" is. - `archiefnominatie` moet een waarde hebben indien `archiefstatus` niet de waarde "nog_te_archiveren" heeft. - `archiefactiedatum` moet een waarde hebben indien `archiefstatus` niet de waarde "nog_te_archiveren" heeft. - `archiefstatus` kan alleen een waarde anders dan "nog_te_archiveren" hebben indien van alle gerelateeerde INFORMATIEOBJECTen het attribuut `status` de waarde "gearchiveerd" heeft. **Opmerkingen** - er worden enkel zaken getoond van de zaaktypes waar u toe geautoriseerd bent. - indien een zaak heropend moet worden, doe dit dan door een nieuwe status toe te voegen die NIET de eindstatus is. Zie de `Status` resource. ## Path parameters - `uuid` string, uuid, required — Unieke resource identifier (UUID4) ## Headers - `Content-Type` 'application/json', required - `X-NLX-Logrecord-ID` string - `X-Audit-Toelichting` string - `Accept-Crs` 'EPSG:4326', required - `Content-Crs` 'EPSG:4326', required ## Request body - PatchedZaak — Set gegevensgroepdata from validated nested data. Usage: include the mixin on the ModelSerializer that has gegevensgroepen. - `url` string, uri — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object. - `uuid` string, uuid — Unieke resource identifier (UUID4) - `identificatie` string — De unieke identificatie van de ZAAK binnen de organisatie die verantwoordelijk is voor de behandeling van de ZAAK. - `bronorganisatie` string — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de zaak heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef - `omschrijving` string — Een korte omschrijving van de zaak. - `toelichting` string — Een toelichting op de zaak. - `zaaktype` string, uri — URL-referentie naar het ZAAKTYPE (in de Catalogi API) in de CATALOGUS waar deze voorkomt - `registratiedatum` string, date — De datum waarop de zaakbehandelende organisatie de ZAAK heeft geregistreerd. Indien deze niet opgegeven wordt, wordt de datum van vandaag gebruikt. - `verantwoordelijkeOrganisatie` string — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die eindverantwoordelijk is voor de behandeling van de zaak. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef - `startdatum` string, date — De datum waarop met de uitvoering van de zaak is gestart - `einddatum` string, date, nullable — De datum waarop de uitvoering van de zaak afgerond is. - `einddatumGepland` string, date, nullable — De datum waarop volgens de planning verwacht wordt dat de zaak afgerond wordt. - `uiterlijkeEinddatumAfdoening` string, date, nullable — De laatste datum waarop volgens wet- en regelgeving de zaak afgerond dient te zijn. - `publicatiedatum` string, date, nullable — Datum waarop (het starten van) de zaak gepubliceerd is of wordt. - `communicatiekanaal` string, uri — Het medium waarlangs de aanleiding om een zaak te starten is ontvangen. URL naar een communicatiekanaal in de VNG-Referentielijst van communicatiekanalen. - `productenOfDiensten` string[] — De producten en/of diensten die door de zaak worden voortgebracht. Dit zijn URLs naar de resources zoals die door de producten- en dienstencatalogus-API wordt ontsloten. De producten/diensten moeten bij het zaaktype vermeld zijn. - `vertrouwelijkheidaanduiding` 'openbaar' | 'beperkt_openbaar' | 'intern' | 'zaakvertrouwelijk' | 'vertrouwelijk' | 'confidentieel' | 'geheim' | 'zeer_geheim' - `betalingsindicatie` union — Indicatie of de, met behandeling van de zaak gemoeide, kosten betaald zijn door de desbetreffende betrokkene. Uitleg bij mogelijke waarden: * `nvt` - Er is geen sprake van te betalen, met de zaak gemoeide, kosten. * `nog_niet` - De met de zaak gemoeide kosten zijn (nog) niet betaald. * `gedeeltelijk` - De met de zaak gemoeide kosten zijn gedeeltelijk betaald. * `geheel` - De met de zaak gemoeide kosten zijn geheel betaald. - 'nvt' | 'nog_niet' | 'gedeeltelijk' | 'geheel' - '' - `betalingsindicatieWeergave` string — Uitleg bij `betalingsindicatie`. - `laatsteBetaaldatum` string, date-time, nullable — De datum waarop de meest recente betaling is verwerkt van kosten die gemoeid zijn met behandeling van de zaak. - `zaakgeometrie` union - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` number[], required - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` Point2D[], required - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` Point2D[], required - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` array[], required - Point2D[] - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` array[], required - Point2D[] - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` array[], required - array[] - Point2D[] - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `geometries` Geometry[], required - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `verlenging` Verlenging, nullable — Gegevens omtrent het verlengen van de doorlooptijd van de behandeling van de ZAAK - `reden` string, required — Omschrijving van de reden voor het verlengen van de behandeling van de zaak. - `duur` string, duration, required — Het aantal werkbare dagen waarmee de doorlooptijd van de behandeling van de ZAAK is verlengd (of verkort) ten opzichte van de eerder gecommuniceerde doorlooptijd. - `opschorting` Opschorting, nullable — Gegevens omtrent het tijdelijk opschorten van de behandeling van de ZAAK - `indicatie` boolean, required — Aanduiding of de behandeling van de ZAAK tijdelijk is opgeschort. - `reden` string, required — Omschrijving van de reden voor het opschorten van de behandeling van de zaak. - `selectielijstklasse` string, uri — URL-referentie naar de categorie in de gehanteerde 'Selectielijst Archiefbescheiden' die, gezien het zaaktype en het resultaattype van de zaak, bepalend is voor het archiefregime van de zaak. - `hoofdzaak` string, uri, nullable — URL-referentie naar de ZAAK, waarom verzocht is door de initiator daarvan, die behandeld wordt in twee of meer separate ZAAKen waarvan de onderhavige ZAAK er één is. - `deelzaken` string[] — URL-referenties naar deel ZAAKen. - `relevanteAndereZaken` RelevanteZaak[] — Een lijst van relevante andere zaken. - `url` string, uri, required - `aardRelatie` 'vervolg' | 'onderwerp' | 'bijdrage', required - `eigenschappen` string[] - `rollen` string[] - `status` string, uri, nullable — Indien geen status bekend is, dan is de waarde 'null' - `zaakinformatieobjecten` string[] - `zaakobjecten` string[] - `kenmerken` ZaakKenmerk[] — Lijst van kenmerken. Merk op dat refereren naar gerelateerde objecten beter kan via `ZaakObject`. - `kenmerk` string, required — Identificeert uniek de zaak in een andere administratie. - `bron` string, required — De aanduiding van de administratie waar het kenmerk op slaat. - `archiefnominatie` union — Aanduiding of het zaakdossier blijvend bewaard of na een bepaalde termijn vernietigd moet worden. Uitleg bij mogelijke waarden: * `blijvend_bewaren` - Het zaakdossier moet bewaard blijven en op de Archiefactiedatum overgedragen worden naar een archiefbewaarplaats. * `vernietigen` - Het zaakdossier moet op of na de Archiefactiedatum vernietigd worden. - 'blijvend_bewaren' | 'vernietigen' - '' - unknown - `archiefstatus` 'nog_te_archiveren' | 'gearchiveerd' | 'gearchiveerd_procestermijn_onbekend' | 'overgedragen' - `archiefactiedatum` string, date, nullable — De datum waarop het gearchiveerde zaakdossier vernietigd moet worden dan wel overgebracht moet worden naar een archiefbewaarplaats. Wordt automatisch berekend bij het aanmaken of wijzigen van een RESULTAAT aan deze ZAAK indien nog leeg. - `resultaat` string, uri, nullable — URL-referentie naar het RESULTAAT. Indien geen resultaat bekend is, dan is de waarde 'null' - `opdrachtgevendeOrganisatie` string — De krachtens publiekrecht ingestelde rechtspersoon dan wel ander niet-natuurlijk persoon waarbinnen het (bestuurs)orgaan zetelt dat opdracht heeft gegeven om taken uit te voeren waaraan de zaak invulling geeft. - `processobjectaard` string, nullable — Omschrijving van het object, subject of gebeurtenis waarop, vanuit archiveringsoptiek, de zaak betrekking heeft. - `startdatumBewaartermijn` string, date, nullable — De datum die de start markeert van de termijn waarop het zaakdossier vernietigd moet worden. - `processobject` Processobject, nullable — Specificatie van de attribuutsoort van het object, subject of gebeurtenis waarop, vanuit archiveringsoptiek, de zaak betrekking heeft en dat bepalend is voor de start van de archiefactietermijn. - `datumkenmerk` string, required — De naam van de attribuutsoort van het procesobject dat bepalend is voor het einde van de procestermijn. - `identificatie` string, required — De unieke aanduiding van het procesobject. - `objecttype` string, required — Het soort object dat het procesobject representeert. - `registratie` string, required — De naam van de registratie waarvan het procesobject deel uit maakt. ## Response `200` OK - Zaak — Een zaak in de context van zaakgericht werken bij Nederlandse overheden, een afgebakend proces dat wordt uitgevoerd om een bepaald doel te bereiken voor een burger, bedrijf of andere instantie. Denk bijvoorbeeld aan het aanvragen van een paspoort, het doen van een melding openbare ruimte, of het aanvragen van een vergunning. - `url` string, uri, required — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object. - `uuid` string, uuid, required — Unieke resource identifier (UUID4) - `identificatie` string — De unieke identificatie van de ZAAK binnen de organisatie die verantwoordelijk is voor de behandeling van de ZAAK. - `bronorganisatie` string, required — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de zaak heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef - `omschrijving` string — Een korte omschrijving van de zaak. - `toelichting` string — Een toelichting op de zaak. - `zaaktype` string, uri, required — URL-referentie naar het ZAAKTYPE (in de Catalogi API) in de CATALOGUS waar deze voorkomt - `registratiedatum` string, date — De datum waarop de zaakbehandelende organisatie de ZAAK heeft geregistreerd. Indien deze niet opgegeven wordt, wordt de datum van vandaag gebruikt. - `verantwoordelijkeOrganisatie` string, required — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die eindverantwoordelijk is voor de behandeling van de zaak. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef - `startdatum` string, date, required — De datum waarop met de uitvoering van de zaak is gestart - `einddatum` string, date, nullable, required — De datum waarop de uitvoering van de zaak afgerond is. - `einddatumGepland` string, date, nullable — De datum waarop volgens de planning verwacht wordt dat de zaak afgerond wordt. - `uiterlijkeEinddatumAfdoening` string, date, nullable — De laatste datum waarop volgens wet- en regelgeving de zaak afgerond dient te zijn. - `publicatiedatum` string, date, nullable — Datum waarop (het starten van) de zaak gepubliceerd is of wordt. - `communicatiekanaal` string, uri — Het medium waarlangs de aanleiding om een zaak te starten is ontvangen. URL naar een communicatiekanaal in de VNG-Referentielijst van communicatiekanalen. - `productenOfDiensten` string[] — De producten en/of diensten die door de zaak worden voortgebracht. Dit zijn URLs naar de resources zoals die door de producten- en dienstencatalogus-API wordt ontsloten. De producten/diensten moeten bij het zaaktype vermeld zijn. - `vertrouwelijkheidaanduiding` 'openbaar' | 'beperkt_openbaar' | 'intern' | 'zaakvertrouwelijk' | 'vertrouwelijk' | 'confidentieel' | 'geheim' | 'zeer_geheim' - `betalingsindicatie` union — Indicatie of de, met behandeling van de zaak gemoeide, kosten betaald zijn door de desbetreffende betrokkene. Uitleg bij mogelijke waarden: * `nvt` - Er is geen sprake van te betalen, met de zaak gemoeide, kosten. * `nog_niet` - De met de zaak gemoeide kosten zijn (nog) niet betaald. * `gedeeltelijk` - De met de zaak gemoeide kosten zijn gedeeltelijk betaald. * `geheel` - De met de zaak gemoeide kosten zijn geheel betaald. - 'nvt' | 'nog_niet' | 'gedeeltelijk' | 'geheel' - '' - `betalingsindicatieWeergave` string, required — Uitleg bij `betalingsindicatie`. - `laatsteBetaaldatum` string, date-time, nullable — De datum waarop de meest recente betaling is verwerkt van kosten die gemoeid zijn met behandeling van de zaak. - `zaakgeometrie` union - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` number[], required - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` Point2D[], required - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` Point2D[], required - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` array[], required - Point2D[] - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` array[], required - Point2D[] - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `coordinates` array[], required - array[] - Point2D[] - number[] - object — GeoJSON geometry - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `geometries` Geometry[], required - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'Feature' | 'FeatureCollection' | 'GeometryCollection', required - `verlenging` Verlenging, nullable — Gegevens omtrent het verlengen van de doorlooptijd van de behandeling van de ZAAK - `reden` string, required — Omschrijving van de reden voor het verlengen van de behandeling van de zaak. - `duur` string, duration, required — Het aantal werkbare dagen waarmee de doorlooptijd van de behandeling van de ZAAK is verlengd (of verkort) ten opzichte van de eerder gecommuniceerde doorlooptijd. - `opschorting` Opschorting, nullable — Gegevens omtrent het tijdelijk opschorten van de behandeling van de ZAAK - `indicatie` boolean, required — Aanduiding of de behandeling van de ZAAK tijdelijk is opgeschort. - `reden` string, required — Omschrijving van de reden voor het opschorten van de behandeling van de zaak. - `selectielijstklasse` string, uri — URL-referentie naar de categorie in de gehanteerde 'Selectielijst Archiefbescheiden' die, gezien het zaaktype en het resultaattype van de zaak, bepalend is voor het archiefregime van de zaak. - `hoofdzaak` string, uri, nullable — URL-referentie naar de ZAAK, waarom verzocht is door de initiator daarvan, die behandeld wordt in twee of meer separate ZAAKen waarvan de onderhavige ZAAK er één is. - `deelzaken` string[], required — URL-referenties naar deel ZAAKen. - `relevanteAndereZaken` RelevanteZaak[] — Een lijst van relevante andere zaken. - `url` string, uri, required - `aardRelatie` 'vervolg' | 'onderwerp' | 'bijdrage', required - `eigenschappen` string[], required - `rollen` string[], required - `status` string, uri, nullable, required — Indien geen status bekend is, dan is de waarde 'null' - `zaakinformatieobjecten` string[], required - `zaakobjecten` string[], required - `kenmerken` ZaakKenmerk[] — Lijst van kenmerken. Merk op dat refereren naar gerelateerde objecten beter kan via `ZaakObject`. - `kenmerk` string, required — Identificeert uniek de zaak in een andere administratie. - `bron` string, required — De aanduiding van de administratie waar het kenmerk op slaat. - `archiefnominatie` union — Aanduiding of het zaakdossier blijvend bewaard of na een bepaalde termijn vernietigd moet worden. Uitleg bij mogelijke waarden: * `blijvend_bewaren` - Het zaakdossier moet bewaard blijven en op de Archiefactiedatum overgedragen worden naar een archiefbewaarplaats. * `vernietigen` - Het zaakdossier moet op of na de Archiefactiedatum vernietigd worden. - 'blijvend_bewaren' | 'vernietigen' - '' - unknown - `archiefstatus` 'nog_te_archiveren' | 'gearchiveerd' | 'gearchiveerd_procestermijn_onbekend' | 'overgedragen' - `archiefactiedatum` string, date, nullable — De datum waarop het gearchiveerde zaakdossier vernietigd moet worden dan wel overgebracht moet worden naar een archiefbewaarplaats. Wordt automatisch berekend bij het aanmaken of wijzigen van een RESULTAAT aan deze ZAAK indien nog leeg. - `resultaat` string, uri, nullable, required — URL-referentie naar het RESULTAAT. Indien geen resultaat bekend is, dan is de waarde 'null' - `opdrachtgevendeOrganisatie` string — De krachtens publiekrecht ingestelde rechtspersoon dan wel ander niet-natuurlijk persoon waarbinnen het (bestuurs)orgaan zetelt dat opdracht heeft gegeven om taken uit te voeren waaraan de zaak invulling geeft. - `processobjectaard` string, nullable — Omschrijving van het object, subject of gebeurtenis waarop, vanuit archiveringsoptiek, de zaak betrekking heeft. - `startdatumBewaartermijn` string, date, nullable — De datum die de start markeert van de termijn waarop het zaakdossier vernietigd moet worden. - `processobject` Processobject, nullable — Specificatie van de attribuutsoort van het object, subject of gebeurtenis waarop, vanuit archiveringsoptiek, de zaak betrekking heeft en dat bepalend is voor de start van de archiefactietermijn. - `datumkenmerk` string, required — De naam van de attribuutsoort van het procesobject dat bepalend is voor het einde van de procestermijn. - `identificatie` string, required — De unieke aanduiding van het procesobject. - `objecttype` string, required — Het soort object dat het procesobject representeert. - `registratie` string, required — De naam van de registratie waarvan het procesobject deel uit maakt. ## Other responses - `400` — Bad request - `401` — Unauthorized - `403` — Forbidden - `404` — Not found - `406` — Not acceptable - `409` — Conflict - `410` — Gone - `412` — Precondition failed - `415` — Unsupported media type - `429` — Too many requests - `500` — Internal server error --- [API](https://skmtc.net/vng-realisatie/apis/zaken-api.md) · [All operations](https://skmtc.net/vng-realisatie/apis/zaken-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vng-realisatie/zaken-api/revisions/e4bb3b85eb48/schema)