ForHosting KIT · Entwickler-Tools

Prüfziffer der portugiesischen NIF berechnen und prüfen

Dieser Rechner für die Prüfziffer der portugiesischen NIF verwendet die standardmäßige Modulo-elf-Prüfsumme der portugiesischen Steueridentifikationsnummer.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie die ersten acht Ziffern ein, um die neunte zu berechnen, oder übermitteln Sie alle neun Ziffern, um die vorhandene Prüfziffer abzugleichen. Das Ergebnis ist deterministisch und sofort verfügbar. Deshalb eignet sich das Werkzeug für Formulare, Importe, Buchhaltungsabläufe und API-Prüfungen. Falsche Längen, nicht numerische Zeichen und unbekannte Betriebsarten werden deutlich gemeldet, anstatt Eingaben stillschweigend zu bereinigen oder zu erraten.

Wählen Sie Berechnung oder Prüfung

Verwenden Sie die Berechnung, wenn Ihnen die achtstellige Basis einer portugiesischen NIF bereits vorliegt und Sie die abschließende Prüfziffer benötigen. Die Antwort enthält sowohl die berechnete Ziffer als auch den vollständigen neunstelligen Wert. Sie können ihn daher unmittelbar in einen nachfolgenden Prüf- oder Testablauf übernehmen. Verwenden Sie die Prüfung, wenn die Quelle bereits alle neun Ziffern enthält. Dabei werden die ersten acht Ziffern von der übermittelten neunten getrennt, der erwartete Wert berechnet und beide Werte miteinander verglichen. Die Antwort nennt zudem die übermittelte und die erwartete Ziffer, sodass sich ein negatives Ergebnis leicht untersuchen lässt. Bewahren Sie die Eingabe als Zeichenfolge und nicht als Zahlenwert auf. Nur eine Zeichenfolge erhält jedes Zeichen einschließlich einer führenden Null unverändert und verhindert, dass die Zahlenformatierung einer Tabellenkalkulation oder Programmiersprache die Kennung vor der Prüfung verändert. Standardmäßig wird geprüft; geben Sie die Betriebsart dennoch ausdrücklich an, wenn ein Ablauf beide Formen verarbeiten kann.

So funktioniert die Modulo-elf-Berechnung

Der Algorithmus verarbeitet die ersten acht Ziffern von links nach rechts mit absteigenden Gewichten von neun bis zwei. Er multipliziert die erste Ziffer mit neun, die zweite mit acht und schließlich die achte mit zwei. Anschließend werden diese acht Produkte addiert und die Summe modulo elf reduziert. Ist der Rest null oder eins, lautet die Prüfziffer null. Bei jedem anderen Rest ergibt sie sich aus elf minus diesem Rest. Die Prüfung führt genau dieselbe Rechnung für die ersten acht Stellen aus und vergleicht das Ergebnis mit der neunten. Diese Funktion entfernt vor der Berechnung weder Leerzeichen noch Punkte, Bindestriche, Länderpräfixe oder Beschriftungen. Diese Strenge ist beabsichtigt: Eine automatische Bereinigung könnte fehlerhafte Quelldaten vertrauenswürdig erscheinen lassen und frühere Fehler bei der Feldzuordnung verbergen. Übermitteln Sie ausschließlich ASCII-Ziffern von null bis neun. Die Berechnung verwendet weder Netzwerk, Zufallswerte, Uhr, Datenbank noch gebietsschemaabhängige Umwandlungen. Gleiche Eingaben und Betriebsarten erzeugen daher stets dieselbe JSON-Ausgabe.

Verstehen Sie Ergebnis und Grenzen

Ein wahres Prüfergebnis bedeutet, dass die neunte Ziffer mit der aus den vorherigen acht Ziffern abgeleiteten Modulo-elf-Prüfsumme übereinstimmt. Diese Strukturprüfung hilft bei Tippfehlern, beschädigten Importen und falsch zugeordneten Spalten. Sie beweist jedoch nicht, dass die Nummer vergeben wurde, weiterhin aktiv ist oder einer bestimmten Person oder Organisation gehört. Dafür benötigen Sie ein maßgebliches Register oder einen geeigneten geschäftlichen Prüfprozess. Der Rechner untersucht außerdem bewusst nur die Prüfsumme und erzwingt keine Annahmen über Kategorien, die möglicherweise in der ersten Ziffer codiert sind. So bleibt sein Umfang präzise, und eine Nummer mit korrekter Prüfsumme wird nicht allein wegen geänderter externer Vergaberegeln abgelehnt. Unterscheiden Sie in einer Datenpipeline Eingabefehler von einem falschen Prüfergebnis: Ein Fehler bezeichnet einen unzulässigen Typ, eine falsche Länge, Zeichen oder Betriebsart; falsch bedeutet, dass eine wohlgeformte neunstellige Nummer geprüft wurde, deren Ziffer nicht übereinstimmte. Jede API-Anfrage kostet $0.002; derselbe deterministische Kern kann auch im Browser ausgeführt werden.

Steuerformular vor dem Absenden prüfen

Prüfen Sie eine neunstellige NIF direkt bei der Eingabe und zeigen Sie bei einer abweichenden Prüfziffer einen gezielten Korrekturhinweis an.

Importierte Kundendaten kontrollieren

Prüfen Sie NIF-Felder nach einer CSV- oder Systemmigration, um Kürzungen, Vertauschungen und Zuordnungsfehler zu erkennen.

Deterministische Testdaten erzeugen

Berechnen Sie die neunte Ziffer einer achtstelligen Basis für Integrationstests von Abrechnungs-, Rechnungs- oder Registrierungssoftware.

Welche Eingabe erfordert die Berechnung?

Genau acht Ziffern als Zeichenfolge. Die Antwort enthält die berechnete Prüfziffer und die vollständige neunstellige NIF.

Welche Eingabe erfordert die Prüfung?

Genau neun Ziffern als Zeichenfolge, einschließlich der Prüfziffer an der letzten Stelle.

Beweist eine gültige Prüfsumme die Vergabe der NIF?

Nein. Sie belegt nur, dass die angegebene neunte Ziffer zur Prüfsumme der ersten acht passt.

Darf ich Leerzeichen, Satzzeichen oder ein Länderpräfix eingeben?

Nein. Übermitteln Sie nur Ziffern. Formatierungszeichen werden abgelehnt, damit fehlerhafte Quelldaten nicht unbemerkt verändert werden.

Wie wird die Prüfziffer berechnet?

Die ersten acht Ziffern werden von neun bis zwei gewichtet, addiert und modulo elf reduziert; Rest null oder eins ergibt null, andernfalls wird der Rest von elf abgezogen.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Für eine schnelle lokale Berechnung können Sie auch die Ausführung im Browser verwenden.

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.

POSThttps://api.kit.forhosting.com/enc/nif-portugal

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/enc/nif-portugal \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"501964843"}'
{
  "number": "501964843"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.nif_portugal",
  "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.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →