PHPackages                             mause/laravel-arca - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. mause/laravel-arca

ActiveLibrary[API Development](/categories/api)

mause/laravel-arca
==================

Laravel package scaffold for AFIP/ARCA integrations.

v1.0.5(1mo ago)023↑130.8%MITPHPPHP ^8.1

Since Apr 28Pushed 1mo agoCompare

[ Source](https://github.com/mauseJavier/arcaWSiaMause)[ Packagist](https://packagist.org/packages/mause/laravel-arca)[ RSS](/packages/mause-laravel-arca/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (4)Versions (7)Used By (0)

Laravel ARCA SDK (Laravel 10+)
==============================

[](#laravel-arca-sdk-laravel-10)

Libreria base para integrar servicios AFIP/ARCA en aplicaciones Laravel 10, 11 y 12.

Requisitos
----------

[](#requisitos)

- PHP 8.1 o superior
- Laravel 10 o superior
- Extensiones PHP: `soap`, `openssl`, `simplexml`

Instalacion
-----------

[](#instalacion)

```
composer require mause/laravel-arca
```

### Instalacion local (sin Packagist)

[](#instalacion-local-sin-packagist)

Si estas desarrollando esta libreria en local, instalala desde tu proyecto Laravel consumidor usando un repositorio de tipo `path`.

Ejemplo en el `composer.json` del proyecto Laravel:

```
{
    "repositories": [
        {
            "type": "path",
            "url": "../ArcaWS-ia",
            "options": {
                "symlink": true
            }
        }
    ],
    "require": {
        "mause/laravel-arca": "dev-main"
    }
}
```

Luego ejecutar:

```
composer update mause/laravel-arca
php artisan vendor:publish --tag=arca-config
```

Notas:

- Ajusta `url` a la ruta real donde tengas la libreria local.
- `symlink: true` permite ver cambios de la libreria al instante en el proyecto Laravel.
- Si no usas rama `main`, cambia `dev-main` por la rama correspondiente o usa `@dev`.

Publicar configuracion
----------------------

[](#publicar-configuracion)

```
php artisan vendor:publish --tag=arca-config
```

Variables de entorno
--------------------

[](#variables-de-entorno)

```
ARCA_MODE=homologation
ARCA_WSAA_HOMO_URL=https://wsaahomo.afip.gov.ar/ws/services/LoginCms
ARCA_WSAA_PROD_URL=https://wsaa.afip.gov.ar/ws/services/LoginCms
ARCA_CERT_PATH_PATTERN=storage/app/public/%s/cert.crt
ARCA_KEY_PATH_PATTERN=storage/app/public/%s/key.key
ARCA_KEY_PASSPHRASE=

# WSN de padrón (nombre del servicio que el certificado tiene autorizado en ARCA)
# Un WSN incorrecto produce: "Computador no autorizado a acceder al servicio"
ARCA_PADRON_SERVICE_CUIT=ws_sr_constancia_inscripcion
ARCA_PADRON_SERVICE_CUIL=ws_sr_padron_a13
ARCA_PADRON_SERVICE_DNI=ws_sr_padron_a13
```

En esquema multiempresa, `%s` se reemplaza por el CUIT emisor. Ejemplo:

- `storage/app/public/30712345678/cert.crt`
- `storage/app/public/30712345678/key.key`

Uso rapido
----------

[](#uso-rapido)

### Verificar instalacion

[](#verificar-instalacion)

```
use Mause\\LaravelArca\\Facades\\Arca;

$data = Arca::ping();
```

### WSAA - Autenticacion

[](#wsaa---autenticacion)

```
use Mause\\LaravelArca\\Facades\\ArcaWsaa;

$companyCuit = '30712345678';

// Generar TRA
$tra = ArcaWsaa::generateTra('wsfe');

// Firmar TRA (CMS/PKCS#7)
$cms = ArcaWsaa::signTra($tra, $companyCuit);

// Solicitar Ticket de Acceso
$ta = ArcaWsaa::requestTa($companyCuit, 'wsfe');
// Retorna: ['token' => '...', 'sign' => '...', 'expires_at' => '...']
```

### WSFEv1 - Facturación Electrónica

[](#wsfev1---facturación-electrónica)

```
use Mause\\LaravelArca\\Facades\\ArcaWsfev1;

$companyCuit = '30712345678';

// Obtener tipos de comprobantes
$types = ArcaWsfev1::getInvoiceTypes($companyCuit);

// Obtener último número autorizado
$lastNumber = ArcaWsfev1::getLastAuthorizedNumber($companyCuit, 1, 6);

// Solicitar CAE
$invoice = [...]; // Array con datos del comprobante
$cae = ArcaWsfev1::requestCae($companyCuit, $invoice);
```

### WS Padrones - Consulta de CUIT, CUIL, DNI

[](#ws-padrones---consulta-de-cuit-cuil-dni)

**Requisito de certificado**: el certificado de cada empresa debe tener autorizado en ARCA el WSN correspondiente a cada operación:

- `ws_sr_constancia_inscripcion` → para consultas por CUIT (persona jurídica)
- `ws_sr_padron_a13` → para consultas por CUIL y por DNI

Un WSN incorrecto en el certificado produce el error "Computador no autorizado a acceder al servicio". Ver catálogo oficial:

```
use Mause\\LaravelArca\\Facades\\ArcaWsPadron;

$companyCuit = '30712345678';

// Consulta automática (detecta DNI, CUIL o CUIT)
$result = ArcaWsPadron::consultarPadron($companyCuit, '12345678');
// Retorna:
// [
//   'type' => 'dni'|'cuil'|'cuit',
//   'data' => [...],
//   'error' => null|'mensaje'
// ]

// Consulta por DNI — usa ws_sr_padron_a13 (PersonaServiceA13)
// Flujo interno: getIdPersonaListByDocumento → getPersona
// Puede retornar array cuando el DNI tiene más de un titular (ej. homónimos)
$dataDni = ArcaWsPadron::consultarPorDni($companyCuit, '12345678');

// Consulta por CUIT (persona jurídica) — usa ws_sr_constancia_inscripcion
$dataCuit = ArcaWsPadron::consultarPersona($companyCuit, '30112345678', 'cuit');

// Consulta por CUIL (persona física) — usa ws_sr_padron_a13
$dataCuil = ArcaWsPadron::consultarPersona($companyCuit, '27123456789', 'cuil');
```

#### Detección automática de tipo

[](#detección-automática-de-tipo)

El módulo detecta automáticamente el tipo de identificador:

- **DNI**: 8 dígitos → `ws_sr_padron_a13` (PersonaServiceA13)
- **CUIL**: 11 dígitos que comienzan con 27 o 28 → `ws_sr_padron_a13`
- **CUIT**: 11 dígitos restantes → `ws_sr_constancia_inscripcion`

```
// Estos se procesan automáticamente con el padrón correcto
ArcaWsPadron::consultarPadron($companyCuit, '12345678');    // → PersonaServiceA13 (DNI)
ArcaWsPadron::consultarPadron($companyCuit, '27123456789');  // → PersonaServiceA13 (CUIL)
ArcaWsPadron::consultarPadron($companyCuit, '30112345678');  // → constancia_inscripcion (CUIT)
```

#### Datos retornados

[](#datos-retornados)

**Para DNI (persona física via PersonaServiceA13)**:

- `idPersona`, `tipoClave`, `tipoPersona`
- `nombre`, `apellido`, `razonSocial`
- `tipoDocumento`, `numeroDocumento`
- `estado`, `domicilio`
- Cuando el DNI tiene más de un titular, `data` es un array de personas

**Para CUIL (persona física)**:

- mismos campos que DNI

**Para CUIT (persona jurídica)**:

- `cuit`, `razonSocial`
- `tipoPersoneria`, `estado`
- `domicilio`, `domicilioFiscal`
- `inscripcionesIva`

**IMPORTANTE**: El certificado debe estar autorizado en ARCA para los WSN correspondientes (`ws_sr_padron_a13` y/o `ws_sr_constancia_inscripcion`). No basta con autorizar un servicio genérico `padron`.

---

### WSFEv1 - Facturacion electronica

[](#wsfev1---facturacion-electronica)

```
use Mause\\LaravelArca\\Facades\\ArcaWsfev1;

$companyCuit = '30712345678';

// Obtener tipos de comprobantes
$types = ArcaWsfev1::getInvoiceTypes($companyCuit);

// Obtener ultimo numero de comprobante
$result = ArcaWsfev1::getLastAuthorizedNumber(
    companyCuit: $companyCuit,
    ptoVta: 1,      // Punto de venta
    cbteType: 6     // Tipo (6 = Factura B)
);

// Solicitar CAE
$invoice = [
    'FeCabReq' => [...],
    'FeDetReq' => [...]
];
$cae = ArcaWsfev1::requestCae($companyCuit, $invoice);
// Retorna: ['cae' => '...', 'expiration' => '...', 'error' => null]
```

Guia de homologacion
--------------------

[](#guia-de-homologacion)

Ver [HOMOLOGACION.md](HOMOLOGACION.md) para pruebas paso a paso en ambiente de testing.

Pruebas con Docker
------------------

[](#pruebas-con-docker)

Ver [DOCKER\_TESTING.md](DOCKER_TESTING.md) para levantar un Laravel consumidor en contenedor, instalar esta librería y ejecutar pruebas de WSAA/WSFEv1.

Guia para IA
------------

[](#guia-para-ia)

Esta seccion deja el contrato de uso explicito para que una IA pueda integrar esta libreria dentro de otro proyecto Laravel sin asumir firmas o rutas incorrectas.

### Supuestos de integracion

[](#supuestos-de-integracion)

- La libreria es multiempresa.
- El identificador del emisor es el CUIT de la empresa.
- Los certificados se resuelven por patron de ruta usando el CUIT emisor.
- El `Auth.Cuit` que se envia a ARCA debe ser el CUIT emisor, no el del cliente.
- El cliente del comprobante se informa dentro de `FeDetReq` con `DocTipo` y `DocNro`.

### Rutas esperadas de certificados

[](#rutas-esperadas-de-certificados)

Por defecto:

- `storage/app/public/{cuit}/cert.crt`
- `storage/app/public/{cuit}/key.key`

Importante:

- `key.key` y `request.csr` los genera la libreria.
- `cert.crt` debe ser el certificado emitido por ARCA luego de subir `request.csr`.
- Si `cert.crt` esta vacio, contiene el CSR o no corresponde con `key.key`, WSAA puede responder con errores remotos opacos como `javax.ejb.EJBException: java.lang.NullPointerException`.

Configuracion asociada:

```
ARCA_CERT_PATH_PATTERN=storage/app/public/%s/cert.crt
ARCA_KEY_PATH_PATTERN=storage/app/public/%s/key.key
```

### Firmas publicas actuales

[](#firmas-publicas-actuales)

```
Arca::ping(): array

ArcaWsaa::generateTra(string $wsn = 'wsfe'): string
ArcaWsaa::createCertificateRequest(string|int $companyCuit, array $distinguishedName, ?string $passphrase = null, int $privateKeyBits = 2048): array
ArcaWsaa::signTra(string $tra, string|int|null $companyCuit = null): ?string
ArcaWsaa::requestTa(string|int $companyCuit, string $wsn = 'wsfe'): ?array

ArcaWsfev1::getInvoiceTypes(string|int $companyCuit): ?array
ArcaWsfev1::getLastAuthorizedNumber(string|int $companyCuit, int $ptoVta, int $cbteType): ?array
ArcaWsfev1::requestCae(string|int $companyCuit, array $invoice): ?array

ArcaWsPadron::consultarPadron(string|int $companyCuit, string|int $identifier): ?array
ArcaWsPadron::consultarPorDni(string|int $companyCuit, string|int $numeroDni): array
ArcaWsPadron::consultarPersona(string|int $companyCuit, string|int $cuitOCuil, string $personType = 'cuit'): array
```

### Flujo correcto para una IA integradora

[](#flujo-correcto-para-una-ia-integradora)

1. Obtener el CUIT emisor desde el modelo de empresa o tenant.
2. Si todavía no existen credenciales, generar `key.key` y `request.csr` con `ArcaWsaa::createCertificateRequest(...)`.
3. Subir `request.csr` al portal oficial de ARCA y descargar `cert.crt`.
4. Verificar que existan `cert.crt` y `key.key` en la carpeta de ese CUIT.
5. Solicitar TA con `ArcaWsaa::requestTa($empresa->cuit, 'wsfe')`.
6. Consultar tipos o ultimo comprobante con el mismo CUIT emisor.
7. Construir `FeCabReq` y `FeDetReq`.
8. Solicitar CAE con `ArcaWsfev1::requestCae($empresa->cuit, $invoice)`.

### Datos mínimos para generar CSR

[](#datos-mínimos-para-generar-csr)

Además del CUIT emisor, esta librería necesita como mínimo:

- `organizationName`: razón social o nombre de la empresa
- `commonName`: alias o nombre del sistema que usará el certificado

Opcionales recomendados:

- `countryName`: por defecto `AR`
- `stateOrProvinceName`
- `localityName`
- `organizationalUnitName`
- `emailAddress`

La librería completa automáticamente:

- `serialNumber`: `CUIT {cuit}`

### Ejemplo de generación de CSR

[](#ejemplo-de-generación-de-csr)

```
use Mause\LaravelArca\Facades\ArcaWsaa;

$csr = ArcaWsaa::createCertificateRequest(
    companyCuit: $empresa->cuit,
    distinguishedName: [
        'organizationName' => $empresa->razon_social,
        'commonName' => 'SistemaFacturacion',
        'countryName' => 'AR',
        'stateOrProvinceName' => 'Buenos Aires',
        'localityName' => 'La Plata',
        'emailAddress' => 'admin@empresa.com',
    ],
    passphrase: null,
    privateKeyBits: 2048,
);
```

El método guarda automáticamente:

- `storage/app/public/{cuit}/key.key`
- `storage/app/public/{cuit}/request.csr`

Después tenés que subir `request.csr` a WSASS o al Administrador de Certificados Digitales para obtener `cert.crt`.

### Ejemplo minimo de integracion

[](#ejemplo-minimo-de-integracion)

```
use Mause\LaravelArca\Facades\ArcaWsaa;
use Mause\LaravelArca\Facades\ArcaWsfev1;

$companyCuit = $empresa->cuit;

$ta = ArcaWsaa::requestTa($companyCuit, 'wsfe');

$last = ArcaWsfev1::getLastAuthorizedNumber($companyCuit, 1, 6);
$nextNumber = (($last['cbte_nro'] ?? 0) + 1);

$invoice = [
    'FeCabReq' => [
        'CantReg' => 1,
        'CbteTipo' => 6,
        'PtoVta' => 1,
    ],
    'FeDetReq' => [
        'FECAEDetRequest' => [
            'Concepto' => 2,
            'DocTipo' => 96,
            'DocNro' => 12345678,
            'CbteDesde' => $nextNumber,
            'CbteHasta' => $nextNumber,
            'CbteFch' => date('Ymd'),
            'ImpTotal' => 100.00,
            'ImpTotConc' => 0,
            'ImpNeto' => 82.64,
            'ImpOpEx' => 0,
            'ImpIVA' => 17.36,
            'ImpTrib' => 0,
            'MonId' => 'PES',
            'MonCotiz' => 1,
        ],
    ],
];

$response = ArcaWsfev1::requestCae($companyCuit, $invoice);
```

### Errores de implementacion a evitar

[](#errores-de-implementacion-a-evitar)

- No pasar el CUIT emisor y asumir un certificado global.
- Enviar el CUIT del cliente en `Auth.Cuit`.
- Pedir CAE sin antes consultar el ultimo comprobante autorizado.
- Usar certificados de homologacion en modo produccion.
- Guardar token/sign fuera de un cache compartido cuando hay multiples instancias.

Estructura
----------

[](#estructura)

- `src/Services/ArcaClient.php` - Cliente base de configuracion
- `src/Modules/Wsaa.php` - Modulo WSAA (autenticacion)
- `src/Modules/Wsfev1.php` - Modulo WSFEv1 (facturacion)
- `src/Modules/WsPadron.php` - Modulo WsPadron (padrones CUIT/CUIL/DNI)
- `src/Contracts/WsaaInterface.php` - Interfaz de WSAA
- `src/Facades/Arca.php` - Facade general
- `src/Facades/ArcaWsaa.php` - Facade WSAA
- `src/Facades/ArcaWsfev1.php` - Facade WSFEv1
- `src/Facades/ArcaWsPadron.php` - Facade WsPadron
- `config/arca.php` - Configuracion del paquete
- `tests/` - Suite de pruebas unitarias (PHPUnit + Orchestra Testbench)

Ejemplos
--------

[](#ejemplos)

Ver carpeta `examples/`:

- `ArcaTestController.php` - Controlador de pruebas
- `arca-test.blade.php` - Vista para debugging

Siguientes pasos sugeridos
--------------------------

[](#siguientes-pasos-sugeridos)

- Implementar generacion de CAEA (Codigo de Autorizacion Electronico Anticipado).
- Agregar soporte para WSMTXCA (facturacion con detalle de items).
- Agregar soporte para WSFEXv1 (facturacion de exportacion).
- Implementar persistencia de CAE en base de datos.
- Generar PDF/XML firmado de comprobante.

License
-------

[](#license)

MIT License

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance91

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

41d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e90da736fd4a582fc54114768813d65fbcf624b8a0bb83ee57d61a974f324905?d=identicon)[mauseJavier](/maintainers/mauseJavier)

---

Top Contributors

[![mauseJavier](https://avatars.githubusercontent.com/u/63788706?v=4)](https://github.com/mauseJavier "mauseJavier (5 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mause-laravel-arca/health.svg)

```
[![Health](https://phpackages.com/badges/mause-laravel-arca/health.svg)](https://phpackages.com/packages/mause-laravel-arca)
```

###  Alternatives

[defstudio/telegraph

A laravel facade to interact with Telegram Bots

815320.5k3](/packages/defstudio-telegraph)[riclep/laravel-storyblok

A Laravel wrapper around the Storyblok API to provide a familiar experience for Laravel devs

6277.0k5](/packages/riclep-laravel-storyblok)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.1k1](/packages/jasara-php-amzn-selling-partner-api)[rapidez/core

Rapidez Core

1822.4k65](/packages/rapidez-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)