Productbeschrijving LV-WOZ Terugmeldingen

(1)

Versie 1.0  2 maart 2022 1 / 27

Productbeschrijving LV-WOZ Terugmeldingen

Datum 2 maart 2022 Versie 1.0

Versiehistorie

Versie datum locatie omschrijving

1.0 02-03-2022 Geheel Initiële versie

(2)

Versie 1.0  2 maart 2022 2 / 27

Inhoudsopgave

1 Inleiding ... 2

2 Digimeldingvoorziening binnen LV-WOZ ... 3

2.1 Berichtuitwisseling Digikoppeling WUS ... 3

2.2 Autorisatie ... 3

2.3 Opstellen en intrekken van terugmeldingen ... 3

2.4 Wijzigen status terugmelding door Bronhouder ... 4

2.5 Opvragen statusoverzicht ... 4

2.6 Opvragen details terugmelding door Afnemer (melder) of Bronhouder ... 5

2.7 Gebruik van de Echo-testfaciliteit ... 5

2.8 Statussen en statusovergangen ... 5

2.9 Doorsturen van terugmeldingen ... 6

3 Voorbeeldberichten ... 7

3.1 Terugmelding door de afnemer ... 7

3.2 Antwoord op een terugmelding ... 9

3.3 Intrekken van een terugmelding door de afnemer ... 10

3.4 Antwoord op een intrekking ... 12

3.5 Statuswijziging door de bronhouder ... 13

3.6 Antwoord op een statuswijziging ... 15

3.7 Wijziging behandelende bronhouder ... 16

3.8 Antwoord op wijziging behandelende bronhouder ... 18

3.9 Opvragen statusoverzicht ... 19

3.10 Antwoord statusoverzicht ... 21

3.11 Opvragen van details van een terugmelding ... 23

3.12 Antwoord met details van een terugmelding ... 24

1 Inleiding

Het is wettelijk vereist dat afnemers in het stelsel van basisregistraties een terugmelding doen naar de

bronhouder als de afnemer onregelmatigheden tegenkomt. In het WOZ-domein is de Belastingdienst één van de belangrijkste terugmelders. Dat gebeurde tot enkele jaren geleden op papier. Aanvankelijk kreeg de

Belastingdienst WOZ-gegevens van elke gemeente en werden terugmeldingen ook rechtstreeks naar de betrokken gemeente gestuurd.

(3)

Versie 1.0  2 maart 2022 3 / 27 2 Digimeldingvoorziening binnen LV-WOZ

LV-WOZ biedt een SOAP-endpoint aan op basis van de Digikoppeling WUS-standaard, vergelijkbaar met huidige dienst Individuele Bevraging. Zowel de terugmelder (Afnemer) als de behandelaar (Bronhouder) communiceert over terugmeldingen met de Landelijke Voorziening WOZ via dit endpoint. Het endpoint kan de volgende berichten (Request) ontvangen en verwerken, en stuurt het bijbehorende antwoord terug (Response):

- Echo

- AnnotatieToevoegen (toevoegen, intrekken, statuswijziging) - StatusOverzicht

- DetailsTerugmelding

2.1 Berichtuitwisseling Digikoppeling WUS

Voor de uitwisseling van berichten wordt Digikoppeling WUS toegepast. Voor de onderliggende transportlaag worden PKIoverheid Private Root TLS-certificaten versie 1.2 of nieuwer gebruikt (machine-to-machine communicatie). Er wordt geen gebruik gemaakt van Signing van SOAP-berichten.

2.2 Autorisatie

Alle geregistreerde afnemers van de Landelijke Voorziening WOZ zijn geautoriseerd om terugmeldingen te doen (ook gemeenten). Terugmeldingen mogen worden ingestuurd door een tussenpartij zoals een

belastingsamenwerkingsverband of de cloudomgeving van een aanbieder van IT-diensten. De Landelijke Voorziening controleert op basis van het OIN uit de PKIoverheid-keten of de technische partij die een

terugmelding aanbiedt geautoriseerd is om namens de in het terugmeldingsbericht (zie 3.1) vastgelegde afnemer berichten in te sturen.

Deze autorisatie komt overeen met autorisatie van de dienst Individuele Bevraging.

2.3 Opstellen en intrekken van terugmeldingen

Een Afnemer doet een melding aan de LV/Basisregistratie door middel van een AnnotatieToevoegenRequest met een AnnotatieBoom met daarin als root (1^e annotatie) een Terugmelding. De initiële status is per definitie Gemeld.

