📖 Introductie
De VAT Helper bevat functionaliteit voor het valideren van Europese BTW-nummers (VAT). De validatie wordt server-side uitgevoerd via een Dataverse Custom API.
👉 Deze helper zorgt voor betrouwbare en land-specifiek correcte BTW-validatie.
⚠️ Deze helper is afhankelijk van een Custom API en werkt niet zonder server-side validatie.
📦 Functionaliteit
✅ Validatie
-
isValid(value, country) → valideert BTW-nummer (async)
⚙️ Werking
De VAT Helper valideert BTW-nummers via een server-side Custom API.
👉 Werkwijze:
- Input wordt gecontroleerd (nummer + landcode)
- Request wordt verstuurd naar Custom API
- API valideert het BTW-nummer
- Resultaat wordt teruggegeven aan de client
Resultaten
-
true → geldig BTW-nummer
-
false → ongeldig BTW-nummer
-
null → fout tijdens API call
🔌 Custom API
brenke_tax
Parameters
| Naam |
Omschrijving |
| brenke_tax_country |
Landcode (bijv. NL, DE, FR) |
| brenke_tax_number |
BTW-nummer |
| brenke_tax_operation |
Type operatie (ISVALID) |
Response
| Field |
Omschrijving |
| brenke_tax_isvalid |
Boolean validatie resultaat |
⚠️ Belangrijke aandachtspunten
- Functie is async → gebruik altijd
await
- Validatie gebeurt server-side (betrouwbaarder dan client-side regex)
- Country is verplicht → zonder landcode geen validatie
- Bij errors wordt
null geretourneerd
⚠️ Elke validatie is een netwerk call → gebruik alleen wanneer nodig (performance).
💡 Voorbeeld
const valid = await core.VAT.isValid("NL123456789B01", "NL");
// true / false / null
📊 Samenvatting
✅ BTW-validatie per land
✅ Server-side betrouwbaarheid
✅ Consistente validatieresultaten
✅ Integratie via Custom API