NIE-Prüfbuchstabe
Zu X1234567 gehört der Prüfbuchstabe L, die vollständige NIE lautet also X1234567L. Geben Sie Präfix und sieben Ziffern ein, um die Nummer einer ausländischen Person zu ergänzen, oder fügen Sie eine ganze NIE ein, um ihren Buchstaben vor Vertrag oder Lohnabrechnung zu prüfen. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Zahl
- X1234567
- Berechnungsmodus
- Compute
- Eingabe
- X1234567
- Präfix
- X
- Präfixziffer
- 0
Die spanische NIE (Número de Identidad de Extranjero) ist die Ausländer-Identitätsnummer für Steuer-, Bank-, Arbeits- und Aufenthaltsprozesse in Spanien. Anders als eine reine Ziffernfolge beginnt jede NIE mit X, Y oder Z, setzt sich mit sieben Ziffern fort und endet mit einem Prüfbuchstaben, der belegt, dass der Rumpf ohne typischen Tippfehler erfasst oder gespeichert wurde. Diese Fähigkeit setzt das offizielle Mapping und die mit den DNI-Prüfbuchstaben gemeinsame mod-23-Regel um: Ersetzen Sie X durch 0, Y durch 1 oder Z durch 2, behandeln Sie das Ergebnis als achtstellige Ganzzahl, nehmen Sie diese Ganzzahl modulo 23 und schlagen Sie den Buchstaben in der festen Tabelle TRWAGMYFPDXBNJZSQVHLCKE nach. Nutzen Sie den Modus compute, wenn Sie nur Präfix und sieben Ziffern haben und den korrekten Endbuchstaben für ein Formular oder einen Stammdatenimport brauchen; nutzen Sie den Modus validate, wenn ein Partner, CRM oder Benutzer eine volle NIE sendet und Sie ein klares valid-Flag sowie den erwarteten Prüfbuchstaben für Fehlermeldungen brauchen.
So wird der spanische NIE-Prüfbuchstabe berechnet
Eine spanische NIE hat immer neun Zeichen, wenn sie ohne Leerzeichen oder Bindestriche geschrieben wird: ein führender Buchstabe aus der Menge X, Y, Z; sieben Dezimalziffern; und ein abschließender Prüfbuchstabe von A bis Z (nicht jeder Buchstabe kommt vor — die Tabelle hat dreiundzwanzig Positionen). Der führende Buchstabe ist nicht dekorativ. Historisch markieren X, Y und Z aufeinanderfolgende Nummernbereiche für ausländische Einwohner; für die Prüfbuchstaben-Formel werden sie in Ziffern umgeschrieben, damit dieselbe DNI-Tabelle wiederverwendet werden kann.
Mappen Sie X auf null, Y auf eins und Z auf zwei und verketten Sie diese Ziffer mit den sieben numerischen Zeichen zu einer achtstelligen Zeichenkette wie 01234567 für den klassischen Rumpf X1234567. Interpretieren Sie diese Zeichenkette als Ganzzahl (führende Nullen ändern den Modularwert nicht) und berechnen Sie den Rest bei Division durch dreiundzwanzig. Indizieren Sie die offizielle Folge T, R, W, A, G, M, Y, F, P, D, X, B, N, J, Z, S, Q, V, H, L, C, K, E mit diesem Rest als nullbasiertem Index.
Der Buchstabe an diesem Index ist der einzige gültige Prüfbuchstabe für diesen Rumpf. Beispiel: X1234567 mappt auf 01234567, Rest neunzehn, Prüfbuchstabe L, volle NIE X1234567L. Der Algorithmus ist deterministisch und lokal: kein Netzaufruf an die spanische Verwaltung, kein Register-Lookup und keine Uhr.
Wo NIE-Buchstabenprüfungen in reale Abläufe passen
HR- und Lohnteams onboarden nicht-spanische Mitarbeitende und müssen den korrekten NIE-Prüfbuchstaben anhängen, bevor die Kennung in Verträge, Sozialversicherungsmeldungen oder Bankzahlungsdateien geschrieben wird, die ungültige Steuer-IDs ablehnen. Immobilien-, Bank- und Telekom-Anmeldeformulare prüfen eine volle neunstellige NIE bei der Kontoerstellung, damit ein einzelner Tippfehler keinen Phantomkunden und keinen Compliance-Konflikt erzeugt. Datenqualitätsjobs gehen jede NIE-Spalte in einem CRM- oder ERP-Export durch, rufen den Modus validate auf und stellen Zeilen mit valid false unter Quarantäne — sie fangen menschliche Edits und Generator-Bugs ab, die rein ziffernbasierte DNI-Rümpfe mit NIE-Präfixregeln verwechseln.
Behandeln Sie einen bestandenen NIE-Buchstaben-Check nicht als Nachweis eines aktiven Aufenthalts bei spanischen Behörden oder einer bestimmten Arbeitserlaubnis; er belegt nur, dass der Prüfbuchstabe mit dem achtstelligen gemappten Rumpf unter der Standard-mod-23-Tabelle übereinstimmt.
Anwendungsfälle
NIE-Spalten in CRM- und ERP-Exporten prüfen
Validieren Sie batchweise jede spanische NIE in einer Kunden- oder Mitarbeiterdatei und stellen Sie Zeilen unter Quarantäne, deren Prüfbuchstabe nicht mehr dem neu berechneten Sollwert entspricht.
Häufige Fragen
Was ist der Prüfbuchstabe einer spanischen NIE?
Es ist das letzte Zeichen einer neunstelligen NIE. Nach dem Mapping von führendem X, Y oder Z auf 0, 1 oder 2 indiziert der achtstellige Wert modulo 23 die offizielle Tabelle TRWAGMYFPDXBNJZSQVHLCKE und liefert diesen Buchstaben.
Was passiert bei falscher Länge, falschem Präfix oder Satzzeichen?
Eine wohlgeformte NIE mit falschem Buchstaben liefert im Modus validate valid false. Fehlgeschlagene Validierungsaufgaben werden nicht berechnet.
Wie wird der Prüfbuchstabe der NIE berechnet?
X wird zu 0, Y zu 1 und Z zu 2, dann teilt man die achtstellige Zahl durch 23. Der Rest zeigt auf den Buchstaben in der Tabelle TRWAGMYFPDXBNJZSQVHLCKE. Bei X1234567 ist der Rest 19, der Buchstabe also L.
Wird der NIE-Buchstabe wie beim DNI berechnet?
Ja, mit derselben Tabelle aus 23 Buchstaben und derselben Division wie beim spanischen DNI. Der einzige Unterschied: Der Anfangsbuchstabe X, Y oder Z wird vorher in 0, 1 oder 2 umgewandelt.
Beweist ein korrekter Buchstabe, dass die NIE vergeben wurde?
Nein. Die Prüfung zeigt nur, dass der Buchstabe zu Präfix und Ziffern passt. Das Werkzeug fragt keine spanische Behörde und kein Register ab und kann daher nicht bestätigen, wem die Nummer gehört.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"number": "X1234567"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nie_spain",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Fehlgeformte Eingabe schlägt mit invalid_input fehl statt stillschweigend bereinigt zu werden, sodass Sie nie eine halb bereinigte Ausländer-ID speichern. Dieselbe reine Arithmetik läuft kostenlos im Browser und zum veröffentlichten API-Preis.
Eingabevertrag, Modi und Fehlerverhalten
Senden Sie ein number-Feld mit dem NIE-Rumpf. Falsche Länge ist ein expliziter Fehler, der den Modus und die gesendete Länge nennt — acht für compute, neun für validate —, damit Client-Formulare eine präzise Meldung zeigen können, ohne zu raten. Leere Zeichenketten, fehlendes number, ungültige mode-Werte, Präfixe außer X Y Z, nicht-numerische Mittelteile und nicht-buchstabige Enden scheitern, bevor ein Modularergebnis für den Speicher vertraut wird, und werden nicht berechnet. Bevorzugen Sie compute, wenn Sie Ausländerkennungen für Formulare vervollständigen; bevorzugen Sie validate, wenn Sie eine Suche oder einen Import an eine volle NIE aus einem Benutzer- oder Partnerfile koppeln. Leerzeichen und Bindestriche werden entfernt, damit gängige Schreibweisen wie X-1234567-L noch geparst werden; Punkte, Schrägstriche und andere Satzzeichen werden als fehlgeformte Eingabe mit invalid_input abgelehnt, damit ein still bereinigter Wert nie den Speicher erreicht. Der Modus compute ist Standard: die Engine verlangt genau acht Zeichen nach der Normalisierung — Präfix X, Y oder Z plus sieben Ziffern — und liefert control_letter, die volle nie-Zeichenkette mit angehängtem Buchstaben, prefix_digit (0, 1 oder 2), mapped_number und remainder. Der Modus validate verlangt genau neun Zeichen einschließlich des abschließenden Prüfbuchstabens; die Antwort meldet valid true, wenn dieser Buchstabe mit dem neu berechneten expected_control_letter übereinstimmt, und valid false, wenn der Rumpf wohlgeformt, der Buchstabe aber falsch ist. Validate gibt stets den gegebenen control_letter, expected_control_letter, prefix, digits, mapped_number, remainder und die korrigierte nie mit dem erwarteten Buchstaben zurück. Alias-Schlüssel wie nie, text, value, code, id und n werden für dasselbe Payload-Feld akzeptiert, sodass Integrationen, die bereits nie sprechen, nicht umbenennen müssen. Weil der Pfad reines Parse ohne Uhr, Zufallsquelle oder Netz ist, liefert derselbe JSON-Body auf dem kostenlosen Browser-Tool und auf der API zu $0.002 pro erfolgreicher Anfrage immer dasselbe JSON-Ergebnis.
Wo NIE-Buchstabenprüfungen in reale Abläufe passen
Einwanderungs- und Relocation-Plattformen berechnen expected_control_letter neu und zeigen eine freundliche Korrektur, wenn ein Antragsteller eine Nummer mit falschem Endzeichen einfügt.
Integrationsbeispiele
NIE-Rumpf für Lohn und Verträge vervollständigen
Rufen Sie den Modus compute mit X/Y/Z plus sieben Ziffern auf, speichern Sie die zurückgegebene nie mit control_letter und speisen Sie die volle Kennung in HR-, Steuer- oder Banksysteme ein.
Eingegebene oder importierte volle NIEs prüfen
Wenn ein Formular oder CSV neun Zeichen sendet, rufen Sie den Modus validate auf und blockieren Sie das Speichern, wenn valid false ist; zeigen Sie expected_control_letter, um einen einzelnen Tippfehler zu korrigieren.
Technische Fragen
Wie berechne ich den NIE-Prüfbuchstaben mit dieser API?
Senden Sie POST mit number gleich Präfix plus sieben Ziffern (zum Beispiel X1234567) und mode compute (oder lassen Sie mode weg). Die Antwort enthält control_letter, nie (volle neun Zeichen), prefix_digit, mapped_number und remainder.
Wie prüfe ich eine volle spanische NIE?
Senden Sie POST mit der neunstelligen NIE und mode validate. Die Antwort enthält valid, control_letter (gegeben), expected_control_letter, prefix, digits, mapped_number, remainder und nie mit dem erwarteten Buchstaben.
Ist das Werkzeug für den NIE-Prüfbuchstaben kostenlos?
Das Browser-Tool ist kostenlos und läuft lokal. API-Aufrufe nutzen das vorausbezahlte KIT-Guthaben zum veröffentlichten Basispreis $0.002; ungültige Eingabe wird nie berechnet.