De afnemer kan zijn melding intrekken door middel van een AnnotatieToevoegenRequest met een Annotatie (geen AnnotatieBoom) met daarin een wijziging AnnotatieStatus (waarbij alleen Ingetrokken is toegestaan).

Figuur 1 Interactiediagram terugmelden/intrekken direct

(4)

Versie 1.0  2 maart 2022 4 / 27 2.4 Wijzigen status terugmelding door Bronhouder

Een Bronhouder wijzigt de status van een terugmelding door middel van een AnnotatieToevoegenRequest met een AnnotatieBoom met daarin een wijziging Annotatiestatus (Ingetrokken is niet toegestaan).

Figuur 2 Interactiediagram status wijzigen

2.5 Opvragen statusoverzicht

Het bericht StatusoverzichtRequest wordt gebruikt in de communicatie tussen Afnemer en LV/Basisregistratie alsook tussen LV/Basisregistratie en Bronhouder om een statusoverzicht op te vragen.

Figuur 3 Interactiediagram status opvragen rechtstreeks

(5)

Versie 1.0  2 maart 2022 5 / 27 2.6 Opvragen details terugmelding door Afnemer (melder) of Bronhouder

Het bericht DetailsTerugmeldingRequest wordt gebruikt in de communicatie tussen Afnemer en

LV/Basisregistratie alsook tussen LV/Basisregistratie en Bronhouder om details van een bepaalde terugmelding op te vragen.

Figuur 4 Interactiediagram detail terugmelding bevragen rechtstreeks

2.7 Gebruik van de Echo-testfaciliteit

Voor het testen van de verbinding kan zowel de Afnemer als de Bronhouder een EchoRequest naar de LV-WOZ sturen. De LV-WOZ zal reageren met een EchoResponse.

Figuur 5 Interactiediagram voor echo’s

2.8 Statussen en statusovergangen

De LV-WOZ maakt uitsluitend gebruik van de in de standaard beschreven statussen en statusovergangen.

Berichten waarin een andere status of een niet ondersteunde statusovergang wordt gecommuniceerd zullen worden afgewezen. Alleen de in dit schema weergegeven statusovergangen zijn toegestaan.

(6)

Versie 1.0  2 maart 2022 6 / 27 Figuur 6 Statusovergangen

In XML-berichten worden de statussen geformuleerd als in onderstaande tabel. Merk op dat in het geval van meerdere woorden geen _ (underscore) wordt gebruikt maar een spatie.

Status XML-notatie

Gemeld GEMELD

Ingetrokken INGETROKKEN

Onvoldoende informatie ONVOLDOENDE INFORMATIE

Verkeerde bronhouder VERKEERDE BRONHOUDER

In behandeling IN BEHANDELING

Ingepland INGEPLAND

Afgehandeld AFGEHANDELD

2.9 Doorsturen van terugmeldingen

Een afnemer die gerede twijfel heeft over de juistheid van een authentiek gegeven dat hij via de landelijke voorziening WOZ verstrekt heeft gekregen meldt dit onder opgaaf van redenen aan de Dienst. De Dienst stuurt de melding onverwijld door naar het college dat het aangaat.

Om dit doorsturen mogelijk te maken kan de gemeente een Digikoppeling-beveiligd DMKS-endpoint aanbieden waarnaar de Landelijke Voorziening WOZ ontvangen terugmeldingen doorstuurt¹. Voor dit eindpoint gelden de beveiligings- en autorisatie-eisen van PKIoverheid en Digikoppeling WUS. Als de bronhouder zo'n endpoint beschikbaarheeft gesteld stuurt de Landelijke Voorziening het oorspronkelijke terugmeldingsbericht (zie 3.1) direct door naar de betrokken bronhouder. Dit betreft uitsluitend het oorspronkelijke terugmeldingsbericht. Het verdere proces verloopt conform de reguliere DMKS-standaard.

1 Zie https://logius.nl/diensten/digimelding/documentatie/best-practice-gebruik-dmks-tussen-landelijke-voorzieningen-en- bronhouders

(7)

Versie 1.0  2 maart 2022 7 / 27 3 Voorbeeldberichten

3.1 Terugmelding door de afnemer

<?xml version="1.0" encoding="utf-8"?>

<dmks:AnnotatieToevoegenRequest

xmlns:dmks="http://webservices.digimelding.nl/dmks/cookiebox/">

<dmks:OinBasisregistratie>00000001802327497000</dmks:OinBasisregistratie>

