ForHosting KIT · Utilidades de desarrollo

Dígito verificador RUC Ecuador

1710034065001 es válido: persona natural de la provincia 17, dígito verificador 5 en la décima posición y establecimiento 001. La herramienta lee el tercer dígito para aplicar la regla correcta, módulo 10 u 11, y le indica el tipo de contribuyente. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Ruc
1710034065001
Obtiene
Tipo
natural_person
Etiqueta del tipo
Natural person (persona natural)
Tercer dígito
1
Código de provincia
17

El RUC ecuatoriano (Registro Único de Contribuyentes) es el identificador fiscal de trece dígitos que emite el Servicio de Rentas Internas para personas naturales, sociedades privadas y entidades públicas. Los dos primeros dígitos codifican la provincia, el tercero selecciona la clase de contribuyente, un dígito de control ponderado ocupa la posición nueve o diez según esa clase, y el bloque final es el código de establecimiento o sucursal. Esta capacidad valida un RUC de trece dígitos puros según el tercer dígito: valores de cero a cinco aplican la regla de módulo diez de persona natural compartida con la cédula, el seis usa los pesos de módulo once de entidad pública, y el nueve usa los de sociedad privada. La respuesta indica si el dígito de control almacenado coincide con el recalculado, el tipo detectado, el código de provincia, el bloque de establecimiento y el dígito esperado cuando existe.

Cómo funcionan los tipos de RUC y los dígitos de control en Ecuador

Un RUC bien formado siempre tiene trece dígitos decimales cuando se elimina la puntuación. Las posiciones uno y dos son el código de provincia y deben estar en el rango de cero-uno a veinticuatro para jurisdicciones nacionales, o treinta para residentes extranjeros registrados en Ecuador.

La posición tres es el discriminador de tipo que elige la categoría legal y la aritmética: los dígitos de cero a cinco marcan persona natural, incluidos regímenes especiales que siguen el cuerpo estilo cédula; el seis marca entidad pública (sector público); el nueve marca sociedad privada. Los dígitos siete y ocho están reservados y no son códigos de tipo válidos, por lo que esta herramienta los rechaza antes de cualquier suma ponderada.

En personas naturales los primeros diez dígitos coinciden con la cédula y el dígito de control es la posición diez bajo módulo diez con coeficientes dos-uno repetidos: cada producto de nueve o más se reduce en nueve (suma de dígitos), la suma se toma módulo diez, y el control es diez menos ese resto, o cero cuando el resto ya es cero.

En sociedades privadas el dígito de control también es la posición diez, pero los pesos son cuatro, tres, dos, siete, seis, cinco, cuatro, tres, dos sobre los primeros nueve dígitos y el resto de la suma módulo once se mapea a cero si el resto es cero; en caso contrario, once menos el resto; un valor mapeado de diez significa que no existe un único dígito decimal de control y el número no puede ser válido.

En entidades públicas el dígito de control es la posición nueve, los pesos son tres, dos, siete, seis, cinco, cuatro, tres, dos sobre los primeros ocho dígitos, y aplica el mismo mapeo de módulo once. Tras el dígito de control, los RUC naturales y privados llevan un código de establecimiento de tres dígitos entre uno y novecientos noventa y nueve (la matriz suele ser cero-cero-uno); las entidades públicas llevan un bloque de sucursal de cuatro dígitos entre uno y nueve mil novecientos noventa y nueve.

Dónde encaja la validación del RUC en flujos de producto reales

Los flujos de alta de fintech y marketplaces ecuatorianos piden el RUC pronto; validar dígitos de control y tipo al perder el foco reduce envíos fallidos y tickets de soporte sin llamar al SRI en cada pulsación. Los sistemas contables y de facturación electrónica que emiten comprobantes electrónicos deben poner en cuarentena filas cuyo dígito de control ya no coincida o cuyo bloque de establecimiento sea todo ceros antes de que el documento llegue a la autorización. Las importaciones de nómina y RR.

No trate un dígito de control correcto como prueba de que el contribuyente existe en los sistemas del SRI, de que el RUC está activo o de que el establecimiento está autorizado a emitir facturas: solo demuestra que la cadena de trece dígitos está aritméticamente bien formada bajo las reglas oficiales dependientes del tipo, el mismo criterio de honestidad que aplica a cualquier herramienta de suma de control fiscal.

Auditar columnas RUC en exportaciones de facturación electrónica

Valide por lotes cada RUC de un CSV de ventas o retenciones y ponga en cuarentena las filas cuyo dígito de control ya no coincida con el valor recalculado o cuyo tercer dígito sea un código reservado.

¿Qué es el dígito de control del RUC ecuatoriano?

Es el dígito verificador dentro de un RUC de trece dígitos, calculado a partir del cuerpo inicial con pesos que dependen del tercer dígito: módulo diez para personas naturales (posiciones 0–5) y módulo once para entidades públicas (6) y sociedades privadas (9).

