{
"openapi": "3.1.0",
"info": {
"title": "Common Gateway",
"description": "The Common Gateway is a further Dutch development of the European API Platform. API Platform is a project of Les Tilleus and, in itself, an extension of the Symfony framework. API Platform is a tool for delivering APIs based on standardized documentation and is used for various French and German government projects. Including Digital state, a precursor to Xroute, GOV.UK and Common Ground. The project is now part of joinup.eu (the European equivalent of Common Ground).",
"version": "1.0.3"
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
],
"paths": {
"/kic/v1/betrokkenenbijklantcontact/{id}": {
"get": {
"operationId": "betrokkenebijklantcontact-get-item",
"summary": "BetrokkeneBijKlantcontact",
"tags": [
"betrokkenebijklantcontact"
],
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"operationId": "betrokkenebijklantcontact-patch-item",
"summary": "BetrokkeneBijKlantcontact",
"tags": [
"betrokkenebijklantcontact"
],
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
}
},
"responses": {
"200": {
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/betrokkenenbijklantcontact": {
"get": {
"tags": [
"betrokkenebijklantcontact"
],
"summary": "BetrokkeneBijKlantcontact",
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"operationId": "betrokkenebijklantcontact-get-collection",
"parameters": [
{
"name": "voorkeurstaal",
"in": "query",
"description": "De taal waarin de persoon of organisatie bij voorkeur interactie heeft met de gemeente.",
"required": false,
"schema": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
],
"description": "De code, behorende bij de landnaam, opgenomen in de Landentabel van de GBA.",
"minLength": 1,
"cascade": true
},
"naam": {
"type": [
"string",
"null"
],
"description": "De naam van het land, zoals opgenomen in de Landentabel van de GBA.",
"minLength": 1,
"cascade": true
}
}
}
},
{
"name": "communicatiekanaal",
"in": "query",
"description": "Het kanaal waarlangs de partij bij voorkeur interactie heeft met de gemeente.",
"required": false,
"schema": {
"type": "object",
"properties": {
"adres": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"omschrijving": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"soortDigitaalAdres": {
"type": "string",
"enum": [
"emailadres",
"telefoonnummer",
"formulier",
null
],
"description": "De typering van het digitale adres waarmee bepaald kan worden op welk kanaal dit digitale adres valide is.",
"cascade": true
}
}
}
},
{
"name": "correspondentieadres",
"in": "query",
"description": "Het adres waarnaar de persoon of de organisatie de voor hen bestemde correspondentie laat verzenden.",
"required": false,
"schema": {
"type": "object",
"properties": {
"aanduidingBijHuisnummer": {
"type": "string",
"enum": [
"bij",
"tegenover",
null
],
"description": "De aanduiding die gebruikt wordt voor bijvoorbeeld een ligplaats of een standplaats die geen eigen nummeraanduiding heeft.",
"cascade": true
},
"adresregelBuitenland1": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland2": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland3": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"antwoordnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"huisletter": {
"type": [
"string",
"null"
],
"maxLength": 1,
"cascade": true
},
"huisnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"huisnummertoevoeging": {
"type": [
"string",
"null"
],
"maxLength": 4,
"cascade": true
},
"postbusnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"postcode": {
"type": [
"string",
"null"
],
"maxLength": 7,
"cascade": true
},
"soortCorrespondentieadres": {
"type": "string",
"enum": [
"postbusnummer",
"antwoordnummer",
"binnenlands_adres",
"buitenlands_adres",
null
],
"description": "Typering waarmee aangegeven wordt of het correspondentieadres een binnenlands - of een buitenlands adres is danwel een postbusnummer of een antwoordnummer.\n\n`postbusnummer` - postbusnummer\n`antwoordnummer` - antwoordnummer\n`binnenlands_adres` - binnenlands adres\n`buitenlands_adres` - buitenlands adres",
"cascade": true
},
"straat": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"woonplaats": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"land": {
"type": [
"object",
"null"
],
"description": "Het SUBJECT dat heeft aangegeven te (gaan) verblijven dan wel verblijft in het LAND",
"_list": "/admin/objects?_self.schema.id=9c497e05-3dda-4cb7-8cde-d3030d0599aa",
"cascade": true
}
}
}
},
{
"name": "bezoekadres",
"in": "query",
"description": "Een bezoekadres is een adres waar een persoon of een bedrijf bezoekers ontvangt.",
"required": false,
"schema": {
"type": "object",
"properties": {
"aanduidingBijHuisnummer": {
"type": "string",
"enum": [
"bij",
"tegenover",
null
],
"description": "De aanduiding die gebruikt wordt voor bijvoorbeeld een ligplaats of een standplaats die geen eigen nummeraanduiding heeft.",
"cascade": true
},
"adresregelBuitenland1": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland2": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland3": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"huisletter": {
"type": [
"string",
"null"
],
"maxLength": 1,
"cascade": true
},
"huisnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"huisnummertoevoeging": {
"type": [
"string",
"null"
],
"maxLength": 4,
"cascade": true
},
"postcode": {
"type": [
"string",
"null"
],
"maxLength": 7,
"cascade": true
},
"soortBezoekadres": {
"type": "string",
"enum": [
"binnenlands_adres",
"buitenlands_adres",
null
],
"description": "Typering waarmee aangegeven of het bezoekadres een binnenlands - of een buitenlands adres is.\n\n`binnenlands_adres` - binnenlands adres\n`buitenlands_adres` - buitenlands adres",
"cascade": true
},
"straat": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"woonplaats": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"land": {
"type": [
"object",
"null"
],
"description": "Het SUBJECT dat heeft aangegeven te (gaan) verblijven dan wel verblijft in het LAND",
"_list": "/admin/objects?_self.schema.id=9c497e05-3dda-4cb7-8cde-d3030d0599aa",
"cascade": true
}
}
}
},
{
"name": "contactnaam",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"contactnaam": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=b62d30d6-cb55-4e77-87bb-d6bb00118515",
"cascade": true
}
}
}
},
{
"name": "partij",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"interneNotitie": {
"type": [
"string",
"null"
],
"cascade": true
},
"indicatieGeheimhouding": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "false"
},
"indicatieActief": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "true"
},
"soortPartij": {
"type": [
"string",
"null"
],
"cascade": true
},
"voorkeurstaal": {
"type": [
"object",
"null"
],
"description": "De taal waarin de persoon of organisatie bij voorkeur interactie heeft met de gemeente.",
"_list": "/admin/objects?_self.schema.id=b4398460-3062-42a9-ab30-7cc2fb674edb",
"cascade": true
},
"organisatie": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=1b7e3fcc-24c5-449f-ac65-c44a370734a8",
"cascade": true
},
"persoon": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=a6a07771-98d4-4223-8df2-b66eb0eb274c",
"cascade": true
},
"contactpersoon": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=763478cb-38f4-4114-aea7-bcbd713cdab0",
"cascade": true
},
"voorkeurskanaal": {
"type": [
"object",
"null"
],
"description": "Het kanaal waarlangs de partij bij voorkeur interactie heeft met de gemeente.",
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true
},
"verstrekteAdressen": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true,
"multiple": true
},
"bezoekadres": {
"type": [
"object",
"null"
],
"description": "Een bezoekadres is een adres waar een persoon of een bedrijf bezoekers ontvangt.",
"_list": "/admin/objects?_self.schema.id=687c3891-3910-4e60-806f-a955ce82653f",
"cascade": true
},
"correspondentieadres": {
"type": [
"object",
"null"
],
"description": "Het adres waarnaar de persoon of de organisatie de voor hen bestemde correspondentie laat verzenden.",
"_list": "/admin/objects?_self.schema.id=d25bc65e-39b8-4d81-a6e7-0746c330b207",
"cascade": true
},
"externeIdentificaties": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=106c8abf-c561-40dc-9f3f-2feb21d86e15",
"cascade": true,
"multiple": true
},
"vertegenwoordiger": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=ab58e6bf-6ff3-49c6-8f2c-f4a27331b6d5",
"cascade": true
},
"vertegenwoordigde": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=ab58e6bf-6ff3-49c6-8f2c-f4a27331b6d5",
"cascade": true
}
}
}
},
{
"name": "klantcontact",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "object",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"onderwerp": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"inhoud": {
"type": [
"string",
"null"
],
"cascade": true
},
"todo": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"resultaat": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"indicatieContactGelukt": {
"type": "string",
"enum": [
"ja",
"nee",
"onbekend",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"taal": {
"type": [
"string",
"null"
],
"cascade": true
},
"vertrouwelijk": {
"type": "string",
"enum": [
"ja",
"nee",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"plaatsgevondenOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"interneTaakOntstaanUit": {
"type": [
"array",
"null"
],
"cascade": true
},
"geregistreerdOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"kanaal": {
"type": [
"object",
"null"
],
"description": "Het communicatiekanaal dat tijdens het klantcontact werd gebruikt.",
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true
},
"actors": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=275e715b-dd75-4f3b-bad3-bab9054baa3f",
"cascade": true,
"multiple": true
},
"bijlage": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=086a6a6c-1894-417c-8ef1-af7b5c2eee82",
"cascade": true,
"multiple": true
},
"gaatOver": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=66764c0e-139a-4705-9af7-8375a20cf622",
"cascade": true
}
}
}
},
{
"name": "organisatienaam",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "intitiator",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"name": "rol",
"in": "query",
"description": "De typering van de rol van de persoon of organisatie in het klantcontact.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"betrokkenebijklantcontact"
],
"summary": "BetrokkeneBijKlantcontact",
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"operationId": "betrokkenebijklantcontact-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
}
},
"responses": {
"200": {
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/BetrokkeneBijKlantcontact"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/bijlagen/{id}": {
"get": {
"tags": [
"bijlage"
],
"summary": "Bijlage",
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"operationId": "bijlage-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"bijlage"
],
"summary": "Bijlage",
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"operationId": "bijlage-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
}
}
},
"responses": {
"200": {
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"bijlage"
],
"summary": "Bijlage",
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"operationId": "bijlage-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/bijlagen": {
"get": {
"tags": [
"bijlage"
],
"summary": "Bijlage",
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"operationId": "bijlage-get-collection",
"parameters": [
{
"name": "klantcontact",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "object",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"onderwerp": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"inhoud": {
"type": [
"string",
"null"
],
"cascade": true
},
"todo": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"resultaat": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"indicatieContactGelukt": {
"type": "string",
"enum": [
"ja",
"nee",
"onbekend",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"taal": {
"type": [
"string",
"null"
],
"cascade": true
},
"vertrouwelijk": {
"type": "string",
"enum": [
"ja",
"nee",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"plaatsgevondenOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"interneTaakOntstaanUit": {
"type": [
"array",
"null"
],
"cascade": true
},
"geregistreerdOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"kanaal": {
"type": [
"object",
"null"
],
"description": "Het communicatiekanaal dat tijdens het klantcontact werd gebruikt.",
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true
},
"actors": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=275e715b-dd75-4f3b-bad3-bab9054baa3f",
"cascade": true,
"multiple": true
},
"bijlage": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=086a6a6c-1894-417c-8ef1-af7b5c2eee82",
"cascade": true,
"multiple": true
},
"gaatOver": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=66764c0e-139a-4705-9af7-8375a20cf622",
"cascade": true
}
}
}
},
{
"name": "objectIdentificator",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "object",
"properties": {
"objecttype": {
"type": [
"string",
"null"
],
"cascade": true
},
"soortObjectId": {
"type": "string",
"enum": [
"integer",
"url",
"uuid",
"bsn",
null
],
"cascade": true
},
"objectId": {
"type": [
"string",
"null"
],
"cascade": true
},
"register": {
"type": [
"string",
"null"
],
"format": "url",
"cascade": true
}
}
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Bijlage"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Bijlage"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"bijlage"
],
"summary": "Bijlage",
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"operationId": "bijlage-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
}
}
},
"responses": {
"200": {
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bijlage"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/digitaaladressen/{id}": {
"get": {
"tags": [
"digitaal adres"
],
"summary": "Digitaal Adres",
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"operationId": "digitaal adres-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"digitaal adres"
],
"summary": "Digitaal Adres",
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"operationId": "digitaal adres-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
}
},
"responses": {
"200": {
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"digitaal adres"
],
"summary": "Digitaal Adres",
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"operationId": "digitaal adres-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/digitaaladressen": {
"get": {
"tags": [
"digitaal adres"
],
"summary": "Digitaal Adres",
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"operationId": "digitaal adres-get-collection",
"parameters": [
{
"name": "adres",
"in": "query",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "omschrijving",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "soortDigitaalAdres",
"in": "query",
"description": "De typering van het digitale adres waarmee bepaald kan worden op welk kanaal dit digitale adres valide is.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"digitaal adres"
],
"summary": "Digitaal Adres",
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"operationId": "digitaal adres-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
}
},
"responses": {
"200": {
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/internetaken/{id}": {
"get": {
"tags": [
"internetaak"
],
"summary": "InterneTaak",
"description": "",
"operationId": "internetaak-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"internetaak"
],
"summary": "InterneTaak",
"description": "",
"operationId": "internetaak-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
}
}
},
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"internetaak"
],
"summary": "InterneTaak",
"description": "",
"operationId": "internetaak-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/internetaken": {
"get": {
"tags": [
"internetaak"
],
"summary": "InterneTaak",
"description": "",
"operationId": "internetaak-get-collection",
"parameters": [
{
"name": "klantcontact",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "object",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"onderwerp": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"inhoud": {
"type": [
"string",
"null"
],
"cascade": true
},
"todo": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"resultaat": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"indicatieContactGelukt": {
"type": "string",
"enum": [
"ja",
"nee",
"onbekend",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"taal": {
"type": [
"string",
"null"
],
"cascade": true
},
"vertrouwelijk": {
"type": "string",
"enum": [
"ja",
"nee",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"plaatsgevondenOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"interneTaakOntstaanUit": {
"type": [
"array",
"null"
],
"cascade": true
},
"geregistreerdOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"kanaal": {
"type": [
"object",
"null"
],
"description": "Het communicatiekanaal dat tijdens het klantcontact werd gebruikt.",
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true
},
"actors": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=275e715b-dd75-4f3b-bad3-bab9054baa3f",
"cascade": true,
"multiple": true
},
"bijlage": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=086a6a6c-1894-417c-8ef1-af7b5c2eee82",
"cascade": true,
"multiple": true
},
"gaatOver": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=66764c0e-139a-4705-9af7-8375a20cf622",
"cascade": true
}
}
}
},
{
"name": "actor",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "object",
"properties": {
"klantcontact": {
"type": [
"array",
"null"
],
"cascade": true
},
"naam": {
"type": [
"string",
"null"
],
"maxLength": 200,
"cascade": true
},
"soortActor": {
"type": "string",
"enum": [
"Medewerker",
"Geautomatiseerde actor",
"Organisatorische eenheid",
null
],
"cascade": true
},
"medewerker": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=1a62ec57-6a31-44fb-ba3a-a23737143a1c",
"cascade": true
},
"geautomatiseerdeActor": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=424d19f7-413a-4620-82d3-f00459c1da71",
"cascade": true
},
"organisatorischeEenheid": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=b62477ac-6fa0-4471-b3c3-1bf431767aeb",
"cascade": true
}
}
}
},
{
"name": "toelichting",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "status",
"in": "query",
"description": "De waarden van de typering van de voortgang van afhandeling van\n\n een VERZOEK.- `te_verwerken` - te verwerken Het verzoek is afgehandeld.
- `verwerkt`\n\n - verwerkt Het verzoek id buiten behandeling gesteld.
",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "nummer",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "gevraagdeHandeling",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "toegewezenOp",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string",
"format": "datetime"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InterneTaak"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InterneTaak"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"internetaak"
],
"summary": "InterneTaak",
"description": "",
"operationId": "internetaak-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
}
}
},
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/InterneTaak"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/klantcontacten/{id}": {
"get": {
"tags": [
"klantcontact"
],
"summary": "Klantcontact",
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"operationId": "klantcontact-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"klantcontact"
],
"summary": "Klantcontact",
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"operationId": "klantcontact-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
}
}
},
"responses": {
"200": {
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/klantcontacten": {
"get": {
"tags": [
"klantcontact"
],
"summary": "Klantcontact",
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"operationId": "klantcontact-get-collection",
"parameters": [
{
"name": "nummer",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "onderwerp",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "inhoud",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "todo",
"in": "query",
"description": "This field is for backwards compatibilty with the klantenbundle.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "resultaat",
"in": "query",
"description": "This field is for backwards compatibilty with the klantenbundle.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "indicatieContactGelukt",
"in": "query",
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "taal",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "vertrouwelijk",
"in": "query",
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "plaatsgevondenOp",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string",
"format": "datetime"
}
},
{
"name": "interneTaakOntstaanUit[]",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "geregistreerdOp",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string",
"format": "datetime"
}
},
{
"name": "kanaal",
"in": "query",
"description": "Het communicatiekanaal dat tijdens het klantcontact werd gebruikt.",
"required": false,
"schema": {
"type": "object",
"properties": {
"adres": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"omschrijving": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"soortDigitaalAdres": {
"type": "string",
"enum": [
"emailadres",
"telefoonnummer",
"formulier",
null
],
"description": "De typering van het digitale adres waarmee bepaald kan worden op welk kanaal dit digitale adres valide is.",
"cascade": true
}
}
}
},
{
"name": "actors",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "object",
"properties": {
"klantcontact": {
"type": [
"array",
"null"
],
"cascade": true
},
"naam": {
"type": [
"string",
"null"
],
"maxLength": 200,
"cascade": true
},
"soortActor": {
"type": "string",
"enum": [
"Medewerker",
"Geautomatiseerde actor",
"Organisatorische eenheid",
null
],
"cascade": true
},
"medewerker": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=1a62ec57-6a31-44fb-ba3a-a23737143a1c",
"cascade": true
},
"geautomatiseerdeActor": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=424d19f7-413a-4620-82d3-f00459c1da71",
"cascade": true
},
"organisatorischeEenheid": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=b62477ac-6fa0-4471-b3c3-1bf431767aeb",
"cascade": true
}
}
}
},
{
"name": "bijlage",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"klantcontact": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=c3f90e4e-0f99-40cc-a503-bd02c0f96823",
"cascade": true
},
"objectIdentificator": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=45042e94-6f29-4bab-a9a6-ba73987e6955",
"cascade": true
}
},
"format": "json"
}
},
{
"name": "gaatOver",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"objectIdentificator": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=45042e94-6f29-4bab-a9a6-ba73987e6955",
"cascade": true
},
"klantContact": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=c3f90e4e-0f99-40cc-a503-bd02c0f96823",
"cascade": true
}
},
"format": "json"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Klantcontact"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Klantcontact"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"klantcontact"
],
"summary": "Klantcontact",
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"operationId": "klantcontact-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
}
}
},
"responses": {
"200": {
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Klantcontact"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/medewerkers/{id}": {
"get": {
"tags": [
"medewerker"
],
"summary": "Medewerker",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"operationId": "medewerker-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"medewerker"
],
"summary": "Medewerker",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"operationId": "medewerker-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
}
}
},
"responses": {
"200": {
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"medewerker"
],
"summary": "Medewerker",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"operationId": "medewerker-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/medewerkers": {
"get": {
"tags": [
"medewerker"
],
"summary": "Medewerker",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"operationId": "medewerker-get-collection",
"parameters": [
{
"name": "telefoonnummer",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "functie",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "eMailadres",
"in": "query",
"description": "Een geldig email-adres, maximaal 20 karakters lang en minimaal een @ en een . opgenomen.",
"required": true,
"schema": {
"type": "string",
"format": "email"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Medewerker"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Medewerker"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"medewerker"
],
"summary": "Medewerker",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"operationId": "medewerker-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
}
}
},
"responses": {
"200": {
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Medewerker"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/organisatorischeeenheden/{id}": {
"get": {
"tags": [
"organisatorische eenheid"
],
"summary": "Organisatorische Eenheid",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"operationId": "organisatorische eenheid-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"organisatorische eenheid"
],
"summary": "Organisatorische Eenheid",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"operationId": "organisatorische eenheid-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
}
},
"responses": {
"200": {
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"organisatorische eenheid"
],
"summary": "Organisatorische Eenheid",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"operationId": "organisatorische eenheid-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/organisatorischeeenheden": {
"get": {
"tags": [
"organisatorische eenheid"
],
"summary": "Organisatorische Eenheid",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"operationId": "organisatorische eenheid-get-collection",
"parameters": [
{
"name": "telefoonnummer",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "eMailadres",
"in": "query",
"description": "Een geldig email-adres, maximaal 20 karakters lang en minimaal een @ en een . opgenomen.",
"required": true,
"schema": {
"type": "string",
"format": "email"
}
},
{
"name": "omschrijving",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"organisatorische eenheid"
],
"summary": "Organisatorische Eenheid",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"operationId": "organisatorische eenheid-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
}
},
"responses": {
"200": {
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/partijen/{id}": {
"get": {
"tags": [
"partij"
],
"summary": "Partij",
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"operationId": "partij-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"partij"
],
"summary": "Partij",
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"operationId": "partij-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
}
}
},
"responses": {
"200": {
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"partij"
],
"summary": "Partij",
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"operationId": "partij-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/partijen": {
"get": {
"tags": [
"partij"
],
"summary": "Partij",
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"operationId": "partij-get-collection",
"parameters": [
{
"name": "nummer",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "interneNotitie",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "indicatieGeheimhouding",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "boolean"
}
},
{
"name": "indicatieActief",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "boolean"
}
},
{
"name": "soortPartij",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "voorkeurstaal",
"in": "query",
"description": "De taal waarin de persoon of organisatie bij voorkeur interactie heeft met de gemeente.",
"required": false,
"schema": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
],
"description": "De code, behorende bij de landnaam, opgenomen in de Landentabel van de GBA.",
"minLength": 1,
"cascade": true
},
"naam": {
"type": [
"string",
"null"
],
"description": "De naam van het land, zoals opgenomen in de Landentabel van de GBA.",
"minLength": 1,
"cascade": true
}
}
}
},
{
"name": "organisatie",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"naam": {
"type": [
"string",
"null"
],
"cascade": true
}
},
"format": "json"
}
},
{
"name": "persoon",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"contactnaam": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=b62d30d6-cb55-4e77-87bb-d6bb00118515",
"cascade": true
}
},
"format": "json"
}
},
{
"name": "contactpersoon",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"contactnaam": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=b62d30d6-cb55-4e77-87bb-d6bb00118515",
"cascade": true
},
"organisatie": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=1b7e3fcc-24c5-449f-ac65-c44a370734a8",
"cascade": true
}
},
"format": "json"
}
},
{
"name": "voorkeurskanaal",
"in": "query",
"description": "Het kanaal waarlangs de partij bij voorkeur interactie heeft met de gemeente.",
"required": false,
"schema": {
"type": "object",
"properties": {
"adres": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"omschrijving": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"soortDigitaalAdres": {
"type": "string",
"enum": [
"emailadres",
"telefoonnummer",
"formulier",
null
],
"description": "De typering van het digitale adres waarmee bepaald kan worden op welk kanaal dit digitale adres valide is.",
"cascade": true
}
}
}
},
{
"name": "verstrekteAdressen",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"adres": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"omschrijving": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"soortDigitaalAdres": {
"type": "string",
"enum": [
"emailadres",
"telefoonnummer",
"formulier",
null
],
"description": "De typering van het digitale adres waarmee bepaald kan worden op welk kanaal dit digitale adres valide is.",
"cascade": true
}
}
}
},
{
"name": "bezoekadres",
"in": "query",
"description": "Een bezoekadres is een adres waar een persoon of een bedrijf bezoekers ontvangt.",
"required": false,
"schema": {
"type": "object",
"properties": {
"aanduidingBijHuisnummer": {
"type": "string",
"enum": [
"bij",
"tegenover",
null
],
"description": "De aanduiding die gebruikt wordt voor bijvoorbeeld een ligplaats of een standplaats die geen eigen nummeraanduiding heeft.",
"cascade": true
},
"adresregelBuitenland1": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland2": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland3": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"huisletter": {
"type": [
"string",
"null"
],
"maxLength": 1,
"cascade": true
},
"huisnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"huisnummertoevoeging": {
"type": [
"string",
"null"
],
"maxLength": 4,
"cascade": true
},
"postcode": {
"type": [
"string",
"null"
],
"maxLength": 7,
"cascade": true
},
"soortBezoekadres": {
"type": "string",
"enum": [
"binnenlands_adres",
"buitenlands_adres",
null
],
"description": "Typering waarmee aangegeven of het bezoekadres een binnenlands - of een buitenlands adres is.\n\n`binnenlands_adres` - binnenlands adres\n`buitenlands_adres` - buitenlands adres",
"cascade": true
},
"straat": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"woonplaats": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"land": {
"type": [
"object",
"null"
],
"description": "Het SUBJECT dat heeft aangegeven te (gaan) verblijven dan wel verblijft in het LAND",
"_list": "/admin/objects?_self.schema.id=9c497e05-3dda-4cb7-8cde-d3030d0599aa",
"cascade": true
}
}
}
},
{
"name": "correspondentieadres",
"in": "query",
"description": "Het adres waarnaar de persoon of de organisatie de voor hen bestemde correspondentie laat verzenden.",
"required": false,
"schema": {
"type": "object",
"properties": {
"aanduidingBijHuisnummer": {
"type": "string",
"enum": [
"bij",
"tegenover",
null
],
"description": "De aanduiding die gebruikt wordt voor bijvoorbeeld een ligplaats of een standplaats die geen eigen nummeraanduiding heeft.",
"cascade": true
},
"adresregelBuitenland1": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland2": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"adresregelBuitenland3": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"antwoordnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"huisletter": {
"type": [
"string",
"null"
],
"maxLength": 1,
"cascade": true
},
"huisnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"huisnummertoevoeging": {
"type": [
"string",
"null"
],
"maxLength": 4,
"cascade": true
},
"postbusnummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"postcode": {
"type": [
"string",
"null"
],
"maxLength": 7,
"cascade": true
},
"soortCorrespondentieadres": {
"type": "string",
"enum": [
"postbusnummer",
"antwoordnummer",
"binnenlands_adres",
"buitenlands_adres",
null
],
"description": "Typering waarmee aangegeven wordt of het correspondentieadres een binnenlands - of een buitenlands adres is danwel een postbusnummer of een antwoordnummer.\n\n`postbusnummer` - postbusnummer\n`antwoordnummer` - antwoordnummer\n`binnenlands_adres` - binnenlands adres\n`buitenlands_adres` - buitenlands adres",
"cascade": true
},
"straat": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"woonplaats": {
"type": [
"string",
"null"
],
"maxLength": 80,
"cascade": true
},
"land": {
"type": [
"object",
"null"
],
"description": "Het SUBJECT dat heeft aangegeven te (gaan) verblijven dan wel verblijft in het LAND",
"_list": "/admin/objects?_self.schema.id=9c497e05-3dda-4cb7-8cde-d3030d0599aa",
"cascade": true
}
}
}
},
{
"name": "externeIdentificaties",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"anderePartijIdentificator": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"partijIdentificator": {
"type": [
"object",
"null"
],
"description": "De code van het soort identificatiecode.\n\nEen inhoudelijke toelichting op de toepassing van het informatie-element.\n\nEen inhoudelijke toelichting op de toepassing van het informatie-element.\n\nEen inhoudelijke toelichting op de toepassing van het informatie-element.\n\nDe verzameling van waarden die gegevens van dit attribuutsoort kunnen hebben, dat wil zeggen het waardenbereik, uitgedrukt in een specifieke structuur.",
"format": "json",
"_list": "/admin/objects?_self.schema.id=45042e94-6f29-4bab-a9a6-ba73987e6955",
"cascade": true
}
},
"format": "json"
}
},
{
"name": "vertegenwoordiger",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"interneNotitie": {
"type": [
"string",
"null"
],
"cascade": true
},
"indicatieGeheimhouding": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "false"
},
"indicatieActief": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "true"
},
"soortPartij": {
"type": [
"string",
"null"
],
"cascade": true
},
"voorkeurstaal": {
"type": [
"object",
"null"
],
"description": "De taal waarin de persoon of organisatie bij voorkeur interactie heeft met de gemeente.",
"_list": "/admin/objects?_self.schema.id=b4398460-3062-42a9-ab30-7cc2fb674edb",
"cascade": true
},
"organisatie": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=1b7e3fcc-24c5-449f-ac65-c44a370734a8",
"cascade": true
},
"persoon": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=a6a07771-98d4-4223-8df2-b66eb0eb274c",
"cascade": true
},
"contactpersoon": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=763478cb-38f4-4114-aea7-bcbd713cdab0",
"cascade": true
},
"voorkeurskanaal": {
"type": [
"object",
"null"
],
"description": "Het kanaal waarlangs de partij bij voorkeur interactie heeft met de gemeente.",
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true
},
"verstrekteAdressen": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true,
"multiple": true
},
"bezoekadres": {
"type": [
"object",
"null"
],
"description": "Een bezoekadres is een adres waar een persoon of een bedrijf bezoekers ontvangt.",
"_list": "/admin/objects?_self.schema.id=687c3891-3910-4e60-806f-a955ce82653f",
"cascade": true
},
"correspondentieadres": {
"type": [
"object",
"null"
],
"description": "Het adres waarnaar de persoon of de organisatie de voor hen bestemde correspondentie laat verzenden.",
"_list": "/admin/objects?_self.schema.id=d25bc65e-39b8-4d81-a6e7-0746c330b207",
"cascade": true
},
"externeIdentificaties": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=106c8abf-c561-40dc-9f3f-2feb21d86e15",
"cascade": true,
"multiple": true
},
"vertegenwoordiger": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=ab58e6bf-6ff3-49c6-8f2c-f4a27331b6d5",
"cascade": true
},
"vertegenwoordigde": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=ab58e6bf-6ff3-49c6-8f2c-f4a27331b6d5",
"cascade": true
}
}
}
},
{
"name": "vertegenwoordigde",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"interneNotitie": {
"type": [
"string",
"null"
],
"cascade": true
},
"indicatieGeheimhouding": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "false"
},
"indicatieActief": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "true"
},
"soortPartij": {
"type": [
"string",
"null"
],
"cascade": true
},
"voorkeurstaal": {
"type": [
"object",
"null"
],
"description": "De taal waarin de persoon of organisatie bij voorkeur interactie heeft met de gemeente.",
"_list": "/admin/objects?_self.schema.id=b4398460-3062-42a9-ab30-7cc2fb674edb",
"cascade": true
},
"organisatie": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=1b7e3fcc-24c5-449f-ac65-c44a370734a8",
"cascade": true
},
"persoon": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=a6a07771-98d4-4223-8df2-b66eb0eb274c",
"cascade": true
},
"contactpersoon": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=763478cb-38f4-4114-aea7-bcbd713cdab0",
"cascade": true
},
"voorkeurskanaal": {
"type": [
"object",
"null"
],
"description": "Het kanaal waarlangs de partij bij voorkeur interactie heeft met de gemeente.",
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true
},
"verstrekteAdressen": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=5112f57f-d3af-4384-bc6a-bc7974de7d5c",
"cascade": true,
"multiple": true
},
"bezoekadres": {
"type": [
"object",
"null"
],
"description": "Een bezoekadres is een adres waar een persoon of een bedrijf bezoekers ontvangt.",
"_list": "/admin/objects?_self.schema.id=687c3891-3910-4e60-806f-a955ce82653f",
"cascade": true
},
"correspondentieadres": {
"type": [
"object",
"null"
],
"description": "Het adres waarnaar de persoon of de organisatie de voor hen bestemde correspondentie laat verzenden.",
"_list": "/admin/objects?_self.schema.id=d25bc65e-39b8-4d81-a6e7-0746c330b207",
"cascade": true
},
"externeIdentificaties": {
"type": [
"object",
"null"
],
"format": "json",
"_list": "/admin/objects?_self.schema.id=106c8abf-c561-40dc-9f3f-2feb21d86e15",
"cascade": true,
"multiple": true
},
"vertegenwoordiger": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=ab58e6bf-6ff3-49c6-8f2c-f4a27331b6d5",
"cascade": true
},
"vertegenwoordigde": {
"type": [
"object",
"null"
],
"_list": "/admin/objects?_self.schema.id=ab58e6bf-6ff3-49c6-8f2c-f4a27331b6d5",
"cascade": true
}
}
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Partij"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Partij"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"partij"
],
"summary": "Partij",
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"operationId": "partij-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
}
}
},
"responses": {
"200": {
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Partij"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/taken/{id}": {
"get": {
"tags": [
"taak"
],
"summary": "Taak",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"operationId": "taak-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"taak"
],
"summary": "Taak",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"operationId": "taak-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
},
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"taak"
],
"summary": "Taak",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"operationId": "taak-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/taken": {
"get": {
"tags": [
"taak"
],
"summary": "Taak",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"operationId": "taak-get-collection",
"parameters": [
{
"name": "identificatie",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"cascade": true
},
"value": {
"type": [
"string",
"null"
],
"cascade": true
}
}
}
},
{
"name": "formulier",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"id",
"url",
null
],
"cascade": true
},
"value": {
"type": [
"string",
"null"
],
"cascade": true
}
}
}
},
{
"name": "verwerker_taak_id",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "verzonden_data[]",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "verloopdatum",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string",
"format": "datetime"
}
},
{
"name": "status",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "title",
"in": "query",
"description": "",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "zaak",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string",
"format": "uri"
}
},
{
"name": "data[]",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "id",
"in": "query",
"description": "De unieke id van dit object voor verder gebruik",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Taak"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Taak"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"taak"
],
"summary": "Taak",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"operationId": "taak-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
},
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/berichten/{id}": {
"get": {
"tags": [
"bericht"
],
"summary": "Bericht",
"description": "Een Bericht",
"operationId": "bericht-get-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"patch": {
"tags": [
"bericht"
],
"summary": "Bericht",
"description": "Een Bericht",
"operationId": "bericht-patch-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
},
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"delete": {
"tags": [
"bericht"
],
"summary": "Bericht",
"description": "Een Bericht",
"operationId": "bericht-delete-item",
"parameters": [
{
"name": "id",
"in": "path",
"description": "",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"content": {
"application/json": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
},
"application/xml": {
"schema": {
"type": "string",
"examples": [
"Object is successfully deleted"
]
},
"examples": {
"default": {
"value": "Object is successfully deleted"
}
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
},
"/kic/v1/berichten": {
"get": {
"tags": [
"bericht"
],
"summary": "Berichten",
"description": "Een Bericht",
"operationId": "bericht-get-collection",
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Bericht"
}
}
},
"required": [
"count",
"results"
]
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"examples": [
1
]
},
"next": {
"type": [
"string",
"null"
],
"format": "uri"
},
"previous": {
"type": [
"string",
"null"
],
"format": "uri"
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Bericht"
}
}
},
"required": [
"count",
"results"
]
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
},
"post": {
"tags": [
"bericht"
],
"summary": "Bericht",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"operationId": "bericht-post-item",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Taak"
}
}
}
},
"responses": {
"200": {
"description": "Een Bericht",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/Bericht"
}
}
}
}
},
"servers": [
{
"url": "http://localhost",
"description": "The kubernetes server"
}
]
}
}
},
"components": {
"schemas": {
"BetrokkeneBijKlantcontact": {
"type": "object",
"title": "BetrokkeneBijKlantcontact",
"description": "De betrokkenheid en de rol van een persoon of organisatie bij het klantcontact.\n\nKlantcontact-betrokkene kent afhankelijk van mogelijkheid of wenselijkheid om in het kader van (opvolging van) de klantinteractie persoonsgegevens te verwerken twee gebruiksmogelijkheden. 1) is van de bij het klantcontact betrokken inwoner of ondernemer na identificatie en/of authenticatie voldoende duidelijk wie die is of vertegenwoordigt, dan wordt eerst opgezocht of deze inwoner of ondernemer reeds als partij bij de gemeente bekend is. Is dat niet zo, dan kan vervolgens een partij worden geregistreerd. Tussen de opgezochte of gecre??erde partij en klantcontact-betrokkene wordt vervolgens een relatie gelegd. Als de betrokkene aangeeft dat all????n voor opvolging van het klantcontact andere dan de bij partij geregistreerde 'default'-contactgegevens gebruikt moeten, worden deze alternatieve contactgegevens vastgelegd in klantcontact-betrokkene. Voor opvolging van het klantcontact gelden de in Klantcontact-betrokkene vastgelegde contactgegevens dus boven gelijkaardige gegevens die bij partij zijn geregistreerd. 2) is van de bij het klantcontact betrokken inwoner of ondernemer na eventuele identificatie en/of authenticatie onvoldoende duidelijk is wie die is of vertegenwoordigt, dan kan in klantcontact-betrokkene een set voor opvolging van het klantcontact benodigde of gewenste contactgegevens worden geregistreerd. In dit geval is er dus g????n sprake van een realtie tussen klantcontact-betrokkene en partij.",
"properties": {
"voorkeurstaal": {
"$ref": "#/components/schemas/Voorkeur"
},
"communicatiekanaal": {
"$ref": "#/components/schemas/Digitaal%20Adres"
},
"correspondentieadres": {
"$ref": "#/components/schemas/Correspondentieadres"
},
"bezoekadres": {
"$ref": "#/components/schemas/Bezoekadres"
},
"contactnaam": {
"$ref": "#/components/schemas/Contactnaam"
},
"partij": {
"$ref": "#/components/schemas/Partij"
},
"klantcontact": {
"$ref": "#/components/schemas/Klantcontact"
},
"organisatienaam": {
"type": [
"string",
"null"
],
"maxLength": 200,
"cascade": true
},
"intitiator": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": "false"
},
"rol": {
"type": "string",
"enum": [
"vertegenwoordiger",
"klant",
null
],
"description": "De typering van de rol van de persoon of organisatie in het klantcontact.",
"cascade": true
}
},
"required": [
"klantcontact",
"rol"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.2"
},
"Voorkeur": {
"type": "object",
"title": "Voorkeur",
"properties": {
"code": {
"type": "string",
"title": "Code",
"description": "De code, behorende bij de landnaam, opgenomen in de Landentabel van de GBA.",
"minLength": 1
},
"naam": {
"type": "string",
"title": "Naam",
"description": "De naam van het land, zoals opgenomen in de Landentabel van de GBA.",
"minLength": 1
}
},
"required": [
"code",
"naam"
],
"version": "0.0.1"
},
"Digitaal Adres": {
"type": "object",
"title": "Digitaal Adres",
"description": "Adres waarop een persoon of een organisatie via een digitaal kanaal bereikt kan worden.\n\nDigitaal adres duidt gegevens aan die beschrijven hoe een persoon of organisatie via een digitaal kanaal bereikt kan worden. Voorbeelden hiervan zijn een telefoonnummer, een e-mailadres of een gebruikersnaam op een sociaal medium. Adressen die gekoppeld kunnen worden aan een vaste plaats in de fysieke wereld, zoals een bezoekadres, postbus of antwoordnummer zijn geen digitaal adres.",
"properties": {
"adres": {
"type": [
"string",
"null"
],
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80,
"cascade": true
},
"omschrijving": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"soortDigitaalAdres": {
"type": "string",
"enum": [
"emailadres",
"telefoonnummer",
"formulier",
null
],
"description": "De typering van het digitale adres waarmee bepaald kan worden op welk kanaal dit digitale adres valide is.",
"cascade": true
}
},
"required": [
"adres",
"omschrijving",
"soortDigitaalAdres"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.2"
},
"Correspondentieadres": {
"type": "object",
"title": "Correspondentieadres",
"description": "Het adres waarnaar de persoon of de organisatie de voor hen bestemde correspondentie laat verzenden.",
"properties": {
"aanduidingBijHuisnummer": {
"type": "string",
"enum": [
"bij",
"tegenover"
],
"description": "De aanduiding die gebruikt wordt voor bijvoorbeeld een ligplaats of een standplaats die geen eigen nummeraanduiding heeft."
},
"adresregelBuitenland1": {
"type": "string",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80
},
"adresregelBuitenland2": {
"type": "string",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80
},
"adresregelBuitenland3": {
"type": "string",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80
},
"antwoordnummer": {
"type": "integer"
},
"huisletter": {
"type": "string",
"maxLength": 1
},
"huisnummer": {
"type": "integer"
},
"huisnummertoevoeging": {
"type": "string",
"maxLength": 4
},
"land": {
"$ref": "#/components/schemas/Land"
},
"postbusnummer": {
"type": "integer"
},
"postcode": {
"type": "string",
"maxLength": 7
},
"soortCorrespondentieadres": {
"type": "string",
"enum": [
"postbusnummer",
"antwoordnummer",
"binnenlands_adres",
"buitenlands_adres"
],
"description": "Typering waarmee aangegeven wordt of het correspondentieadres een binnenlands - of een buitenlands adres is danwel een postbusnummer of een antwoordnummer.\n\n`postbusnummer` - postbusnummer\n`antwoordnummer` - antwoordnummer\n`binnenlands_adres` - binnenlands adres\n`buitenlands_adres` - buitenlands adres"
},
"straat": {
"type": "string",
"maxLength": 80
},
"woonplaats": {
"type": "string",
"maxLength": 80
}
},
"required": [
"aanduidingBijHuisnummer",
"land",
"soortCorrespondentieadres"
],
"version": "0.0.1"
},
"Land": {
"type": "object",
"title": "Land",
"description": "Het SUBJECT dat heeft aangegeven te (gaan) verblijven dan wel verblijft in het LAND",
"properties": {
"einddatumLand": {
"type": "object",
"title": "Einddatum land",
"description": "De datum waarop het land/gebied is opgeheven."
},
"ingangsdatumLand": {
"type": "object",
"title": "Ingangsdatum land",
"description": "De datum waarop het land/gebied is ontstaan."
},
"landcode": {
"type": "string",
"title": "Landcode",
"description": "De code, behorende bij de landnaam, opgenomen in de Landentabel van de GBA.",
"minLength": 1
},
"landnaam": {
"type": "string",
"title": "Landnaam",
"description": "De naam van het land, zoals opgenomen in de Landentabel van de GBA.",
"minLength": 1
}
},
"required": [
"einddatumLand",
"ingangsdatumLand",
"landcode",
"landnaam"
],
"version": "0.0.1"
},
"Bezoekadres": {
"type": "object",
"title": "Bezoekadres",
"description": "Een bezoekadres is een adres waar een persoon of een bedrijf bezoekers ontvangt.",
"properties": {
"aanduidingBijHuisnummer": {
"type": "string",
"enum": [
"bij",
"tegenover"
],
"description": "De aanduiding die gebruikt wordt voor bijvoorbeeld een ligplaats of een standplaats die geen eigen nummeraanduiding heeft."
},
"adresregelBuitenland1": {
"type": "string",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80
},
"adresregelBuitenland2": {
"type": "string",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80
},
"adresregelBuitenland3": {
"type": "string",
"description": "Een generieke regel om adresgegevens in op te nemen.",
"maxLength": 80
},
"huisletter": {
"type": "string",
"maxLength": 1
},
"huisnummer": {
"type": "integer"
},
"huisnummertoevoeging": {
"type": "string",
"maxLength": 4
},
"land": {
"$ref": "#/components/schemas/Land"
},
"postcode": {
"type": "string",
"maxLength": 7
},
"soortBezoekadres": {
"type": "string",
"enum": [
"binnenlands_adres",
"buitenlands_adres"
],
"description": "Typering waarmee aangegeven of het bezoekadres een binnenlands - of een buitenlands adres is.\n\n`binnenlands_adres` - binnenlands adres\n`buitenlands_adres` - buitenlands adres"
},
"straat": {
"type": "string",
"maxLength": 80
},
"woonplaats": {
"type": "string",
"maxLength": 80
}
},
"required": [
"aanduidingBijHuisnummer",
"land",
"soortBezoekadres"
],
"version": "0.0.1"
},
"Contactnaam": {
"type": "object",
"title": "Contactnaam",
"properties": {
"achternaam": {
"type": "string",
"title": "Achternaam",
"description": "De achternaam waarmee de persoon aangesproken wenst te worden. Deze zal over het algemeen gelijk zijn aan de (geslachts)naam waarvan de eventueel aanwezige voorvoegsels en adellijke titel/predikaat zijn afgesplitst."
},
"voornaam": {
"type": "string",
"title": "Voornaam",
"description": "De roepnaam waarmee de persoon wenst aangeproken te worden."
},
"voorvoegselAchternaam": {
"type": "string",
"title": "Voorvoegsel achternaam",
"description": "Dat deel van de achternaam dat voorkomt in de Voorvoegseltabel en, gescheiden door een spatie, vooraf gaat aan de rest van de achternaam."
},
"voorletters": {
"type": "string",
"title": "Voorletters"
}
},
"version": "0.0.1"
},
"Partij": {
"type": "object",
"title": "Partij",
"description": "Een persoon of organisatie waarmee de gemeente een relatie heeft.\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?\n\n(Uiteindelijk) belanghebbenden waarmee de gemeente geen direct contact heeft (of heeft gehad) (bijvoorbeeld door vertegenwoordiging) zien we als partijen waarmee de gemeente een relatie heeft.? Een vertegenwoordiger (van een belanghebbende) is een partij? Partijen zijn ???gekende??? personen of organisaties? Dit betekent dat er voor eerste registratie en bij eventueel (her)gebruik authenticatie heeft plaatsgevonden. Dit hoeft niet per se te gebeuren met DigiD, eHerkenning o.i.d. Er is dus ook niet altijd sprake van vastlegging en verwerking van een BSN of ander buiten de gemeente toegekend ID-nummer.?",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"interneNotitie": {
"type": [
"string",
"null"
],
"cascade": true
},
"indicatieGeheimhouding": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": false
},
"indicatieActief": {
"type": [
"boolean",
"null"
],
"cascade": true,
"defaultValue": true
},
"soortPartij": {
"type": [
"string",
"null"
],
"cascade": true
},
"voorkeurstaal": {
"$ref": "#/components/schemas/Voorkeur"
},
"organisatie": {
"$ref": "#/components/schemas/Organisatie"
},
"persoon": {
"$ref": "#/components/schemas/Contactnaam"
},
"contactpersoon": {
"$ref": "#/components/schemas/Contactpersoon"
},
"voorkeurskanaal": {
"$ref": "#/components/schemas/Digitaal%20Adres"
},
"verstrekteAdressen": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Digitaal%20Adres"
}
},
"correspondentieadres": {
"$ref": "#/components/schemas/Correspondentieadres"
},
"bezoekadres": {
"$ref": "#/components/schemas/Bezoekadres"
},
"externeIdentificaties": {
"$ref": "#/components/schemas/Externe%20Identificatie"
},
"vertegenwoordiger": {
"$ref": "#/components/schemas/Partij"
},
"vertegenwoordigde": {
"$ref": "#/components/schemas/Partij"
},
"berichten": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Bericht"
}
}
},
"required": [
"nummer",
"interneNotitie",
"indicatieGeheimhouding",
"indicatieActief"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.2"
},
"Organisatie": {
"type": "object",
"title": "Organisatie",
"properties": {
"naam": {
"type": "string"
}
},
"version": "0.0.1"
},
"Persoonsnaam": {
"type": "object",
"title": "Persoonsnaam",
"properties": {
"contactnaam": {
"$ref": "#/components/schemas/Contactnaam"
}
},
"version": "0.0.2"
},
"Contactpersoon": {
"type": "object",
"title": "Contactpersoon",
"properties": {
"contactnaam": {
"$ref": "#/components/schemas/Contactnaam"
},
"organisatie": {
"$ref": "#/components/schemas/Organisatie"
}
},
"version": "0.0.1"
},
"Externe Identificatie": {
"type": "object",
"title": "Externe Identificatie",
"description": "De identificatiecode van een Relatie zoals die in een andere (authentieke?) registratie gevoerd wordt.",
"properties": {
"anderePartijIdentificator": {
"type": "string",
"maxLength": 40
},
"partijIdentificator": {
"$ref": "#/components/schemas/Identificator"
}
},
"required": [
"partijIdentificator"
],
"version": "0.0.2"
},
"Identificator": {
"type": "object",
"title": "Identificator",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"properties": {
"objecttype": {
"type": "string"
},
"soortObjectId": {
"type": "string",
"enum": [
"integer",
"url",
"uuid",
"bsn"
]
},
"objectId": {
"type": "string"
},
"register": {
"type": "string",
"format": "url"
}
},
"required": [
"objecttype",
"soortObjectId",
"objectId",
"register"
],
"version": "0.0.1"
},
"Bericht": {
"type": "object",
"properties": {
"batchID": {
"type": "string",
"description": "GUID zonder accolades in registry format."
},
"aanmaakDatum": {
"type": "string",
"description": "Datum waarop de batch is aangemaakt.",
"format": "date-time"
},
"berichtLeverancierID": {
"type": "string",
"description": "Het OIN van uw organisaite, 20 cijfers.",
"maxLength": 20
},
"berichtID": {
"type": "string",
"description": "GUID in registry format."
},
"berichtType": {
"type": "string",
"description": "De letterlijke naam van het berichtType."
},
"publicatieDatum": {
"type": "string",
"description": "Datum waarop het bericht wordt gepubliceerd.",
"format": "date-time"
},
"onderwerp": {
"type": "string",
"description": "Onderwerp van het bericht.",
"maxLength": 50
},
"berichttekst": {
"type": "string",
"description": "Tekst van het bericht.",
"maxLength": 4000
},
"referentie": {
"type": "string",
"description": "Uw eigen referentiegegevens.",
"maxLength": 25
},
"gebruikerID": {
"type": "string",
"description": "BSN van geadresseerde.",
"format": "bsn"
},
"soortGebruiker": {
"type": "string",
"description": "Vaste waarde: Burger.",
"default": "Burger"
},
"inhoud": {
"type": "string",
"description": "Inhoud (PDF) als base64."
},
"bijlageType": {
"type": "string",
"description": "Vaste waarde: Pdf.",
"default": "Pdf"
},
"omschrijving": {
"type": "string",
"description": "Omschrijving van de bijlage.",
"maxLength": 40
},
"volgorde": {
"type": "string",
"description": "Indien 1 bijlage meegestuurd \"1\" indien 2 bijlagen meegestuurd \"2\""
},
"partij": {
"$ref": "#/components/schemas/Partij"
}
}
},
"Klantcontact": {
"type": "object",
"title": "Klantcontact",
"description": "Een contact tussen een klant of een vertegenwoordiger van een klant en de gemeente.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.\n\nHet klantcontact is bedoeld om inwoners of ondernemers die contact hebben gehad met de gemeente op een voor hen zo begrijpelijk en relevant mogelijke manier te infomeren over de inhoud van dat contact. Over een klantcontact vastgelegde informatie kan bijvoorbeeld (na inloggen) worden getoond op de gemeentelijke website of telefonisch worden verstrekt door een medewerker van het klantcontactcentrum. Als gevolg hiervan is de volledige inhoud van een klantcontact geschikt voor openbaarmaking aan betrokken inwoners. De definitie van klantcontact is bewust wat 'open' gelaten. Op deze manier passen daarbinnen ook contacten die voortkomen uit nu onvoorziene scenario's of via nog te ontwikkelen kanalen. Uitgangspunt is in alle gevallen dat ????n klantcontact de informatie omvat die een klant of dienst vertegenwoordiger tijdens een voor hen herkenbare handeling of gebeurtenis overbrengt aan de gemeente of vice versa. Zo'n handeling kan bijvoorbeeld het afleggen van baliebezoek zijn, het telefonisch voeren van een gesprek met een medewerker of een interactie met een chatbot op de gemeentelijke website. Maar ook gebeurtenissen als het indienen van een elektronisch formulier of het versturen van een brief door de gemeente aan een klant of vertegenwoordiger resulteren in een klantcontact. Voor het bepalen van het begin en eind van een klantcontact geldt dat informatie die binnen een korte tijdsperiode tussen gemeente en klant wordt uitgewisseld waar mogelijk resulteert in ????n klantcontact, terwijl een verzonden kennisgeving en een uren of dagen later ontvangen reactie daarop resulteren in twee ???losse??? klantcontacten. Dit betekent dat een klantcontact naar aanleiding van een telefoongesprek 'duurt' van het aannemen van het gesprek tot het be??indigen hiervan, terwijl een contact naar aanleiding van een baliebezoek de periode beschrijft vanaf het aan een medewerker verschijnen van een klant of vertegenwoordiger tot aan diens vertrek. In het geval van ontvangst door de gemeente van een brief van een klant waarop de gemeente enige dagen later eveneens schriftelijk reageert, worden beide brieven daarentegen als twee individuele klantcontacten te beschouwd. Tussen de voorbeelden hierboven in ligt een aantal kanalen waarbij informatie minder snel wordt uitgewisseld dan bij een telefoongesprek of baliecontact, maar (veel) sneller dan bij een briefwisseling. Denk aan communicatie via contactformulieren, e-mail of chatapps en -bots. Zeker in de laatste gevallen kan sprake zijn van korte, elkaar snel opvolgende interacties die samen het karakter hebben van een gesprek. Anders dan een telefoon- of baliegesprek kan een interactie via deze kanalen echter voor uren of dagen onderbroken worden, om daarna weer te worden opgepakt. In zo'n geval is het aan medewerkers van de gemeente - in geval van geautomatiseerde interacties samen met systeemontwikkelaars - om te bepalen wat vanuit klantperspectief de meest voor de hand liggende ???omvang??? van een klantcontact is. Tijdens een klantcontact kan duidelijk worden dat een inwoner verschillende verzoeken voor de gemeente heeft. Een klant kan tijdens een telefoongesprek bijvoorbeeld vragen naar een afspraak voor overleg over een te verbouwen woning en daarnaast een verzakking van stoep voor zijn huis melden. Deze verzoeken moeten op uiteenlopende wijze en waarschijnlijk door verschillende afdelingen worden opgevolgd. Met het bepalen welke medewerlkers of afdelingen nodig zijn om aan verzoeken van een klant invulling te geven, begint in feite de behandeling van deze verzoeken. Deze behandeling is nadrukkelijk g????n onderdeel van het klantcontact. Anders dan het registreren van voor het klantcontact relevante onderwerpen biedt het klantcontact dan ook geen mogelijkheden de inhoud daarvan naar verschillende verzoeken, aanvragen of meldingen uit te splitsen. Hiervoor zijn de concepten 'interne taak' en 'zaak' bedoeld. Het klantcontact uit het voorbeeld hierboven zou bijvoorbeeld aanleiding kunnen zijn voor het aanmaken van zowel een zaak van type 'melding openbare ruimte' om de stoep te herstellen, als een interne taak voor een medewerker van de afdeling fysieke leefomgeving om een afspraak te maken voor overleg over de voorgenomen verbouwing.",
"properties": {
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"onderwerp": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"inhoud": {
"type": [
"string",
"null"
],
"cascade": true
},
"todo": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"resultaat": {
"type": [
"string",
"null"
],
"description": "This field is for backwards compatibilty with the klantenbundle.",
"deprecated": true
},
"indicatieContactGelukt": {
"type": "string",
"enum": [
"ja",
"nee",
"onbekend",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"taal": {
"type": [
"string",
"null"
],
"cascade": true
},
"vertrouwelijk": {
"type": "string",
"enum": [
"ja",
"nee",
null
],
"description": "Deze enumeratie is toegevoegd omdat de ingevulde waarde geen boolean kan zijn (waar of niet waar). De gewenste waarden zijn Ja of leeg. Als het attribuut dus opgenomen wordt heeft het de Nill waarde of de waarde `Ja`.\n\n`ja` - Het verzoek is afgehandeld.",
"cascade": true
},
"plaatsgevondenOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"interneTaakOntstaanUit": {
"type": [
"array",
"null"
],
"cascade": true
},
"geregistreerdOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"kanaal": {
"$ref": "#/components/schemas/Digitaal%20Adres"
},
"actors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Actor"
}
},
"bijlage": {
"$ref": "#/components/schemas/Bijlage"
},
"gaatOver": {
"$ref": "#/components/schemas/Onderwerp%20Object"
}
},
"required": [
"nummer",
"onderwerp",
"plaatsgevondenOp",
"geregistreerdOp"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.3"
},
"Actor": {
"type": "object",
"title": "Actor",
"description": "De actor handelt in een interne taak of een klantcontact.",
"properties": {
"klantcontact": {
"type": "array"
},
"naam": {
"type": "string",
"maxLength": 200
},
"soortActor": {
"type": "string",
"enum": [
"Medewerker",
"Geautomatiseerde actor",
"Organisatorische eenheid"
]
},
"medewerker": {
"$ref": "#/components/schemas/Medewerker"
},
"geautomatiseerdeActor": {
"$ref": "#/components/schemas/Geautomatiseerde%20Actor"
},
"organisatorischeEenheid": {
"$ref": "#/components/schemas/Organisatorische%20Eenheid"
}
},
"required": [
"naam"
],
"version": "0.0.2"
},
"Medewerker": {
"type": "object",
"title": "Medewerker",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"properties": {
"telefoonnummer": {
"type": [
"string",
"null"
],
"maxLength": 20,
"cascade": true
},
"functie": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
},
"eMailadres": {
"type": [
"string",
"null"
],
"description": "Een geldig email-adres, maximaal 20 karakters lang en minimaal een @ en een . opgenomen.",
"format": "email",
"maxLength": 200,
"cascade": true
}
},
"required": [
"telefoonnummer",
"eMailadres"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.2"
},
"Geautomatiseerde Actor": {
"type": "object",
"title": "Geautomatiseerde Actor",
"description": "Iemand die voor of namens de gemeente werkzaamheden verricht.",
"properties": {
"functie": {
"type": "string",
"maxLength": 40
},
"omschrijving": {
"type": "string",
"maxLength": 40
}
},
"required": [
"functie",
"omschrijving"
],
"version": "0.0.1"
},
"Organisatorische Eenheid": {
"type": "object",
"title": "Organisatorische Eenheid",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"properties": {
"telefoonnummer": {
"type": [
"string",
"null"
],
"maxLength": 20,
"cascade": true
},
"eMailadres": {
"type": [
"string",
"null"
],
"description": "Een geldig email-adres, maximaal 20 karakters lang en minimaal een @ en een . opgenomen.",
"format": "email",
"maxLength": 200,
"cascade": true
},
"omschrijving": {
"type": [
"string",
"null"
],
"maxLength": 40,
"cascade": true
}
},
"required": [
"telefoonnummer",
"eMailadres",
"omschrijving"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.1"
},
"Bijlage": {
"type": "object",
"title": "Bijlage",
"description": "Een digitale bijlage bij een klantcontact. Deze bijlage kan bestaan uit een bestand dat meegestuurd is met een e-mail of een ingescand document.",
"properties": {
"klantcontact": {
"$ref": "#/components/schemas/Klantcontact"
},
"objectIdentificator": {
"$ref": "#/components/schemas/Identificator"
}
},
"required": [
"klantcontact",
"objectIdentificator"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.2"
},
"Onderwerp Object": {
"type": "object",
"title": "Onderwerpobject",
"description": "Het deel van een functioneel afgebakend onderdeel binnen de organisatie dat haar activiteiten uitvoert binnen een VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en die verantwoordelijk is voor de behandeling van zaken.\n\nAlleen ORGANISATORISCHE EENHEden van de organisaties die zaken behandelen worden hier bedoeld (bijvoorbeeld afdelingen van gemeenten). Dus niet organisatorische eenheden van andere organisaties zoals de externe initiatoren van zaken (bijvoorbeeld de afdeling van een bedrijf die een vergunning aanvraagt). De ORGANISATORISCHE EENHEID zoals hier bedoeld is gehuisvest binnen ????n fysieke vestiging van de organisatie. Als een functioneel afgebakend onderdeel van de organisatie haar activiteiten uitvoert in meerdere vestigingen dan wordt die uitgewisseld als evenveel ORGANISATORISCHE EENHEden als die vestigingen. Door de relatie naar VESTIGING VAN ZAAKBEHANDELENDE ORGANISATIE en daarmee via VESTIGING naar NIET NATUURLIJK PERSOON is bekend om welke zaakbehandelende organisatie het gaat. Een ORGANISATORISCHE EENHEID kan zowel groot als klein zijn. De ene ORGANISATORISCHE EENHEID mag andere ORGANISATORISCHE EENHEden bevatten, maar dit wordt niet gemodelleerd. We beperken ons tot het aangeven welke ORGANISATORISCHE EENHEID welke rol heeft in een ZAAK en welke gegevens daarvan vanuit het oogpunt van een zaak relevant zijn. ORGANISATORISCHE EENHEID is een specialisatie ('subtype') van BETROKKENE.",
"properties": {
"objectIdentificator": {
"$ref": "#/components/schemas/Identificator"
},
"klantContact": {
"$ref": "#/components/schemas/Klantcontact"
}
},
"version": "0.0.2"
},
"InterneTaak": {
"type": "object",
"title": "InterneTaak",
"properties": {
"klantcontact": {
"$ref": "#/components/schemas/Klantcontact"
},
"actor": {
"$ref": "#/components/schemas/Actor"
},
"toelichting": {
"type": [
"string",
"null"
],
"cascade": true
},
"status": {
"type": "string",
"enum": [
"te_verwerken",
"verwerkt",
null
],
"description": "De waarden van de typering van de voortgang van afhandeling van\n\n een VERZOEK.- `te_verwerken` - te verwerken Het verzoek is afgehandeld.
- `verwerkt`\n\n - verwerkt Het verzoek id buiten behandeling gesteld.
",
"cascade": true
},
"nummer": {
"type": [
"integer",
"null"
],
"cascade": true
},
"gevraagdeHandeling": {
"type": [
"string",
"null"
],
"maxLength": 200,
"cascade": true
},
"toegewezenOp": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
}
},
"required": [
"klantcontact",
"actor",
"status",
"nummer",
"gevraagdeHandeling",
"toegewezenOp"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.3"
},
"Taak": {
"type": "object",
"title": "Taak",
"description": "Een taak voor een burger, inwoner of vertegenwoordiger van een organisatie die moet worden uitgevoerd",
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "De unieke id van dit object voor verder gebruik",
"format": "uuid",
"cascade": true
},
"type": {
"type": "string",
"format": "uri"
},
"url": {
"type": "string",
"format": "uri"
},
"data": {
"type": [
"array",
"null"
],
"cascade": true
},
"zaak": {
"type": [
"string",
"null"
],
"format": "uri",
"cascade": true
},
"title": {
"type": [
"string",
"null"
],
"cascade": true
},
"onderwerp": {
"type": "string"
},
"toelichting": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"open",
"ingediend",
"verwerkt",
"gesloten",
null
],
"cascade": true
},
"actie": {
"$ref": "#/components/schemas/Taak%20Formulier"
},
"verloopdatum": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"vervaldatum": {
"type": [
"string",
"null"
],
"format": "datetime",
"cascade": true
},
"identificatie": {
"type": [
"string",
"null"
],
"_list": "/admin/objects?_self.schema.id=1b0a2011-1466-47e8-9ce6-3be053f11958",
"cascade": true
},
"verzonden_data": {
"type": [
"array",
"null"
],
"cascade": true
},
"verwerker_taak_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"cascade": true
},
"betrokkenen": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Taak-betrokkene"
}
},
"extraData": {
"type": "array"
}
},
"required": [
"id",
"title"
],
"createAuditTrails": false,
"exclude": false,
"maxDepth": 3,
"nameProperties": [],
"version": "0.0.1"
},
"Taak Formulier": {
"type": "object",
"title": "TaakFormulier",
"description": "Een taak.formulier",
"properties": {
"type": {
"type": "string",
"enum": [
"id",
"url"
]
},
"value": {
"type": "string"
}
},
"version": "0.0.1"
},
"Taak-betrokkene": {
"type": "object",
"title": "Taak betrokkene",
"description": "Een taak betrokkene",
"properties": {
"betrokkeneType": {
"type": "string",
"enum": [
"medewerker",
"natuurlijk_persoon"
]
},
"rolType": {
"type": "string"
},
"betrokkene": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Taak-betrokkene-medewerker-of-persoon"
}
},
"partij": {
"$ref": "#/components/schemas/Partij"
}
},
"version": "0.0.1"
},
"Taak-betrokkene-medewerker-of-persoon": {
"type": "object",
"title": "Taak betrokkene medewerker of persoon",
"description": "Een taak betrokkene medewerker of persoon",
"properties": {
"naam": {
"type": "string"
},
"medewerkerIdentificatie": {
"type": "string"
},
"inpBsn": {
"type": "string",
"format": "bsn"
}
},
"version": "0.0.1"
}
}
}
}