Calcolo e verifica della cifra di controllo del NIF portoghese

Inserisca le prime otto cifre per calcolare la nona, oppure invii tutte le nove cifre per verificare che quella fornita corrisponda al calcolo. Il risultato è deterministico e immediato, quindi adatto a moduli, importazioni, procedure contabili e convalide tramite API. Lunghezze errate, caratteri non numerici e modalità non supportate vengono segnalati chiaramente, senza correzioni o interpretazioni silenziose.

Scelga se calcolare o convalidare

Usi la modalità di calcolo quando dispone già della base di otto cifre di un NIF portoghese e deve ricavare la cifra di controllo finale. La risposta comprende la cifra calcolata e il valore completo di nove cifre, così può inserirlo direttamente in una successiva procedura di convalida o collaudo. Usi la modalità di convalida quando la fonte contiene già tutte le nove cifre. Il controllo separa le prime otto dalla nona fornita, calcola il valore previsto e comunica se i due coincidono. Restituisce anche le cifre fornita e prevista, facilitando la diagnosi di un esito negativo. Mantenga l’input come stringa e non come valore numerico. Una stringa conserva esattamente ogni carattere, compreso un eventuale zero iniziale, ed evita che la formattazione numerica di un foglio di calcolo o di un linguaggio alteri l’identificativo prima della verifica. La modalità predefinita è la convalida, ma è opportuno indicarla esplicitamente quando un processo può gestire entrambi i formati.

Come funziona il calcolo modulo undici

L’algoritmo elabora le prime otto cifre da sinistra a destra con pesi decrescenti da nove a due. Moltiplica la prima cifra per nove, la seconda per otto e prosegue fino a moltiplicare l’ottava per due. Gli otto prodotti vengono sommati e il totale viene ridotto modulo undici. Se il resto è zero o uno, la cifra di controllo è zero. Per qualsiasi altro resto, la cifra equivale a undici meno tale resto. La convalida esegue esattamente lo stesso calcolo sulle prime otto posizioni e confronta il risultato con la nona. Questa capacità non elimina spazi, punti, trattini, prefissi nazionali o etichette prima del calcolo. Tale rigidità è intenzionale: una pulizia automatica potrebbe far apparire affidabili dati malformati e nascondere errori nella precedente mappatura dei campi. Invii esclusivamente cifre ASCII da zero a nove. Il calcolo non usa rete, valori casuali, orologio, database o conversioni dipendenti dalle impostazioni locali; pertanto, input e modalità identici producono sempre la stessa risposta JSON.

Interpreti il risultato e i suoi limiti

Un risultato di convalida vero significa che la nona cifra è coerente con il checksum modulo undici ricavato dalle otto precedenti. È un controllo strutturale utile per errori di digitazione, importazioni danneggiate e colonne associate in modo errato, ma non dimostra che il numero sia stato emesso, sia ancora attivo o appartenga a una determinata persona od organizzazione. Per tali verifiche serve un registro autorevole o un processo aziendale appropriato. Analogamente, il calcolatore valuta deliberatamente il checksum senza imporre ipotesi sulle categorie codificate nella prima cifra. In questo modo mantiene un ambito preciso ed evita di rifiutare un numero con checksum valido solo perché cambia una regola esterna di assegnazione. In una pipeline distingua gli errori di input da un risultato falso: un errore indica tipo, lunghezza, caratteri o modalità errati; falso indica che un valore ben formato è stato controllato ma la cifra non coincide. Ogni richiesta API costa $0.002, e lo stesso nucleo deterministico può funzionare nel browser.