ForHosting KIT · Outils pour développeurs

Chiffre de contrôle cédula Équateur

Saisissez 171003406 et obtenez le chiffre de contrôle 5 : la cédula complète est donc 1710034065. Vous pouvez aussi coller les dix chiffres pour voir si le dernier respecte la règle officielle du modulo 10. Utile pour les inscriptions, la paie et la facturation. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Cédula
171003406
Vous obtenez
Mode de calcul
Compute
Entrée
171003406
Corps
171003406
Chiffre de contrôle
5

Toute cédula d’identité équatorienne de personne physique est un nombre à dix chiffres dont le dernier n’est pas libre : c’est un chiffre de contrôle public produit par la méthode des coefficients modulo dix du Registro Civil. Les équipes qui construisent des formulaires KYC, des imports de paie, des passerelles de facturation électronique et des outils d’inscription scolaire ou clinique ont constamment besoin soit de calculer ce chiffre à partir des neuf premières positions, soit de confirmer qu’une cédula complète saisie est cohérente avec les poids officiels. Ce calculateur du chiffre de contrôle de la cédula d’Équateur accepte neuf chiffres pour renvoyer le chiffre et le numéro complet, ou une cédula à dix chiffres pour recalculer la valeur attendue et fixer un indicateur valid clair. Les espaces et tirets sont retirés afin que le collage depuis un PDF fonctionne encore.

Comment le chiffre de contrôle de la cédula équatorienne est calculé

Une cédula d’identité nationale équatorienne de personne physique compte dix chiffres décimaux. Les deux premiers codent la province d’émission et doivent valoir de zéro un à vingt-quatre selon le catalogue provincial officiel. Le troisième chiffre est limité de zéro à cinq pour les personnes physiques ; des troisièmes chiffres plus élevés relèvent d’autres régimes fiscaux avec d’autres algorithmes et sortent de cette vérification.

Les chiffres quatre à neuf forment un corps séquentiel attribué par l’état civil. Le dixième chiffre est entièrement déterminé par les neuf premiers : il n’est pas choisi par le citoyen et ne peut être deviné indépendamment de ces neuf valeurs. La méthode standard des coefficients modulo dix multiplie chacun des neuf chiffres du corps par un vecteur fixe de poids alternés deux, un, deux, un, deux, un, deux, un, deux de gauche à droite.

Lorsqu’un produit est supérieur ou égal à dix, on soustrait neuf de ce produit afin que chaque position contribue une valeur d’un seul chiffre. Les neuf produits ajustés sont additionnés pour former une somme pondérée. Le chiffre de contrôle est dix moins la somme modulo dix, et si cette différence valait dix le chiffre devient zéro — de façon équivalente, contrôle égale (10 − (somme modulo 10)) modulo 10.

Comme chaque étape est une arithmétique entière sur une table de poids fixe, deux clients qui envoient les mêmes neuf chiffres reçoivent toujours le même chiffre de contrôle, la même somme pondérée et le même détail des produits.

La méthode n’est pas Luhn des cartes de paiement dans tous les détails de présentation, même si les deux familles partagent l’idée du modulo dix : ici les coefficients sont fixes de gauche à droite pour la structure de la cédula, et les règles de province et de troisième chiffre contraignent encore les corps valides. N’utilisez pas un validateur Luhn générique sur des champs de cédula équatorienne si vous avez besoin d’imposer province et troisième chiffre ainsi que la liste de produits documentée dans la réponse.

Où vérifier le chiffre d'une cédula est utile

Les formulaires d’onboarding et KYC pour clients équatoriens demandent souvent de saisir une cédula et ont besoin d’un contrôle instantané côté client avant une revue plus lente contre les systèmes officiels. Les sites éducatifs qui se positionnent sur des phrases telles que calculateur chiffre contrôle cédula équateur ont besoin d’un outil gratuit en direct dont le chemin navigateur coïncide avec l’automatisation pour que les captures de tutoriel restent exactes.

Cliniques, écoles et municipalités qui récupèrent une carte plastique usée peuvent n’avoir que neuf chiffres fiables et avoir besoin du dixième pour terminer des rendez-vous en ligne, des dossiers d’assurance ou des inscriptions. Les développeurs de suites multi-pays d’identifiants fiscaux et nationaux peuvent appeler ce point d’entrée spécialisé lorsque le pays est l’Équateur et qu’ils veulent le chiffre lui-même plus le contexte de province, pas seulement un booléen, tout en gardant des validateurs séparés pour la lettre du DNI espagnol, les poids du CUIT argentin ou le CPF brésilien.

Comme l’implémentation est pure parse de niveau A, chaque appel réussi reste dans le modèle de coût analytique sans jetons de modèle ni réseau sortant. Ne traitez jamais un chiffre de contrôle correct comme une preuve que la personne est correctement identifiée, vivante, résidente ou présente au Registro Civil : cela prouve seulement que la chaîne de chiffres est cohérente avec la méthode publiée des coefficients modulo dix pour les cédulas de personne physique.

Contrôles préalables formulaires et KYC

Validez une cédula équatorienne à dix chiffres saisie avant l’envoi, afin que l’utilisateur corrige un chiffre de contrôle erroné sans aller-retour vers l’état civil.

