WOZ Massale bevraging
Met de webservice Massale bevraging vraagt u in grote hoeveelheden data uit de LV-WOZ op. U geeft in een StUF 3.01 vraagbericht aan welke gegevens u wilt ontvangen.
Bent u opgenomen in de Wet WOZ als wettelijke gebruiker van WOZ-data? Dan kunt u mogelijk gebruikmaken van de dienst Massale bevraging. De Autorisatiematrix WOZ biedt meer uitleg over toepassing van de wet op onze producten. Lees meer informatie op de pagina WOZ voor afnemers.
WOZ Massale bevraging
gratisIn uw vraagbericht bepaalt u welke gegevens u wilt ontvangen. U kunt:
- bevragen op WOZ-object, waarde of sluimerend WOZ-object
- sorteren op bijvoorbeeld WOZ-objectnummer, waardepeildatum of gemeente- of waterschapscode
- kiezen voor alleen actuele of ook historische informatie
- bepalen welke attributen u wilt ontvangen
Kies uw rol, de productie-omgeving en daarna Massale Bevraging.
Zo sluit u op de webservice aan
- Voor het gebruik van de webservice Massale bevraging is een actief Organisatie Identificatienummer (OIN) of HandelsRegisterNummer (HRN) verplicht. Hebt u nog geen OIN of een HRN? Lees meer informatie op logius.nl.
- Ook is een geldig PKIoverheid-certificaat verplicht. Uw PKIoverheid-certificaat vraagt u aan via uw certificaatverstrekker. Meer informatie over het PKIoverheid-certificaat vindt u op logius.nl.
- Voor de webservice Massale bevraging hebt u ook een CPA nodig. U vraagt deze aan via het CPA-register op de cparegister.nl.
Technische documentatie webservice
WOZ Massale bevraging gebruikt verschillende koppelvlakken:
- De inhoud van de webservice voldoet aan de WOZ-XSD uit het koppelvlak LV-WOZ versie 3.12 (20260918). Download het koppelvlak als zipbestand via de waarderingskamer.nl.
- De communicatie met WOZ Massale bevraging verloopt volgens de Digikoppeling ebMS. Wij gebruiken ook de onderliggende standaarden, zoals SOAP 1.1 en XML 1.0. De nieuwste versie van de Digikoppeling Koppelvlakstandaard ebMS vindt u op logius.nl.
- Het antwoordbericht dat u ontvangt voldoet aan de Berichtenstandaard Digikoppeling Grote berichten. U download de XSD Grote berichten hier. Lees meer over deze berichtenstandaard op logius.nl.
Afhandeltermijn Massale bevraging
Hoe snel u een antwoord ontvangt, hangt af van het aantal aanvragen dat in behandeling is. Zijn er minder dan 6 massale bevragingen in behandeling? Dan geldt de afhandeltermijn uit de Dienst-Niveau-Overeenkomst LV-WOZ. Lees hierover meer op waarderingskamer.nl.
U ontvangt:
- binnen 1 uur een antwoord bij het bevragen van een kleine tot middelgrote gemeente
- binnen 24 uur een antwoord bij het bevragen van een grote gemeente
- binnen 6 dagen een antwoord voor een bevraging van heel Nederland
Vraag en antwoord
Alle primaire en sommige secundaire afnemers mogen WOZ Massale bevraging afnemen. Wie dat zijn, vindt u op de pagina WOZ voor afnemers.
Twijfelt u of u WOZ Massale bevraging af mag nemen? De Autorisatiematrix op waarderingskamer.nl geeft u inzicht.
Welke informatie uit de LV-WOZ u op mag vragen, vindt u in de Autorisatiematrix op waarderingskamer.nl.
We ondersteunen de volgende typen vraagberichten:
- Lv02
- Lv04
- Lv06
- Lv08
- Lv10
Dit type vraagberichten bepaalt of u alleen actuele of ook historische informatie ontvangt.
We ondersteunen vraagberichten over de volgende onderwerpen:
- WOZ-waarden (wrd)
- Sluimerend WOZ-objecten (swo)
- WOZ-objecten (woz)
Dit bepaalt over welke objecten en waarden u informatie ontvangt.
In de LV-WOZ ondersteunen we vragen voor subjecten (nnp, nps en ves) niet.
Meer informatie hierover kunt u vinden op de pagina LV-WOZ koppelvlak.
U ontvangt een antwoordbericht (action: afleveren) met daarin de link om het antwoordbestand te downloaden. In de bestandsnaam van het antwoordbericht staat het referentienummer van uw vraagbericht. Zo weet u welk antwoord bij welke vraag hoort. Het antwoordbericht voldoet aan het koppelvlak Digikoppeling Grote Berichten.
Het antwoordbestand is een La StUF XML antwoordbestand verpakt in ZIP64 formaat. Het antwoordbericht voldoet aan de WOZ XSD.
Wanneer u een mutatiebericht instuurt, dan verwacht u de wijziging terug te zien in de LV-WOZ. Stelt u een vraagbericht, dan hoort u hier op een antwoord te krijgen. Gebeurt dit niet, controleer dan of wij uw bericht ontvangen hebben. In reactie op uw bericht ontvangt u altijd een acknowledgement van ons. Hebt u geen acknowledgement ontvangen? Dan is uw bericht niet bij ons afgeleverd. U kunt uw bericht dan opnieuw aanbieden
Hebt u wel een acknowledgement ontvangen, maar is er iets fout gegaan met de verwerking van uw bericht? Dan ontvangt u een foutmelding. Meer informatie over foutmeldingen vindt u bij vraag en antwoord op deze pagina.
Is uw bericht door ons ontvangen maar niet verwerkbaar dan ontvangt u een foutmelding. In de foutmelding wordt omschreven waarom het bericht is afgewezen. Na herstel van het bericht kunt u deze opnieuw aanbieden. Vergeet daarbij niet het bericht een nieuw referentienummer mee te geven.
Vragen
Hebt u vragen over een verstuurd bericht of ontvangen foutmelding? Neem dan eerst contact op met uw softwareleverancier. Komt u er samen niet uit dan kunt u uw vragen indienen via het contactformulier van klantenservice WOZ. Neem onderstaande informatie in ieder geval op:
- Naam van de omgeving en de dienst die u gebruikt
- Het unieke referentienummer van het verstuurde bericht
- Datum en tijdstip waarop u het bericht verstuurd hebt
- Uw analyse of die van uw softwareleverancier (voor zover aanwezig)
Specifieke informatie foutmeldingen LV-WOZ
- Een omschrijving van foutmeldingen en foutcodes voor de LV-WOZ vindt u in het Overzicht van Controles en Foutcodes op de website van de waarderingskamer.nl.
- De specifieke opbouw van LV-WOZ foutberichten vindt u in het koppelvlak LV-WOZ – versie: 3.12 (20260116) op de website van de waarderingskamer.nl.
Technisch gebruik foutberichten volgens de StUF-standaard
De LV-WOZ houdt zich aan de berichtenstandaard: Standaard Uitwisseling Formaat (StUF). Informatie over het gebruik van foutberichten in het kader van deze standaard vindt u in het document Standaard Uitwisseling Formaat – StUF 03.01 op vng-realisatie.github.io.
Paragraaf 4.4.3 op pagina 48 van dit document omschrijft de regels voor foutberichten in de StUF standaard. In tabel 8.1 op pagina 131 vindt u een samenvatting van algemene StUF foutmeldingen.
Uw CPA kunt u aanvragen via het CPA-register op de website van cparegister.nl. Kies bij het aanmaken de juiste specificatie en geef aan welk type Digikoppeling u gebruikt: internet of Diginetwerk.
Productie-omgeving
- Kadaster_WOZ0312_Mutatie_INET
- Kadaster_WOZ0312_Mutatie_DIGINET
Hebt u uw CPA aangevraagd? Geef uw verzoek dan aan ons door via het formulier Aanmelden LV-WOZ. Onze medewerkers halen het CPA uit het CPA-register dus die hoeft u niet bij te voegen.
Bovenstaande werkwijze is alleen van toepassing als uw OIN niet wijzigt.
Het PKIO-certificaat maakt onderdeel uit van uw communicatie met diensten van de LV-WOZ. Oorzaken voor het wijzigen van uw PKIO-certificaat zijn:
- uw OIN wijzigt
- uw PKIO-certificaat verloopt
Of er vervolgstappen nodig zijn, leest u hierna.
Uw OIN wijzigt
Bij vraag en antwoord op deze pagina leest u ‘Wat u moet doen als uw OIN wijzigt’.
Uw PKIO-certificaat verloopt
Vraagt u een nieuw PKIO- certificaat aan omdat het oude verlopen is? Let er dan op dat voor de diensten Mutatieverwerking bronhouders, Individuele bevraging, Massale bevraging, WOZ Terugmeldingen en WOZ API Bevragen een PKIO-certificaat onder de root Staat der Nederlanden Private Root CA-G1 gebruikt moet worden. Naast uw OIN, controleren wij op dit kenmerk in het PKIO-certificaat op het moment dat u een bericht aanbiedt bij de LV-WOZ.
Het PKIO-certificaat in uw CPA
Voor de diensten Mutatieverwerking bronhouders en Massale bevraging maakt uw PKIO-certificaat ook onderdeel uit van uw CPA. Uw CPA met het oude PKIO-certificaat hoeft niet altijd vervangen te worden. Voor het systeem van de LV-WOZ hoeft het oude en het nieuwe PKIO-certificaat niet overeen te komen. Belangrijk is wel dat:
- het OIN in het nieuwe PKIO-certificaat gelijk is aan die in het oude PKIO-certificaat
- de einddatum van het CPA niet overschreden is
- dezelfde CPA’s, met hetzelfde CPA-ID, actief zijn in uw systeem en het systeem van de LV-WOZ
Bespreek met uw software- of Digikoppeling-leverancier of uw systeem met dezelfde instellingen om kan gaan. Moet uw CPA toch vervangen worden, dan leest u bij vraag en antwoord op deze pagina meer over dit proces.
Het publieke deel van uw PKIO-certificaat
De LV-WOZ werkt niet met het publieke deel van uw PKIO-certificaat, deze hoeft u niet in te sturen.
Naast de LV-WOZ maken verschillende landelijke voorzieningen en diensten van het Kadaster gebruik van hetzelfde OIN. Denk aan de LV-BAG, de BRK-PB en de diensten BRK Levering en GDS2 afgifteservice van het Kadaster.
Wij koppelen uw OIN aan uw klantnummer. Er kan maximaal 1 OIN aan 1 klantnummer worden gekoppeld dus het is niet mogelijk om uw oude OIN tijdelijk naast uw nieuwe OIN te laten bestaan. Daarnaast is het noodzakelijk dat alle landelijke voorzieningen en diensten op hetzelfde moment gebruikmaken van het nieuwe OIN.
Neem tijdig contact op
Wijzigt uw OIN? Informeer ons dan op tijd. U kunt hiervoor gebruikmaken van het contactformulier WOZ.
Vermeld in ieder geval:
- uw klantnummer
- uw oude OIN
- uw nieuwe OIN
- op welke datum u uw OIN wilt wijzigen
Voor de LV-WOZ zult u een nieuw CPA moeten aanleveren waarin het nieuwe PKIoverheid-certificaat met het nieuwe OIN is verwerkt. Meer informatie hierover vindt u bij de vraag 'Hoe kunt u een CPA aanvragen en laten inlezen bij de LV-WOZ?'
Wij informeren u over releases, storingen en onderhoudswerkzaamheden van de Landelijke Voorziening WOZ op de de WOZ servicepagina.
Neem contact op met de klantenservice WOZ. Onze klantenservice is bereikbaar op werkdagen tussen 9.00 en 17.00 uur via:
- telefoonnummer 088 - 183 43 00
- het contactformulier van klantenservice WOZ
- de chat via de knop ‘Vragen? Start een chat’