{"openapi":"3.0.1","info":{"description":"De Taken API maakt het mogelijk om taken binnen Realworks aan te maken, bij te werken en op te halen. Taken kunnen worden gekoppeld aan medewerkers, relaties en projecten en bevatten onder andere een type, status, omschrijving en einddatum.\n\n#### Zo gebruik je deze API\n1. Haal eerst de beschikbare taakstatussen en taaktypes voor de betreffende afdeling op.\n2. Maak een nieuwe taak aan en koppel deze waar nodig aan een medewerker, relatie of project.\n3. Werk een bestaande taak bij met het unieke `taakId`.\n4. Haal taken op voor een specifieke medewerker of vraag een taak rechtstreeks op met het `taakId`.\n5. Gebruik `ingangsDatumToekomst` en `toekomstigeStatus` wanneer een gepauzeerde taak op een later moment automatisch een andere status moet krijgen.\n\n#### Relaties aanmaken\nBij het aanmaken van relaties via de relaties V3 endpoints controleert Realworks eerst of er een bestaande relatie kan worden gematcht voordat er een nieuwe relatie wordt aangemaakt.\n\nAlle relatietypes worden gecontroleerd op e-mailadres en of de relatie wel of niet in quarantaine staat.\n\n* Bij particulieren en contactpersonen wordt gecontroleerd op mobiel nummer en telefoonnummer 1 en 2.\n* Bij bedrijven wordt gecontroleerd op bedrijfsnaam.\n* Een contactpersoon moet ook gekoppeld zijn aan een bedrijf (`companyId`).\n\n#### Bijzonderheden\n* Taakstatussen en taaktypes kunnen per afdeling verschillen. Haal de beschikbare waarden daarom op voordat je een taak aanmaakt of wijzigt.\n* Gebruik `medewerkerId` en, waar van toepassing, `relatieId` in plaats van medewerker- of relatiecodes.\n* Het `taakId` wordt bij het wijzigen van een taak in het endpoint meegegeven en niet in de requestbody.\n* De velden `ingangsDatumToekomst` en `toekomstigeStatus` zijn alleen relevant wanneer de gebruikte taakstatus een toekomstige status ondersteunt, zoals een gepauzeerde taak.\n* Taken kunnen worden gefilterd op onder andere medewerker, status, project, relatie en datum.\n* Via `POST /taken/v3/relaties` kunnen bedrijven, contactpersonen en particulieren worden aangemaakt voor gebruik binnen een takenkoppeling.\n\n#### Laatste wijzigingen\n* `medewerkerId` en `relatieId` vervangen de eerdere medewerker- en relatiecodes.\n* Een apart endpoint toegevoegd om een taak op basis van `taakId` op te halen.\n* `toekomstigeStatus`, `ingangsDatumToekomst` en `korteOmschrijving` toegevoegd aan de taakresponse.\n* Een endpoint toegevoegd voor het aanmaken van relaties binnen de Taken API.","title":"Taken"},"externalDocs":{"description":"OpenAPI Specification","url":"/openapi-doc/v1/Taken"},"servers":[{"url":"https://api.realworks.nl"}],"security":[{"rwauth":[]}],"tags":[{"name":"Taken"}],"paths":{"/taken/v3":{"post":{"description":"### Migratie-overzicht (t.o.v. vorige versies)\n\n**Nieuw**\n* `medewerkerId`\n* `medewerkerIdAanmaker`\n* (v3 payload gebruikt consequent id’s i.p.v. codes)\n\n**Gewijzigd**\n* `medewerkercode` (v1/v2) → `medewerkerId` (v3).\n* `medewerkerscodeAanmaker` (v1/v2) → `medewerkerIdAanmaker` (v3).\n* `relatie` object (v1: met `relatiecode` + `relatiesoort`) → `relatieId` (v2/v3).\n* Endpoint-URL: gebruik voortaan `/taken/v3`.\n\n**Verwijderd**\n* medewerkercode\n* medewerkerscodeAanmaker\n* relatie (RelatieReferentie-object met code/soort)\n\n**Wat moet je aanpassen**\n* Gebruik `medewerkerId` (integer) i.p.v. `medewerkercode` (string).\n* Gebruik `medewerkerIdAanmaker` i.p.v. `medewerkerscodeAanmaker`.\n* Gebruik `relatieId` (integer) i.p.v. het relatie-object (code/soort).\n* Update je URL naar `/taken/v3`.\n","operationId":"verstuurGegevensTaak-v3","requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/TakenCreatePayloadV3"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncWritePathReply"}}},"description":"Response ontvangen"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"description":"Too Many Requests"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Verstuur een nieuwe taak naar het Realworks systeem","tags":["Taken"]}},"/taken/v3/afdeling/{afdelingscode}/taak/{taakId}":{"get":{"description":"Taak ophalen (1 specifieke taak).\n\n**Nieuw**\n* Nieuw endpoint om één taak op te halen: `/taken/v3/afdeling/{afdelingscode}/taak/{taakId}`\n\n**Wat moet je aanpassen**\n* Als je eerder alleen “zoeken” gebruikte om een taak te vinden: gebruik dit endpoint om een taak direct op id op te halen.\n* Zorg dat je `afdelingscode` en `taakId` beschikbaar hebt in je integratie.\n","operationId":"taakPerId","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"description":"Taak id","in":"path","name":"taakId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/TaakV3"}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Taak ophalen op basis van taak id","tags":["Taken"]}},"/taken/v3/medewerker/{medewerkerId}":{"get":{"description":"Zoeken door taken (voor een medewerker).\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Nieuw**\n* `resultaten[].ingangsDatumToekomst`\n* `resultaten[].toekomstigeStatus`\n* `resultaten[].korteOmschrijving`\n\n**Gewijzigd**\n* Endpoint-URL: gebruik voortaan `/taken/v3/medewerker/{medewerkerId}`\n* Response items: gebruik het huidige `TaakV3` responsemodel.\n\n**Verwijderd**\n* `resultaten[].eigenCode`\n* `resultaten[].geplandeWerktijdMinuten`\n\n**Wat moet je aanpassen**\n* Als je `eigenCode` of `geplandeWerktijdMinuten` gebruikte: die velden niet meer gebruiken.\n* Als je status-/planninglogica hebt: verwerk (optioneel) `toekomstigeStatus` + `ingangsDatumToekomst`.\n","operationId":"zoekenTaken","parameters":[{"description":"MedewerkerId","in":"path","name":"medewerkerId","required":true,"schema":{"type":"integer","format":"int32"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}},{"in":"query","name":"projectcode","required":false,"schema":{"type":"string"}},{"in":"query","name":"relatiecode","required":false,"schema":{"type":"string"}},{"in":"query","name":"relatiesoort","required":false,"schema":{"type":"string"}},{"in":"query","name":"tcreator","required":false,"schema":{"type":"string"}},{"in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"typeomschrijving","required":false,"schema":{"type":"string"}},{"description":"tedateVan (ex: _2017-11-03 20:00:00_ or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"tedateVan","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"tedateTot (ex: _2017-11-03 20:00:00_ or _2017-11-03T20:00:00_ (Safari browser)","in":"query","name":"tedateTot","required":false,"schema":{"type":"string","format":"date-time"}},{"description":" (min: _1_, max: _100_)","in":"query","name":"aantal","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer","format":"int32","default":100}},{"in":"query","name":"vanaf","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiSearchResultsTaakV3"}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Zoeken door taken","tags":["Taken"]}},"/taken/v3/relaties":{"post":{"description":"Nieuw endpoint om relaties aan te maken t.b.v. taken-koppelingen.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Nieuw**\n* In V3 is er een specifiek endpoint toegevoegd voor het aanmaken van relaties: `/wonen/v3/relaties`.\n* De request payload is flexibel en ondersteunt verschillende types via `oneOf`:\n    + `BEDRIJF`\n    + `CONTACTPERSOON`\n    + `PARTICULIER`\n\n**Wat moet je aanpassen**\n* Gebruik dit endpoint om nieuwe relaties aan te maken in plaats van generieke relatie-endpoints.\n* Zorg dat je het juiste payloadtype meestuurt op basis van de gewenste `relatiesoort`.\n","operationId":"relatiesTaskCreëren","requestBody":{"content":{"application/json;charset=UTF-8":{"examples":{"BedrijfPayload":{"description":"BedrijfPayload","summary":"If you choose BEDRIJF in relatiesoort","value":{"relatiesoort":"BEDRIJF","bedrijfsnaam":"string","mobielTelefoonnummer":"123-1331-122","straat":"string","email":"ab@realworks.com","telefoonnummer":"123-1331-122","postcode":"112133","accountmanager":"accountManager","huisnummer":"12","huisnummertoevoeging":"1","woonplaats":"string","afdelingscode":"afdelingscode"}},"ContactPersonPayload":{"description":"ContactPersonPayload","summary":"If you choose CONTACTPERSOON in relatiesoort","value":{"titel":"string","land":"string","companyId":"string","relatiesoort":"CONTACTPERSOON","initialen":"string","tussenvoegsel":"string","achternaam":"string","geslacht":"V","roepnaam":"string","email":"ab@realworks.com","straat":"string","afdelingscode":"afdelingscode","postcode":"112133","accountmanager":"accountManager","telefoonnummer":"123-1331-122","huisnummer":"12","huisnummertoevoeging":"1","woonplaats":"string","mobielTelefoonnummer":"123-1331-122"}},"ParticulierPayload":{"description":"ParticulierPayload","summary":"If you choose PARTICULIER in relatiesoort","value":{"initialen":"string","tussenvoegsel":"string","achternaam":"string","geslacht":"M","roepnaam":"string","relatiesoort":"PARTICULIER","land":"string","titel":"string","afdelingscode":"afdelingscode","huisnummer":"12","huisnummertoevoeging":"1","woonplaats":"string","telefoonnummer":"123-1331-122","postcode":"112133","accountmanager":"accountManager","straat":"string","email":"ab@realworks.com","mobielTelefoonnummer":"123-1331-122"}}},"schema":{"oneOf":[{"$ref":"#/components/schemas/BedrijfPayload"},{"$ref":"#/components/schemas/ContactPersonPayload"},{"$ref":"#/components/schemas/ParticulierPayload"}]}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncWritePathReply"}}},"description":"Response ontvangen"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"description":"Too Many Requests"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Relatie toevoegen voor taken","tags":["Taken"]}},"/taken/v3/statussen/{afdelingscode}":{"get":{"description":"Endpoint is verplaatst naar v3; functioneel gelijk gebleven.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* Het endpoint is nu beschikbaar onder : `/taken/v3/statussen/{afdelingscode}`.\n\n**Wat moet je aanpassen**\n* Update de URL in je aanroep naar `/takenv3/statussen/{afdelingscode}`.\n","operationId":"statussenTaak","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgendaOrTaskStatus"}}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Taak statussen","tags":["Taken"]}},"/taken/v3/types/{afdelingscode}":{"get":{"description":"Endpoint is verplaatst naar v3; functioneel gelijk gebleven.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Gewijzigd**\n* Het endpoint is nu beschikbaar onder : `/taken/v3/types/{afdelingscode}`.\n\n**Wat moet je aanpassen**\n* Update de URL naar `/taken/v3/types/{afdelingscode}`.\n","operationId":"typenTaak","parameters":[{"description":"Vestiging (eigenaar van het object)","in":"path","name":"afdelingscode","required":true,"schema":{"type":"string"}},{"in":"query","name":"actief","required":false,"schema":{"type":"string","enum":["true","false","all"],"default":"true"}}],"responses":{"200":{"content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskType"}}}},"description":"Succes"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"content":{},"description":"Te veel aanvragen"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Taak types","tags":["Taken"]}},"/taken/v3/{taakId}":{"put":{"description":"Werk een bestaande taak bij in het Realworks systeem.\n\n### Migratie-overzicht (t.o.v. vorige versies)\n\n**Nieuw**\n* Path parameter `{taakId}`\n* `medewerkerId`\n* `relatieId`\n\n**Gewijzigd**\n* `id` zit niet meer in de body (v1/v2), maar gaat via path parameter `{taakId}` (v3).\n* `medewerkercode` → `medewerkerId`.\n* `relatie` object (v1) → `relatieId` (v2/v3).\n* Endpoint-URL: gebruik voortaan `/taken/v3/{taakId}`.\n\n**Verwijderd**\n* `id` (in requestbody)\n* `medewerkercode`\n* `relatie` (RelatieReferentie-object)\n\n**Wat moet je aanpassen**\n* Geef het taak-id mee in de URL: `/taken/v3/{taakId}`.\n* Verwijder `id` uit de requestbody.\n* Gebruik `medewerkerId` i.p.v. `medewerkercode`.\n* Gebruik `relatieId` i.p.v. `relatie` (code/soort).\n","operationId":"gegevenstaakBijwerken-v3","parameters":[{"description":"Taak-ID","in":"path","name":"taakId","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/TakenUpdatePayloadV3"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncWritePathReply"}}},"description":"Response ontvangen"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Fout in aanroep"},"401":{"description":"Geen toegang; de volgende zaken kunnen deze fout geven. 1. De voorwaarden voor gebruik API zijn nog niet geaccepteerd in de developers.realworks.nl omgeving. 2. De token die gebruikt wordt is niet correct. Neem contact op met Realworks als de fout zich voor blijft doen."},"403":{"content":{},"description":"Verboden"},"404":{"content":{},"description":"Niet gevonden"},"429":{"description":"Too Many Requests"},"500":{"description":"Interne fout"},"503":{"content":{},"description":"Service tijdelijk onbeschikbaar"}},"summary":"Verstuur een taak naar het Realworks systeem","tags":["Taken"]}}},"components":{"schemas":{"AgendaOrTaskStatus":{"type":"object","properties":{"actief":{"type":"boolean"},"bedrijfscode":{"type":"string"},"entitytype":{"type":"integer","format":"int32"},"status":{"type":"string"},"systemid":{"type":"integer","format":"int32"},"tekstKleur":{"type":"string"},"volgorde":{"type":"integer","format":"int32"}}},"AgendaTakenRelatieV2":{"type":"object","properties":{"id":{"type":"integer","format":"int32","nullable":true},"type":{"type":"string","nullable":true}}},"ApiSearchResultsTaakV3":{"type":"object","properties":{"paginering":{"$ref":"#/components/schemas/PaginationInfo"},"resultaten":{"type":"array","items":{"$ref":"#/components/schemas/TaakV3"}}},"description":"Zoekresultaten"},"BedrijfPayload":{"type":"object","allOf":[{"$ref":"#/components/schemas/RelatieCreatePayload"},{"type":"object","properties":{"bedrijfsnaam":{"minLength":1,"type":"string","description":"bedrijfsnaam"},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"BEDRIJF"}}}],"description":"Bedrijf payload data","required":["afdelingscode","bedrijfsnaam","email","relatiesoort"]},"CalendarProject":{"type":"object","properties":{"projectcode":{"type":"string","nullable":true},"type":{"type":"string","nullable":true,"enum":["ZOEKOPDRACHTEN","WONEN","NIEUWBOUW","BOUWTYPE","BOUWNUMMER","BOG"]}},"nullable":true},"ContactPersonPayload":{"type":"object","allOf":[{"$ref":"#/components/schemas/RelatieCreatePayload"},{"type":"object","properties":{"achternaam":{"minLength":1,"type":"string","description":"achternaam"},"companyId":{"minLength":1,"type":"string","description":"companyId"},"geslacht":{"type":"string","description":"geslacht","nullable":true,"enum":["M","V","O"]},"initialen":{"type":"string","description":"initialen","nullable":true},"land":{"type":"string","description":"land","nullable":true},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"CONTACTPERSOON"},"roepnaam":{"type":"string","description":"roepnaam","nullable":true},"titel":{"type":"string","description":"titel","nullable":true},"tussenvoegsel":{"type":"string","description":"tussenvoegsel","nullable":true}}}],"description":"Contact person payload data","required":["achternaam","afdelingscode","companyId","email","relatiesoort"]},"ErrorResponse":{"type":"object","properties":{"meldingen":{"type":"array","items":{"type":"string"}}},"description":"Foutmeldingen"},"PaginationInfo":{"type":"object","properties":{"totaalAantal":{"type":"integer","format":"int64"},"volgende":{"type":"string","format":"uri","nullable":true}},"description":"Pagineringsinformatie"},"ParticulierPayload":{"type":"object","allOf":[{"$ref":"#/components/schemas/RelatieCreatePayload"},{"type":"object","properties":{"achternaam":{"minLength":1,"type":"string","description":"achternaam"},"geslacht":{"type":"string","description":"geslacht","nullable":true,"enum":["M","V","O"]},"initialen":{"type":"string","description":"initialen","nullable":true},"land":{"type":"string","description":"land","nullable":true},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"PARTICULIER"},"roepnaam":{"type":"string","description":"roepnaam","nullable":true},"titel":{"type":"string","description":"titel","nullable":true},"tussenvoegsel":{"type":"string","description":"tussenvoegsel","nullable":true}}}],"description":"Particulier payload data","required":["achternaam","afdelingscode","email","relatiesoort"]},"RelatieCreatePayload":{"required":["afdelingscode","email","relatiesoort"],"type":"object","properties":{"accountmanager":{"type":"string","description":"accountmanager","nullable":true,"example":"accountManager"},"afdelingscode":{"minLength":1,"type":"string","description":"afdelingscode","example":"afdelingscode"},"email":{"minLength":1,"type":"string","description":"email","example":"ab@realworks.com"},"huisnummer":{"type":"string","description":"huisnummer","nullable":true,"example":"12"},"huisnummertoevoeging":{"type":"string","description":"huisnummertoevoeging","nullable":true,"example":"1"},"mobielTelefoonnummer":{"type":"string","description":"mobielTelefoonnummer","nullable":true,"example":"123-1331-122"},"postcode":{"type":"string","description":"postcode","nullable":true,"example":"112133"},"relatiesoort":{"minLength":1,"type":"string","description":"relatiesoort","example":"BEDRIJF","enum":["BEDRIJF, CONTACTPERSOON, PARTICULIER"]},"straat":{"type":"string","description":"straat","nullable":true},"telefoonnummer":{"type":"string","description":"telefoonnummer","nullable":true,"example":"123-1331-122"},"woonplaats":{"type":"string","description":"woonplaats","nullable":true}},"description":"Relatie create payload data"},"SyncWritePathReply":{"type":"object","properties":{"entityId":{"type":"integer","description":"ID van de nieuw gemaakte/bijgewerkte entiteit","format":"int64","nullable":true},"entityKey":{"type":"string","description":"Key van de nieuw gemaakte/bijgewerkte entiteit","nullable":true},"entityType":{"type":"string","description":"Entiteitstype gemaakt/bijgewerkt","nullable":true},"foutmeldingen":{"type":"array","nullable":true,"items":{"type":"string"}},"ontvangstId":{"type":"string","description":"Identifier zoals mogelijk opgegeven door de client, anders gegenereerd. UUID-4"},"result":{"type":"string","enum":["OK","ERROR","EXCEPTION","IN_PROGRESS","WAITING_FOR_S3_UPLOAD"]}}},"TaakV3":{"type":"object","properties":{"bedrijfscode":{"type":"string"},"bedrijfsrelatiecode":{"type":"string","description":"Code van het gekoppelde bedrijf","nullable":true},"code":{"type":"string"},"datumGereed":{"type":"string","format":"date-time","nullable":true},"id":{"type":"integer","format":"int32"},"ingangsDatumToekomst":{"type":"string","format":"date","nullable":true},"invoerdatum":{"type":"string","format":"date-time","nullable":true},"korteOmschrijving":{"type":"string","nullable":true},"laatstBijgewerkt":{"type":"string","description":"Laatst bijgewerkt","format":"date-time","nullable":true},"omschrijving":{"type":"string","nullable":true},"popupHerinnering":{"type":"string","nullable":true,"enum":["T10_MINUTEN_ERVOOR","T20_MINUTEN_ERVOOR","T30_MINUTEN_ERVOOR","T45_MINUTEN_ERVOOR","T1_UUR_ERVOOR","T2_UUR_ERVOOR","T4_UUR_ERVOOR","T1_DAG_ERVOOR"]},"project":{"$ref":"#/components/schemas/CalendarProject"},"relaties":{"type":"array","items":{"$ref":"#/components/schemas/AgendaTakenRelatieV2"}},"status":{"type":"string","nullable":true},"toekomstigeStatus":{"type":"string","nullable":true},"type":{"type":"string","nullable":true},"vrijgegevenMove":{"type":"boolean","nullable":true}}},"TakenCreatePayloadV3":{"required":["afdelingscode","datumGereed","medewerkerId","taakStatus","taakType"],"type":"object","properties":{"afdelingscode":{"maxLength":10,"minLength":0,"type":"string","description":"Code van het makelaarskantoor","example":"deptm1"},"datumGereed":{"type":"string","description":"DatumGereed","example":"2020-11-08 09:00:00"},"geplandeWerktijdUren":{"type":"integer","description":"GeplandeWerktijdUren","format":"int64","nullable":true,"example":2},"ingangsDatumToekomst":{"type":"string","description":"Ingangs datum toekomst","format":"date","nullable":true,"example":"2022-11-08"},"inzage":{"type":"string","description":"Inzage","example":"Prive","enum":["Prive","Iedereen"]},"korteOmschrijving":{"type":"string","description":"KorteOmschrijving","nullable":true},"medewerkerId":{"type":"integer","description":"MedewerkerId","format":"int32","example":100123},"medewerkerIdAanmaker":{"type":"integer","description":"MedewerkerIdAanmaker","format":"int32","nullable":true,"example":10009},"omschrijving":{"type":"string","description":"Omschrijving","nullable":true},"popupHerinnering":{"type":"string","description":"PopupHerinnering","nullable":true,"example":"T20_MINUTEN_ERVOOR","enum":["T10_MINUTEN_ERVOOR","T20_MINUTEN_ERVOOR","T30_MINUTEN_ERVOOR","T45_MINUTEN_ERVOOR","T1_UUR_ERVOOR","T2_UUR_ERVOOR","T4_UUR_ERVOOR","T1_DAG_ERVOOR"]},"projectcode":{"maxLength":10,"minLength":0,"type":"string","description":"Projectcode","nullable":true,"example":"AB101715"},"relatieId":{"type":"integer","description":"RelatieId","format":"int32","example":10009},"taakStatus":{"type":"integer","description":"TaakStatus","format":"int32","example":62260},"taakType":{"type":"integer","description":"TaakType","format":"int32","example":210649},"toekomstigeStatus":{"type":"integer","description":"Toekomstige status","format":"int32","nullable":true,"example":1}},"description":"Inhoud van het request"},"TakenUpdatePayloadV3":{"required":["afdelingscode","datumGereed","medewerkerId","taakStatus","taakType"],"type":"object","properties":{"afdelingscode":{"maxLength":10,"minLength":0,"type":"string","description":"Code van het makelaarskantoor","example":"deptm1"},"datumGereed":{"type":"string","description":"DatumGereed","example":"2020-11-08 09:00:00"},"geplandeWerktijdUren":{"type":"integer","description":"GeplandeWerktijdUren","format":"int64","nullable":true,"example":2},"ingangsDatumToekomst":{"type":"string","description":"Ingangs datum toekomst","format":"date","nullable":true,"example":"2022-11-08"},"inzage":{"type":"string","description":"Inzage","example":"Prive","enum":["Prive","Iedereen"]},"korteOmschrijving":{"type":"string","description":"KorteOmschrijving","nullable":true},"medewerkerId":{"type":"integer","description":"MedewerkerId","format":"int32","example":100123},"omschrijving":{"type":"string","description":"Omschrijving","nullable":true},"popupHerinnering":{"type":"string","description":"PopupHerinnering","nullable":true,"example":"T20_MINUTEN_ERVOOR","enum":["T10_MINUTEN_ERVOOR","T20_MINUTEN_ERVOOR","T30_MINUTEN_ERVOOR","T45_MINUTEN_ERVOOR","T1_UUR_ERVOOR","T2_UUR_ERVOOR","T4_UUR_ERVOOR","T1_DAG_ERVOOR"]},"projectcode":{"maxLength":10,"minLength":0,"type":"string","description":"Projectcode","nullable":true,"example":"AB101715"},"relatieId":{"type":"integer","description":"RelatieId","format":"int32","example":10009},"taakStatus":{"type":"integer","description":"TaakStatus","format":"int32","example":62260},"taakType":{"type":"integer","description":"TaakType","format":"int32","example":210649},"toekomstigeStatus":{"type":"integer","description":"Toekomstige status","format":"int32","nullable":true,"example":1}},"description":"Inhoud van het request"},"TaskType":{"type":"object","properties":{"actief":{"type":"boolean"},"gereedbinnendagen":{"type":"number"},"gereedbinnenminuten":{"type":"number"},"gereedbinnenuren":{"type":"number"},"korteomschrijving":{"type":"string"},"systemid":{"type":"integer","format":"int32"},"type":{"type":"string"}}}},"securitySchemes":{"rwauth":{"in":"header","name":"Authorization","type":"apiKey"}}}}