Retrouver le chiffre de contrôle à partir de neuf chiffres

Calculez le dernier chiffre officiel à partir d’un corps de neuf chiffres lorsqu’une carte est usée, partiellement lisible ou stockée sans le chiffre de contrôle.

Imports par lots de paie et CRM

Notez des lignes d’identifiants équatoriens dans des scripts : recalculez le chiffre de contrôle, fixez valid et mettez en quarantaine les écarts avant qu’ils n’atteignent la RH ou la facturation.

Comment calcule-t-on le chiffre de contrôle de la cédula équatorienne ?

Multipliez les neuf premiers chiffres par les coefficients 2,1,2,1,2,1,2,1,2. Si un produit vaut 10 ou plus, soustrayez 9. Additionnez les produits ajustés, puis prenez (10 − somme mod 10) mod 10 comme chiffre de contrôle. Par exemple, le corps 171003406 donne le chiffre 5.

Quelles règles de province et de troisième chiffre s’appliquent ?

Les cédulas de personne physique utilisent les codes de province 01 à 24 et un troisième chiffre de 0 à 5. Les autres troisièmes chiffres relèvent d’autres régimes fiscaux et sont rejetés par ce calculateur.

Peut-on valider une cédula complète à dix chiffres ?

Oui. Envoyez dix chiffres (espaces ou tirets autorisés).

Puis-je coller une cédula avec des espaces ou des tirets ?

Oui. Les espaces et les tirets sont d'abord retirés, si bien qu'un numéro copié depuis un PDF fonctionne aussi. Avec neuf chiffres, l'outil calcule le chiffre de contrôle ; avec dix, il vérifie celui que vous avez saisi.

L'outil vérifie-t-il aussi le RUC d'une entreprise ?

Non. Il couvre la cédula des personnes physiques, dont le troisième chiffre va de 0 à 5. Les troisièmes chiffres plus élevés relèvent d'autres catégories de contribuables, avec des règles différentes.

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.

POSThttps://api.kit.forhosting.com/enc/ci-ecuador

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é.

curl -X POST https://api.kit.forhosting.com/enc/ci-ecuador \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cedula":"171003406"}'
{
  "cedula": "171003406"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ci_ecuador",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Les codes de province doivent être compris entre zéro un et vingt-quatre et le troisième chiffre entre zéro et cinq pour les personnes physiques, de sorte que les corps mal formés échouent avec invalid_input au lieu d’inventer un chiffre.

Contrat d’entrée, forme de la réponse et modes de validation

Le mode optionnel peut être auto, compute ou validate ; auto est la valeur par défaut et infère compute lorsqu’il reste exactement neuf chiffres après suppression des espaces, tirets, points et underscores, ou validate lorsqu’il reste exactement dix. Préférez compute lorsque vous assemblez une cédula à partir d’un corps de neuf chiffres récupéré de documents partiels ; préférez validate lorsqu’un utilisateur, un fichier partenaire ou un pipeline OCR fournit un numéro complet à dix chiffres et que vous avez besoin d’une porte booléenne avant une consultation de l’état civil ou de données de référence. Envoyez en POST un corps JSON avec un champ chaîne obligatoire nommé cedula. Les alias text, input, number, digits, value, ci et n sont acceptés pour que les clients légers et les zones de texte génériques réutilisent le même endpoint sans renommer les champs. Le mode compute renvoie check_digit comme chaîne d’un caractère, full comme la cédula complète à dix chiffres, body comme la charge utile à neuf chiffres, province et third_digit pour l’affichage, weighted_sum et products pour la transparence, coefficients comme le vecteur de poids fixe, algorithm égal à modulo10_coefficients, mode compute, et valid true car aucun chiffre conflictuel n’a été fourni. Le mode validate attend une chaîne de dix chiffres incluant le chiffre de contrôle final ; le moteur recalcule le chiffre attendu, le compare au dernier chiffre fourni, fixe valid à true ou false et renvoie provided_check_digit pour que l’interface surligne un caractère mal saisi sans deviner. Les chaînes vides, les caractères non numériques après retrait des séparateurs, les mauvaises longueurs pour le mode choisi, les codes de province hors de zéro un à vingt-quatre et les troisièmes chiffres hors de zéro à cinq lèvent invalid_input avec un message qui nomme le problème ; ces échecs ne sont pas facturés. Les appels API réussis coûtent le prix de base publié de $0.002 par élément ; l’outil dans le navigateur reste gratuit pour les contrôles interactifs.

Où une API du chiffre de la cédula d’Équateur trouve son utilité

Les imports de paie et RH reçoivent des identifiants d’employés depuis des tableurs où un seul dernier chiffre erroné ferait rejeter tout un lot ; un oracle déterministe qui renvoie le check_digit attendu et valid permet de signaler des lignes sans appeler des portails gouvernementaux à chaque enregistrement.

Que se passe-t-il si le chiffre de contrôle est incorrect ?

En mode validate la réponse inclut toujours le check_digit attendu et la chaîne full, et valid est false si le dernier chiffre ne correspond pas. Une entrée complètement mal formée échoue avec invalid_input.

Combien coûte le calculateur du chiffre de la cédula d’Équateur ?

L’outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n’est pas facturée.

Consulter la documentation complète du KIT →