ForHosting KIT · Entwickler-Tools

Brasilien-CPF-Prüfziffern

Geben Sie die neun Ziffern 529982247 ein und erhalten Sie die Prüfziffern 25, die vollständige CPF lautet also 52998224725. Oder fügen Sie elf Ziffern ein und sehen Sie, ob die letzten zwei stimmen. Platzhalter wie 11111111111 gelten als ungültig. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

Zahl: 529982247

Erhalten Sie

Berechnungsmodus: Compute
Eingabe: 529982247
Prüfziffern: 25
Prüfziffer 1: 2

Der brasilianische CPF (Cadastro de Pessoas Físicas) ist eine elfstellige Steuerkennung für Banken, Lohnabrechnung, E-Commerce und behördliche Formulare. Neun Ziffern identifizieren die Person; die letzten zwei sind Prüfziffern aus einer festen mod-11-Formel, sodass Tippfehler und viele Vertauschungen eher scheitern, als wie ein anderes gültiges Register auszusehen. Diese Fähigkeit berechnet jene zwei Prüfziffern aus einer reinen neunstelligen Basis oder prüft einen vollständigen elfstelligen CPF und meldet, ob das gespeicherte Paar dem neu berechneten Wert entspricht. Ketten aus wiederholten Ziffern wie nur Nullen oder nur Einsen gelten nach brasilianischen Regeln als ungültig, auch wenn die Arithmetik bestünde.

So werden brasilianische CPF-Prüfziffern berechnet

Ein CPF besteht ohne Satzzeichen stets aus elf Dezimalziffern. Die ersten neun bilden den Basisregistereintrag; die zehnte und elfte sind Verifikatoren. Für die erste Prüfziffer multiplizieren Sie jede der neun Basisziffern mit den absteigenden Gewichten zehn bis zwei, summieren die Produkte, nehmen diese Summe modulo elf und bilden den Rest ab: ist der Rest kleiner als zwei, ist die Ziffer null, sonst elf minus Rest.

Für die zweite Prüfziffer hängen Sie die erste an die neun Basisziffern und wiederholen denselben mod-11-Prozess mit den Gewichten elf bis zwei. Die Validierung ist die Umkehrung: berechnen Sie beide Ziffern aus den ersten neun Zeichen neu und vergleichen Sie sie mit den letzten zwei. Die offizielle Praxis verwirft zudem CPFs, in denen alle Ziffern identisch sind—zum Beispiel 00000000000 oder 11111111111—weil diese Zeichenketten die Arithmetik für manche Gewichtsmuster erfüllen, aber nicht als echte Kennungen ausgegeben werden.

*-Werkzeuge unterscheiden.

Anwendungsfälle

CPF-Spalten in Massenexporten prüfen

Validieren Sie jeden CPF in einem Lohn-CSV oder ERP-Auszug stapelweise und setzen Sie Zeilen in Quarantäne, deren Prüfziffern nicht mehr dem neu berechneten Paar entsprechen oder wiederholte Ziffern-Platzhalter sind.

Häufige Fragen

Was sind brasilianische CPF-Prüfziffern?

Es sind die zehnte und elfte Ziffer eines CPF, berechnet aus den ersten neun mit offiziellen absteigenden mod-11-Gewichten, sodass Einzeltippfehler und viele Vertauschungen weit häufiger scheitern, als wie ein anderes Register auszusehen.

Was passiert mit Buchstaben, Punkten, Bindestrichen oder falschen Längen?

Fehlgeschlagene Aufgaben werden nicht berechnet. Entfernen Sie die Formatierung XXX.XXX.XXX-XX im Client vor dem Aufruf.

Warum gilt eine CPF wie 11111111111 als ungültig?

Folgen wie 00000000000 oder 11111111111 können die Rechnung erfüllen, werden aber nie als echte Kennungen vergeben. Nach amtlicher Praxis markiert das Werkzeug sie deshalb als ungültig.

Wie wird die zweite CPF-Prüfziffer berechnet?

Hängen Sie die erste Prüfziffer an die neun Basisziffern, multiplizieren Sie die zehn Ziffern mit den Gewichten 11 bis 2 und addieren Sie. Ist der Rest bei Division durch 11 kleiner als 2, lautet die Ziffer 0, sonst 11 minus Rest.

Zeigt das Werkzeug, welche Prüfziffern richtig gewesen wären?

Ja. Bei der Prüfung erhalten Sie neben den eingegebenen Prüfziffern auch das erwartete Paar und die korrekt gebildete CPF. So lässt sich ein Tippfehler direkt benennen.

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

POSThttps://api.kit.forhosting.com/enc/cpf-brazil

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/cpf-brazil \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"529982247"}'

