Terug naar vorige pagina

WOZ API Huidige Bevragingen

Rechtstreekse koppeling voor gemeentelijke WOZ processen

Actuele gegevens

De WOZ API Huidige Bevragingen is een rechtstreekse koppeling voor gemeentelijke WOZ processen op de  LV-WOZ. Met de WOZ API Huidige Bevragingen kunt u actuele gegevens in de LV-WOZ bevragen.

Ontwikkeld vanuit gebruikerswensen gemeenten

Gebruikerswensen van de gemeenten vormen het uitgangspunt van deze API. De WOZ API Huidige Bevragingen is een Haal Centraal API die samen met VNG Realisatie is ontwikkeld vanuit de Common Ground gedachte.

De WOZ API Huidige Bevragingen is  alleen beschikbaar voor gemeenten. Opgevraagde informatie mag alleen gebruikt worden voor het heffen van belastingen. Wilt u meer dan alleen huidige bevragingen? Dit is mogelijk met WOZ Individuele bevragingen.

WOZ API Huidige Bevragingen

gratis

U ontvangt het volgende:

  • near realtime actuele data
  • RESTful API die data uitlevert in JSON formaat
  • Haal Centraal API

Vraag toegang aan

Beperkingen gebruik WOZ API Huidige Bevragingen  

Er zijn enkele beperkingen aan het gebruik van de WOZ API Huidige Bevragingen. Deze API is alleen beschikbaar voor gemeenten en zij mogen de opgevraagde informatie alleen gebruiken voor het heffen van belasting binnen de eigen gemeente.  Daarnaast kan op dit moment alleen actuele informatie van een WOZ-object opgevraagd worden. Hierbij is het aantal bevragingen beperkt tot 35 vragen per minuut en maximaal 10.000 bevragingen per dag. 

Actief OIN en PKIO certificaat

Voor het gebruik van de WOZ API Huidige Bevragingen is een actief Organisatie Identificatienummer (OIN) en PKIO-certificaat verplicht. Meer informatie over OIN en het PKIO-certificaat kunt u vinden op PKIoverheid op de website van Logius.
Hebt u nog geen geldig OIN (of een HRN)? Kijk dan op Digikoppeling op de website van Logius.

Technische documentatie WOZ API Huidige Bevragingen

De technische documentatie voor de implementatie van de WOZ API Huidige Bevragingen vindt u op de GitHub van VNG-Realisatie. Voor specifieke informatie over het ontwikkelen van een aansluiting vindt u hier een link naar de pagina Getting Started.

Vraag en antwoord

API staat voor Application Programming Interface. Met een API kan een computerprogramma communiceren met een ander programma of onderdelen ervan. Zo kunt u een database of programma bevragen. Vergelijk het met een digitale stekkerdoos die externe partijen toegang geeft tot interne gegevens. Past uw stekker niet, dan hebt u geen toegang. Wij maken voor u een API, oftewel een passende stekker, aan. 

Het programma Haal Centraal heeft API’s ontwikkeld waarmee gemeenten basisgegevens rechtstreeks bij de landelijke registraties kunnen bevragen. Het Kadaster biedt de volgende Haal Centraal API’s waarop gemeenten kunnen aansluiten:   

Lees meer over Haal Centraal op de website van VNG.

De WOZ API Huidige Bevragingen is  alleen beschikbaar voor gemeenten. Opgevraagde informatie mag alleen gebruikt worden voor het heffen van belastingen. 

Ontwikkelt u een client applicatie en wilt u testen of de code correct is? Dan kunt u gebruikmaken van de testomgeving (ETO).

U vraagt toegang aan voor de WOZ API Huidige Bevragingen met het WOZ aanvraagformulier

Met de WOZ API Huidige Bevragingen kunnen bronhouders van de LV-WOZ gratis een beperkt aantal bevragingen doen voor het doel van heffen van belastingen binnen de gemeente. Het aantal bevragingen is hierin beperkt tot 10.000 per dag. Ook kunt u geen massale bevragingen met meerdere objecten doen.

De WOZ API Huidige Bevragingen is ontwikkeld op basis van de gebruikerswensen van gemeenten. Dit is in lijn met het programma Haal Centraal.
Bij de ontwikkeling van de API zijn keuzes gemaakt die de implementatie voor gemeenten eenvoudiger maken. Zo hebben gemeenten alleen behoefte aan huidige gegevens.

Met WOZ Individuele Bevragingen kunt u ook de historie opvragen, inclusief alle gegevens die in de LV-WOZ bekend zijn. Bij de ontwikkeling van de WOZ Individuele Bevragingen is geen rekening gehouden met specifieke gebruikerswensen.

Ga voor meer informatie naar de pagina WOZ Individuele Bevragingen.

In de LV-WOZ wordt van alle objecten de historie bewaart. Met de API ontvangt u alleen de huidige, actuele gegevens.

Als een wijziging wordt doorgevoerd in de LV-WOZ, is deze meteen beschikbaar in de WOZ API Huidige Bevragingen.

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 hieronder.

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 Huidige Bevragingen 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 gebruik  maken van het nieuwe OIN. 

Neem tijdig contact op

Als uw OIN wijzigt, adviseren wij u ons hierover tijdig te infomeren. U kunt hiervoor gebruik maken 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.

Hebt u een vraag waarop u het antwoord niet kon vinden? Neem dan contact op met de klantenservice WOZ op telefoonnummer 088 - 183 43 00. Onze medewerkers zijn u op werkdagen van 9.00 tot 17.00 uur graag van dienst. Of stel uw vraag direct via het contactformulier.

Handige link

Onderdeel van Haal Centraal

Het programma Haal Centraal heeft API’s ontwikkeld, waarmee gemeenten basisgegevens rechtstreeks bij landelijke registraties (BAG, BRK en WOZ) kunnen bevragen. Alle gemeenten kunnen op deze API's aansluiten.