Lettera di controllo NIE
A X1234567 corrisponde la lettera di controllo L, quindi il NIE completo è X1234567L. Inserisca il prefisso e le sette cifre per completare il numero di uno straniero, oppure incolli un NIE intero per verificarne la lettera prima di un contratto o di una busta paga. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Numero
- X1234567
- Modalità di calcolo
- Compute
- Input
- X1234567
- Prefisso
- X
- Cifra del prefisso
- 0
Il NIE spagnolo (Número de Identidad de Extranjero) è il numero di identità per gli stranieri usato nei flussi fiscali, bancari, lavorativi e di residenza in Spagna. A differenza di una semplice stringa di cifre, ogni NIE inizia con X, Y o Z, prosegue con sette cifre e termina con una lettera di controllo che dimostra che il corpo è stato digitato o memorizzato senza un errore comune. Questa capacità implementa la mappatura ufficiale e la regola mod-23 condivisa con le lettere di controllo del DNI: sostituisca 0 a X, 1 a Y o 2 a Z, tratti il risultato come intero a otto cifre, prenda tale intero modulo 23 e cerchi la lettera nella tabella fissa TRWAGMYFPDXBNJZSQVHLCKE. Usi la modalità compute quando dispone solo del prefisso e delle sette cifre e le serve la lettera finale corretta per un modulo o un’importazione di anagrafiche; usi la modalità validate quando un partner, un CRM o un utente invia un NIE completo e le serve un flag valid chiaro più la lettera di controllo attesa per i messaggi di errore.
Come si calcola la lettera di controllo del NIE spagnolo
Un NIE spagnolo ha sempre nove caratteri quando è scritto senza spazi o trattini: una lettera iniziale dell’insieme X, Y, Z; sette cifre decimali; e una lettera di controllo finale da A a Z (non compaiono tutte le lettere — la tabella ha ventitré posizioni). La lettera iniziale non è decorativa. Storicamente X, Y e Z segnano intervalli successivi di numeri assegnati ai residenti stranieri; per la formula della lettera di controllo vengono riscritte come cifre così da riusare la stessa tabella del DNI.
Mappi X a zero, Y a uno e Z a due, poi concateni quella cifra con i sette caratteri numerici per formare una stringa di otto cifre come 01234567 per il corpo classico X1234567. Interpreti quella stringa come intero (gli zeri iniziali non cambiano il valore modulare) e calcoli il resto della divisione per ventitré. Indici nella sequenza ufficiale T, R, W, A, G, M, Y, F, P, D, X, B, N, J, Z, S, Q, V, H, L, C, K, E usando quel resto come indice basato su zero.
La lettera a quell’indice è l’unica lettera di controllo valida per quel corpo. Esempio: X1234567 si mappa su 01234567, resto diciannove, lettera di controllo L, NIE completo X1234567L. L’algoritmo è deterministico e locale: nessuna chiamata di rete al governo spagnolo, nessuna consultazione di registro e nessun orologio.
Dove i controlli della lettera NIE si inseriscono nei flussi reali
I team HR e payroll inseriscono dipendenti non spagnoli e devono allegare la lettera di controllo NIE corretta prima di scrivere l’identificativo su contratti, dichiarazioni di previdenza o file di pagamento bancario che rifiutano ID fiscali non validi. I moduli di registrazione immobiliari, bancari e telecom convalidano un NIE completo di nove caratteri alla creazione dell’account così una sola lettera digitata male non crea un cliente fantasma né uno scarto di conformità.
I job di qualità dei dati percorrono ogni colonna NIE in un export CRM o ERP, chiamano la modalità validate e mettono in quarantena le righe dove valid è false, catturando sia modifiche umane sia bug di generatori che confondono i corpi solo numerici del DNI con le regole di prefisso del NIE.
Non tratti una lettera NIE corretta come prova di residenza attiva presso le autorità spagnole né di un permesso di lavoro specifico; dimostra solo che la lettera di controllo è coerente con il corpo a otto cifre mappato secondo la tabella standard mod-23.
Casi d'uso
Revisionare colonne NIE in export CRM e ERP
Convalidi in batch ogni NIE spagnolo in un file clienti o dipendenti e metta in quarantena le righe la cui lettera di controllo non corrisponde più al valore atteso ricalcolato.
Domande frequenti
Cos’è la lettera di controllo di un NIE spagnolo?
È l’ultimo carattere di un NIE a nove caratteri. Dopo aver mappato la X, Y o Z iniziale a 0, 1 o 2, il valore a otto cifre modulo 23 indica nella tabella ufficiale TRWAGMYFPDXBNJZSQVHLCKE quella lettera.
Cosa succede con lunghezza errata, prefisso sbagliato o punteggiatura?
Un NIE ben formato con lettera sbagliata restituisce valid false in modalità validate. Le attività di convalida fallite non vengono fatturate.
Lo strumento della lettera di controllo del NIE spagnolo è gratuito?
Lo strumento nel browser è gratuito e gira in locale.
Come si calcola la lettera di controllo del NIE?
Si sostituisce la X con 0, la Y con 1 o la Z con 2, si divide il numero di otto cifre per 23 e il resto indica la lettera nella tabella TRWAGMYFPDXBNJZSQVHLCKE. Per X1234567 il resto è 19 e la lettera è L.
La lettera del NIE si calcola come quella del DNI?
Sì, con la stessa tabella di 23 lettere e la stessa divisione del DNI spagnolo. L'unica differenza è che la lettera iniziale X, Y o Z viene prima trasformata in 0, 1 o 2.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/enc/nie-spain \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"X1234567"}'const res = await fetch("https://api.kit.forhosting.com/enc/nie-spain", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "X1234567"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/nie-spain",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "X1234567"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/nie-spain", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"X1234567"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"X1234567"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/nie-spain", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"number": "X1234567"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nie_spain",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
L’input malformato fallisce con invalid_input invece di una pulizia silenziosa, così non memorizza mai un ID straniero a metà. La stessa aritmetica pura gira gratis nel browser e al prezzo pubblicato dell’API.
Contratto di input, modalità e comportamento in caso di errore
Invii un campo number con il corpo del NIE. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata — otto per compute, nove per validate — così i moduli client possono mostrare un messaggio preciso senza indovinare. Stringhe vuote, number mancante, valori di mode non validi, prefissi diversi da X Y Z, parti centrali non numeriche e finali non letterali falliscono prima che un risultato modulare sia affidato allo storage e non vengono fatturati. Preferisca compute quando completa identificativi di stranieri per i moduli; preferisca validate quando subordina una ricerca o un’importazione a un NIE completo da un utente o da un file partner. Spazi e trattini vengono rimossi così forme comuni come X-1234567-L vengono ancora analizzate; punti, barre e altra punteggiatura sono rifiutati come input malformato con invalid_input, affinché un valore pulito in silenzio non arrivi mai allo storage. La modalità compute è predefinita: il motore richiede esattamente otto caratteri dopo la normalizzazione — prefisso X, Y o Z più sette cifre — e restituisce control_letter, la stringa nie completa con la lettera aggiunta, prefix_digit (0, 1 o 2), mapped_number e remainder. La modalità validate richiede esattamente nove caratteri inclusa la lettera di controllo finale; la risposta riporta valid true quando quella lettera coincide con expected_control_letter ricalcolata, e valid false quando il corpo è ben formato ma la lettera è sbagliata. Validate restituisce sempre il control_letter fornito, expected_control_letter, prefix, digits, mapped_number, remainder e il nie corretto costruito con la lettera attesa. Alias come nie, text, value, code, id e n sono accettati per lo stesso campo di payload, così le integrazioni che già parlano di nie non devono rinominarlo. Poiché il percorso è parse puro senza orologio, sorgente casuale o rete, lo stesso corpo JSON produce sempre lo stesso risultato JSON sullo strumento gratuito del browser e sull’API a $0.002 per richiesta riuscita.
Dove i controlli della lettera NIE si inseriscono nei flussi reali
Le piattaforme di immigrazione e ricollocamento ricalcolano expected_control_letter e mostrano una correzione amichevole quando un richiedente incolla un numero con carattere finale errato.
Casi di integrazione
Completare un corpo NIE per payroll e contratti
Chiami la modalità compute con X/Y/Z più sette cifre, memorizzi il nie restituito con control_letter e alimenti l’identificativo completo nei sistemi HR, fiscali o bancari.
Convalidare NIE completi digitati o importati in ingresso
Quando un modulo o un CSV invia nove caratteri, chiami la modalità validate e blocchi il salvataggio se valid è false, mostrando expected_control_letter per correggere un solo errore di battitura.
Domande tecniche
Come calcolo la lettera di controllo del NIE spagnolo con questa API?
Invii un POST con number uguale al prefisso più sette cifre (ad esempio X1234567) e mode compute (oppure ometta mode). La risposta include control_letter, nie (nove caratteri completi), prefix_digit, mapped_number e remainder.
Come convalidare un NIE spagnolo completo?
Invii un POST con il NIE a nove caratteri e mode validate. La risposta include valid, control_letter (fornita), expected_control_letter, prefix, digits, mapped_number, remainder e nie costruito con la lettera attesa.