<dmks:Registratie>WOZ</dmks:Registratie>

<dmks:AnnotatieBoom>

<dmks:Annotatie>

<dmks:Terugmelding uuid="11111111-6d55-4607-942f-978c12a3cfd3">

<dmks:GeannoteerdDoor>

<dmks:Oin>00000011100000001010</dmks:Oin>

<dmks:Persoonsaanduiding>Medewerker van afnemer</dmks:Persoonsaanduiding>

</dmks:GeannoteerdDoor>

<dmks:GeannoteerdOp>2021-09- 10T10:20:30.040+02:00</dmks:GeannoteerdOp>

<dmks:Toelichting>Hier kan een toelichting worden gegeven.</dmks:Toelichting>

<dmks:Bronverwijzingen>

<dmks:Bronverwijzing>

<dmks:Uri>urn:woz:012301234567</dmks:Uri>

</dmks:Bronverwijzing>

</dmks:Bronverwijzingen>

<dmks:Attributenset>

<dmks:Attribuut>

<dmks:Uri>urn:attribuut:woz/aanduidingWozObject/postcode</dmks:Uri>

<dmks:BetwijfeldeWaarde>1234AB</dmks:BetwijfeldeWaarde>

<dmks:VoorgesteldeWaarde>9876ZY</dmks:VoorgesteldeWaarde>

</dmks:Attribuut>

<dmks:Attribuut>

<dmks:Uri>urn:attribuut:woz/aanduidingWozObject/woonplaatsNaam</dmks:Uri>

<dmks:BetwijfeldeWaarde>Amsterdam</dmks:BetwijfeldeWaarde>

<dmks:VoorgesteldeWaarde>Zuidhorn</dmks:VoorgesteldeWaarde>

</dmks:Attribuut>

<dmks:Attribuut>

<dmks:Uri>urn:attribuut:woz/grondoppervlakte</dmks:Uri>

<dmks:BetwijfeldeWaarde>1256</dmks:BetwijfeldeWaarde>

<dmks:VoorgesteldeWaarde>7856</dmks:VoorgesteldeWaarde>

</dmks:Attribuut>

</dmks:Attributenset>

</dmks:Terugmelding>

</dmks:Annotatie>

</dmks:AnnotatieBoom>

</dmks:AnnotatieToevoegenRequest>

(8)

Versie 1.0  2 maart 2022 8 / 27 XML-tag of -attribuut Omschrijving

OinBasisregistratie OIN van het Kadaster; dit zijn altijd 20 cijfers

Registratie Code van maximaal 3 letters van de registratie waarvoor de terugmelding wordt gedaan. In deze context altijd WOZ in hoofdletters.

Terugmelding, attribuut UUID

Unieke identificatie van de terugmelding door middel van een Versie 4 UUID (random). In zeer zeldzame gevallen kan het voorkomen dat een afnemer of een bronhouder een UUID probeert te gebruiken die al in gebruik is. In zulke gevallen volgt een foutmelding (UUID reeds in gebruik) en moet de betrokken organisatie een andere UUID kiezen.

GeannoteerdDoor, Oin

OIN van de organisatie die de terugmelding doet, dit zijn altijd 20-cijfers.

GeannoteerdDoor, Persoonsaanduiding

Aanduiding van de persoon die de terugmelding doet; dit mag ook de tekst Anoniem zijn. Hierin vermelde

persoonsgegevens vallen onder de regelgeving van de AVG.

GeannoteerdOp De datum en tijd waarop de terugmelding is opgesteld in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt: YYYY-MM-DDThh:mm:ss.sss+hh:mm

Toelichting Vrije tekst voor het toelichten van de terugmelding. Wanneer in deze toelichting persoonsgegevens voorkomen is daarop de regelgeving van de AVG van toepassing. De toelichting heeft maximaal 2000 tekens.

Bronverwijzingen, Bronverwijzing

De eerste bronverwijzing moet altijd beginnen met urn:woz:{wozObjectnummer}

De eerste bronverwijzing mag na dit vaste begin meer gegevens bevatten. De Landelijke Voorziening WOZ gebruikt het vaste begin voor het bepalen van de juiste bronhouder.

Attributenset, Attribuut

De Catalogus Digimelding WOZ definieert welke URI's kunnen worden gebruikt voor terugmeldingen op attributen.

Van elk attribuut kan de terugmelder een betwijfelde waarde en indien gewenst een voorgestelde waarde opgeven.

Status De AnnotatieStatus staat nooit expliciet in dit bericht. De status van een nieuwe terugmelding is altijd GEMELD.

