ForHosting KIT · Outils pour développeurs

Chiffre contrôle RUC Équateur

1710034065001 est valide : une personne physique de la province 17, chiffre de contrôle 5 en dixième position et établissement 001. L'outil lit le troisième chiffre pour appliquer la bonne règle, modulo 10 ou 11, et indique le type de contribuable. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Ruc: 1710034065001

Vous obtenez

Type: natural_person
Libellé du type: Natural person (persona natural)
Troisième chiffre: 1
Code de province: 17

Le RUC équatorien (Registro Único de Contribuyentes) est l'identifiant fiscal à treize chiffres délivré par le Servicio de Rentas Internas aux personnes physiques, sociétés privées et entités publiques. Les deux premiers chiffres codent la province, le troisième sélectionne la classe de contribuable, un chiffre de contrôle pondéré occupe la position neuf ou dix selon cette classe, et le bloc final est le code d'établissement ou de succursale. Cette capacité valide un RUC pur à treize chiffres en s'appuyant sur le troisième chiffre : les valeurs de zéro à cinq appliquent la règle modulo dix des personnes physiques partagée avec la cédula, six utilise les poids modulo onze des entités publiques, et neuf ceux des sociétés privées. La réponse indique si le chiffre de contrôle stocké correspond à la valeur recalculée, le type détecté, le code de province, le bloc d'établissement et le chiffre attendu lorsqu'il existe.

Comment fonctionnent les types de RUC et les chiffres de contrôle en Équateur

Un RUC bien formé comporte toujours treize chiffres décimaux lorsque la ponctuation est retirée. Les positions un et deux sont le code de province et doivent être dans la plage de zéro-un à vingt-quatre pour les juridictions nationales, ou trente pour les résidents étrangers enregistrés en Équateur.

La position trois est le discriminateur de type qui choisit la catégorie juridique et l'arithmétique : les chiffres de zéro à cinq marquent une personne physique (persona natural), y compris les régimes spéciaux qui suivent encore le corps de type cédula ; le six marque une entité publique (sector público) ; le neuf marque une société privée (sociedad privada). Les chiffres sept et huit sont réservés et ne sont pas des codes de type valides, c'est pourquoi cet outil les rejette avant toute somme pondérée.

Pour les personnes physiques, les dix premiers chiffres correspondent à la cédula et le chiffre de contrôle est la position dix en modulo dix avec les coefficients deux-un répétés : chaque produit de neuf ou plus est réduit de neuf (somme des chiffres), la somme est prise modulo dix, et le contrôle vaut dix moins ce reste, ou zéro lorsque le reste est déjà zéro.

Pour les sociétés privées, le chiffre de contrôle est aussi la position dix, mais les poids sont quatre, trois, deux, sept, six, cinq, quatre, trois, deux sur les neuf premiers chiffres et le reste de la somme modulo onze se mappe à zéro si le reste est zéro, sinon onze moins le reste ; une valeur mappée de dix signifie qu'aucun chiffre de contrôle décimal unique n'existe et que le numéro ne peut pas être valide.

Pour les entités publiques, le chiffre de contrôle est la position neuf, les poids sont trois, deux, sept, six, cinq, quatre, trois, deux sur les huit premiers chiffres, et le même mappage modulo onze s'applique. Après le chiffre de contrôle, les RUC naturels et privés portent un code d'établissement à trois chiffres entre un et neuf cent quatre-vingt-dix-neuf (la matrice est en général zéro-zéro-un) ; les entités publiques portent un bloc de succursale à quatre chiffres entre un et neuf mille neuf cent quatre-vingt-dix-neuf.

Comment valider un RUC pas à pas

Envoyez un champ ruc ne contenant que les caractères de zéro à neuf et long d'exactement treize chiffres. Valid vaut true uniquement lorsque le chiffre de contrôle correspond et que le bloc d'établissement est dans la plage non nulle autorisée pour ce type ; un chiffre erroné renvoie tout de même une charge utile structurée avec valid false pour afficher « attendu X, reçu Y » sans seconde requête.

Les chaînes vides, le ruc manquant, les longueurs autres que treize, les codes de province hors de zéro-un à vingt-quatre et trente, et les troisièmes chiffres sept ou huit échouent avant toute somme pondérée et ne sont pas facturés. Préférez cette capacité lorsque vous avez besoin du rapport de type spécifique à l'Équateur et du routage officiel dual modulo dix / modulo onze ; un vérificateur générique de format d'identifiant fiscal multi-pays n'appliquera pas les branches du troisième chiffre SRI ni les règles d'établissement.

Cas d’usage

Auditer les colonnes RUC des exports de facturation électronique

Validez par lots chaque RUC d'un CSV de ventes ou de retenues et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur recalculée ou dont le troisième chiffre est un code réservé.

Questions fréquentes

Qu'est-ce que le chiffre de contrôle du RUC équatorien ?

C'est le chiffre vérificateur d'un RUC à treize chiffres, calculé à partir du corps initial avec des poids qui dépendent du troisième chiffre : modulo dix pour les personnes physiques (positions 0–5) et modulo onze pour les entités publiques (6) et les sociétés privées (9).

