Lettre de contrôle NIE
Pour X1234567, la lettre de contrôle est L : le NIE complet s'écrit donc X1234567L. Saisissez le préfixe et les sept chiffres pour compléter le numéro d'un étranger, ou collez un NIE entier pour vérifier sa lettre avant un contrat ou une paie. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Nombre
- X1234567
- Mode de calcul
- Compute
- Entrée
- X1234567
- Préfixe
- X
- Chiffre du préfixe
- 0
Le NIE espagnol (Número de Identidad de Extranjero) est le numéro d’identité des étrangers utilisé dans la fiscalité, la banque, l’emploi et la résidence en Espagne. Contrairement à une pure chaîne de chiffres, chaque NIE commence par X, Y ou Z, se poursuit par sept chiffres et se termine par une lettre de contrôle qui prouve que le corps a été saisi ou stocké sans erreur courante. Cette capacité met en œuvre le mapping officiel et la règle mod-23 partagée avec les lettres de contrôle du DNI : substituez 0 à X, 1 à Y ou 2 à Z, traitez le résultat comme un entier de huit chiffres, prenez cet entier modulo 23 et cherchez la lettre dans la table fixe TRWAGMYFPDXBNJZSQVHLCKE. Utilisez le mode compute lorsque vous ne disposez que du préfixe et des sept chiffres et que vous avez besoin de la lettre finale correcte pour un formulaire ou un import de données de référence ; utilisez le mode validate lorsqu’un partenaire, un CRM ou un utilisateur envoie un NIE complet et que vous avez besoin d’un indicateur valid clair plus la lettre de contrôle attendue pour les messages d’erreur.
Comment la lettre de contrôle du NIE espagnol est calculée
Un NIE espagnol compte toujours neuf caractères lorsqu’il est écrit sans espaces ni tirets : une lettre initiale de l’ensemble X, Y, Z ; sept chiffres décimaux ; et une lettre de contrôle finale de A à Z (toutes les lettres n’apparaissent pas — la table a vingt-trois positions). La lettre initiale n’est pas décorative.
Historiquement X, Y et Z marquent des plages successives de numéros attribués aux résidents étrangers ; pour la formule de la lettre de contrôle elles sont réécrites en chiffres afin de réutiliser la même table du DNI. Mappez X à zéro, Y à un et Z à deux, puis concaténez ce chiffre avec les sept caractères numériques pour former une chaîne de huit chiffres telle que 01234567 pour le corps classique X1234567.
Interprétez cette chaîne comme un entier (les zéros en tête ne changent pas la valeur modulaire) et calculez le reste de la division par vingt-trois. Indexez dans la séquence officielle T, R, W, A, G, M, Y, F, P, D, X, B, N, J, Z, S, Q, V, H, L, C, K, E en utilisant ce reste comme index basé sur zéro. La lettre à cet index est la seule lettre de contrôle valide pour ce corps.
Exemple : X1234567 se mappe sur 01234567, reste dix-neuf, lettre de contrôle L, NIE complet X1234567L. L’algorithme est déterministe et local : aucun appel réseau au gouvernement espagnol, aucune consultation de registre et aucune horloge. Cet outil ne confirme pas qu’une personne détient une carte de séjour active, n’étend pas les codes provinciaux et n’affirme pas qu’une somme de contrôle valide autorise le NIE pour un régime fiscal particulier — il prouve seulement que la lettre finale est cohérente avec la règle officielle mod-23.
Où les contrôles de lettre NIE s’intègrent dans les flux réels
Les équipes RH et paie intègrent des collaborateurs non espagnols et doivent joindre la lettre de contrôle NIE correcte avant d’écrire l’identifiant sur des contrats, des déclarations de sécurité sociale ou des fichiers de paiement bancaire qui rejettent les identifiants fiscaux invalides. Les formulaires d’inscription immobiliers, bancaires et télécoms valident un NIE complet de neuf caractères à la création du compte pour qu’une seule lettre mal saisie ne crée pas un client fantôme ni un écart de conformité.
Les tâches de qualité des données parcourent chaque colonne NIE d’un export CRM ou ERP, appellent le mode validate et mettent en quarantaine les lignes où valid est false — capturant à la fois les éditions humaines et les bugs de générateurs qui confondent les corps purement numériques du DNI avec les règles de préfixe du NIE.
Ne traitez pas une lettre NIE correcte comme preuve de résidence active auprès des autorités espagnoles ni d’un permis de travail spécifique ; elle prouve seulement que la lettre de contrôle est cohérente avec le corps de huit chiffres mappé selon la table standard mod-23.
Cas d’usage
Auditer les colonnes NIE dans les exports CRM et ERP
Validez par lot chaque NIE espagnol d’un fichier clients ou employés et mettez en quarantaine les lignes dont la lettre de contrôle ne correspond plus à la valeur attendue recalculée.
Questions fréquentes
Qu’est-ce que la lettre de contrôle d’un NIE espagnol ?
C’est le dernier caractère d’un NIE de neuf caractères. Après mapping du X, Y ou Z initial vers 0, 1 ou 2, la valeur de huit chiffres modulo 23 indexe la table officielle TRWAGMYFPDXBNJZSQVHLCKE pour produire cette lettre.
Que se passe-t-il en cas de longueur incorrecte, de mauvais préfixe ou de ponctuation ?
Un NIE bien formé avec une mauvaise lettre renvoie valid false en mode validate. Les tâches de validation en échec ne sont pas facturées.
Comment calcule-t-on la lettre de contrôle du NIE ?
On remplace X par 0, Y par 1 ou Z par 2, on divise le nombre de huit chiffres par 23 et le reste désigne la lettre dans la table TRWAGMYFPDXBNJZSQVHLCKE. Pour X1234567, le reste vaut 19 et la lettre est L.
La lettre du NIE se calcule-t-elle comme celle du DNI ?
Oui, avec la même table de 23 lettres et la même division que le DNI espagnol. Seule différence : la lettre initiale X, Y ou Z est d'abord convertie en 0, 1 ou 2.
Une lettre correcte prouve-t-elle que le NIE a été attribué ?
Non. Le contrôle montre seulement que la lettre correspond au préfixe et aux chiffres. L'outil n'interroge aucun service de l'administration espagnole ni aucun registre, il ne peut donc pas confirmer à qui appartient le numéro.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"number": "X1234567"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nie_spain",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Une entrée mal formée échoue avec invalid_input au lieu d’un nettoyage silencieux, afin que vous ne stockiez jamais un identifiant d’étranger à moitié nettoyé. La même arithmétique pure s’exécute gratuitement dans le navigateur et au prix publié de l’API.
Contrat d’entrée, modes et comportement en cas d’erreur
Envoyez un champ number avec le corps du NIE. Une longueur incorrecte est une erreur explicite qui nomme le mode et la longueur envoyée — huit pour compute, neuf pour validate — afin que les formulaires clients affichent un message précis sans deviner. Chaînes vides, number manquant, valeurs de mode invalides, préfixes autres que X Y Z, milieux non numériques et fins non alphabétiques échouent avant qu’un résultat modulaire soit confié au stockage et ne sont pas facturés. Préférez compute lorsque vous complétez des identifiants d’étrangers pour des formulaires ; préférez validate lorsque vous conditionnez une recherche ou un import à un NIE complet issu d’un utilisateur ou d’un fichier partenaire. Les espaces et tirets sont supprimés pour que des formes courantes comme X-1234567-L soient encore analysées ; points, barres et autre ponctuation sont rejetés comme entrée mal formée avec invalid_input afin qu’une valeur nettoyée en silence n’atteigne jamais le stockage. Le mode compute est le mode par défaut : le moteur exige exactement huit caractères après normalisation — préfixe X, Y ou Z plus sept chiffres — et renvoie control_letter, la chaîne nie complète avec la lettre ajoutée, prefix_digit (0, 1 ou 2), mapped_number et remainder. Le mode validate exige exactement neuf caractères y compris la lettre de contrôle finale ; la réponse indique valid true lorsque cette lettre correspond à expected_control_letter recalculée, et valid false lorsque le corps est bien formé mais que la lettre est incorrecte. Validate renvoie toujours le control_letter fourni, expected_control_letter, prefix, digits, mapped_number, remainder et le nie corrigé construit avec la lettre attendue. Des alias tels que nie, text, value, code, id et n sont acceptés pour le même champ de charge utile afin que les intégrations qui parlent déjà de nie n’aient pas besoin d’un renommage. Comme le chemin est un parse pur sans horloge, source aléatoire ni réseau, le même corps JSON produit toujours le même résultat JSON sur l’outil gratuit du navigateur et sur l’API à $0.002 par requête réussie.
Où les contrôles de lettre NIE s’intègrent dans les flux réels
Les plateformes d’immigration et de relocalisation recalculent expected_control_letter et affichent une correction amicale lorsqu’un demandeur colle un numéro avec un caractère final incorrect.
Cas d'intégration
Compléter un corps de NIE pour la paie et les contrats
Appelez le mode compute avec X/Y/Z plus sept chiffres, stockez le nie renvoyé avec control_letter et alimentez l’identifiant complet dans les systèmes RH, fiscaux ou bancaires.
Valider des NIE complets saisis ou importés à l’entrée
Lorsqu’un formulaire ou un CSV envoie neuf caractères, appelez le mode validate et bloquez l’enregistrement si valid est false, en affichant expected_control_letter pour corriger une seule frappe.
Questions techniques
Comment calculer la lettre de contrôle du NIE espagnol avec cette API ?
Envoyez un POST avec number égal au préfixe plus sept chiffres (par exemple X1234567) et mode compute (ou omettez mode). La réponse inclut control_letter, nie (neuf caractères complets), prefix_digit, mapped_number et remainder.
Comment valider un NIE espagnol complet ?
Envoyez un POST avec le NIE de neuf caractères et mode validate. La réponse inclut valid, control_letter (fournie), expected_control_letter, prefix, digits, mapped_number, remainder et nie construit avec la lettre attendue.
L’outil de lettre de contrôle du NIE espagnol est-il gratuit ?
L’outil navigateur est gratuit et s’exécute localement. Les appels API utilisent le solde prépayé KIT au prix de base publié $0.002 ; une entrée invalide n’est jamais facturée.