(9)

Versie 1.0  2 maart 2022 9 / 27 3.2 Antwoord op een terugmelding

<dmks:AnnotatieToevoegenResponse

<dmks:Tijdstempel>2021-09-10T11:21:31.041+02:00</dmks:Tijdstempel>

<dmks:AnnotatieVerwijzing>11111111-6d55-4607-942f- 978c12a3cfd3</dmks:AnnotatieVerwijzing>

</dmks:AnnotatieToevoegenResponse>

XML-tag of -attribuut Omschrijving

Tijdstempel De datum en tijd waarop de terugmelding is vastgelegd en deze response is verstuurd, in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt:

YYYY-MM-DDThh:mm:ss.sss+hh:mm

AnnotatieVerwijzing De UUID van de Terugmelding. Zie het attribuut uuid op de XML-tag Terugmelding in het terugmeldingsbericht.

(10)

Versie 1.0  2 maart 2022 10 / 27 3.3 Intrekken van een terugmelding door de afnemer

<dmks:Annotatie>

<dmks:Annotatiestatus uuid="44444444-12e8-403d-bccb-a63e17903f82">

<dmks:Oin>00000011100000001010</dmks:Oin>

<dmks:Persoonsaanduiding>Medewerker van afnemer</dmks:Persoonsaanduiding>

<dmks:Annotatieverwijzing>11111111-6d55-4607-942f- 978c12a3cfd3</dmks:Annotatieverwijzing>

<dmks:Status>INGETROKKEN</dmks:Status>

</dmks:Annotatiestatus>

</dmks:Annotatie>

(11)

Annotatiestatus, attribuut uuid

Unieke identificatie van de intrekking door middel van een Versie 4 UUID (random). In zeer zeldzame gevallen kan het voorkomen dat een afnemer of een bronhouder een UUID probeert te gebruiken die al in gebruik is. In zulke gevallen volgt een foutmelding (UUID reeds in gebruik) en moet de betrokken organisatie een andere UUID kiezen.

OIN van de organisatie die de terugmelding doet,dit zijn altijd 2-cijfers.

GeannoteerdOp De datum en tijd waarop de terugmelding is opgesteld in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt:

Annotatieverwijzing UUID van de terugmelding (annotatie) die ingetrokken moet worden.

Status Een intrekking is een wijziging van de AnnotatieStatus door de afnemer die de betreffende terugmelding eerder heeft gedaan waarbij de nieuwe status altijd INGETROKKEN is.

(12)

Versie 1.0  2 maart 2022 12 / 27 3.4 Antwoord op een intrekking

Tijdstempel De datum en tijd waarop de intrekking is vastgelegd en deze response is verstuurd, in ISO8601-notatie inclusief tijdzone.

Het formaat is vast en als volgt:

AnnotatieVerwijzing De UUID van de terugmelding die is ingetrokken. Zie de XML-tag AnnotatieVerwijziging in het intrekkingsbericht.

(13)

Versie 1.0  2 maart 2022 13 / 27 3.5 Statuswijziging door de bronhouder

<dmks:Annotatie>

<dmks:Annotatiestatus uuid="22222222-393c-44bf-9ced- cb14e218786d">

<dmks:Oin>00000022200000002020</dmks:Oin>

<dmks:Persoonsaanduiding>Medewerker van bronhouder</dmks:Persoonsaanduiding>

<dmks:Toelichting>Dit kunnen wij niet in behandeling nemen</dmks:Toelichting>

<dmks:Status>ONVOLDOENDE INFORMATIE<dmks:Status>

</dmks:Annotatie>

(14)

OinBasisregistratie OIN van het Kadaster, dit zijn altijd 20-cijfers

Annotatiestatus, attribuut uuid

Unieke identificatie van de statuswijziging door middel van een Versie 4 UUID (random). In zeer zeldzame gevallen kan het voorkomen dat een afnemer of een bronhouder een UUID probeert te gebruiken die al in gebruik is. In zulke gevallen volgt een foutmelding (UUID reeds in gebruik) en moet de betrokken organisatie een andere UUID kiezen.

OIN van de bronhouder die de terugmelding behandelt.

Aanduiding van de persoon die de terugmelding behandelt;

dit mag ook de tekst Anoniem zijn. Hierin vermelde

GeannoteerdOp De datum en tijd waarop de statuswijziging is opgesteld in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt:

Toelichting Toelichting van de bronhouder waarom de status wijzigt. De toelichting heeft maximaal 2000 tekens.

