...
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:
| Table of Contents |
|---|
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) |
| last_name | De naam |
| first_name | De voornaam |
| date_of_birth | De geboortedatum |
| place_of_birth | De geboorteplaats |
| gender | Het geslacht. |
| 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 |
| 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.