¿Qué significa el tercer dígito?

0–5 significa persona natural (control módulo 10 en la posición 10), 6 entidad pública (módulo 11 en la posición 9) y 9 sociedad privada (módulo 11 en la posición 10).

¿Qué ocurre con letras, guiones, longitud incorrecta o códigos de provincia erróneos?

Las tareas de validación fallidas no se facturan. Elimine el formato en su cliente antes de llamar.

¿Es gratuita la herramienta de dígito de control del RUC de Ecuador?

La herramienta del navegador es gratuita y se ejecuta en local.

¿El RUC de una persona natural es igual a su cédula?

Casi. En una persona natural, los diez primeros dígitos del RUC coinciden con la cédula, dígito verificador incluido, y los tres últimos son el código de establecimiento, como 001. Por eso ambos usan la misma regla del módulo 10.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

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

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/enc/ruc-ecuador \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"1710034065001"}'
{
  "ruc": "1710034065001"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ruc_ecuador",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Caracteres no numéricos, longitudes incorrectas, códigos de provincia inválidos y terceros dígitos reservados se rechazan con un error invalid_input claro. Ejecútela gratis en el navegador o llame a la API de KIT; ambas rutas comparten la misma aritmética pura, sin ida y vuelta de red ni consulta al registro del SRI.

Cómo funcionan los tipos de RUC y los dígitos de control en Ecuador

Como cada paso es aritmética modular de pesos fijos, los mismos trece dígitos producen siempre el mismo veredicto de validez en el navegador, en el Worker o en un arnés fuera de línea: por eso la capacidad se publica como motor parse de nivel A y no como llamada a un modelo ni consulta en vivo al SRI.

Cómo validar un RUC con esta API

Envíe un campo ruc que contenga solo caracteres del cero al nueve y tenga exactamente trece dígitos. Cadenas vacías, ruc ausente, longitudes distintas de trece, códigos de provincia fuera de cero-uno a veinticuatro y treinta, y terceros dígitos siete u ocho fallan antes de cualquier suma ponderada y no se facturan. Prefiera esta capacidad cuando necesite el informe de tipo específico de Ecuador y el enrutado oficial dual módulo diez / módulo once; un comprobador genérico de formato de NIF de varios países no aplicará las ramas del tercer dígito del SRI ni las reglas de establecimiento. Espacios, puntos, guiones, letras y puntos decimales se rechazan como entrada no numérica con invalid_input para que un formulario no acepte un valor limpiado en silencio: elimine cualquier máscara de formato en su cliente antes de la llamada. Si tiene éxito, el motor devuelve ruc como cadena de dígitos normalizada, valid como booleano, type como uno de natural_person, public_entity o private_company, type_label como descripción breve, third_digit, province_code, algorithm como modulo_10 o modulo_11, check_position (nueve o diez), check_digit tal como se envió, expected_check_digit cuando se pudo calcular un dígito decimal, establishment como bloque de sucursal final, length trece y algorithm_id ruc_ecuador. Valid es true solo cuando el dígito de control coincide y el bloque de establecimiento está en el rango no nulo permitido para ese tipo; un dígito incorrecto sigue devolviendo un payload estructurado con valid false para que pueda mostrar «esperado X, recibido Y» sin una segunda petición. Como la ruta es parse puro, sin reloj, fuente aleatoria ni red, la misma entrada produce siempre el mismo JSON en la herramienta gratuita del navegador y en la API. A $0.002 por solicitud correcta puede proteger importaciones masivas de CRM, puertas de facturación electrónica y auditorías de archivos de socios sin negociar un tramo a medida.

Dónde encaja la validación del RUC en flujos de producto reales

HH. de contratistas independientes pueden condicionar el almacenamiento a valid true y mostrar type_label para que el operador vea si el número es persona natural, sociedad privada o entidad pública. Los trabajos de calidad de datos recalculan expected_check_digit para cada columna RUC de una exportación ERP y marcan discrepancias antes de que lleguen a la declaración fiscal o a los archivos de retención.

Condicionar altas y formularios KYC a un RUC válido

Cuando un cliente escriba un RUC de trece dígitos, valídelo al perder el foco, muestre type_label y expected_check_digit si valid es false, y bloquee el avance hasta que el dígito de control y el bloque de establecimiento pasen.

Clasificar el tipo de contribuyente antes de enrutar flujos

Use el campo type devuelto (natural_person, private_company, public_entity) para elegir plantillas de documento, tasas de retención o rutas de aprobación sin una consulta separada al registro.

¿Cómo valido un RUC con esta API?

Haga POST con ruc igual a exactamente trece dígitos (solo 0-9). La respuesta incluye valid, type, type_label, check_digit, expected_check_digit cuando esté disponible, province_code, establishment y algorithm.

Ver la documentación completa del KIT →