nif.mod11
NIF portoghese — algoritmo Mod-11 e prefissi
Codice fiscale portoghese a 9 cifre; cifra di controllo calcolata tramite Mod-11 con pesi 9..2.
Cos'è un NIF
Un NIF (Número de Identificação Fiscal) è il codice fiscale portoghese a 9 cifre emesso dall'AT a persone fisiche, aziende e altre entità. I file SAF-T fanno riferimento ai NIF in tre punti obbligatori: Header.TaxRegistrationNumber, ogni Customer.CustomerTaxID e ogni Supplier.SupplierTaxID.
L'algoritmo Mod-11
La nona cifra è una cifra di controllo calcolata a partire dalle prime otto:
- Moltiplica la cifra 1 per 9, la cifra 2 per 8, …, la cifra 8 per 2.
- Somma i prodotti.
- Calcola il resto della divisione per 11.
- Se il risultato è 0 o 1, la cifra di controllo è 0.
- Altrimenti la cifra di controllo è 11 − risultato.
# Esempio: 503504564
# cifre 5 0 3 5 0 4 5 6
# pesi 9 8 7 6 5 4 3 2
# prodotti 45 0 21 30 0 16 15 12 → somma 139
# 139 mod 11 = 7
# 11 - 7 = 4
# controllo = 4 → corrisponde alla cifra 9 ✓
Prime cifre ammesse
| Intervallo | Usato da |
|---|---|
| 1, 2, 3 | Persone fisiche (residenti) |
| 5 | Aziende (LDA, SA, ecc.) |
| 6 | Pubblica amministrazione |
| 8 | Empresário em Nome Individual (ENI, ditte individuali) |
| 9 | Altre entità |
| 45, 70-79, 90, 91, 98, 99 | Casi specifici (es. eredità, condominio, residente all'estero) |
Casi particolari
999999990è il placeholder riservato dall'AT per "Consumidor final" (acquirente al dettaglio anonimo). È ammesso inCustomer.CustomerTaxIDper fatture di tipo retail.- Qualsiasi NIF che fallisce Mod-11 viene rifiutato, anche se le cifre sembrano plausibili.
Come correggere
La correzione dipende da quale lato ha la cifra sbagliata:
- Header.TaxRegistrationNumber sbagliato — il tuo stesso NIF è mal configurato nell'ERP. Aggiorna il profilo aziendale e riesporta — oppure, se ti serve solo spedire questo file, usa l'editor inline per correggere il valore sul posto.
- NIF di Cliente o Fornitore sbagliato — errore di battitura o record obsoleto. Correggilo nei dati anagrafici e riesporta — oppure correggi l'occorrenza problematica con l'editor inline quando riesportare non è un'opzione.
SAFTCheck non inventa mai un NIF; l'editor inline applica solo il valore che tu fornisci. Non suggeriamo automaticamente codici fiscali.
Correlato
- Formato ATCUD — il codice univoco a livello di documento, separato dai NIF.
- Editor inline — correggi un NIF sul posto quando hai il valore corretto.