alban/validador-cedula-ruc-ec

Validador de RUC y cédula en Ecuador

1.0.1 2024-01-12 00:47 UTC

Requires

• php: >=5.4.0

Requires (Dev)

• phpunit/phpunit: ^6.1

MIT

• Christian Albán
• Edwin Ramírez
• Bryan Suárez

README

Descargo de responsabilidad Este proyecto no es de mi autoría, es un fork del proyecto tavo1987/ec-laravel-validator, el cual busca continuar manteniendo el packete y corregir errores.

Notas

• Se corrige el error conocido del tercér dígito menor a 6 para las cédulas

Este pequeño paquete ha sido desarrollado para validar fácilmente:

• Cédula
• RUC de persona natural
• RUC de sociedad privada
• RUC de sociedad pública

Introducción

Para el desarrollo de este paquete se ha tomado como base el siguiente repositorio validacion-cedula-ruc-ecuador creado por diaspar, el cual ha sido modificado, para que sea mucho más fácil de instalar y usar en cualquier proyecto PHP mediante composer.

Si quieres saber más sobre la lógica utilizada a este paquete puedes visitar el siguiente artículo Cómo validar cédula y RUC en Ecuador, donde se detalla el proceso manual.

Instalación

composer require alban/validador-cedula-ruc-ec

Uso

• Primero Asegúrese de requerir al archivo de carga automática de composer así:

require 'vendor/autoload.php';

• Luego Instanciar la clase y llamar al método para validar la identificación

Ejemplo:

//Cargar el autoload de composer
require 'vendor/autoload.php';

// Crear nuevo objeto
$validador = new Alban\ValidadorEc;

// validar CI
if ($validador->validarCedula('0926687856')) {
    echo 'Cédula válida';
} else {
    echo 'Cédula incorrecta: '.$validador->getError();
}

// validar RUC persona natural
if ($validador->validarRucPersonaNatural('0926687856001')) {
    echo 'RUC válido';
} else {
    echo 'RUC incorrecto: '.$validador->getError();
}

// validar RUC sociedad privada
if ($validador->validarRucSociedadPrivada('0992397535001')) {
    echo 'RUC válido';
} else {
    echo 'RUC incorrecto: '.$validador->getError();
}

// validar RUC sociedad pública
if ($validador->validarRucSociedadPublica('1760001550001')) {
    echo 'RUC válido';
} else {
    echo 'RUC incorrecto: '.$validador->getError();
}

Tests

El paquete se encuentra con su respectiva suite de tests (phpunit) los cuales puedes encontrarlos en el siguiente directorio tests

Cómo contribuir

Si encuentras algún error o quieres agregar más funcionalidad, por favor siéntete libre de abrir un issue o enviar un pull request, que lo analizaremos y agregaremos a nuestro repositorio lo mas pronto posible, siempre y cuando cumpla con las siguientes reglas

• Todos los Test deben estar en verde, es decir pasar exitosamente
• Si escribes una nueva funcionalidad este debe tener su propio test, para probar la misma