Chiffres de contrôle CPF Brésil
Saisissez les neuf chiffres 529982247 et obtenez les chiffres de contrôle 25 : le CPF complet est donc 52998224725. Vous pouvez aussi coller onze chiffres pour voir si les deux derniers concordent. Les numéros fictifs comme 11111111111 sont signalés non valides. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Nombre
- 529982247
- Mode de calcul
- Compute
- Entrée
- 529982247
- Chiffres de contrôle
- 25
- Chiffre de contrôle 1
- 2
Le CPF brésilien (Cadastro de Pessoas Físicas) est un identifiant fiscal à onze chiffres utilisé dans la banque, la paie, le commerce en ligne et les formulaires officiels. Neuf chiffres identifient la personne ; les deux derniers sont des chiffres de contrôle issus d’une formule fixe mod-11, de sorte qu’une faute de frappe et de nombreuses transpositions échouent plutôt que de ressembler à un autre enregistrement valide. Cette capacité calcule ces deux chiffres de contrôle à partir d’une base pure de neuf chiffres, ou valide un CPF complet à onze et indique si la paire stockée correspond à la valeur recalculée. Les chaînes de chiffres répétés, comme uniquement des zéros ou des uns, sont traitées comme invalides selon les règles brésiliennes même si l’arithmétique passerait.
Comment les chiffres de contrôle du CPF brésilien sont calculés
Un CPF comporte toujours onze chiffres décimaux lorsqu’il est écrit sans ponctuation. Les neuf premiers forment l’enregistrement de base ; le dixième et le onzième sont des vérificateurs. Pour obtenir le premier chiffre de contrôle, multipliez chacun des neuf chiffres de base par les poids décroissants de dix à deux, additionnez les produits, prenez cette somme modulo onze et mappez le reste : si le reste est inférieur à deux le chiffre est zéro, sinon le chiffre est onze moins le reste.
Pour obtenir le second chiffre de contrôle, ajoutez le premier aux neuf chiffres de base et répétez le même processus mod-11 avec les poids de onze à deux. La validation est l’inverse : recalculez les deux chiffres à partir des neuf premiers caractères et comparez-les aux deux derniers. La pratique officielle rejette aussi les CPF dont tous les chiffres sont identiques—par exemple 00000000000 ou 11111111111—car ces chaînes satisfont l’arithmétique pour certains motifs de poids tout en n’étant pas émises comme vrais identifiants.
*.
Cas d’usage
Auditer les colonnes CPF dans les exports en masse
Validez par lots chaque CPF d’un CSV de paie ou d’un extrait ERP et mettez en quarantaine les lignes dont les chiffres de contrôle ne correspondent plus à la paire recalculée ou sont des placeholders de chiffres répétés.
Questions fréquentes
Que sont les chiffres de contrôle du CPF brésilien ?
Ce sont le dixième et le onzième chiffres d’un CPF, calculés à partir des neuf premiers avec les poids officiels décroissants mod-11, de sorte qu’une faute d’un chiffre et de nombreuses transpositions échouent bien plus souvent que de ressembler à un autre enregistrement.
Que se passe-t-il avec des lettres, points, tirets ou mauvaises longueurs ?
Les tâches en échec ne sont pas facturées. Retirez le formatage XXX.XXX.XXX-XX côté client avant d’appeler.
L’outil de chiffres de contrôle du CPF brésilien est-il gratuit ?
L’outil navigateur est gratuit et s’exécute en local.
Pourquoi un CPF comme 11111111111 est-il déclaré non valide ?
Des suites comme 00000000000 ou 11111111111 peuvent satisfaire le calcul, mais elles ne sont jamais attribuées comme vrais identifiants. Conformément à la pratique officielle, l'outil les déclare non valides.
Comment calcule-t-on le second chiffre de contrôle du CPF ?
Ajoutez le premier chiffre de contrôle aux neuf chiffres de base, multipliez les dix chiffres par les poids de 11 à 2 et additionnez. Si le reste de la division par 11 est inférieur à 2, le chiffre vaut 0 ; sinon, il vaut 11 moins le reste.
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/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)Exemple de requête
{
"number": "529982247"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.cpf_brazil",
"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
Les caractères non numériques, les longueurs incorrectes et l’entrée vide sont rejetés avec une erreur invalid_input claire. Exécutez-la gratuitement dans le navigateur ou appelez l’API KIT ; les deux chemins partagent la même arithmétique pure, sans réseau et sans registres stockés.
Comment les chiffres de contrôle du CPF brésilien sont calculés
Comme l’algorithme est de l’arithmétique modulaire entière pure à poids fixes, les mêmes neuf chiffres produisent toujours la même paire de contrôle sur chaque plateforme—navigateur, Worker ou banc de tests hors ligne—raison pour laquelle la capacité est publiée comme moteur parse de niveau A et non comme appel à un modèle.
Comment calculer les chiffres de contrôle ou valider un CPF complet
Envoyez un champ number ne contenant que les caractères de zéro à neuf. Le mode validate attend exactement onze chiffres. Cette forme facilite l’affichage « vous avez saisi XY, attendu AB » dans une interface KYC ou d’inscription sans second appel. Chaînes vides, number manquant, valeurs de mode invalides et longueurs incorrectes (par exemple huit ou douze chiffres) échouent avant toute somme pondérée et ne sont pas facturées. Espaces, points, tirets, lettres et points décimaux sont rejetés comme entrée non numérique avec invalid_input, afin qu’un formulaire n’accepte jamais une valeur nettoyée en silence : retirez la ponctuation côté client si l’utilisateur saisit le masque habituel XXX.XXX.XXX-XX. Le mode compute est le défaut : fournissez exactement neuf chiffres de base ; le moteur renvoie check_digits comme chaîne de deux caractères, check_digit_1 et check_digit_2 séparément, cpf comme le code complet à onze chiffres, et length onze. La réponse indique valid true seulement lorsque la paire finale correspond à expected_check_digits recalculé et que la chaîne n’est pas une suite de chiffres identiques ; elle inclut toujours base (les neuf premiers), check_digits tel que soumis, expected_check_digits et le cpf canonique formé de base plus la paire attendue. Comme le chemin est parse pur sans horloge, source aléatoire ni réseau, la même entrée produit toujours le même JSON dans l’outil gratuit du navigateur et via l’API. À $0.002 par requête réussie vous pouvez protéger des imports CRM en masse, des audits de fichiers partenaires et des portes de formulaires sans négocier un niveau sur mesure.
Où les chiffres du CPF s’intègrent aux flux produit réels
Les parcours d’onboarding des fintechs et marketplaces brésiliens demandent le CPF tôt ; valider les chiffres de contrôle à la sortie du champ réduit les envois échoués et les tickets de support sans appeler un registre public à chaque frappe. Les systèmes de paie et RH importent des CSV d’employés et doivent mettre en quarantaine les lignes dont le onzième chiffre ne correspond plus, ce qui capture aussi bien les retouches humaines que les bugs d’un de trop dans les générateurs amont. Ne traitez pas un chiffre de contrôle correct comme preuve que la personne existe dans les systèmes de la Receita Federal ni que le document est actif : cela prouve seulement que la chaîne de onze chiffres est arithmétiquement bien formée selon la règle CPF et n’est pas un placeholder de chiffres répétés, le même standard d’honnêteté que pour tout outil de somme de contrôle fiscale. Le checkout e-commerce qui accepte le CPF comme ID fiscal peut bloquer la suite tant que valid n’est pas true et afficher expected_check_digits lorsque la paire est fausse. Les jobs de qualité des données recalculent expected_check_digits pour chaque colonne CPF d’un export et signalent les écarts avant facturation ou reporting fiscal.
Cas d'intégration
Compléter neuf chiffres de base pour fixtures et formulaires
Prenez une base de neuf chiffres d’un plan de tests ou d’un enregistrement partiel, appelez le mode compute et stockez ou affichez le cpf complet à onze chiffres avec les deux contrôles ajoutés.
Valider des CPF saisis ou importés à l’entrée
Lorsqu’un formulaire d’inscription, un import CRM ou une API partenaire envoie onze chiffres, appelez le mode validate et bloquez le stockage si valid est false, en affichant expected_check_digits pour corriger une faute de frappe.
Questions techniques
Comment calculer les chiffres de contrôle CPF avec cette API ?
Faites un POST avec number égal à exactement neuf chiffres et mode compute (ou omettez mode). La réponse inclut check_digits, check_digit_1, check_digit_2 et cpf (le code complet à onze chiffres).
Comment valider un CPF complet à onze chiffres ?
Faites un POST avec la chaîne de onze chiffres et mode validate. La réponse inclut valid, check_digits, expected_check_digits, base et le cpf canonique.