{
    "openapi": "3.1.0",
    "info": {
        "title": "Beveiliging X, open API voor planning en operatie",
        "version": "1.0.0",
        "summary": "Opdrachtgevers, objecten, teams, beveiligers, diensten, uren, verlof, beschikbaarheid, bevindingen en rondes; schrijven langs de planregels; webhooks met handtekening.",
        "description": "De open API van Beveiliging X geeft een ander systeem (HR, salaris, toegangscontrole, een eigen dashboard of de opdrachtgever) de planning en operatie van een beveiligingsorganisatie, en laat het diensten plannen langs dezelfde planregels als het planbord.\n\nElk verzoek draagt een toegangssleutel in Authorization: Bearer. De sleutel bepaalt de organisatie en de scopes; hij werkt namens de kantoorgebruiker die hem uitgaf en nooit met meer rechten dan die.\n\nLijsten bladeren met een cursor (links.volgende) en kennen gewijzigd_sinds voor een incrementele synchronisatie. Diensten, uren en verlof zijn er ook als CSV en XML. Een weigering heeft altijd dezelfde vorm (Fout). Een schrijfverzoek kent de kop Idempotency-Key.\n\nEen beveiliger gaat nooit met BSN, IBAN, adres, geboortedatum of documenten naar buiten, en niets uit de sleutelkluis van een object.",
        "contact": {
            "name": "Beveiliging X",
            "email": "contact@godeliveryx.eu",
            "url": "https://beveiligingx.nl/api.html"
        }
    },
    "servers": [
        {
            "url": "https://api.beveiligingx.nl/api/v1/beveiliging",
            "description": "Productie"
        }
    ],
    "security": [
        {
            "sleutel": [
                "beveiliging.lezen"
            ]
        }
    ],
    "tags": [
        {
            "name": "Stamgegevens",
            "description": "Opdrachtgevers, objecten met coördinaten en normen, teams en beveiligers."
        },
        {
            "name": "Diensten",
            "description": "Het rooster en de uitvoering; schrijven langs de planregels."
        },
        {
            "name": "Uren",
            "description": "Gewerkte diensten met toeslagregels uit de loonspecificatie."
        },
        {
            "name": "Verlof en beschikbaarheid",
            "description": "Verlof en afwezigheid, en wanneer een beveiliger kan."
        },
        {
            "name": "Operatie",
            "description": "Bevindingen en rondes."
        },
        {
            "name": "Dossier",
            "description": "Kwalificaties met vervaldatum (eigen scope)."
        },
        {
            "name": "Specificatie",
            "description": "Deze specificatie zelf."
        }
    ],
    "paths": {
        "/openapi.json": {
            "get": {
                "operationId": "specificatie",
                "tags": [
                    "Specificatie"
                ],
                "summary": "Deze specificatie (OpenAPI 3.1, JSON)",
                "security": [],
                "responses": {
                    "200": {
                        "description": "De specificatie.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/opdrachtgevers": {
            "get": {
                "operationId": "opdrachtgevers",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Opdrachtgevers",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "name": "actief",
                        "in": "query",
                        "required": false,
                        "description": "Alleen actieve (true) of inactieve (false). Verwijderde staan erin met verwijderd_op.",
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Opdrachtgever"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/opdrachtgevers/{id}": {
            "get": {
                "operationId": "opdrachtgever",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Een opdrachtgever",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Opdrachtgever"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/objecten": {
            "get": {
                "operationId": "objecten",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Objecten met coördinaten, bezettingsnormen en teams",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "name": "actief",
                        "in": "query",
                        "required": false,
                        "description": "true is open, false is gesloten.",
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "opdrachtgever",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de opdrachtgever.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "team",
                        "in": "query",
                        "required": false,
                        "description": "Objecten die dit team vandaag draait.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Object"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/objecten/{id}": {
            "get": {
                "operationId": "object",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Een object",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Object"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/teams": {
            "get": {
                "operationId": "teams",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Teams met leden en objecten",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "name": "actief",
                        "in": "query",
                        "required": false,
                        "description": "Alleen actieve of inactieve teams.",
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Team"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/teams/{id}": {
            "get": {
                "operationId": "team",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Een team",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Team"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/beveiligers": {
            "get": {
                "operationId": "beveiligers",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Beveiligers (zonder BSN, IBAN, adres of documenten)",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "name": "actief",
                        "in": "query",
                        "required": false,
                        "description": "Alleen actieve of inactieve beveiligers.",
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "team",
                        "in": "query",
                        "required": false,
                        "description": "Wie vandaag in dit team zit.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Beveiliger"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/beveiligers/{id}": {
            "get": {
                "operationId": "beveiliger",
                "tags": [
                    "Stamgegevens"
                ],
                "summary": "Een beveiliger",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Beveiliger"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/beveiligers/{id}/kwalificaties": {
            "get": {
                "operationId": "beveiligerKwalificaties",
                "tags": [
                    "Dossier"
                ],
                "summary": "De kwalificaties van een beveiliger",
                "description": "Scope beveiliging.dossier.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.dossier.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.dossier.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Kwalificatie"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/beveiligers/{id}/beschikbaarheid": {
            "put": {
                "operationId": "zetBeschikbaarheid",
                "tags": [
                    "Verlof en beschikbaarheid"
                ],
                "summary": "Beschikbaarheid zetten",
                "description": "Per weekdag (0 is zondag) en per datum. Werkt zoals in de app van de beveiliger: niveau no is niet beschikbaar; een datum vervangt wat er voor die datum stond. Scope beveiliging.planning.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.planning.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.planning.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BeschikbaarheidInvoer"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De beschikbaarheid van de beveiliger na het zetten.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Beschikbaarheid"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/kwalificaties": {
            "get": {
                "operationId": "kwalificaties",
                "tags": [
                    "Dossier"
                ],
                "summary": "Kwalificaties met vervaldatum",
                "description": "Scope beveiliging.dossier.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.dossier.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.dossier.lezen",
                "parameters": [
                    {
                        "name": "beveiliger",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de beveiliger.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "soort",
                        "in": "query",
                        "required": false,
                        "description": "wpbr_pas, vog, screening, diploma, ehbo of bhv.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "verloopt_voor",
                        "in": "query",
                        "required": false,
                        "description": "Alleen wat voor deze datum (JJJJ-MM-DD) verloopt.",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Kwalificatie"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/diensten": {
            "get": {
                "operationId": "diensten",
                "tags": [
                    "Diensten"
                ],
                "summary": "Diensten: gepland, gepubliceerd en vervallen, met aan- en afmelden",
                "description": "Scope beveiliging.lezen. Ook als CSV of XML: ?formaat=csv|xml of Accept: text/csv / application/xml; de volgende pagina staat dan in de kop Link.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/van"
                    },
                    {
                        "$ref": "#/components/parameters/tot"
                    },
                    {
                        "name": "object",
                        "in": "query",
                        "required": false,
                        "description": "Het id van het object.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "team",
                        "in": "query",
                        "required": false,
                        "description": "Het id van het team.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "beveiliger",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de beveiliger.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "planstatus",
                        "in": "query",
                        "required": false,
                        "description": "concept, gepubliceerd of vervallen.",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "concept",
                                "gepubliceerd",
                                "vervallen"
                            ]
                        }
                    },
                    {
                        "name": "uitvoering",
                        "in": "query",
                        "required": false,
                        "description": "gepland, aangemeld of afgerond.",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "gepland",
                                "aangemeld",
                                "afgerond"
                            ]
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    },
                    {
                        "$ref": "#/components/parameters/formaat"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Dienst"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            },
                            "text/csv": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "Een rij per record, met een kopregel; komma als scheiding."
                            },
                            "application/xml": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/FormaatNietBeschikbaar"
                    },
                    "206": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            },
            "post": {
                "operationId": "maakDienst",
                "tags": [
                    "Diensten"
                ],
                "summary": "Een conceptdienst neerzetten",
                "description": "Zoals op het planbord. Met beveiliger_id oordeelt de regelmotor over de toewijzing: een blokkade weigert (422 planregels_blokkade), een waarschuwing weigert tot u force: true meestuurt (422 planregels_waarschuwing). Een dienst in een vastgezette periode kan niet (409 periode_vast). Scope beveiliging.planning.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.planning.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.planning.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DienstInvoer"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De nieuwe dienst, met de bevindingen van de planregels.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DienstMetBevindingen"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/diensten/{id}": {
            "get": {
                "operationId": "dienst",
                "tags": [
                    "Diensten"
                ],
                "summary": "Een dienst",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Dienst"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            },
            "patch": {
                "operationId": "wijzigDienst",
                "tags": [
                    "Diensten"
                ],
                "summary": "Een conceptdienst wijzigen",
                "description": "Alleen een conceptdienst die nog niet loopt (anders 409 geen_concept). Wat u niet meestuurt blijft staan. Een andere tijd, dag, soort, object of beveiliger gaat langs de regelmotor. Scope beveiliging.planning.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.planning.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.planning.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DienstWijziging"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De dienst na de wijziging, met de bevindingen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DienstMetBevindingen"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/diensten/{id}/toewijzen": {
            "post": {
                "operationId": "wijsToe",
                "tags": [
                    "Diensten"
                ],
                "summary": "Een beveiliger toewijzen",
                "description": "Langs de regelmotor, net als slepen op het planbord. Ook op een gepubliceerde dienst, zolang hij niet vervallen of gedraaid is en de periode niet vaststaat. Scope beveiliging.planning.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.planning.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.planning.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/Toewijzing"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De dienst met de nieuwe beveiliger en de bevindingen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DienstMetBevindingen"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/diensten/{id}/vrijgeven": {
            "post": {
                "operationId": "geefVrij",
                "tags": [
                    "Diensten"
                ],
                "summary": "De beveiliger van een dienst halen (open dienst)",
                "description": "De dienst blijft staan zonder beveiliger: een gat dat de planner nog vult. Scope beveiliging.planning.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.planning.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.planning.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/Vrijgeven"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De open dienst.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DienstMetBevindingen"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/diensten/{id}/vervallen": {
            "post": {
                "operationId": "laatVervallen",
                "tags": [
                    "Diensten"
                ],
                "summary": "Een conceptdienst laten vervallen",
                "description": "Vervallen, niet verwijderen: de geschiedenis van de dienst blijft staan. Alleen een conceptdienst. Scope beveiliging.planning.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.planning.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.planning.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/Vervallen"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De vervallen dienst.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DienstMetBevindingen"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/uren": {
            "get": {
                "operationId": "uren",
                "tags": [
                    "Uren"
                ],
                "summary": "Gewerkte diensten met minuten, meerwerk en toeslagregels",
                "description": "Scope beveiliging.uren.lezen. Ook als CSV of XML: ?formaat=csv|xml of Accept: text/csv / application/xml; de volgende pagina staat dan in de kop Link.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.uren.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.uren.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/van"
                    },
                    {
                        "$ref": "#/components/parameters/tot"
                    },
                    {
                        "name": "object",
                        "in": "query",
                        "required": false,
                        "description": "Het id van het object.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "team",
                        "in": "query",
                        "required": false,
                        "description": "Het id van het team.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "beveiliger",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de beveiliger.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    },
                    {
                        "$ref": "#/components/parameters/formaat"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Uren"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            },
                            "text/csv": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "Een rij per record, met een kopregel; komma als scheiding."
                            },
                            "application/xml": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/FormaatNietBeschikbaar"
                    },
                    "206": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/verlof": {
            "get": {
                "operationId": "verlof",
                "tags": [
                    "Verlof en beschikbaarheid"
                ],
                "summary": "Verlof en afwezigheid",
                "description": "Scope beveiliging.lezen. Ook als CSV of XML: ?formaat=csv|xml of Accept: text/csv / application/xml; de volgende pagina staat dan in de kop Link.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/van"
                    },
                    {
                        "$ref": "#/components/parameters/tot"
                    },
                    {
                        "name": "beveiliger",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de beveiliger.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "required": false,
                        "description": "pending, approved, rejected, active (lopende ziekte), withdrawn, cancelled of revoked.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "soort",
                        "in": "query",
                        "required": false,
                        "description": "vacation, unpaid, special of sick.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    },
                    {
                        "$ref": "#/components/parameters/formaat"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Verlof"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            },
                            "text/csv": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "Een rij per record, met een kopregel; komma als scheiding."
                            },
                            "application/xml": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/FormaatNietBeschikbaar"
                    },
                    "206": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            },
            "post": {
                "operationId": "vraagVerlofAan",
                "tags": [
                    "Verlof en beschikbaarheid"
                ],
                "summary": "Verlof aanvragen namens een beveiliger",
                "description": "Dezelfde toets op overlap als in de app. Kantoor beoordeelt; dat komt terug als verlof.goedgekeurd of verlof.afgewezen. Scope beveiliging.verlof.schrijven.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.verlof.schrijven"
                        ]
                    }
                ],
                "x-scope": "beveiliging.verlof.schrijven",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/VerlofInvoer"
                            }
                        }
                    }
                },
                "responses": {
                    "0": {
                        "description": "De aanvraag, open voor kantoor.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Verlof"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/Onverwerkbaar"
                    },
                    "423": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "424": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "425": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "426": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "427": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/verlof/{id}": {
            "get": {
                "operationId": "verlofaanvraag",
                "tags": [
                    "Verlof en beschikbaarheid"
                ],
                "summary": "Een verlofaanvraag",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Verlof"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/beschikbaarheid": {
            "get": {
                "operationId": "beschikbaarheid",
                "tags": [
                    "Verlof en beschikbaarheid"
                ],
                "summary": "Beschikbaarheid per weekdag en per datum",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/van"
                    },
                    {
                        "$ref": "#/components/parameters/tot"
                    },
                    {
                        "name": "beveiliger",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de beveiliger.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Beschikbaarheid"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/bevindingen": {
            "get": {
                "operationId": "bevindingen",
                "tags": [
                    "Operatie"
                ],
                "summary": "Bevindingen (zonder foto)",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/van"
                    },
                    {
                        "$ref": "#/components/parameters/tot"
                    },
                    {
                        "name": "object",
                        "in": "query",
                        "required": false,
                        "description": "Het id van het object.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "dienst",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de dienst.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "required": false,
                        "description": "De stand van de bevinding.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "risico",
                        "in": "query",
                        "required": false,
                        "description": "Het risico van de bevinding.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Bevinding"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/bevindingen/{id}": {
            "get": {
                "operationId": "bevinding",
                "tags": [
                    "Operatie"
                ],
                "summary": "Een bevinding",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Bevinding"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/bevindingen/{id}/foto": {
            "get": {
                "operationId": "bevindingFoto",
                "tags": [
                    "Operatie"
                ],
                "summary": "Een getekende link naar de foto (vijf minuten)",
                "description": "Scope beveiliging.bevindingen.foto.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.bevindingen.foto"
                        ]
                    }
                ],
                "x-scope": "beveiliging.bevindingen.foto",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/FotoLink"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/bevindingen/{id}/foto/bestand": {
            "get": {
                "operationId": "bevindingFotoBestand",
                "tags": [
                    "Operatie"
                ],
                "summary": "De foto achter een getekende link",
                "description": "Geen sleutel: de handtekening in de link is de toegang en verloopt na vijf minuten. Neem de link letterlijk over uit GET /bevindingen/{id}/foto.",
                "security": [],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    },
                    {
                        "name": "organisatie",
                        "in": "query",
                        "required": true,
                        "description": "Staat in de getekende link.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "expires",
                        "in": "query",
                        "required": true,
                        "description": "Staat in de getekende link.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "signature",
                        "in": "query",
                        "required": true,
                        "description": "Staat in de getekende link.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "De foto.",
                        "content": {
                            "image/jpeg": {
                                "schema": {
                                    "type": "string",
                                    "contentMediaType": "image/jpeg"
                                }
                            },
                            "image/png": {
                                "schema": {
                                    "type": "string",
                                    "contentMediaType": "image/png"
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    }
                }
            }
        },
        "/rondes": {
            "get": {
                "operationId": "rondes",
                "tags": [
                    "Operatie"
                ],
                "summary": "Rondes met de scans van de controlepunten",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/van"
                    },
                    {
                        "$ref": "#/components/parameters/tot"
                    },
                    {
                        "name": "dienst",
                        "in": "query",
                        "required": false,
                        "description": "Het id van de dienst.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "object",
                        "in": "query",
                        "required": false,
                        "description": "Het id van het object.",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "required": false,
                        "description": "pending, active, interrupted of completed.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/gewijzigd_sinds"
                    },
                    {
                        "$ref": "#/components/parameters/per_pagina"
                    },
                    {
                        "$ref": "#/components/parameters/cursor"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Een pagina.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data",
                                        "links",
                                        "meta"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Ronde"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "202": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "203": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "204": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "205": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        },
        "/rondes/{id}": {
            "get": {
                "operationId": "ronde",
                "tags": [
                    "Operatie"
                ],
                "summary": "Een ronde",
                "description": "Scope beveiliging.lezen.",
                "security": [
                    {
                        "sleutel": [
                            "beveiliging.lezen"
                        ]
                    }
                ],
                "x-scope": "beveiliging.lezen",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/id"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Gevonden.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Ronde"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "405": {
                        "$ref": "#/components/responses/OngeldigVerzoek"
                    },
                    "406": {
                        "$ref": "#/components/responses/NietAangemeld"
                    },
                    "407": {
                        "$ref": "#/components/responses/Geschorst"
                    },
                    "408": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "409": {
                        "$ref": "#/components/responses/TeVeelVerzoeken"
                    }
                }
            }
        }
    },
    "webhooks": {
        "dienst.aangemaakt": {
            "post": {
                "operationId": "webhook_dienst_aangemaakt",
                "summary": "Dienst aangemaakt",
                "description": "Een nieuwe dienst staat op het rooster: op het planbord, uit een basisrooster, een aanvraag van een opdrachtgever of via de API. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "dienst.aangemaakt"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "dienst.gewijzigd": {
            "post": {
                "operationId": "webhook_dienst_gewijzigd",
                "summary": "Dienst gewijzigd",
                "description": "Tijd, soort, object, team, notitie of planstatus van een dienst veranderde (ook publiceren van de periode). `velden` noemt wat. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "dienst.gewijzigd"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstGewijzigdGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "dienst.toegewezen": {
            "post": {
                "operationId": "webhook_dienst_toegewezen",
                "summary": "Beveiliger toegewezen of vrijgegeven",
                "description": "De beveiliger op een dienst veranderde. `beveiliger_id` leeg is een open dienst; `vorige_beveiliger_id` is wie er stond. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "dienst.toegewezen"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstToegewezenGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "dienst.vervallen": {
            "post": {
                "operationId": "webhook_dienst_vervallen",
                "summary": "Dienst vervallen",
                "description": "Een dienst vervalt; hij blijft met zijn geschiedenis bestaan. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "dienst.vervallen"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "dienst.aangemeld": {
            "post": {
                "operationId": "webhook_dienst_aangemeld",
                "summary": "Beveiliger aangemeld",
                "description": "De beveiliger meldde zich aan op het object (geofence of handmatig). Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "dienst.aangemeld"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "dienst.afgemeld": {
            "post": {
                "operationId": "webhook_dienst_afgemeld",
                "summary": "Beveiliger afgemeld",
                "description": "De dienst is afgerond, met de gewerkte minuten en eventueel meerwerk. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "dienst.afgemeld"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "meerwerk.geregistreerd": {
            "post": {
                "operationId": "webhook_meerwerk_geregistreerd",
                "summary": "Meerwerk geregistreerd",
                "description": "Op een dienst is meerwerk vastgelegd: wie het vroeg en waarom. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "meerwerk.geregistreerd"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/DienstGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "bevinding.gemeld": {
            "post": {
                "operationId": "webhook_bevinding_gemeld",
                "summary": "Bevinding gemeld",
                "description": "Een beveiliger meldde een bevinding. Zonder foto; die haalt u met de scope beveiliging.bevindingen.foto. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "bevinding.gemeld"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/BevindingGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "verlof.aangevraagd": {
            "post": {
                "operationId": "webhook_verlof_aangevraagd",
                "summary": "Verlof aangevraagd",
                "description": "Een beveiliger (of een koppeling namens hem) vroeg verlof aan. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "verlof.aangevraagd"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/VerlofGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "verlof.goedgekeurd": {
            "post": {
                "operationId": "webhook_verlof_goedgekeurd",
                "summary": "Verlof goedgekeurd",
                "description": "Kantoor keurde verlof goed of boekte het zelf in. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "verlof.goedgekeurd"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/VerlofGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "verlof.afgewezen": {
            "post": {
                "operationId": "webhook_verlof_afgewezen",
                "summary": "Verlof afgewezen",
                "description": "Kantoor wees een verlofaanvraag af. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "verlof.afgewezen"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/VerlofGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "maandstaat.gesloten": {
            "post": {
                "operationId": "webhook_maandstaat_gesloten",
                "summary": "Maandstaat gesloten",
                "description": "Kantoor sloot de maandstaat van een object: de geleverde uren en het te factureren bedrag liggen vast. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "maandstaat.gesloten"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/MaandstaatGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "factuur.aangemaakt": {
            "post": {
                "operationId": "webhook_factuur_aangemaakt",
                "summary": "Verkoopfactuur aangemaakt",
                "description": "De boekhouding maakte een verkoopfactuur of creditnota (alleen als de boekhouding aan staat). Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "factuur.aangemaakt"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/FactuurGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "kwalificatie.verloopt": {
            "post": {
                "operationId": "webhook_kwalificatie_verloopt",
                "summary": "Kwalificatie verloopt",
                "description": "Een kwalificatie van een beveiliger verloopt binnen zestig dagen, of is net verlopen. Een keer per fase. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "kwalificatie.verloopt"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/KwalificatieGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        },
        "test.ping": {
            "post": {
                "operationId": "webhook_test_ping",
                "summary": "Test",
                "description": "De knop Test versturen in de backoffice. Ondertekend met HMAC-SHA256 in X-BeveiligingX-Handtekening (t=<tijdstempel>,v1=<hex>) over \"<tijdstempel>.<inhoud>\".",
                "parameters": [
                    {
                        "name": "X-BeveiligingX-Handtekening",
                        "in": "header",
                        "required": true,
                        "description": "t=<tijdstempel>,v1=<hex HMAC-SHA256 van \"<tijdstempel>.<inhoud>\" met het geheim>",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Tijdstempel",
                        "in": "header",
                        "required": true,
                        "description": "Seconden sinds 1970 (UTC). Weiger als hij meer dan 300 seconden afwijkt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis",
                        "in": "header",
                        "required": true,
                        "description": "Het type, zoals dienst.aangemaakt.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Gebeurtenis-Id",
                        "in": "header",
                        "required": true,
                        "description": "Het id van de gebeurtenis (evt_...), gelijk aan id in de envelop; dezelfde bij opnieuw versturen.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Aflevering",
                        "in": "header",
                        "required": true,
                        "description": "Het id van deze aflevering (dlv_...).",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "X-BeveiligingX-Poging",
                        "in": "header",
                        "required": true,
                        "description": "Het nummer van de poging, vanaf 1.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/Envelop"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "const": "test.ping"
                                            },
                                            "data": {
                                                "$ref": "#/components/schemas/TestGebeurtenis"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "2XX": {
                        "description": "Ontvangen. Antwoord binnen tien seconden; zwaar werk doet u daarna."
                    },
                    "default": {
                        "description": "Elk ander antwoord (of geen antwoord) is mislukt: Beveiliging X probeert het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2, 6, 12 en 24 uur."
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "sleutel": {
                "type": "http",
                "scheme": "bearer",
                "description": "Een toegangssleutel (begint met tlk_) uit de backoffice, Integraties en keten, API en webhooks. Scopes: beveiliging.lezen, beveiliging.planning.schrijven, beveiliging.verlof.schrijven, beveiliging.uren.lezen, beveiliging.dossier.lezen, beveiliging.bevindingen.foto."
            }
        },
        "parameters": {
            "id": {
                "name": "id",
                "in": "path",
                "required": true,
                "description": "Het id.",
                "schema": {
                    "type": "integer",
                    "minimum": 1
                }
            },
            "van": {
                "name": "van",
                "in": "query",
                "required": false,
                "description": "Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie.",
                "schema": {
                    "type": "string",
                    "format": "date"
                }
            },
            "tot": {
                "name": "tot",
                "in": "query",
                "required": false,
                "description": "Tot en met deze dag (JJJJ-MM-DD).",
                "schema": {
                    "type": "string",
                    "format": "date"
                }
            },
            "gewijzigd_sinds": {
                "name": "gewijzigd_sinds",
                "in": "query",
                "required": false,
                "description": "Alleen wat op of na dit moment wijzigde (ISO 8601). De volgorde wordt dan gewijzigd_op en id. Bewaar de hoogste gewijzigd_op die u zag en geef die de volgende keer mee: u mist niets en krijgt hooguit een rij twee keer.",
                "schema": {
                    "type": "string",
                    "format": "date-time"
                }
            },
            "per_pagina": {
                "name": "per_pagina",
                "in": "query",
                "required": false,
                "description": "Rijen per pagina: standaard 100, hoogstens 500 (bij CSV en XML 5000).",
                "schema": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5000,
                    "default": 100
                }
            },
            "cursor": {
                "name": "cursor",
                "in": "query",
                "required": false,
                "description": "De plek waar de vorige pagina ophield; neem links.volgende over met dezelfde filters.",
                "schema": {
                    "type": "string"
                }
            },
            "formaat": {
                "name": "formaat",
                "in": "query",
                "required": false,
                "description": "json (standaard), csv of xml. Accept: text/csv of application/xml werkt ook.",
                "schema": {
                    "type": "string",
                    "enum": [
                        "json",
                        "csv",
                        "xml"
                    ]
                }
            },
            "IdempotencyKey": {
                "name": "Idempotency-Key",
                "in": "header",
                "required": false,
                "description": "Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict.",
                "schema": {
                    "type": "string",
                    "maxLength": 120
                }
            }
        },
        "responses": {
            "OngeldigVerzoek": {
                "description": "400: een cursor of Idempotency-Key die niet klopt.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Deze cursor kennen we niet.",
                            "fout": {
                                "code": "cursor_ongeldig",
                                "status": 400
                            }
                        }
                    }
                }
            },
            "NietAangemeld": {
                "description": "401: geen sleutel, of een onbekende of ingetrokken sleutel.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Sleutel onbekend of ingetrokken.",
                            "fout": {
                                "code": "niet_aangemeld",
                                "status": 401
                            }
                        }
                    }
                }
            },
            "Geschorst": {
                "description": "402: de organisatie is geschorst of haar abonnement is niet actief.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "De organisatie achter deze sleutel is geschorst of haar abonnement is niet actief.",
                            "fout": {
                                "code": "organisatie_geschorst",
                                "status": 402
                            }
                        }
                    }
                }
            },
            "GeenToegang": {
                "description": "403: de sleutel mist de scope, de module staat uit, of de kantoorgebruiker achter de sleutel mist het recht.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Deze sleutel heeft de scope beveiliging.uren.lezen niet.",
                            "fout": {
                                "code": "scope_ontbreekt",
                                "status": 403
                            }
                        }
                    }
                }
            },
            "NietGevonden": {
                "description": "404: bestaat niet of hoort bij een andere organisatie.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Dienst 42 bestaat niet (of hoort niet bij deze organisatie).",
                            "fout": {
                                "code": "niet_gevonden",
                                "status": 404
                            }
                        }
                    }
                }
            },
            "FormaatNietBeschikbaar": {
                "description": "406: dit formaat is er niet voor deze lijst.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Kies json, csv of xml als formaat.",
                            "fout": {
                                "code": "formaat_niet_beschikbaar",
                                "status": 406
                            }
                        }
                    }
                }
            },
            "Conflict": {
                "description": "409: de toestand laat het niet toe (geen_concept, niet_planbaar, periode_vast, verzoek_loopt).",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Via de API wijzig je alleen een conceptdienst die nog niet loopt.",
                            "fout": {
                                "code": "geen_concept",
                                "status": 409
                            }
                        }
                    }
                }
            },
            "Onverwerkbaar": {
                "description": "422: validatie (fout.velden), een blokkade of waarschuwing van de planregels (fout.bevindingen), of een Idempotency-Key bij een ander verzoek.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Overlapt met de dagdienst op Distributiecentrum Oost.",
                            "fout": {
                                "code": "planregels_blokkade",
                                "status": 422,
                                "bevindingen": [
                                    {
                                        "regel": "beveiliging.overlap",
                                        "ernst": "blok",
                                        "melding": "Overlapt met de dagdienst op Distributiecentrum Oost.",
                                        "gegevens": {
                                            "shift_id": 41
                                        }
                                    }
                                ]
                            }
                        }
                    }
                }
            },
            "TeVeelVerzoeken": {
                "description": "429: te veel verzoeken (120 per minuut per sleutel); Retry-After zegt hoe lang wachten.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        },
                        "example": {
                            "message": "Te veel pogingen. Probeer het over 30 seconden opnieuw.",
                            "fout": {
                                "code": "te_veel_verzoeken",
                                "status": 429
                            }
                        }
                    }
                }
            }
        },
        "schemas": {
            "Fout": {
                "type": "object",
                "required": [
                    "message",
                    "fout"
                ],
                "properties": {
                    "message": {
                        "type": "string",
                        "description": "De zin voor een mens, in het Nederlands."
                    },
                    "fout": {
                        "type": "object",
                        "required": [
                            "code",
                            "status"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "description": "Vaste code voor een programma: niet_aangemeld, scope_ontbreekt, organisatie_geschorst, module_uit, namens_inactief, recht_ingetrokken, niet_gevonden, validatie, planregels_blokkade, planregels_waarschuwing, geen_concept, niet_planbaar, periode_vast, idempotentie_conflict, idempotentie_sleutel_ongeldig, verzoek_loopt, cursor_ongeldig, formaat_niet_beschikbaar, geen_foto, link_ongeldig, te_veel_verzoeken, serverfout."
                            },
                            "status": {
                                "type": "integer"
                            },
                            "velden": {
                                "type": "object",
                                "additionalProperties": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "description": "Bij validatie: per veld de zinnen."
                            },
                            "bevindingen": {
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/Planregel"
                                },
                                "description": "Bij planregels_blokkade en planregels_waarschuwing: alle bevindingen van de regelmotor."
                            },
                            "scope": {
                                "type": "string"
                            }
                        }
                    }
                }
            },
            "Planregel": {
                "type": "object",
                "description": "Een uitkomst van de regelmotor. Een blok weigert altijd; een waarschuwing alleen zonder force.",
                "properties": {
                    "regel": {
                        "type": "string"
                    },
                    "ernst": {
                        "type": "string",
                        "enum": [
                            "blok",
                            "waarschuwing",
                            "info"
                        ]
                    },
                    "melding": {
                        "type": "string"
                    },
                    "gegevens": {
                        "type": "object"
                    }
                },
                "required": [
                    "regel",
                    "ernst",
                    "melding",
                    "gegevens"
                ]
            },
            "Links": {
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "volgende": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "self",
                    "volgende"
                ],
                "examples": [
                    {
                        "self": "https://api.beveiligingx.nl/api/v1/beveiliging/diensten?van=2026-06-01",
                        "volgende": "https://api.beveiligingx.nl/api/v1/beveiliging/diensten?van=2026-06-01&cursor=WyIyMDI2LTA2LTAxIDA3OjAwOjAwIiwiNDEiXQ"
                    }
                ]
            },
            "Meta": {
                "type": "object",
                "properties": {
                    "per_pagina": {
                        "type": "integer"
                    },
                    "aantal": {
                        "type": "integer"
                    },
                    "volgende_cursor": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "per_pagina",
                    "aantal",
                    "volgende_cursor"
                ]
            },
            "Opdrachtgever": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "naam": {
                        "type": "string"
                    },
                    "soort": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "contactpersoon": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "actief": {
                        "type": "boolean"
                    },
                    "factuuradres": {
                        "type": "object",
                        "properties": {
                            "adres": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "postcode": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "plaats": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "adres",
                            "postcode",
                            "plaats"
                        ]
                    },
                    "btw_nummer": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "betaaltermijn_dagen": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "aangemaakt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "verwijderd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "naam",
                    "soort",
                    "contactpersoon",
                    "email",
                    "actief",
                    "factuuradres",
                    "btw_nummer",
                    "betaaltermijn_dagen",
                    "aangemaakt_op",
                    "gewijzigd_op",
                    "verwijderd_op"
                ],
                "examples": [
                    {
                        "id": 7,
                        "naam": "Havenbedrijf Zuid",
                        "soort": "direct",
                        "contactpersoon": "A. de Vries",
                        "email": "beveiliging@havenzuid.example",
                        "actief": true,
                        "factuuradres": {
                            "adres": "Kade 12",
                            "postcode": "3011 AA",
                            "plaats": "Rotterdam"
                        },
                        "btw_nummer": "NL000000000B01",
                        "betaaltermijn_dagen": 30,
                        "aangemaakt_op": "2026-01-05T09:12:00+01:00",
                        "gewijzigd_op": "2026-05-30T14:02:11+02:00",
                        "verwijderd_op": null
                    }
                ]
            },
            "Object": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "naam": {
                        "type": "string"
                    },
                    "adres": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "opdrachtgever_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "opdrachtgever_label": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "coordinaten": {
                        "oneOf": [
                            {
                                "type": "object",
                                "properties": {
                                    "lat": {
                                        "type": "number"
                                    },
                                    "lng": {
                                        "type": "number"
                                    }
                                },
                                "required": [
                                    "lat",
                                    "lng"
                                ]
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "geofence_meters": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "rondes_per_dienst": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "actief": {
                        "type": "boolean"
                    },
                    "gesloten_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "normen": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "weekdag": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "dienstsoort": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "minimum": {
                                    "type": "integer"
                                },
                                "gewenst": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "ernst": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "blok",
                                        "waarschuwing",
                                        null
                                    ]
                                },
                                "alleen_toegestaan": {
                                    "type": "boolean"
                                },
                                "geldig_van": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                },
                                "geldig_tot": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                }
                            },
                            "required": [
                                "id",
                                "weekdag",
                                "dienstsoort",
                                "minimum",
                                "gewenst",
                                "ernst",
                                "alleen_toegestaan",
                                "geldig_van",
                                "geldig_tot"
                            ]
                        }
                    },
                    "teams": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "team_id": {
                                    "type": "integer"
                                },
                                "van": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                },
                                "tot": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                }
                            },
                            "required": [
                                "team_id",
                                "van",
                                "tot"
                            ]
                        }
                    },
                    "aangemaakt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "naam",
                    "adres",
                    "opdrachtgever_id",
                    "opdrachtgever_label",
                    "coordinaten",
                    "geofence_meters",
                    "rondes_per_dienst",
                    "actief",
                    "gesloten_op",
                    "normen",
                    "teams",
                    "aangemaakt_op",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 12,
                        "naam": "Distributiecentrum Oost",
                        "adres": "Logistiekweg 4, Utrecht",
                        "opdrachtgever_id": 7,
                        "opdrachtgever_label": null,
                        "coordinaten": {
                            "lat": 52.0907,
                            "lng": 5.1214
                        },
                        "geofence_meters": 150,
                        "rondes_per_dienst": 2,
                        "actief": true,
                        "gesloten_op": null,
                        "normen": [
                            {
                                "id": 3,
                                "weekdag": null,
                                "dienstsoort": "dag",
                                "minimum": 2,
                                "gewenst": null,
                                "ernst": "waarschuwing",
                                "alleen_toegestaan": false,
                                "geldig_van": "2026-01-01",
                                "geldig_tot": null
                            }
                        ],
                        "teams": [
                            {
                                "team_id": 4,
                                "van": "2026-01-01",
                                "tot": null
                            }
                        ],
                        "aangemaakt_op": "2026-01-05T09:20:00+01:00",
                        "gewijzigd_op": "2026-03-02T11:00:00+01:00"
                    }
                ]
            },
            "Team": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "naam": {
                        "type": "string"
                    },
                    "soort": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "actief": {
                        "type": "boolean"
                    },
                    "planningscyclus": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "cyclus_weken": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "leden": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "beveiliger_id": {
                                    "type": "integer"
                                },
                                "rol": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "van": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                },
                                "tot": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                }
                            },
                            "required": [
                                "beveiliger_id",
                                "rol",
                                "van",
                                "tot"
                            ]
                        }
                    },
                    "objecten": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "object_id": {
                                    "type": "integer"
                                },
                                "van": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                },
                                "tot": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                }
                            },
                            "required": [
                                "object_id",
                                "van",
                                "tot"
                            ]
                        }
                    },
                    "aangemaakt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "naam",
                    "soort",
                    "actief",
                    "planningscyclus",
                    "cyclus_weken",
                    "leden",
                    "objecten",
                    "aangemaakt_op",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 4,
                        "naam": "Ploeg Noord",
                        "soort": "ploeg",
                        "actief": true,
                        "planningscyclus": "weeks",
                        "cyclus_weken": 4,
                        "leden": [
                            {
                                "beveiliger_id": 31,
                                "rol": "lid",
                                "van": "2026-01-01",
                                "tot": null
                            }
                        ],
                        "objecten": [
                            {
                                "object_id": 12,
                                "van": "2026-01-01",
                                "tot": null
                            }
                        ],
                        "aangemaakt_op": "2026-01-02T08:00:00+01:00",
                        "gewijzigd_op": "2026-04-14T10:30:00+02:00"
                    }
                ]
            },
            "Beveiliger": {
                "type": "object",
                "description": "Nooit BSN, IBAN, adres, geboortedatum of documenten.",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "naam": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "personeelsnummer": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "contractsoort": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "zzp": {
                        "type": "boolean"
                    },
                    "uren_per_week": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "in_dienst_sinds": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "actief": {
                        "type": "boolean"
                    },
                    "teams": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        }
                    },
                    "aangemaakt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "naam",
                    "email",
                    "personeelsnummer",
                    "contractsoort",
                    "zzp",
                    "uren_per_week",
                    "in_dienst_sinds",
                    "actief",
                    "teams",
                    "aangemaakt_op",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 31,
                        "naam": "Mo Yilmaz",
                        "email": "mo.yilmaz@voorbeeld.example",
                        "personeelsnummer": "B-0031",
                        "contractsoort": "vast",
                        "zzp": false,
                        "uren_per_week": 38,
                        "in_dienst_sinds": "2024-03-01",
                        "actief": true,
                        "teams": [
                            4
                        ],
                        "aangemaakt_op": "2024-02-20T10:00:00+01:00",
                        "gewijzigd_op": "2026-05-01T09:00:00+02:00"
                    }
                ]
            },
            "Kwalificatie": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "beveiliger_id": {
                        "type": "integer"
                    },
                    "soort": {
                        "type": "string"
                    },
                    "omschrijving": {
                        "type": "string"
                    },
                    "nummer": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "geldig_tot": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "verlopen": {
                        "type": "boolean"
                    },
                    "beoordeling": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "beoordeeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "beveiliger_id",
                    "soort",
                    "omschrijving",
                    "nummer",
                    "geldig_tot",
                    "verlopen",
                    "beoordeling",
                    "beoordeeld_op",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 88,
                        "beveiliger_id": 31,
                        "soort": "wpbr_pas",
                        "omschrijving": "WPBR-legitimatiebewijs (grijze pas)",
                        "nummer": "P123456",
                        "geldig_tot": "2027-02-28",
                        "verlopen": false,
                        "beoordeling": "verified",
                        "beoordeeld_op": "2026-02-01T10:00:00+01:00",
                        "gewijzigd_op": "2026-02-01T10:00:00+01:00"
                    }
                ]
            },
            "Dienst": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "object_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "team_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "contract_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "planperiode_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "dienstsoort": {
                        "type": "string",
                        "enum": [
                            "dag",
                            "avond",
                            "nacht",
                            "dag12",
                            "nacht12"
                        ]
                    },
                    "begint_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "eindigt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "geplande_minuten": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "planstatus": {
                        "type": "string",
                        "enum": [
                            "concept",
                            "gepubliceerd",
                            "vervallen"
                        ]
                    },
                    "uitvoering": {
                        "type": "string",
                        "enum": [
                            "gepland",
                            "aangemeld",
                            "afgerond"
                        ]
                    },
                    "bron": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "vervanging": {
                        "oneOf": [
                            {
                                "type": "object",
                                "properties": {
                                    "status": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    },
                                    "van_beveiliger_id": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ]
                                    }
                                },
                                "required": [
                                    "status",
                                    "van_beveiliger_id"
                                ]
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "aangemeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "aanmeldmethode": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "geofence": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "afgemeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "afmelding_ontbreekt_sinds": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewerkte_minuten": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "meerwerk": {
                        "oneOf": [
                            {
                                "type": "object",
                                "properties": {
                                    "minuten": {
                                        "type": "integer"
                                    },
                                    "gevraagd_door": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    },
                                    "reden": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    },
                                    "geregistreerd_op": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date-time"
                                    }
                                },
                                "required": [
                                    "minuten",
                                    "gevraagd_door",
                                    "reden",
                                    "geregistreerd_op"
                                ]
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "notities": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "aangemaakt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "object_id",
                    "team_id",
                    "beveiliger_id",
                    "contract_id",
                    "planperiode_id",
                    "dienstsoort",
                    "begint_op",
                    "eindigt_op",
                    "geplande_minuten",
                    "planstatus",
                    "uitvoering",
                    "bron",
                    "vervanging",
                    "aangemeld_op",
                    "aanmeldmethode",
                    "geofence",
                    "afgemeld_op",
                    "afmelding_ontbreekt_sinds",
                    "gewerkte_minuten",
                    "meerwerk",
                    "notities",
                    "aangemaakt_op",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 41,
                        "object_id": 12,
                        "team_id": 4,
                        "beveiliger_id": 31,
                        "contract_id": 6,
                        "planperiode_id": 20,
                        "dienstsoort": "dag",
                        "begint_op": "2026-06-01T07:00:00+02:00",
                        "eindigt_op": "2026-06-01T15:00:00+02:00",
                        "geplande_minuten": 480,
                        "planstatus": "gepubliceerd",
                        "uitvoering": "afgerond",
                        "bron": "handmatig",
                        "vervanging": null,
                        "aangemeld_op": "2026-06-01T06:54:00+02:00",
                        "aanmeldmethode": "geofence",
                        "geofence": "inside",
                        "afgemeld_op": "2026-06-01T15:20:00+02:00",
                        "afmelding_ontbreekt_sinds": null,
                        "gewerkte_minuten": 506,
                        "meerwerk": {
                            "minuten": 26,
                            "gevraagd_door": "Teamleider opdrachtgever",
                            "reden": "Laatste vrachtwagen te laat",
                            "geregistreerd_op": "2026-06-01T14:50:00+02:00"
                        },
                        "notities": null,
                        "aangemaakt_op": "2026-05-20T10:00:00+02:00",
                        "gewijzigd_op": "2026-06-01T15:20:02+02:00"
                    }
                ]
            },
            "DienstMetBevindingen": {
                "type": "object",
                "properties": {
                    "data": {
                        "$ref": "#/components/schemas/Dienst"
                    },
                    "bevindingen": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Planregel"
                        }
                    }
                },
                "required": [
                    "data",
                    "bevindingen"
                ],
                "examples": [
                    {
                        "data": {
                            "id": 41,
                            "object_id": 12,
                            "team_id": 4,
                            "beveiliger_id": 31,
                            "contract_id": 6,
                            "planperiode_id": 20,
                            "dienstsoort": "dag",
                            "begint_op": "2026-06-01T07:00:00+02:00",
                            "eindigt_op": "2026-06-01T15:00:00+02:00",
                            "geplande_minuten": 480,
                            "planstatus": "gepubliceerd",
                            "uitvoering": "afgerond",
                            "bron": "handmatig",
                            "vervanging": null,
                            "aangemeld_op": "2026-06-01T06:54:00+02:00",
                            "aanmeldmethode": "geofence",
                            "geofence": "inside",
                            "afgemeld_op": "2026-06-01T15:20:00+02:00",
                            "afmelding_ontbreekt_sinds": null,
                            "gewerkte_minuten": 506,
                            "meerwerk": {
                                "minuten": 26,
                                "gevraagd_door": "Teamleider opdrachtgever",
                                "reden": "Laatste vrachtwagen te laat",
                                "geregistreerd_op": "2026-06-01T14:50:00+02:00"
                            },
                            "notities": null,
                            "aangemaakt_op": "2026-05-20T10:00:00+02:00",
                            "gewijzigd_op": "2026-06-01T15:20:02+02:00"
                        },
                        "bevindingen": [
                            {
                                "regel": "contracturen",
                                "ernst": "waarschuwing",
                                "melding": "Mo Yilmaz komt op 112 procent van het contract deze week.",
                                "gegevens": {
                                    "percent": 112
                                }
                            }
                        ]
                    }
                ]
            },
            "DienstInvoer": {
                "type": "object",
                "required": [
                    "object_id",
                    "dienstsoort",
                    "datum"
                ],
                "properties": {
                    "object_id": {
                        "type": "integer"
                    },
                    "dienstsoort": {
                        "type": "string",
                        "enum": [
                            "dag",
                            "avond",
                            "nacht",
                            "dag12",
                            "nacht12"
                        ]
                    },
                    "datum": {
                        "type": "string",
                        "format": "date"
                    },
                    "begint": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{2}:\\d{2}$",
                        "description": "UU:MM; leeg is het standaardvenster van de dienstsoort."
                    },
                    "eindigt": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{2}:\\d{2}$"
                    },
                    "beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "notities": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000
                    },
                    "force": {
                        "type": "boolean",
                        "description": "Ook doorgaan bij waarschuwingen. Een blokkade weigert altijd."
                    }
                },
                "examples": [
                    {
                        "object_id": 12,
                        "dienstsoort": "dag",
                        "datum": "2026-06-01",
                        "begint": "07:00",
                        "eindigt": "15:00",
                        "beveiliger_id": 31
                    }
                ]
            },
            "DienstWijziging": {
                "type": "object",
                "properties": {
                    "object_id": {
                        "type": "integer"
                    },
                    "dienstsoort": {
                        "type": "string",
                        "enum": [
                            "dag",
                            "avond",
                            "nacht",
                            "dag12",
                            "nacht12"
                        ]
                    },
                    "datum": {
                        "type": "string",
                        "format": "date"
                    },
                    "begint": {
                        "type": "string",
                        "pattern": "^\\d{2}:\\d{2}$"
                    },
                    "eindigt": {
                        "type": "string",
                        "pattern": "^\\d{2}:\\d{2}$"
                    },
                    "beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "force": {
                        "type": "boolean"
                    }
                },
                "examples": [
                    {
                        "begint": "08:00",
                        "eindigt": "16:00"
                    }
                ]
            },
            "Toewijzing": {
                "type": "object",
                "required": [
                    "beveiliger_id"
                ],
                "properties": {
                    "beveiliger_id": {
                        "type": "integer"
                    },
                    "force": {
                        "type": "boolean"
                    }
                },
                "examples": [
                    {
                        "beveiliger_id": 31
                    }
                ]
            },
            "Vrijgeven": {
                "type": "object",
                "properties": {
                    "force": {
                        "type": "boolean"
                    }
                },
                "examples": [
                    {
                        "force": false
                    }
                ]
            },
            "Vervallen": {
                "type": "object",
                "properties": {
                    "reden": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 180
                    }
                },
                "examples": [
                    {
                        "reden": "Opdrachtgever zegde de avond af."
                    }
                ]
            },
            "Uren": {
                "type": "object",
                "properties": {
                    "dienst_id": {
                        "type": "integer"
                    },
                    "beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "object_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "team_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "datum": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "dienstsoort": {
                        "type": "string"
                    },
                    "begint_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "eindigt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "aangemeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "afgemeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "geplande_minuten": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "gewerkte_minuten": {
                        "type": "integer"
                    },
                    "meerwerk_minuten": {
                        "type": "integer"
                    },
                    "eindtijd_bevestigd_door_kantoor": {
                        "type": "boolean"
                    },
                    "specificatie": {
                        "oneOf": [
                            {
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "integer"
                                    },
                                    "maand": {
                                        "type": "string"
                                    },
                                    "versie": {
                                        "type": "integer"
                                    },
                                    "status": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "id",
                                    "maand",
                                    "versie",
                                    "status"
                                ]
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "regels": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "soort": {
                                    "type": "string"
                                },
                                "omschrijving": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "minuten": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "uurloon_cent": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "percentage": {
                                    "type": [
                                        "number",
                                        "null"
                                    ]
                                },
                                "bedrag_cent": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "regel": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "datum": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date"
                                }
                            },
                            "required": [
                                "soort",
                                "omschrijving",
                                "minuten",
                                "uurloon_cent",
                                "percentage",
                                "bedrag_cent",
                                "regel",
                                "datum"
                            ]
                        }
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "dienst_id",
                    "beveiliger_id",
                    "object_id",
                    "team_id",
                    "datum",
                    "dienstsoort",
                    "begint_op",
                    "eindigt_op",
                    "aangemeld_op",
                    "afgemeld_op",
                    "geplande_minuten",
                    "gewerkte_minuten",
                    "meerwerk_minuten",
                    "eindtijd_bevestigd_door_kantoor",
                    "specificatie",
                    "regels",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "dienst_id": 41,
                        "beveiliger_id": 31,
                        "object_id": 12,
                        "team_id": 4,
                        "datum": "2026-06-01",
                        "dienstsoort": "nacht",
                        "begint_op": "2026-06-01T23:00:00+02:00",
                        "eindigt_op": "2026-06-02T07:00:00+02:00",
                        "aangemeld_op": "2026-06-01T22:56:00+02:00",
                        "afgemeld_op": "2026-06-02T07:30:00+02:00",
                        "geplande_minuten": 480,
                        "gewerkte_minuten": 514,
                        "meerwerk_minuten": 34,
                        "eindtijd_bevestigd_door_kantoor": false,
                        "specificatie": {
                            "id": 9,
                            "maand": "2026-06",
                            "versie": 1,
                            "status": "final"
                        },
                        "regels": [
                            {
                                "soort": "basis",
                                "omschrijving": "Basisuren",
                                "minuten": 480,
                                "uurloon_cent": 1650,
                                "percentage": null,
                                "bedrag_cent": 13200,
                                "regel": "cao art. 13",
                                "datum": "2026-06-01"
                            },
                            {
                                "soort": "toeslag",
                                "omschrijving": "Nachttoeslag",
                                "minuten": 420,
                                "uurloon_cent": 1650,
                                "percentage": 30,
                                "bedrag_cent": 3465,
                                "regel": "cao art. 21",
                                "datum": "2026-06-01"
                            }
                        ],
                        "gewijzigd_op": "2026-06-02T07:30:05+02:00"
                    }
                ]
            },
            "Verlof": {
                "type": "object",
                "description": "Bij ziekte (sick) is reden altijd leeg.",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "beveiliger_id": {
                        "type": "integer"
                    },
                    "soort": {
                        "type": "string",
                        "enum": [
                            "vacation",
                            "unpaid",
                            "special",
                            "sick"
                        ]
                    },
                    "van": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "tot": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "status": {
                        "type": "string"
                    },
                    "reden": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "beoordeeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "aangemaakt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "beveiliger_id",
                    "soort",
                    "van",
                    "tot",
                    "status",
                    "reden",
                    "beoordeeld_op",
                    "aangemaakt_op",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 55,
                        "beveiliger_id": 31,
                        "soort": "vacation",
                        "van": "2026-07-13",
                        "tot": "2026-07-24",
                        "status": "approved",
                        "reden": "Zomervakantie",
                        "beoordeeld_op": "2026-05-02T10:11:00+02:00",
                        "aangemaakt_op": "2026-04-28T19:40:00+02:00",
                        "gewijzigd_op": "2026-05-02T10:11:00+02:00"
                    }
                ]
            },
            "VerlofInvoer": {
                "type": "object",
                "required": [
                    "beveiliger_id",
                    "soort",
                    "van",
                    "tot",
                    "reden"
                ],
                "properties": {
                    "beveiliger_id": {
                        "type": "integer"
                    },
                    "soort": {
                        "type": "string",
                        "enum": [
                            "vacation",
                            "unpaid",
                            "special"
                        ]
                    },
                    "van": {
                        "type": "string",
                        "format": "date"
                    },
                    "tot": {
                        "type": "string",
                        "format": "date"
                    },
                    "reden": {
                        "type": "string",
                        "maxLength": 1000
                    }
                },
                "examples": [
                    {
                        "beveiliger_id": 31,
                        "soort": "vacation",
                        "van": "2026-07-13",
                        "tot": "2026-07-24",
                        "reden": "Zomervakantie"
                    }
                ]
            },
            "Beschikbaarheid": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "beveiliger_id": {
                        "type": "integer"
                    },
                    "weekdag": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "datum": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "beschikbaar": {
                        "type": "boolean"
                    },
                    "niveau": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "notitie": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "reistijd_minuten": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "beveiliger_id",
                    "weekdag",
                    "datum",
                    "beschikbaar",
                    "niveau",
                    "notitie",
                    "reistijd_minuten",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 301,
                        "beveiliger_id": 31,
                        "weekdag": 6,
                        "datum": null,
                        "beschikbaar": false,
                        "niveau": "no",
                        "notitie": null,
                        "reistijd_minuten": null,
                        "gewijzigd_op": "2026-05-10T12:00:00+02:00"
                    }
                ]
            },
            "BeschikbaarheidInvoer": {
                "type": "object",
                "properties": {
                    "weekdagen": {
                        "type": "array",
                        "maxItems": 7,
                        "items": {
                            "type": "object",
                            "required": [
                                "weekdag",
                                "beschikbaar"
                            ],
                            "properties": {
                                "weekdag": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 6
                                },
                                "beschikbaar": {
                                    "type": "boolean"
                                },
                                "niveau": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "yes",
                                        "maybe",
                                        "no",
                                        null
                                    ]
                                }
                            }
                        }
                    },
                    "uitzonderingen": {
                        "type": "array",
                        "maxItems": 366,
                        "items": {
                            "type": "object",
                            "required": [
                                "datum",
                                "beschikbaar"
                            ],
                            "properties": {
                                "datum": {
                                    "type": "string",
                                    "format": "date"
                                },
                                "beschikbaar": {
                                    "type": "boolean"
                                },
                                "notitie": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 255
                                }
                            }
                        }
                    }
                },
                "examples": [
                    {
                        "weekdagen": [
                            {
                                "weekdag": 0,
                                "beschikbaar": false,
                                "niveau": "no"
                            }
                        ],
                        "uitzonderingen": [
                            {
                                "datum": "2026-06-12",
                                "beschikbaar": false,
                                "notitie": "Bruiloft"
                            }
                        ]
                    }
                ]
            },
            "Bevinding": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "dienst_id": {
                        "type": "integer"
                    },
                    "object_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "ronde_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "controlepunt_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "categorie": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "plaats": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "risico": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "politie_nodig": {
                        "type": "boolean"
                    },
                    "omschrijving": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "locatie": {
                        "oneOf": [
                            {
                                "type": "object",
                                "properties": {
                                    "lat": {
                                        "type": "number"
                                    },
                                    "lng": {
                                        "type": "number"
                                    }
                                },
                                "required": [
                                    "lat",
                                    "lng"
                                ]
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "gemeld_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "geescaleerd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "escalatie_reden": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "reactie": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "beantwoord_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "afgesloten_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "heeft_foto": {
                        "type": "boolean"
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "dienst_id",
                    "object_id",
                    "beveiliger_id",
                    "ronde_id",
                    "controlepunt_id",
                    "categorie",
                    "plaats",
                    "risico",
                    "politie_nodig",
                    "omschrijving",
                    "status",
                    "locatie",
                    "gemeld_op",
                    "geescaleerd_op",
                    "escalatie_reden",
                    "reactie",
                    "beantwoord_op",
                    "afgesloten_op",
                    "heeft_foto",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 501,
                        "dienst_id": 41,
                        "object_id": 12,
                        "beveiliger_id": 31,
                        "ronde_id": 77,
                        "controlepunt_id": 9,
                        "categorie": "deur",
                        "plaats": "Nooduitgang hal B",
                        "risico": "midden",
                        "politie_nodig": false,
                        "omschrijving": "Nooduitgang stond open, gesloten en gemeld.",
                        "status": "open",
                        "locatie": {
                            "lat": 52.0911,
                            "lng": 5.122
                        },
                        "gemeld_op": "2026-06-02T02:14:00+02:00",
                        "geescaleerd_op": null,
                        "escalatie_reden": null,
                        "reactie": null,
                        "beantwoord_op": null,
                        "afgesloten_op": null,
                        "heeft_foto": true,
                        "gewijzigd_op": "2026-06-02T02:14:00+02:00"
                    }
                ]
            },
            "FotoLink": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string"
                    },
                    "verloopt_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "geldig_minuten": {
                        "type": "integer"
                    }
                },
                "required": [
                    "url",
                    "verloopt_op",
                    "geldig_minuten"
                ],
                "examples": [
                    {
                        "url": "https://api.beveiligingx.nl/api/v1/beveiliging/bevindingen/501/foto/bestand?organisatie=3&expires=1780363200&signature=6b1d...",
                        "verloopt_op": "2026-06-02T09:05:00+02:00",
                        "geldig_minuten": 5
                    }
                ]
            },
            "Ronde": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "dienst_id": {
                        "type": "integer"
                    },
                    "volgnummer": {
                        "type": "integer"
                    },
                    "status": {
                        "type": "string"
                    },
                    "gepland_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "gestart_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "onderbroken_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "onderbreking_reden": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "hervat_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "afgerond_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "scans": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "controlepunt_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "controlepunt": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "status": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "gescand_op": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time"
                                },
                                "storing": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "geofence": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                }
                            },
                            "required": [
                                "id",
                                "controlepunt_id",
                                "controlepunt",
                                "status",
                                "gescand_op",
                                "storing",
                                "geofence"
                            ]
                        }
                    },
                    "gewijzigd_op": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "dienst_id",
                    "volgnummer",
                    "status",
                    "gepland_op",
                    "gestart_op",
                    "onderbroken_op",
                    "onderbreking_reden",
                    "hervat_op",
                    "afgerond_op",
                    "scans",
                    "gewijzigd_op"
                ],
                "examples": [
                    {
                        "id": 77,
                        "dienst_id": 41,
                        "volgnummer": 1,
                        "status": "completed",
                        "gepland_op": null,
                        "gestart_op": "2026-06-02T01:00:00+02:00",
                        "onderbroken_op": null,
                        "onderbreking_reden": null,
                        "hervat_op": null,
                        "afgerond_op": "2026-06-02T01:42:00+02:00",
                        "scans": [
                            {
                                "id": 900,
                                "controlepunt_id": 9,
                                "controlepunt": "Hal B noord",
                                "status": "ok",
                                "gescand_op": "2026-06-02T01:12:00+02:00",
                                "storing": null,
                                "geofence": "inside"
                            }
                        ],
                        "gewijzigd_op": "2026-06-02T01:42:00+02:00"
                    }
                ]
            },
            "Envelop": {
                "type": "object",
                "description": "De envelop van elke webhook.",
                "properties": {
                    "id": {
                        "type": "string",
                        "description": "evt_ plus een ULID. Dezelfde bij opnieuw versturen: gebruik hem om een herhaling te negeren."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "dienst.aangemaakt",
                            "dienst.gewijzigd",
                            "dienst.toegewezen",
                            "dienst.vervallen",
                            "dienst.aangemeld",
                            "dienst.afgemeld",
                            "meerwerk.geregistreerd",
                            "bevinding.gemeld",
                            "verlof.aangevraagd",
                            "verlof.goedgekeurd",
                            "verlof.afgewezen",
                            "maandstaat.gesloten",
                            "factuur.aangemaakt",
                            "kwalificatie.verloopt",
                            "test.ping"
                        ]
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "api_version": {
                        "type": "string",
                        "const": "v1"
                    },
                    "tenant": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "naam": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "id",
                            "naam"
                        ]
                    },
                    "data": {
                        "type": "object"
                    }
                },
                "required": [
                    "id",
                    "type",
                    "occurred_at",
                    "api_version",
                    "tenant",
                    "data"
                ],
                "examples": [
                    {
                        "id": "evt_01jz8m2c4n7q9r0s1t2v3w4x5y",
                        "type": "dienst.toegewezen",
                        "occurred_at": "2026-05-28T14:03:12+02:00",
                        "api_version": "v1",
                        "tenant": {
                            "id": 3,
                            "naam": "Wachtpost Beveiliging B.V."
                        },
                        "data": {
                            "dienst": {
                                "id": 41,
                                "object_id": 12,
                                "team_id": 4,
                                "beveiliger_id": 31,
                                "contract_id": 6,
                                "planperiode_id": 20,
                                "dienstsoort": "dag",
                                "begint_op": "2026-06-01T07:00:00+02:00",
                                "eindigt_op": "2026-06-01T15:00:00+02:00",
                                "geplande_minuten": 480,
                                "planstatus": "gepubliceerd",
                                "uitvoering": "afgerond",
                                "bron": "handmatig",
                                "vervanging": null,
                                "aangemeld_op": "2026-06-01T06:54:00+02:00",
                                "aanmeldmethode": "geofence",
                                "geofence": "inside",
                                "afgemeld_op": "2026-06-01T15:20:00+02:00",
                                "afmelding_ontbreekt_sinds": null,
                                "gewerkte_minuten": 506,
                                "meerwerk": {
                                    "minuten": 26,
                                    "gevraagd_door": "Teamleider opdrachtgever",
                                    "reden": "Laatste vrachtwagen te laat",
                                    "geregistreerd_op": "2026-06-01T14:50:00+02:00"
                                },
                                "notities": null,
                                "aangemaakt_op": "2026-05-20T10:00:00+02:00",
                                "gewijzigd_op": "2026-06-01T15:20:02+02:00"
                            },
                            "beveiliger_id": 31,
                            "vorige_beveiliger_id": null
                        }
                    }
                ]
            },
            "DienstGebeurtenis": {
                "type": "object",
                "properties": {
                    "dienst": {
                        "$ref": "#/components/schemas/Dienst"
                    }
                },
                "required": [
                    "dienst"
                ]
            },
            "DienstGewijzigdGebeurtenis": {
                "type": "object",
                "properties": {
                    "dienst": {
                        "$ref": "#/components/schemas/Dienst"
                    },
                    "velden": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "De velden van Dienst die veranderden."
                    }
                },
                "required": [
                    "dienst",
                    "velden"
                ]
            },
            "DienstToegewezenGebeurtenis": {
                "type": "object",
                "properties": {
                    "dienst": {
                        "$ref": "#/components/schemas/Dienst"
                    },
                    "beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "vorige_beveiliger_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "dienst",
                    "beveiliger_id",
                    "vorige_beveiliger_id"
                ]
            },
            "BevindingGebeurtenis": {
                "type": "object",
                "properties": {
                    "bevinding": {
                        "$ref": "#/components/schemas/Bevinding"
                    }
                },
                "required": [
                    "bevinding"
                ]
            },
            "VerlofGebeurtenis": {
                "type": "object",
                "properties": {
                    "verlof": {
                        "$ref": "#/components/schemas/Verlof"
                    }
                },
                "required": [
                    "verlof"
                ]
            },
            "MaandstaatGebeurtenis": {
                "type": "object",
                "properties": {
                    "maandstaat": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "object_id": {
                                "type": "integer"
                            },
                            "object": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "opdrachtgever": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "maand": {
                                "type": "string"
                            },
                            "status": {
                                "type": "string"
                            },
                            "geleverde_minuten": {
                                "type": "integer"
                            },
                            "te_factureren_cent": {
                                "type": "integer"
                            },
                            "gesloten_op": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time"
                            }
                        },
                        "required": [
                            "id",
                            "object_id",
                            "object",
                            "opdrachtgever",
                            "maand",
                            "status",
                            "geleverde_minuten",
                            "te_factureren_cent",
                            "gesloten_op"
                        ]
                    }
                },
                "required": [
                    "maandstaat"
                ]
            },
            "FactuurGebeurtenis": {
                "type": "object",
                "properties": {
                    "factuur": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "soort": {
                                "type": "string",
                                "enum": [
                                    "verkoop",
                                    "verkoopcredit"
                                ]
                            },
                            "nummer": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "status": {
                                "type": "string"
                            },
                            "factuurdatum": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date"
                            },
                            "vervaldatum": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date"
                            },
                            "relatie": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    },
                                    "naam": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    }
                                },
                                "required": [
                                    "code",
                                    "naam"
                                ]
                            },
                            "referentie": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "totaal_excl_cent": {
                                "type": "integer"
                            },
                            "btw_cent": {
                                "type": "integer"
                            },
                            "totaal_cent": {
                                "type": "integer"
                            },
                            "bron": {
                                "oneOf": [
                                    {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ]
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "id"
                                        ]
                                    },
                                    {
                                        "type": "null"
                                    }
                                ]
                            }
                        },
                        "required": [
                            "id",
                            "soort",
                            "nummer",
                            "status",
                            "factuurdatum",
                            "vervaldatum",
                            "relatie",
                            "referentie",
                            "totaal_excl_cent",
                            "btw_cent",
                            "totaal_cent",
                            "bron"
                        ]
                    }
                },
                "required": [
                    "factuur"
                ]
            },
            "KwalificatieGebeurtenis": {
                "type": "object",
                "properties": {
                    "kwalificatie": {
                        "$ref": "#/components/schemas/Kwalificatie"
                    },
                    "beveiliger": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "naam": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "id",
                            "naam"
                        ]
                    },
                    "fase": {
                        "type": "string",
                        "enum": [
                            "binnenkort",
                            "verlopen"
                        ]
                    },
                    "dagen_tot_verloop": {
                        "type": "integer",
                        "description": "Negatief als hij al verlopen is."
                    }
                },
                "required": [
                    "kwalificatie",
                    "beveiliger",
                    "fase",
                    "dagen_tot_verloop"
                ]
            },
            "TestGebeurtenis": {
                "type": "object",
                "properties": {
                    "bericht": {
                        "type": "string"
                    },
                    "webhook_id": {
                        "type": "integer"
                    }
                },
                "required": [
                    "bericht",
                    "webhook_id"
                ]
            }
        }
    },
    "x-scopes": [
        {
            "scope": "beveiliging.lezen",
            "label": "Planning en operatie lezen",
            "uitleg": "Opdrachtgevers, objecten met normen, teams, beveiligers, diensten, verlof, beschikbaarheid, bevindingen zonder foto en rondes."
        },
        {
            "scope": "beveiliging.planning.schrijven",
            "label": "Planning schrijven",
            "uitleg": "Conceptdiensten maken, wijzigen en laten vervallen, beveiligers toewijzen en beschikbaarheid zetten. Alles langs de planregels."
        },
        {
            "scope": "beveiliging.verlof.schrijven",
            "label": "Verlof aanvragen",
            "uitleg": "Een verlofaanvraag indienen namens een beveiliger; beoordelen doet kantoor."
        },
        {
            "scope": "beveiliging.uren.lezen",
            "label": "Uren en toeslagen lezen",
            "uitleg": "Gewerkte diensten met minuten, meerwerk en de regels uit de loonspecificatie."
        },
        {
            "scope": "beveiliging.dossier.lezen",
            "label": "Kwalificaties lezen",
            "uitleg": "De kwalificaties van beveiligers met hun vervaldatum. Nooit een BSN, IBAN of document."
        },
        {
            "scope": "beveiliging.bevindingen.foto",
            "label": "Foto bij een bevinding",
            "uitleg": "Een getekende link van vijf minuten naar de foto bij een bevinding."
        }
    ]
}