Que signifie le troisième chiffre ?

0–5 signifie personne physique (contrôle modulo 10 en position 10), 6 entité publique (modulo 11 en position 9) et 9 société privée (modulo 11 en position 10).

Que se passe-t-il avec lettres, tirets, mauvaise longueur ou mauvais codes de province ?

Les tâches de validation en échec ne sont pas facturées. Retirez le formatage côté client avant l'appel.

L'outil de chiffre de contrôle du RUC d'Équateur est-il gratuit ?

L'outil navigateur est gratuit et s'exécute en local.

À quoi correspondent les derniers chiffres du RUC ?

Ils désignent l'établissement. Pour une personne physique ou une société privée, ce sont les trois derniers chiffres, par exemple 001 ; pour une entité publique, les quatre derniers, car son chiffre de contrôle se trouve déjà en neuvième position.

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

POSThttps://api.kit.forhosting.com/enc/ruc-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é.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/enc/ruc-ecuador \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"1710034065001"}'

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

import os, requests

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

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

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

{
  "ruc": "1710034065001"
}

Exemple de réponse

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

Tarifs

par requête$0.002

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, les codes de province invalides et les troisièmes chiffres réservés 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 aller-retour réseau ni consultation du registre SRI.

Comment fonctionnent les types de RUC et les chiffres de contrôle en Équateur

Comme chaque étape est une arithmétique modulaire à poids fixes, les mêmes treize chiffres produisent toujours le même verdict de validité dans le navigateur, le Worker ou un banc hors ligne — d'où le déploiement en moteur parse de niveau A plutôt qu'en appel de modèle ou requête SRI en direct.

Comment valider un RUC avec cette API

Les 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 tout masque de formatage côté client avant l'appel. En cas de succès, le moteur renvoie ruc comme chaîne de chiffres normalisée, valid comme booléen, type comme l'une des valeurs natural_person, public_entity ou private_company, type_label comme courte description, third_digit, province_code, algorithm comme modulo_10 ou modulo_11, check_position (neuf ou dix), check_digit tel que soumis, expected_check_digit lorsqu'un chiffre décimal a pu être calculé, establishment comme bloc de succursale final, length treize et algorithm_id ruc_ecuador. Comme le chemin est un 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 sur l'API. À $0.002 par requête réussie, vous pouvez protéger les imports CRM en masse, les portes de facturation électronique et les audits de fichiers partenaires sans négocier un palier sur mesure.

Où la validation du RUC s'insère dans de vrais flux produit

Les parcours d'onboarding fintech et marketplace en Équateur demandent le RUC tôt ; valider les chiffres de contrôle et le type au blur réduit les soumissions échouées et les tickets de support sans appeler le SRI à chaque frappe. Les systèmes comptables et de facturation électronique qui émettent des comprobantes electrónicos doivent mettre en quarantaine les lignes dont le chiffre de contrôle ne correspond plus ou dont le bloc d'établissement est entièrement à zéro avant que le document n'atteigne l'autorisation. Ne traitez pas un chiffre de contrôle correct comme preuve que le contribuable existe dans les systèmes SRI, que le RUC est actif ou que l'établissement est autorisé à émettre des factures — cela prouve seulement que la chaîne de treize chiffres est arithmétiquement bien formée selon les règles officielles dépendantes du type, le même niveau d'honnêteté que pour tout outil de somme de contrôle fiscale. Les imports paie et RH de prestataires indépendants peuvent conditionner le stockage à valid true et afficher type_label pour que l'opérateur voie s'il s'agit d'une personne physique, d'une société privée ou d'une entité publique. Les tâches de qualité des données recalculent expected_check_digit pour chaque colonne RUC d'un export ERP et signalent les écarts avant qu'ils n'atteignent la déclaration fiscale ou les fichiers de retenue.

Cas d'intégration

Conditionner l'inscription et les formulaires KYC à un RUC valide

Lorsqu'un client saisit un RUC de treize chiffres, validez au blur, affichez type_label et expected_check_digit si valid est false, et bloquez la suite tant que le chiffre de contrôle et le bloc d'établissement n'ont pas réussi.

Classer le type de contribuable avant de router les flux

Utilisez le champ type renvoyé (natural_person, private_company, public_entity) pour choisir modèles de documents, taux de retenue ou chemins d'approbation sans appel séparé au registre.

Questions techniques

Comment valider un RUC avec cette API ?

Envoyez un POST avec ruc égal à exactement treize chiffres (0-9 uniquement). La réponse inclut valid, type, type_label, check_digit, expected_check_digit le cas échéant, province_code, establishment et algorithm.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment fonctionnent les types de RUC et les chiffres de contrôle en Équateur

Comment valider un RUC pas à pas

Cas d’usage

Auditer les colonnes RUC des exports de facturation électronique

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Comment fonctionnent les types de RUC et les chiffres de contrôle en Équateur

Comment valider un RUC avec cette API

Où la validation du RUC s'insère dans de vrais flux produit

Cas d'intégration

Conditionner l'inscription et les formulaires KYC à un RUC valide

Classer le type de contribuable avant de router les flux

Questions techniques

merci