Verificatore NTN

Il Verificatore NTN valida la struttura sintattica dei NTN nazionali utilizzati dalle autorità fiscali e dai registri delle imprese. Si rivolge a commercialisti, esperti di payroll, responsabili conformità e team di onboarding, offrendo controlli rapidi prima dell'inserimento, della creazione di fornitori o della rendicontazione fiscale. Lo strumento supporta più giurisdizioni tramite un parametro country_code e restituisce un NTN canonical formattato, un flag di validità booleano e un messaggio leggibile. Progettato per l'integrazione in pipeline di data cleansing e flussi ERP/CRM, garantisce identificatori coerenti tra sistemi. Applica espressioni regolari di formato specifiche per paese e vincoli di lunghezza, seguiti da un controllo checksum opzionale se definito dalla giurisdizione. In assenza di una regola paese con checksum, vengono eseguiti solo controlli di sintassi. Le uscite sono deterministiche: valido indica esito positivo o negativo, formatted_ntn mostra una rappresentazione canonica e validation_message spiega il risultato. L'approccio evita ricerche esterne e si concentra sulla correttezza strutturale. Gestisce spazi, separatori localizzati e caratteri vietati all'inizio/fine. Restituisce false se mancano input, codici paese non supportati o input con caratteri vietati. Se sono necessarie fonti esterne, lo strumento segnala la dipendenza e fornisce un messaggio informativo per l'integrazione a monte. Si allinea con pratiche regionali degli identificatori fiscali e standard internazionali di data-cleaning. Avvia con PK come esempio primario ed è progettato per aggiungere altre giurisdizioni, mantenendo messaggi di errore neutri per paesi non supportati. Si presume che l'input sia solo per la validazione del formato; non garantisce validità legale o iscrizione attiva. Esclude verifica governativa in tempo reale, elaborazione batch oltre le capacità di esportazione attuali e considerazioni legate all'UI.