devralint/cuit-cuil-validator

Validador y parser de CUIT/CUIL argentinos (dígito verificador módulo 11). Sin dependencias de framework.

v1.0.0 2026-06-02 13:50 UTC

Requires

• php: >=8.2

Requires (Dev)

• phpstan/phpstan: ^1.11
• phpunit/phpunit: ^11

MIT

• Devralint

• validator
• argentina
• validador
• afip
• CUIT
• arca
• cuil
• cuit-validator

Published on Packagist.org on 2026-06-02 14:16 UTC

README

devralint/cuit-cuil-validator

Librería PHP para validar y parsear CUIT/CUIL argentinos. Algoritmo módulo 11 con pesos [5,4,3,2,7,6,5,4,3,2]. Sin dependencias de framework.

Instalación

composer require devralint/cuit-cuil-validator

Requisitos: PHP >= 8.2

Uso

Validación rápida (stateless)

use Devralint\Cuit\Validator;

Validator::isValid('20-12345678-6'); // true
Validator::isValid('20-12345678-9'); // false — dígito verificador incorrecto
Validator::isValid('20 12345678 6'); // true — acepta espacios
Validator::isValid('20123456786');   // true — sin separadores

Value object

use Devralint\Cuit\Cuit;
use Devralint\Cuit\Exception\InvalidCuitException;

// Construcción estricta: lanza InvalidCuitException si inválido
$cuit = Cuit::fromString('20-12345678-6');

echo $cuit->prefix;      // "20"
echo $cuit->body;        // "12345678"
echo $cuit->checkDigit;  // 6
echo $cuit->formatted(); // "20-12345678-6"
echo (string) $cuit;     // "20-12345678-6"

$cuit->isFisica();       // true
$cuit->isJuridica();     // false

// Construcción tolerante: devuelve null si inválido
$cuit = Cuit::tryFrom('invalido'); // null

Tipo de persona

use Devralint\Cuit\PersonaType;

$cuit->type; // PersonaType::Fisica | PersonaType::Juridica | PersonaType::Otro

Prefijos	Tipo
20, 23, 24, 25, 26, 27	Fisica
30, 33, 34	Juridica
otros	Otro (CUIT válido, tipo desconocido)

Nota: la inferencia del tipo es orientativa. AFIP/ARCA es la fuente de verdad definitiva.

Integración con Laravel

// En un Form Request
use Devralint\Cuit\Validator as CuitValidator;

$request->validate([
    'cuit' => ['required', 'string', function (string $attr, mixed $value, Closure $fail) {
        if (!CuitValidator::isValid((string) $value)) {
            $fail("El campo $attr no es un CUIT/CUIL válido.");
        }
    }],
]);

Para una integración completa (Rule, cast Eloquent, Service Provider), ver el paquete satélite devralint/laravel-cuit (próximamente).

Integración con Yii 2

use Devralint\Cuit\Validator as CuitValidator;
use yii\validators\Validator;

class CuitValidator extends Validator
{
    public function validateValue($value): ?array
    {
        return CuitValidator::isValid((string) $value)
            ? null
            : [$this->message ?? 'CUIT/CUIL inválido.', []];
    }
}

Caso de borde: dígito verificador = 10

El algoritmo módulo 11 puede producir dv = 10. Esta librería usa la convención permisiva (la más difundida en Argentina): 10 → 9. AFIP/ARCA evita emitir CUIT con ese resultado reasignando el prefijo, por lo que en la práctica estos casos son raros.

Desarrollo

composer install
composer test       # PHPUnit 11
composer analyse    # PHPStan level max

Licencia

MIT — ver LICENSE.