SDK de PHP para facturación electrónica del SRI: guía de inicio

Integrar la facturación electrónica del SRI desde PHP es más sencillo con el SDK oficial de AZUR. Resuelve lo que más tiempo toma en una integración: reintentos, duplicados, errores y webhooks.

Instalación

Requiere PHP 8.1 o superior:

composer require azur/sdk

El código fuente está en GitHub: azurfacturacionelectronica/sdk-php.

Tu credencial

Créala en AZUR en menú de usuario → Credenciales API. Usa una azur_test_ para desarrollar y guárdala en una variable de entorno, nunca en el código.

Primeros pasos

use Azur\Sdk\Azur;

$azur = new Azur(getenv('AZUR_API_KEY'));

// ¿Con qué empresa y punto de emisión estoy trabajando?
$contexto = $azur->contexto();

// Buscar clientes
$clientes = $azur->clientes->buscar('Ferretería');

Los recursos están agrupados: comprobantes, facturas, clientes, productos, inventario, cartera, contabilidad, reportes, recibidos y webhooks, entre otros. Consulta los métodos exactos en el README del repositorio.

Lo que el SDK hace por ti

• Reintentos automáticos ante límites por minuto (respetando Retry-After) y fallos de red.
• Idempotency-Key automática en las escrituras: un reintento no duplica la factura.
• Sincronización por cursor para traer todo lo nuevo sin perder ni repetir comprobantes.
• Excepciones claras: credencial inválida, sin permiso, no encontrado, validación con sus motivos, límite excedido.
• Verificación de webhooks con Azur\Sdk\Webhook::verificar().

¿Ya usas la api_key de emisión?

Si tu sistema emite con la API clásica (/factura/emision con la api_key del punto), el SDK incluye Azur\Sdk\Emision para seguir usándola, incluida la retención 2.0 con retencion20().

Siguientes pasos

• Revisa la referencia completa.
• Configura un webhook para enterarte cuando el SRI autoriza.
• Pasa a producción con una credencial azur_live_ y permisos mínimos.

Empieza a integrar: crea tu cuenta gratis.