Annotatieverwijzing UUID van de terugmelding (annotatie) waarvan de status wordt gewijzigd.

Status De bronhouder die de betreffende terugmelding in behandeling heeft kan de status wijzigen naar IN BEHANDELING,

INGEPLAND, AFGEHANDELD,

ONVOLDOENDE INFORMATIE (zoals in dit voorbeeld)

(15)

Versie 1.0  2 maart 2022 15 / 27 3.6 Antwoord op een statuswijziging

Tijdstempel De datum en tijd waarop de melding onvoldoende informatie is vastgelegd en deze response is verstuurd, in ISO8601- notatie inclusief tijdzone. Het formaat is vast en als volgt:

AnnotatieVerwijzing De UUID van de terugmelding waarvan de status is gewijzigd. Zie de XML-tag AnnotatieVerwijziging in het statuswijzigingsbericht.

(16)

Versie 1.0  2 maart 2022 16 / 27 3.7 Wijziging behandelende bronhouder

Als een bronhouder constateert dat een terugmelding door een andere bronhouder moet worden behandeld kan de bronhouder dat aangeven met de statuswijziging VERKEERDE BRONHOUDER en de annotatie

BehandelendeBronhouder waarmee de juiste bronhouder wordt doorgegeven.

Bij een gemeentelijke herindeling moet de oude gemeente met de annotatie BehandelendeBronhouder elke terugmelding (ook afgehandelde terugmeldingen) overdragen aan de juiste opvolgende gemeente. Bij splitsing van een gemeente kan dat betekenen dat een deel van de terugmeldingen naar de ene opvolgende gemeente gaat en een ander deel van de terugmeldingen naar een andere opvolgende gemeente gaat. De status wijzigt niet bij een gemeentelijke herindeling. De status VERKEERDE BRONHOUDER is in deze situatie niet van toepassing. Anders dan in onderstaand voorbeeld zal de AnnotatieStatus dan dus worden weggelaten.

<dmks:Annotatie>

<dmks:Oin>00000022200000002020</dmks:Oin>

<dmks:Persoonsaanduiding>Medewerker van bronhouder</dmks:Persoonsaanduiding>

<dmks:Toelichting>Een andere bronhouder moet dit in behandling nemen</dmks:Toelichting>

<dmks:Status>VERKEERDE BRONHOUDER<dmks:Status>

</dmks:Annotatie>

<dmks:Annotatie>

<dmks:BehandelendeBronhouder uuid="33333333-d8ab-48cc-9a15- d3ed2d8f6777">

<dmks:Oin>00000022200000002020</dmks:Oin>

<dmks:Persoonsaanduiding>Een willekeurige bronhouder</dmks:Persoonsaanduiding>

<dmks:Bronhouder>1234</dmks:Bronhouder>

</dmks:BehandelendeBronhouder>

</dmks:Annotatie>

(17)

OinBasisregistratie OIN van het Kadaster, dit zijn altijd 20-cijfers.

Annotatiestatus, attribuut uuid (2x)

Unieke identificatie van de Annotatie door middel van een Versie 4 UUID (random). In zeer zeldzame gevallen kan het voorkomen dat een afnemer of een bronhouder een UUID probeert te gebruiken die al in gebruik is. In zulke gevallen volgt een foutmelding (UUID reeds in gebruik) en moet de betrokken organisatie een andere UUID kiezen.

OIN van de organisatie die de terugmelding behandelt, dit zijn altijd 20-cijfers.

GeannoteerdOp De datum en tijd waarop de terugmelding is opgesteld in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt:

Toelichting Toelichting waarom een andere bronhouder de terugmelding moet behandelen. De toelichting heeft maximaal 2000 tekens.

Annotatieverwijzing (2x) UUID van de terugmelding (annotatie) die bij de verkeerde bronhouder is terechtgekomen. Let op: de

Annotatieverwijzing

Status De bronhouder die de betreffende terugmelding in behandeling heeft wijzigt de status naar

VERKEERDE BRONHOUDER.

Bronhouder De 4-cijferige gemeentecode van de bronhouder die de behandeling van deze terugmelding moet overnemen. Geef niets op (met <Bronhouder></Bronhouder> of met

<Bronhouder/> ) als niet bekend of niet duidelijk is welke bronhouder de behandeling moet overnemen.

(18)

Versie 1.0  2 maart 2022 18 / 27 3.8 Antwoord op wijziging behandelende bronhouder

