Basicamente este repositorio permitirá tener una clase para validar Cédula y Ruc Ecuador.
PHP
Switch branches/tags
Nothing to show
Clone or download
diaspar Merge pull request #2 from jaop2316/master
Correct spelling errors in the messages that show to the users
Latest commit 085dd53 Jan 30, 2017

README.md

ValidadorIdentificacion

Introducción

Básicamente la Clase ValidadorIdentificacion permitirá tener una clase para validar Cédula y RUC del Ecuador. Se busca llegar a los lenguajes más populares: php, js, java, .net (vb, c-sharp), ruby.

Ya la clase inicial creada en php permite validar cédula, RUC de persona natural y RUC de sociedad privada y públicas

El siguiente link permitira conocer un poco más de la matematica asociada:

http://www.icaiza.com/blog/programacion/como-validar-el-digito-verificador-de-la-cedula-ecuatoriana

Adjuntamos también un documento teórico (instructivo.pdf - página 36 a la 40)

El proyecto cuenta con documentación automática creada por phpdocumentor en el folder docs/

Uso

  • Incluir la clase en el proyecto PHP deseado.
  • Instanciar la clase y llamar al metodo para validar la identificación
require('validadores/php/validaridentificacion.php');

// Crear nuevo objecto
$validador = new ValidarIdentificacion();

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

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

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

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

Tests

Para ver todos los mensajes de error que provee la clase se adjunta archivo de tests.

Para poder correr los tests, instalar y usar phpunit de la siguiente forma:

phpunit --verbose --colors ValidarIdentificacionTest.php

Como ayudar

Me gustaría contar con la ayuda de la Comunidad. Si desean pueden:

  • Ver el código e indicar cualquier corrección.
  • Ver y probar los tests con phpunit e indicar si pueden agregarse mas tests
  • Usar la clase de php como base y crear Una clase en otro lenguaje.
  • Crear tests para clases en otro lenguaje.
  • Mejorar la documentacion.

Si desean pueden hacer un pull request y yo acepto sus cambios a medida que los hagan.

Contactarme

Twitter: @diaspar3

Github: https://github.com/diaspar/validacion-cedula-ruc-ecuador

E-mail: mauriciolopeztam@gmail.com