Cómo facturar al SRI desde Laravel en 10 minutos

Si tu aplicación está hecha en Laravel, puedes facturar al SRI con el SDK de PHP de AZUR siguiendo los patrones habituales del framework.

1. Instala el SDK

composer require azur/sdk

2. Configura la credencial

Crea la credencial en AZUR (menú de usuario → Credenciales API) y agrégala a tu .env:

AZUR_API_KEY=azur_test_...

Expónla en config/services.php:

'azur' => ['key' => env('AZUR_API_KEY')],

3. Registra el cliente en el contenedor

// AppServiceProvider::register()
$this->app->singleton(\Azur\Sdk\Azur::class, fn () =>
    new \Azur\Sdk\Azur(config('services.azur.key')));

Así puedes inyectarlo en cualquier controlador, job o servicio.

4. Factura desde un job

La facturación es ideal para un job en cola: no bloquea al usuario y se reintenta si algo falla. Dentro del job, usa el recurso de facturas del SDK para guardar el comprobante (como borrador mientras pruebas) y, cuando estés listo, enviarlo al SRI. Revisa los nombres exactos de los métodos y los campos de la factura en el README del SDK y en la referencia de la API.

El SDK agrega una Idempotency-Key automática en cada escritura, así un reintento del job no duplica la factura.

5. Recibe los webhooks

Registra un webhook para enterarte cuando el SRI autoriza o rechaza. En tu ruta, verifica la firma con el SDK antes de procesar:

$evento = \Azur\Sdk\Webhook::verificar(
    $request->getContent(), $request->headers->all(), config('services.azur.webhook_secret'));

Usa el cuerpo crudo (getContent()), no el JSON ya decodificado, y excluye la ruta del middleware CSRF.

6. Manejo de errores

El SDK lanza excepciones específicas (credencial inválida, sin permiso, validación con motivos, límite excedido). Captúralas para mostrar mensajes útiles o reprogramar el job.

Checklist antes de producción

• Credencial azur_live_ con permisos mínimos.
• IP autorizadas si tu servidor tiene IP fija.
• Webhook con firma verificada.
• Pruebas completas en ambiente de pruebas.

Integra hoy: crea tu cuenta gratis y consulta la guía de la API.