Tijdstempel De datum en tijd waarop de melding verkeerde bronhouder is vastgelegd en deze response is verstuurd, in ISO8601- notatie inclusief tijdzone. Het formaat is vast en als volgt:

AnnotatieVerwijzing De UUID van de terugmelding waarvan de behandelende bronhouder is gewijzigd. Zie de XML-tags

AnnotatieVerwijziging in het wijzigingsbericht.

(19)

Versie 1.0  2 maart 2022 19 / 27 3.9 Opvragen statusoverzicht

<?xml version="1.0"?>

<dmks:StatusoverzichtRequest

<dmks:OinVragendeOrganisatie>00000002003214394002</dmks:OinVragendeOrganisati e>

<dmks:Filter>

<dmks:VanafTijdstempelIndienen>2016-08- 01T13:06:58.711+01:00</dmks:VanafTijdstempelIndienen>

</dmks:Filter>

</dmks:StatusoverzichtRequest>

<dmks:Filter>

<dmks:VanafTijdstempelIndienen>2016-08- 01T00:00:00.000+01:00</dmks:VanafTijdstempelIndienen>

<dmks:TotEnMetTijdstempelIndienen>2016-08- 01T23:59:59.999+01:00</dmks:TotEnMetTijdstempelIndienen>

</dmks:Filter>

<dmks:Filter>

<dmks:VanafTijdstempelWijziging>2016-08- 01T00:00:00.000+01:00</dmks:VanafTijdstempelWijziging>

<dmks:TotEnMetTijdstempelWijziging>2016-08- 01T23:59:59.999+01:00</dmks:TotEnMetTijdstempelWijziging>

</dmks:Filter>

<dmks:Filter>

<dmks:Terugmeldingsstatus>GEMELD</dmks:Terugmeldingsstatus>

</dmks:Filter>

De status GEMELD staat niet expliciet in het bericht met de initiële Terugmelding, maar kan in deze filters wel worden gebruikt. Combinaties van filters anders dan deze voorbeelden zijn mogelijk.

(20)

OinVragendeOrganisatie OIN van de vragende organisatie. Afnemers kunnen vragen om het statusoverzicht van door hen gedane

terugmeldingen. Bronhouders kunnen vragen om het statusoverzicht van voor hen bestemde of door hen gedane terugmeldingen.

OinBasisregistratie OIN van het Kadaster Filter,

VanafTijdstempelIndienen

Dit filter beperkt de resultaten tot terugmeldingen met Tijdstempel op of na de opgegeven datum en tijd. Zie het Tijdstempel in de AnnotatieToevoegenResponse die als antwoord op een terugmelding wordt verstuurd.

Filter,

TotEnMetTijdstempelIndienen

Dit filter beperkt de resultaten tot terugmeldingen met Tijdstempel voor of op de opgegeven datum en tijd. Zie het Tijdstempel in de AnnotatieToevoegenResponse die als antwoord op een terugmelding wordt verstuurd.

Filter,

VanafTijdstempelWijziging

Dit filter beperkt de resultaten tot terugmeldingen met Tijdstempel van de laatste Annotatie op of na de opgegeven datum en tijd. Zie de AnnotatieToevoegenResponse die als antwoord op een wijziging wordt verstuurd.

Filter,

TotEnMetTijdstempelWijziging

Dit filter beperkt de resultaten tot terugmeldingen met Tijdstempel van de laatste Annotatie voor of op de opgegeven datum en tijd. Zie de

AnnotatieToevoegenResponse die als antwoord op een wijziging wordt verstuurd.

Filter,

Terugmeldingsstatus

Dit filter beperkt de resultaten tot terugmeldingen met als laatste status

GEMELD, INGETROKKEN, IN BEHANDELING, INGEPLAND, AFGEHANDELD,

ONVOLDOENDE INFORMATIE of VERKEERDE BRONHOUDER

(21)

Versie 1.0  2 maart 2022 21 / 27 3.10 Antwoord statusoverzicht

<dmks:StatusoverzichtResponse

<dmks:AnnotatieLijst>

<dmks:Annotatie>

<dmks:Tijdstempel>2016-08- 02T19:06:25.000+02:00</dmks:Tijdstempel>

<dmks:Uuid>11111111-6d55-4607-942f-978c12a3cfd3</dmks:Uuid>

<dmks:Meldingskenmerk/>

<dmks:Oin>00000022200000002020</dmks:Oin>

<dmks:Status>ONVOLDOENDE INFORMATIE</dmks:Status>

</dmks:Annotatie>

