{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/vng-realisatie/main/json-schema/vng-realisatie-zaak-type-schema.json",
  "title": "ZaakType",
  "description": "Set gegevensgroepdata from validated nested data.\n\nUsage: include the mixin on the ModelSerializer that has gegevensgroepen.",
  "x-generated": "2026-10-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vng-realisatie-catalogi-openapi.yml#/components/schemas/ZaakType",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "readOnly": true,
      "title": "url",
      "description": "URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.",
      "minLength": 1,
      "maxLength": 1000
    },
    "identificatie": {
      "type": "string",
      "description": "Unieke identificatie van het ZAAKTYPE binnen de CATALOGUS waarin het ZAAKTYPE voorkomt.",
      "title": "identificatie",
      "maxLength": 50
    },
    "omschrijving": {
      "type": "string",
      "description": "Omschrijving van de aard van ZAAKen van het ZAAKTYPE.",
      "title": "omschrijving",
      "maxLength": 80
    },
    "omschrijvingGeneriek": {
      "type": "string",
      "description": "Algemeen gehanteerde omschrijving van de aard van ZAAKen van het ZAAKTYPE",
      "title": "omschrijving generiek",
      "maxLength": 80
    },
    "vertrouwelijkheidaanduiding": {
      "allOf": [
        {
          "$ref": "#/$defs/VertrouwelijkheidaanduidingEnum"
        }
      ],
      "description": "Aanduiding van de mate waarin zaakdossiers van ZAAKen van dit ZAAKTYPE voor de openbaarheid bestemd zijn. Indien de zaak bij het aanmaken geen vertrouwelijkheidaanduiding krijgt, dan wordt deze waarde gezet.\n\nUitleg bij mogelijke waarden:\n\n* `openbaar` - Openbaar\n* `beperkt_openbaar` - Beperkt openbaar\n* `intern` - Intern\n* `zaakvertrouwelijk` - Zaakvertrouwelijk\n* `vertrouwelijk` - Vertrouwelijk\n* `confidentieel` - Confidentieel\n* `geheim` - Geheim\n* `zeer_geheim` - Zeer geheim",
      "title": "vertrouwelijkheidaanduiding"
    },
    "doel": {
      "type": "string",
      "description": "Een omschrijving van hetgeen beoogd is te bereiken met een zaak van dit zaaktype.",
      "title": "doel"
    },
    "aanleiding": {
      "type": "string",
      "description": "Een omschrijving van de gebeurtenis die leidt tot het starten van een ZAAK van dit ZAAKTYPE.",
      "title": "aanleiding"
    },
    "toelichting": {
      "type": "string",
      "description": "Een eventuele toelichting op dit zaaktype, zoals een beschrijving van het procesverloop op de hoofdlijnen.",
      "title": "toelichting"
    },
    "indicatieInternOfExtern": {
      "allOf": [
        {
          "$ref": "#/$defs/IndicatieInternOfExternEnum"
        }
      ],
      "description": "Een aanduiding waarmee onderscheid wordt gemaakt tussen ZAAKTYPEn die Intern respectievelijk Extern geïnitieerd worden. Indien van beide sprake kan zijn, dan prevaleert de externe initiatie.\n\nUitleg bij mogelijke waarden:\n\n* `inkomend` - Inkomend\n* `intern` - Intern\n* `uitgaand` - Uitgaand",
      "title": "indicatie intern of extern"
    },
    "handelingInitiator": {
      "type": "string",
      "description": "Werkwoord dat hoort bij de handeling die de initiator verricht bij dit zaaktype. Meestal 'aanvragen', 'indienen' of 'melden'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/doc/attribuutsoort/zaaktype.handeling_initiator",
      "title": "handeling initiator",
      "maxLength": 20
    },
    "onderwerp": {
      "type": "string",
      "description": "Het onderwerp van ZAAKen van dit ZAAKTYPE. In veel gevallen nauw gerelateerd aan de product- of dienstnaam uit de Producten- en Dienstencatalogus (PDC). Bijvoorbeeld: 'Evenementenvergunning', 'Geboorte', 'Klacht'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/doc/attribuutsoort/zaaktype.onderwerp",
      "title": "onderwerp",
      "maxLength": 80
    },
    "handelingBehandelaar": {
      "type": "string",
      "description": "Werkwoord dat hoort bij de handeling die de behandelaar verricht bij het afdoen van ZAAKen van dit ZAAKTYPE. Meestal 'behandelen', 'uitvoeren', 'vaststellen' of 'onderhouden'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/doc/attribuutsoort/zaaktype.handeling_behandelaar",
      "title": "handeling behandelaar",
      "maxLength": 20
    },
    "doorlooptijd": {
      "type": "string",
      "description": "De periode waarbinnen volgens wet- en regelgeving een ZAAK van het ZAAKTYPE afgerond dient te zijn, in kalenderdagen.",
      "title": "doorlooptijd behandeling",
      "format": "duration"
    },
    "servicenorm": {
      "type": [
        "string",
        "null"
      ],
      "description": "De periode waarbinnen verwacht wordt dat een ZAAK van het ZAAKTYPE afgerond wordt conform de geldende servicenormen van de zaakbehandelende organisatie(s).",
      "title": "servicenorm behandeling",
      "format": "duration"
    },
    "opschortingEnAanhoudingMogelijk": {
      "type": "boolean",
      "title": "Opschorting/aanhouding mogelijk",
      "description": "Aanduiding die aangeeft of ZAAKen van dit mogelijk ZAAKTYPE kunnen worden opgeschort en/of aangehouden."
    },
    "verlengingMogelijk": {
      "type": "boolean",
      "description": "Aanduiding die aangeeft of de Doorlooptijd behandeling van ZAAKen van dit ZAAKTYPE kan worden verlengd.",
      "title": "verlenging mogelijk"
    },
    "verlengingstermijn": {
      "type": [
        "string",
        "null"
      ],
      "description": "Een tijdsduur in ISO 8601 formaat waarmee de Doorlooptijd behandeling van ZAAKen van dit ZAAKTYPE kan worden verlengd. Mag alleen een waarde bevatten als verlenging mogelijk is.",
      "title": "verlengingstermijn",
      "format": "duration"
    },
    "trefwoorden": {
      "type": "array",
      "items": {
        "type": "string",
        "title": "Trefwoord",
        "maxLength": 30
      },
      "description": "Een trefwoord waarmee ZAAKen van het ZAAKTYPE kunnen worden gekarakteriseerd.",
      "title": "trefwoorden"
    },
    "publicatieIndicatie": {
      "type": "boolean",
      "description": "Aanduiding of (het starten van) een ZAAK dit ZAAKTYPE gepubliceerd moet worden.",
      "title": "publicatie indicatie"
    },
    "publicatietekst": {
      "type": "string",
      "description": "De generieke tekst van de publicatie van ZAAKen van dit ZAAKTYPE.",
      "title": "publicatietekst"
    },
    "verantwoordingsrelatie": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "description": "De relatie tussen ZAAKen van dit ZAAKTYPE en de beleidsmatige en/of financiële verantwoording.",
      "title": "verantwoordingsrelatie"
    },
    "productenOfDiensten": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": "URL naar product/dienst",
        "maxLength": 1000
      },
      "description": "Het product of de dienst die door ZAAKen van dit ZAAKTYPE wordt voortgebracht.",
      "title": "producten of diensten"
    },
    "selectielijstProcestype": {
      "type": "string",
      "format": "uri",
      "description": "URL-referentie naar een vanuit archiveringsoptiek onderkende groep processen met dezelfde kenmerken (PROCESTYPE in de Selectielijst API).",
      "title": "selectielijst procestype",
      "maxLength": 200
    },
    "referentieproces": {
      "allOf": [
        {
          "$ref": "#/$defs/ReferentieProces"
        }
      ],
      "description": "Het Referentieproces dat ten grondslag ligt aan dit ZAAKTYPE.",
      "title": "referentieproces"
    },
    "verantwoordelijke": {
      "type": "string",
      "description": "De (soort) organisatorische eenheid of (functie van) medewerker die verantwoordelijk is voor de uitvoering van zaken van het ZAAKTYPE.",
      "title": "verantwoordelijke",
      "maxLength": 50
    },
    "zaakobjecttypen": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": ""
      },
      "readOnly": true,
      "title": "Zaaktype",
      "uniqueItems": true
    },
    "broncatalogus": {
      "allOf": [
        {
          "$ref": "#/$defs/BronCatalogus"
        }
      ],
      "description": "De CATALOGUS waaraan het ZAAKTYPE is ontleend.",
      "title": "broncatalogus"
    },
    "bronzaaktype": {
      "allOf": [
        {
          "$ref": "#/$defs/BronZaaktype"
        }
      ],
      "description": "Het zaaktype binnen de CATALOGUS waaraan dit ZAAKTYPE is ontleend.",
      "title": "bronzaaktype"
    },
    "catalogus": {
      "type": "string",
      "format": "uri",
      "description": "URL-referentie naar de CATALOGUS waartoe dit ZAAKTYPE behoort.",
      "title": "Catalogus"
    },
    "statustypen": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": ""
      },
      "readOnly": true,
      "description": "URL-referenties naar de STATUSTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
      "title": "Zaaktype",
      "uniqueItems": true
    },
    "resultaattypen": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": ""
      },
      "readOnly": true,
      "description": "URL-referenties naar de RESULTAATTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
      "title": "is relevant voor",
      "uniqueItems": true
    },
    "eigenschappen": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": ""
      },
      "readOnly": true,
      "description": "URL-referenties naar de EIGENSCHAPPEN die aanwezig moeten zijn in ZAKEN van dit ZAAKTYPE.",
      "title": "Zaaktype",
      "uniqueItems": true
    },
    "informatieobjecttypen": {
      "type": "string",
      "readOnly": true,
      "title": "informatieobjecttypen"
    },
    "roltypen": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": ""
      },
      "readOnly": true,
      "description": "URL-referenties naar de ROLTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
      "title": "Zaaktype",
      "uniqueItems": true
    },
    "besluittypen": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "title": "heeft relevante besluittypen"
      },
      "title": "heeft relevante besluittypen",
      "description": "URL-referenties naar de BESLUITTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
      "uniqueItems": true
    },
    "deelzaaktypen": {
      "type": "array",
      "items": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri",
        "title": ""
      },
      "description": "De ZAAKTYPE(n) waaronder ZAAKen als deelzaak kunnen voorkomen bij ZAAKen van dit ZAAKTYPE.",
      "title": "deelzaaktypen",
      "uniqueItems": true
    },
    "gerelateerdeZaaktypen": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ZaakTypenRelatie"
      },
      "description": "De ZAAKTYPEn van zaken die relevant zijn voor zaken van dit ZAAKTYPE.",
      "title": "zaaktype van"
    },
    "beginGeldigheid": {
      "type": "string",
      "format": "date",
      "description": "De datum waarop het is ontstaan.",
      "title": "datum begin geldigheid"
    },
    "eindeGeldigheid": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "De datum waarop het is opgeheven.",
      "title": "datum einde geldigheid"
    },
    "beginObject": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "De datum waarop de eerst versie van het object ontstaan is.",
      "title": "datum begin object"
    },
    "eindeObject": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "De datum van de aller laatste versie van het object.",
      "title": "datum einde object"
    },
    "versiedatum": {
      "type": "string",
      "format": "date",
      "description": "De datum waarop de (gewijzigde) kenmerken van het ZAAKTYPE geldig zijn geworden",
      "title": "versiedatum"
    },
    "concept": {
      "type": "boolean",
      "readOnly": true,
      "description": "Geeft aan of het object een concept betreft. Concepten zijn niet-definitieve versies en zouden niet gebruikt moeten worden buiten deze API.",
      "title": "concept"
    }
  },
  "required": [
    "aanleiding",
    "beginGeldigheid",
    "besluittypen",
    "catalogus",
    "concept",
    "doel",
    "doorlooptijd",
    "eigenschappen",
    "gerelateerdeZaaktypen",
    "handelingBehandelaar",
    "handelingInitiator",
    "identificatie",
    "indicatieInternOfExtern",
    "informatieobjecttypen",
    "omschrijving",
    "onderwerp",
    "opschortingEnAanhoudingMogelijk",
    "productenOfDiensten",
    "publicatieIndicatie",
    "referentieproces",
    "resultaattypen",
    "roltypen",
    "statustypen",
    "url",
    "verantwoordelijke",
    "verlengingMogelijk",
    "versiedatum",
    "vertrouwelijkheidaanduiding",
    "zaakobjecttypen"
  ],
  "$defs": {
    "AardRelatieEnum": {
      "enum": [
        "vervolg",
        "bijdrage",
        "onderwerp"
      ],
      "type": "string"
    },
    "BronCatalogus": {
      "type": "object",
      "description": "De CATALOGUS waaraan het ZAAKTYPE is ontleend.",
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "title": "URL-referentie broncatalogus",
          "maxLength": 200
        },
        "domein": {
          "type": "string",
          "description": "Het domein van de CATALOGUS waaraan het ZAAKTYPE is ontleend.",
          "title": "broncatalogus domein",
          "maxLength": 5
        },
        "rsin": {
          "type": "string",
          "description": "Het RSIN van de INGESCHREVEN NIET-NATUURLIJK PERSOON die beheerder is van de CATALOGUS waaraan het ZAAKTYPE is ontleend.",
          "title": "broncatalogus rsin",
          "maxLength": 9
        }
      },
      "required": [
        "domein",
        "rsin",
        "url"
      ]
    },
    "BronZaaktype": {
      "type": "object",
      "description": "Het zaaktype binnen de CATALOGUS waaraan dit ZAAKTYPE is ontleend.",
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "title": "URL-referentie bronzaaktype",
          "maxLength": 200
        },
        "identificatie": {
          "type": "string",
          "description": "De Zaaktype-identificatie van het bronzaaktype binnen de CATALOGUS.",
          "title": "bronzaaktype identificatie",
          "maxLength": 50
        },
        "omschrijving": {
          "type": "string",
          "description": "De Zaaktype-omschrijving van het bronzaaktype, zoals gehanteerd in de Broncatalogus.",
          "title": "bronzaaktype omschrijving",
          "maxLength": 80
        }
      },
      "required": [
        "identificatie",
        "omschrijving",
        "url"
      ]
    },
    "IndicatieInternOfExternEnum": {
      "enum": [
        "intern",
        "extern"
      ],
      "type": "string"
    },
    "ReferentieProces": {
      "type": "object",
      "description": "Het Referentieproces dat ten grondslag ligt aan dit ZAAKTYPE.",
      "properties": {
        "naam": {
          "type": "string",
          "title": "Referentieprocesnaam",
          "description": "De naam van het Referentieproces.",
          "maxLength": 80
        },
        "link": {
          "type": "string",
          "format": "uri",
          "title": "Referentieproceslink",
          "description": "De URL naar de beschrijving van het Referentieproces",
          "maxLength": 200
        }
      },
      "required": [
        "naam"
      ]
    },
    "VertrouwelijkheidaanduidingEnum": {
      "enum": [
        "openbaar",
        "beperkt_openbaar",
        "intern",
        "zaakvertrouwelijk",
        "vertrouwelijk",
        "confidentieel",
        "geheim",
        "zeer_geheim"
      ],
      "type": "string"
    },
    "ZaakTypenRelatie": {
      "type": "object",
      "properties": {
        "zaaktype": {
          "type": "string",
          "format": "uri",
          "description": "URL referentie naar het gerelateerde zaaktype, mogelijks in een extern ZTC.",
          "title": "gerelateerd zaaktype",
          "maxLength": 200
        },
        "aardRelatie": {
          "allOf": [
            {
              "$ref": "#/$defs/AardRelatieEnum"
            }
          ],
          "description": "Omschrijving van de aard van de relatie van zaken van het ZAAKTYPE tot zaken van het andere ZAAKTYPE\n\nUitleg bij mogelijke waarden:\n\n* `vervolg` - Vervolg\n* `bijdrage` - Bijdrage\n* `onderwerp` - Onderwerp",
          "title": "aard relatie"
        },
        "toelichting": {
          "type": "string",
          "description": "Een toelichting op de aard van de relatie tussen beide ZAAKTYPEN.",
          "title": "toelichting",
          "maxLength": 255
        }
      },
      "required": [
        "aardRelatie",
        "zaaktype"
      ]
    }
  }
}