ValiCUIT

Un validador de CUIT/CUIL para ActiveModel & Rails.

Instalación

Lo de siempre... agregar esta línea en el Gemfile del proyecto:

gem 'valicuit'

Y, finalmente, ejecutar bundle install

Uso

Es un validador más. Dentro de cualquier modelo se especifica que un atributo X se valide con cuit (o cuil, es indistinto), de esta forma:

class Persona < ActiveRecord::Base
  validates :cuit, cuit: true  # Notar que también podría usarse cuil: true
end

Con esto, se dispone de validación por formato (por defecto 11 dígitos, sin separador) y por dígito verificador (con el algoritomo módulo 11)

Opciones adicionales

Se puede agregar la opción de incluir y validar un separador para los grupos que componen el CUIT/CUIL, de esta forma:

class Persona < ActiveRecord::Base
  validates :cuit, cuit: { separator: '-' }
end

Adicionalmente se puede validar que la parte del género y del DNI del CUIT se corresponda con dichos campos propios en el mismo modelo.

Por ejemplo, para el caso del DNI podría ser:

class Persona < ActiveRecord::Base
  validates :cuit, cuit: { dni_compatible: :documento }
end

Y eso verificaría que la parte central del CUIT (que corresponde al DNI) sea igual al valor del campo 'documento' (qué, en dicho modelo, representaría el DNI de la persona)

Análogamente se cumple lo mismo para el género:

class Persona < ActiveRecord::Base
  validates :cuit, cuit: { gender_compatible: { field: :genero, male: 'M', female: 'F', company: 'C' } }
end

Y se especifica el campo que representa el género en el modelo, más los valores para validar tales géneros.

Notar que la opción company, para validar CUITs de empresas/instituciones, es opcional (pasará la validación directamente en caso de no estar especificado) mientras que las opciones male, female y field no lo son.

Tests

Se corren con RSpec.

Agradecimientos

Contribuciones

Clonar el proyecto.
Crear un feature branch (git checkout -b mi-nuevo-feature).
Commitear los cambios realizados (git commit -am 'Agrego algo nuevo o mejoro algo').
Pushear el feature (git push origin mi-nuevo-feature).
Crear un Pull Request.