</dmks:AnnotatieLijst>

</dmks:StatusoverzichtResponse>

(22)

Tijdstempel Dit is het tijdstempel zoals gestuurd in de AnnotatieToevoegenResponse als reactie op de Terugmelding.

Uuid Unieke identificatie van de terugmelding door middel van een Versie 4 UUID (random).

Meldingskenmerk Niet van toepassing. De XML-tag is verplicht aanwezig (XSD) maar blijft leeg.

Bronverwijzing Dit is de eerste bronverwijzing die altijd moet beginnen met urn:woz:{wozObjectnummer}

Deze eerste bronverwijzing mag na dit vaste begin meer gegevens bevatten. De Landelijke Voorziening WOZ gebruikt het vaste begin voor het bepalen van de juiste bronhouder.

AnnotatieStatus, attribuut uuid

Unieke identificatie van de meest recente statuswijziging door middel van een Versie 4 UUID (random). Is er geen statuswijziging dan worden hier de gegevens van de terugmelding zelf opgenomen.

OIN van de bronhouder die de laatste statuswijziging heeft gedaan. Als er geen statuswijziging is het OIN van de organisatie die de terugmelding heeft gedaan.

Aanduiding van de persoon die de laatste statuswijziging heeft gedaan. Als er geen statuswijziging is de aanduiding van de persoon die de terugmelding heeft gedaan. Hierin vermelde persoonsgegevens vallen onder de regelgeving van de AVG.

GeannoteerdOp De datum en tijd waarop de laatste statuswijziging (bij geen statuswijziging: terugmelding) is opgesteld in ISO8601- notatie inclusief tijdzone. Het formaat is vast en als volgt:

Toelichting Vrije tekst voor het toelichten van de laatste statuswijziging (bij geen statuswijziging: terugmelding). Wanneer in deze toelichting persoonsgegevens voorkomen is daarop de regelgeving van de AVG van toepassing. De toelichting heeft maximaal 2000 tekens.

Annotatieverwijzing Unieke identificatie van de terugmelding door middel van een Versie 4 UUID (random).

Status De AnnotatieStatus is bij een nieuwe terugmelding altijd GEMELD. Na één of meer statuswijzigingen is dit de status van de laatste statuswijziging.

(23)

Versie 1.0  2 maart 2022 23 / 27 3.11 Opvragen van details van een terugmelding

<dmks:DetailsTerugmeldingRequest

<dmks:Uuid>11111111-6d55-4607-942f-978c12a3cfd3</dmks:Uuid>

</dmks:DetailsTerugmeldingRequest>

OinVragendeOrganisatie OIN van de vragende organisatie. Afnemers kunnen vragen om het statusoverzicht van door hen gedane

terugmeldingen. Bronhouders kunnen vragen om het statusoverzicht van voor hen bestemde of door hen gedane terugmeldingen.

OinBasisregistratie OIN van het Kadaster

Uuid Unieke identificatie van de terugmelding door middel van een Versie 4 UUID (random).

(24)

Versie 1.0  2 maart 2022 24 / 27 3.12 Antwoord met details van een terugmelding

<dmks:DetailsTerugmeldingResponse

<dmks:Annotatie>

<dmks:Terugmelding uuid="11111111-6d55-4607-942f-978c12a3cfd3">

<dmks:Oin>00000002003214394002</dmks:Oin>

<dmks:Persoonsaanduiding>Iemand</dmks:Persoonsaanduiding>

<dmks:Toelichting>Hier kan een toelichting worden gegeven.</dmks:Toelichting>

<dmks:Bronverwijzingen>

</dmks:Bronverwijzingen>

<dmks:Attributenset>

<dmks:Attribuut>

<dmks:Uri>urn:attribuut:woz/aanduidingWozObject/postcode</dmks:Uri>

<dmks:BetwijfeldeWaarde>1234AB</dmks:BetwijfeldeWaarde>

<dmks:VoorgesteldeWaarde>9876ZY</dmks:VoorgesteldeWaarde>

</dmks:Attribuut>

<dmks:Attribuut>

<dmks:Uri>urn:attribuut:woz/aanduidingWozObject/woonplaatsNaam</dmks:Uri>

<dmks:BetwijfeldeWaarde>Amsterdam</dmks:BetwijfeldeWaarde>

<dmks:VoorgesteldeWaarde>Zuidhorn</dmks:VoorgesteldeWaarde>

</dmks:Attribuut>

<dmks:Attribuut>