const res = await fetch("https://api.kit.forhosting.com/enc/cpf-brazil", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "number": "529982247"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/cpf-brazil",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "number": "529982247"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/cpf-brazil", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"number":"529982247"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"number":"529982247"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/cpf-brazil", 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": "529982247"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.cpf_brazil",
  "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

pro Anfrage$0.002

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

Nichtnumerische Zeichen, falsche Längen und leere Eingaben werden mit einem klaren invalid_input-Fehler abgewiesen. Führen Sie sie kostenlos im Browser aus oder rufen Sie die KIT-API auf; beide Wege teilen dieselbe reine Arithmetik, ohne Netzwerk und ohne gespeicherte Register.

So werden brasilianische CPF-Prüfziffern berechnet

Da der Algorithmus reine ganzzahlige Modulararithmetik mit festen Gewichten ist, erzeugen dieselben neun Ziffern auf jeder Plattform dasselbe Prüfziffernpaar—Browser, Worker oder Offline-Test-Harness—weshalb die Fähigkeit als parse-Engine der Stufe A und nicht als Modellaufruf veröffentlicht wird.

So berechnen oder prüfen Sie Prüfziffern bzw. einen vollen CPF

Senden Sie ein number-Feld, das nur die Zeichen null bis neun enthält. Der Modus validate erwartet genau elf Ziffern. Leere Zeichenketten, fehlendes number, ungültige mode-Werte und falsche Längen (beispielsweise acht oder zwölf Ziffern) scheitern vor jeder gewichteten Summe und werden nicht berechnet. Leerzeichen, Punkte, Bindestriche, Buchstaben und Dezimalpunkte werden als nichtnumerische Eingabe mit invalid_input abgewiesen, damit ein Formular nie stillschweigend bereinigte Werte akzeptiert: entfernen Sie die Satzzeichen im Client, wenn Benutzer die gewohnte Maske XXX.XXX.XXX-XX tippen. Der Modus compute ist Standard: geben Sie genau neun Basisziffern an; die Engine liefert check_digits als zweizeichenige Zeichenkette, check_digit_1 und check_digit_2 einzeln, cpf als vollständigen elfstelligen Code und length elf. Die Antwort meldet valid true nur, wenn das Schluss-Paar dem neu berechneten expected_check_digits entspricht und die Zeichenkette keine identische Ziffernfolge ist; sie enthält stets base (die ersten neun), check_digits wie übermittelt, expected_check_digits und das kanonische cpf aus base plus erwartetem Paar. Diese Form erleichtert die Anzeige «Sie haben XY eingegeben, erwartet AB» in einer KYC- oder Anmelde-UI ohne zweiten Aufruf. Weil der Pfad reines parse ohne Uhr, Zufallsquelle oder Netzwerk ist, liefert dieselbe Eingabe im kostenlosen Browser-Tool und über die API stets dasselbe JSON. Mit $0.002 pro erfolgreicher Anfrage können Sie Massen-CRM-Importe, Partnerdatei-Audits und Formular-Gates schützen, ohne eine Sonderstufe zu verhandeln.

Wo CPF-Prüfziffern in reale Produktabläufe passen

Onboarding-Abläufe brasilianischer Fintechs und Marktplätze fordern den CPF früh; die Prüfung der Prüfziffern beim Verlassen des Feldes reduziert fehlgeschlagene Absendungen und Supporttickets, ohne bei jedem Tastendruck ein Behördenregister anzurufen. Lohn- und HR-Systeme importieren Mitarbeiter-CSVs und sollten Zeilen in Quarantäne legen, deren elfte Ziffer nicht mehr passt—das fängt sowohl manuelle Edits als auch Off-by-one-Fehler in vorgelagerten Generatoren. Behandeln Sie eine korrekte Prüfziffer nicht als Nachweis, dass die Person in den Systemen der Receita Federal existiert oder das Dokument aktiv ist—sie belegt nur, dass die elfstellige Zeichenkette unter der CPF-Regel arithmetisch wohlgeformt ist und kein Platzhalter aus wiederholten Ziffern, derselbe Ehrlichkeitsmaßstab wie bei jedem Steuer-Checksummen-Werkzeug. E-Commerce-Checkout, der den CPF als Steuer-ID akzeptiert, kann den Fortgang blockieren, bis valid true ist, und expected_check_digits anzeigen, wenn das Paar falsch ist. Datenqualitätsjobs berechnen expected_check_digits für jede CPF-Spalte eines Exports neu und markieren Abweichungen vor Abrechnung oder fiskalischer Berichterstattung.

Integrationsbeispiele

Neun Basisziffern für Fixtures und Formulare ergänzen

Nehmen Sie eine neunstellige Basis aus einem Testplan oder Teildatensatz, rufen Sie den compute-Modus auf und speichern oder zeigen Sie den vollständigen elfstelligen cpf mit beiden Prüfziffern.

Getippte oder importierte CPFs beim Eingang prüfen

Wenn ein Anmeldeformular, CRM-Import oder Partner-API elf Ziffern sendet, rufen Sie den validate-Modus auf und blockieren Sie die Speicherung, wenn valid false ist; zeigen Sie expected_check_digits zur Korrektur eines Tippfehlers.

Technische Fragen

Wie berechne ich CPF-Prüfziffern mit dieser API?

Senden Sie POST mit number auf genau neun Ziffern und mode compute (oder lassen Sie mode weg). Die Antwort enthält check_digits, check_digit_1, check_digit_2 und cpf (den vollständigen elfstelligen Code).

Wie prüfe ich einen vollständigen elfstelligen CPF?

Senden Sie POST mit der elfstelligen Zeichenkette und mode validate. Die Antwort enthält valid, check_digits, expected_check_digits, base und das kanonische cpf.

Ist das Tool für brasilianische CPF-Prüfziffern kostenlos?

Das Browser-Tool ist kostenlos und läuft lokal. API-Aufrufe nutzen vorausbezahltes KIT-Guthaben zum veröffentlichten Basispreis $0.002; ungültige Eingaben werden nie berechnet.

Vollständige KIT-Dokumentation lesen →

Brasilien-CPF-Prüfziffern

Im Browser ausführen – kostenlos

Rechenbeispiel

So werden brasilianische CPF-Prüfziffern berechnet

Anwendungsfälle

CPF-Spalten in Massenexporten prüfen

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Fehler

Technische Hinweise

So werden brasilianische CPF-Prüfziffern berechnet

So berechnen oder prüfen Sie Prüfziffern bzw. einen vollen CPF

Wo CPF-Prüfziffern in reale Produktabläufe passen

Integrationsbeispiele

Neun Basisziffern für Fixtures und Formulare ergänzen

Getippte oder importierte CPFs beim Eingang prüfen

Technische Fragen

danke