Gestandaardiseerde vraag ID's voor identificatie en adressering

Wanneer je gebruik maakt van invulvelden om contactinformatie te verzamelen van je contacten gebruik je vaste vraag ID’s. De vraag ID is steeds een combinatie van een aantal onderdelen:

De vraag ID wordt samengesteld door de hoedanigheid, het type, het volgnummer een het vraagveld aan elkaar te koppelen door gebruik te maken van een _ (underscore): hoedanigheid_type_volgnummer_vraagveld.

Bijvoorbeeld:

person_requester_1_identity_number
company_customer_1_legal_name
company_person_requester_1_last_name

Hoedanigheid

De hoedanigheid bepaalt of het om een persoon, een bedrijf, een organisatie een persoon binnen een bedrijf of een persoon binnen een organisatie gaat.

Hoedanigheid	Betekenis
person	De informatie hoort bij een persoon (burger / particulier)
company	De informatie hoort bij een onderneming.
company_person	De informatie hoort bij een persoon die in naam van een onderneming handelt.
organization	De persoon hoort bij een vereniging of een organisatie.
organization_person	De informatie hoort bij een persoon die in naam van een vereniging of organisatie handelt.

Type

Het type bepaalt of het om de aanvrager, de ontvanger, de veroorzaker of een derde gaat.

Type	Betekenis
requester	De persoon, onderneming, vereniging of organisatie is de aanvrager.
causer	De persoon, onderneming, vereniging of organisatie is de veroorzaker.
internal_service	De persoon, onderneming, vereniging of organisatie is een interne medewerker of dienst. Dit type wordt vooral gebruikt om de ontvanger van een inkomend contactmoment te registreren.
customer	De persoon, onderneming, vereniging of organisatie is in een derde.

Volgnummer

Het volgnummer is de numerieke aanduiding die je gebruikt om meerdere contacten van dezelfde hoedanigheid en hetzelfde type te registreren.

Bijvoorbeeld

person_requester_1
person_requester_2
person_requester_3
...

Hoewel de samengestelde vraag ID achterliggend automatisch het volgnummer 1 krijgt wanneer je geen volgnummer gebruikt, raden we aan steeds een volgnummer in je vraag ID op te nemen.

Vaste vraagvelden

De specifieke informatie die je wilt vragen.

Persoonsgegevens

Onderstaande vraagvelden kan je enkel gebruiken in combinatie met person, company_person of organization_person.

Vraagveld	Betekenis
identity_number	Het rijksregisternummer. De ingave in dit veld moet een correct rijksregisternummer zijn.
title	De aanspreektitel (mr + mvr) Maak hiervoor gebruik van een keuzelijst of radiobuttons waarbij je de waarden mr en mvr gebruikt.
last_name	De naam
first_name	De voornaam
date_of_birth	De geboortedatum
place_of_birth	De geboorteplaats
gender	Het geslacht. Maak hiervoor gebruik van een keuzelijst of radiobuttons waarbij je de waarden MALE en FEMALE gebruikt.
nationality_choice	De nationaliteit
profession	Het beroep
oca_context

Gegevens van de onderneming/vereniging/organisatie

Onderstaande vraagvelden kan je enkel gebruiken in combinatie met company of organization.

Vraagveld	Betekenis
kbo_number	Het KBO-nummer. De ingave in dit veld moet een correct KBO-nummer zijn.
organization_number	Het verenigingsnummer
vat	Het BTW-nummer
legal_name	De naam
department	De afdeling

Gegevens van de persoon in de onderneming/vereniging/organisatie

Onderstaande vraagvelden kan je enkel gebruiken in combinatie met company_person of organization_person.

Vraagveld	Betekenis
function	De functie

Adres- en contactgegevens

Onderstaande vraagvelden kunnen gebruikt worden in combinatie met alle hoedanigheden.

Vraagveld	Betekenis
address	Het volledige adres, bij gebruik van het adreselement
street_name	De straat
house_number	Het huisnummer
locator	Het busnummer
zip_code	De postcode
city	De gemeente
country	Het land
phone_number	Het telefoonnummer
mobile_number	Het mobiel nummer
fax	Het faxnummer
email	Het e-mailadres
website	De url van de website

Consents

Onderstaande velden kunnen gebruikt worden om een consent op te slaan

Vraagveld	Betekenis
consent_contactgegevens_lokaal	Een consent voor hergebruik van de gegevens bij volgende aanvragen
consent_contactgegevens_rijksregister	Een consent voor synchronisatie van contactgegevens naar het rijksregister

Variabele vraagvelden

Naast de vaste vraagvelden kan je eender welk variabel vraagveld gebruiken om informatie over een contact te registeren. Zo kan je schoenmaat bijvoorbeeld registreren als person_requester_1_shoesize. In het kader van de GDPR raden wij aan deze regel altijd toepassen. Zo kan je eenvoudig informatie van een contact ophalen en gegevens van zaken anonimiseren of gegevens van contactmomenten anonimiseren.