Argentine Fields by Nodo N

• Installation
• Form fields
• Table columns and infolist entries
• Validation rules (Laravel, no Filament needed)
• Translations
• Notes and limits
• Testing
• License

Form fields, table columns, infolist entries and validation rules for the data every Argentine app asks for: CUIT/CUIL, DNI, CBU/CVU, alias, phone numbers, amounts in pesos, provinces and VAT condition.

• Real validation: CUIT and CBU check digits, not just a regex.
• Typing masks (20-12345678-6, 12.345.678, $ 1.234,56).
• Stores clean values (only digits, plain decimals) and shows them formatted.
• The validation rules also work in plain Laravel, without Filament.
• Messages in Spanish and English.

Requires PHP 8.3+ and Filament 5.

#Installation

composer require nodonhq/filament-argentina

#Form fields

use NodonHq\FilamentArgentina\Forms\CbuAliasInput;
use NodonHq\FilamentArgentina\Forms\CbuInput;
use NodonHq\FilamentArgentina\Forms\CuitInput;
use NodonHq\FilamentArgentina\Forms\DniInput;
use NodonHq\FilamentArgentina\Forms\PesosInput;
use NodonHq\FilamentArgentina\Forms\PhoneInput;
use NodonHq\FilamentArgentina\Forms\ProvinceSelect;
use NodonHq\FilamentArgentina\Forms\TaxConditionSelect;

CuitInput::make('cuit')->label('CUIT'),            // stores 20123456786
CuitInput::make('cuit')->company(),                // only legal entities (30, 33, 34)
CuitInput::make('cuil')->person(),                 // only individuals
DniInput::make('dni'),                             // stores 12345678
CbuInput::make('cbu'),                             // CBU or CVU, stores the 22 digits
CbuInput::make('cvu')->cvuOnly(),                  // or ->cbuOnly()
CbuAliasInput::make('alias'),
PhoneInput::make('phone'),                         // stores 1123456789
PhoneInput::make('whatsapp')->e164(mobile: true),  // stores +5491123456789
PesosInput::make('price'),                         // typed 1.234,56, stores "1234.56"
ProvinceSelect::make('province'),                  // stores the ISO 3166-2 code (AR-X)
TaxConditionSelect::make('tax_condition'),         // stores ARCA's id (5 = Consumidor Final)

To keep the separators in the database, add ->storeFormatted() to the CUIT, DNI or CBU fields.

#Table columns and infolist entries

use NodonHq\FilamentArgentina\Tables\CbuColumn;
use NodonHq\FilamentArgentina\Tables\CuitColumn;
use NodonHq\FilamentArgentina\Tables\DniColumn;
use NodonHq\FilamentArgentina\Tables\PesosColumn;

CuitColumn::make('cuit'),       // 20-12345678-6
DniColumn::make('dni'),         // 12.345.678
CbuColumn::make('cbu'),         // 01105995 40000000123457
PesosColumn::make('price'),     // $ 1.234,56 (right aligned)

The same exist for infolists in NodonHq\FilamentArgentina\Infolists: CuitEntry, DniEntry, CbuEntry and PesosEntry.

For provinces and VAT condition, cast the attribute to the enum and use a regular TextColumn: it shows the label.

protected function casts(): array
{
    return [
        'province' => \NodonHq\FilamentArgentina\Enums\Province::class,
        'tax_condition' => \NodonHq\FilamentArgentina\Enums\TaxCondition::class,
    ];
}

#Validation rules (Laravel, no Filament needed)

use NodonHq\FilamentArgentina\Rules\ArgentinePhone;
use NodonHq\FilamentArgentina\Rules\Cbu;
use NodonHq\FilamentArgentina\Rules\CbuAlias;
use NodonHq\FilamentArgentina\Rules\Cuit;
use NodonHq\FilamentArgentina\Rules\Dni;
use NodonHq\FilamentArgentina\Rules\PesosAmount;

$request->validate([
    'cuit' => ['required', new Cuit],
    'company_cuit' => ['required', Cuit::make()->company()],
    'dni' => [new Dni],
    'cbu' => [new Cbu],
    'cvu' => [Cbu::make()->cvuOnly()],
    'alias' => [new CbuAlias],
    'phone' => [new ArgentinePhone],
    'amount' => [new PesosAmount],
]);

The checks behind them are available as plain helpers in NodonHq\FilamentArgentina\Support (Cuit::isValid(), Cuit::format(), Cbu::isCvu(), Phone::e164(), Pesos::parse(), ...).

#Translations

Messages come in Spanish (es) and English (en) and follow the app locale. To change them:

php artisan vendor:publish --tag=filament-argentina-translations

#Notes and limits

• Phone numbers must include the area code. The old mobile format with 15 (011 15 1234-5678) is not accepted: use 11 1234-5678 or +54 9 11 1234-5678.
• The CUIT check is offline: it verifies the number is well formed, not that it is registered with ARCA.
• CUIT prefixes accepted by default: 20, 23, 24, 25, 26, 27 (individuals) and 30, 33, 34 (legal entities).

#Testing

composer test
composer analyse

#License

MIT. See LICENSE.md.