npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

validator-ec

v2.0.1

Published

Validar cédula y RUC de Ecuador según el SRI, y saber por qué fallan. Validate Ecuadorian cédula (cedula) and RUC numbers. TypeScript, sin dependencias.

Readme

validator-ec

Valida cédulas, RUCs y códigos postales ecuatorianos con las reglas que publica el SRI.

npm Descargas CI Licencia

import { isCedula, isRUC, parseIdentification } from "validator-ec";

isCedula("1710034065"); // true
isRUC("1790016919001"); // true
isRUC("9999999999999"); // false, es el consumidor final
parseIdentification("1710034060"); // { ok: false, reason: "digito_verificador" }
  • Fiel al SRI. Cada regla cita de dónde sale, y no inventa un dígito verificador que el SRI ya no garantiza.
  • No rechaza a contribuyentes reales. Acepta los RUCs de sociedades y entidades públicas que el SRI emite sin cumplir el módulo 11.
  • Probado con propiedades. Cientos de casos generados por prueba, contra un oráculo escrito aparte a partir de la regla.
  • Pequeño. Sin dependencias, con tipos incluidos, y menos de 1 kB minificado y comprimido.
  • Publicado con procedencia. Cada versión sale de GitHub Actions con una declaración de procedencia de npm que puedes verificar.

Instalación

pnpm add validator-ec

O con npm install validator-ec, yarn add validator-ec o bun add validator-ec.

Necesita Node.js 22.12 o posterior. Se publica como módulo ES, y require("validator-ec") también lo carga. En el navegador funciona con cualquier empaquetador.

API

Todas las funciones reciben una cadena y nunca lanzan errores.

Leer una identificación

parseIdentification(valor: string): Identification

Lee una cédula, un RUC o el consumidor final de una vez, y dice qué es o por qué no es válido. Es lo que usan todas las demás funciones, y lo que necesita un formulario para explicar el error.

parseIdentification("1710034065"); // { ok: true, kind: "cedula", taxpayer: "persona_natural" }
parseIdentification("1790016919001"); // { ok: true, kind: "ruc", taxpayer: "sociedad_o_extranjero" }
parseIdentification("9999999999999"); // { ok: true, kind: "consumidor_final" }
parseIdentification("1710034060"); // { ok: false, reason: "digito_verificador" }

| reason | Qué falla | | --- | --- | | "longitud" | No tiene 10 ni 13 caracteres. | | "caracteres" | Tiene algo que no es un dígito. | | "provincia" | No empieza por una provincia que pueda emitirlo: del 01 al 24, o el 30 en una cédula. | | "tercer_digito" | El tercer dígito no corresponde a ningún tipo de contribuyente. | | "digito_verificador" | El verificador de la cédula no cumple el módulo 10. | | "establecimiento" | Un RUC que no termina en 001. |

taxpayer dice a quién pertenece, hasta donde el número lo dice: "persona_natural" (una cédula o su RUC), "sociedad" (una entidad pública, tercer dígito 6) o "sociedad_o_extranjero" (tercer dígito 9: una sociedad privada o una persona natural extranjera sin cédula, que solo el catastro del SRI distingue).

Preguntas de sí o no

isCedula("1710034065"); // true
isRUC("1760001550001"); // true, entidad pública
isFinalConsumer("9999999999999"); // true
isNaturalPerson("1710034065001"); // true
taxpayerTypeOf("1790016919001"); // "sociedad_o_extranjero"

| Función | Devuelve | | --- | --- | | isCedula(valor) | Si es una cédula válida. | | isRUC(valor) | Si es un RUC válido. El consumidor final no lo es. | | isFinalConsumer(valor) | Si es 9999999999999 (FINAL_CONSUMER), el consumidor final de los comprobantes electrónicos. | | taxpayerTypeOf(ruc) | El taxpayer de un RUC válido, o null. | | isNaturalPerson(valor) | Si es, con certeza, de una persona natural: una cédula válida o su RUC. |

Una persona, dos identificaciones

El SRI deja que una persona natural compre con su cédula aunque esté inscrita con su RUC. Estas funciones las unen.

cedulaOfRUC("1710034065001"); // "1710034065"
cedulaOfRUC("1790016919001"); // null, una sociedad no tiene cédula
sameTaxpayer("1710034065001", "1710034065"); // true
sameTaxpayer("1790016919001", "1790016919"); // false

sameTaxpayer nunca une dos valores que no son cédulas o RUCs válidos.

Código postal

isZipCode(codigo: string): boolean

Si tiene la forma de un código postal ecuatoriano: seis dígitos que empiezan por una provincia del 01 al 24, o por el 90 de las zonas no delimitadas. Es independiente de las identificaciones.

isZipCode("170102"); // true, Gualea (Quito)
isZipCode("900003"); // true, Manga del Cura

Solo comprueba la forma. No hay una lista oficial abierta de los códigos que existen, así que no puede decir si un código existe: para eso, consulta a la Agencia Nacional Postal. Las pruebas comprueban que acepta los 1.225 códigos ecuatorianos que lista GeoNames.

Las reglas, y de dónde salen

El dígito verificador de la cédula sigue el módulo 10 del SRI: los nueve primeros dígitos se multiplican por 2, 1, 2…, a cada producto mayor que 9 se le resta 9, y el verificador completa la suma hasta la siguiente decena, o es 0 si ya es múltiplo de 10. El tercer dígito va del 0 al 5, porque el SRI reserva el 6 y el 9 para los RUCs de entidades públicas y sociedades.

El RUC de entidades públicas y sociedades no se comprueba con el módulo 11. Desde 2021 el SRI emite RUCs que no lo cumplen, declara válido todo RUC que genera y recomienda consultar su catastro para saber si uno existe (comunicado del SRI). Sin conexión, solo se puede comprobar su forma; para saber si un RUC existe, consulta el catastro del SRI.

El consumidor final es el tipo 07 de la tabla 6 de la ficha técnica de comprobantes electrónicos del SRI.

Desde la versión 1

La versión 2 cambia algunas respuestas para seguir al SRI. El registro de cambios explica cada una y cómo migrar.

Contribuir

Hace falta pnpm. Tras pnpm install, antes de cada pull request a main:

pnpm check        # formato, lint y código sin usar
pnpm check-types  # tipos
pnpm test         # pruebas
pnpm build        # compilación

Las pruebas son propiedades con Hegel contra un oráculo escrito en la propia prueba a partir de la regla del SRI, y cada valor fijo cita de dónde sale. AGENTS.md tiene las reglas completas.

Para publicar, sube una etiqueta vX.Y.Z que coincida con package.json: GitHub Actions publica en npm con la publicación de confianza, sin tokens.

In English

validator-ec validates Ecuadorian cédulas, RUCs (tax IDs) and postal codes with the rules Ecuador's tax authority, the SRI, publishes. It has no dependencies and ships its own types.

import { isCedula, isRUC, parseIdentification } from "validator-ec";

isCedula("1710034065"); // true
isRUC("1790016919001"); // true
parseIdentification("1710034060"); // { ok: false, reason: "digito_verificador" }

Function names are English; the values they return use the SRI's Spanish terms ("persona_natural", "digito_verificador"), so they match the SRI's own documents. The API reference above applies as written.

Licencia

Apache 2.0. La lista de códigos postales con que se prueba isZipCode (tests/data) es de GeoNames, bajo CC BY 4.0.