NTN-controleur

NTN-controleur controleert de syntactische structuur van Nationale NTN-nummers gebruikt door belastingautoriteiten en handelsregisters. Het is bedoeld voor accountants, salarisadministratie en compliance-teams en levert snelle controles vóór invoer, leverancierscreatie of aangifte. Het hulpmiddel ondersteunt meerdere rechtsgebieden via een country_code-parameter en geeft een canoniek geformatteerde NTN, een booleaanse geldigheids-indicator en een leesbaar bericht. Het is ontworpen voor integratie in data-cleaning pipelines en ERP- of CRM-workflows, zodat identificeerders consistent blijven tussen systemen. De tool past land-specifieke formaat-regex en lengtebeperkingen toe, gevolgd door optionele checksum-checks indien door de jurisdictie gedefinieerd. Als geen landregel een checksum definieert, worden alleen syntaxiscontroles toegepast. De outputs zijn deterministisch: geldig betekent pass/fail, formatted_ntn toont canonieke representatie (bijv. gegroepeerde tekens) en validation_message licht het resultaat toe. De aanpak vermijdt externe lookup en richt zich op structurele correctheid. Omgaan met spaties, gelokaliseerde scheidingstekens en per ongeluk voor-/nascheidingstekens. Geeft false terug bij ontbrekende invoer, niet-ondersteunde landcodes of invoer met verboden tekens. Als externe data vereist is, markeert de tool de afhankelijkheid en levert een informatief bericht voor upstream-integratie. Sluit aan bij regionale praktijken van belastingidentificatoren en internationale data-cleansing-standaarden. Begint met PK als primair voorbeeld en is ontworpen om aanvullende jurisdicties toe te voegen, met neutrale foutmeldingen voor niet-ondersteunde landen. Er wordt verondersteld dat invoer uitsluitend bedoeld is voor formatvalidatie; geen juridische geldigheid of actief inschrijving. Sluit realtime overheid-verificatie, batchverwerking buiten huidige exportmogelijkheden en UI-gerelateerde overwegingen uit.