<dmks:Uri>urn:attribuut:woz/grondoppervlakte</dmks:Uri>

<dmks:BetwijfeldeWaarde>1256</dmks:BetwijfeldeWaarde>

<dmks:VoorgesteldeWaarde>7856</dmks:VoorgesteldeWaarde>

</dmks:Attribuut>

</dmks:Attributenset>

</dmks:Terugmelding>

</dmks:Annotatie>

<dmks:Annotatie>

<dmks:BehandelendeBronhouder uuid="44444444-d8ab-48cc-9a15- d3ed2d8f6777">

<dmks:Oin>00000001802327497000</dmks:Oin>

<dmks:Persoonsaanduiding>Dienst voor het kadaster en de openbare registers</dmks:Persoonsaanduiding>

(25)

Versie 1.0  2 maart 2022 25 / 27

<dmks:Bronhouder>1234</dmks:Bronhouder>

</dmks:BehandelendeBronhouder>

</dmks:Annotatie>

<dmks:Annotatie>

<dmks:Oin>00000022200000002020</dmks:Oin>

<dmks:Status>ONVOLDOENDE INFORMATIE</dmks:Status>

</dmks:Annotatie>

</dmks:DetailsTerugmeldingResponse>

Na ontvangst van de terugmelding bepaalt het Kadaster de BehandelendeBronhouder. Dit is voor zowel de afnemer (melder) als de bronhouder (behandelaar) zichtbaar in de DetailsTerugmeldingResponse doordat het Oin in GeannoteerdDoor het OIN van het Kadaster is. GeannoteerdOp van BehandelendeBronhouder door het Kadaster is gelijk aan het Tijdstempel in de AnnotatieToevoegenResponse die het Kadaster stuurt naar de melder in reactie op een Terugmelding.

(26)

Terugmelding, attribuut uuid

Unieke identificatie van de terugmelding door middel van een Versie 4 UUID (random). In zeer zeldzame gevallen kan het voorkomen dat een afnemer of een bronhouder een UUID probeert te gebruiken die al in gebruik is. In zulke gevallen volgt een foutmelding (UUID reeds in gebruik) en moet de betrokken organisatie een andere UUID kiezen.

GeannoteerdDoor, Oin (terugmelding)

OIN van de organisatie die de terugmelding doet, dit zijn altijd 20-cijfers.

GeannoteerdDoor, Persoonsaanduiding (terugmelding)

GeannoteerdOp (terugmelding)

De datum en tijd waarop de terugmelding is opgesteld in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt: YYYY-MM-DDThh:mm:ss.sss+hh:mm

Toelichting (terugmelding)

Vrije tekst voor het toelichten van de terugmelding. Wanneer in deze toelichting persoonsgegevens voorkomen is daarop de regelgeving van de AVG van toepassing. De toelichting heeft maximaal 2000 tekens.

Bronverwijzingen, Bronverwijzing (terugmelding)

De eerste bronverwijzing moet altijd beginnen met urn:woz:{wozObjectnummer}

De eerste bronverwijzing mag na dit vaste begin meer gegevens bevatten. De Landelijke Voorziening WOZ gebruikt het vaste begin voor het bepalen van de juiste bronhouder.

Attributenset, Attribuut (terugmelding)

Uri van het attribuute (de Catalogus Digimelding WOZ definieert welke Uri's kunnen worden gebruikt voor

terugmeldingen), betwijfelde en e.v.t. voorgestelde waarde.

GeannoteerdDoor, Oin (annotatiestatus)

OIN van de bronhouder die de terugmelding behandelt, , dit zijn altijd 20-cijfers.

GeannoteerdDoor, Persoonsaanduiding (annotatiestatus)

(27)

Versie 1.0  2 maart 2022 27 / 27 GeannoteerdOp

(annotatiestatus)

De datum en tijd waarop de statuswijziging is opgesteld in ISO8601-notatie inclusief tijdzone. Het formaat is vast en als volgt:

YYYY-MM-DDThh:mm:ss.sss+hh:mm Toelichting

(annotatiestatus)

Toelichting van de bronhouder waarom de status wijzigt. De toelichting heeft maximaal 2000 tekens.

Annotatieverwijzing (annotatiestatus)

UUID van de terugmelding waarvan de status is gewijzigd.

Status (annotatiestatus) De bronhouder die de betreffende terugmelding in behandeling heeft kan de status wijzigen naar IN BEHANDELING, INGEPLAND, AFGEHANDELD, ONVOLDOENDE INFORMATIE (zoals in dit voorbeeld)