Esta guía propone una arquitectura de integración para aplicaciones PHP 7.4 y 8.x. La adaptación debe implementarse y probarse con tu software y su versión concreta.
1. Mantén las credenciales en el servidor
Solicita la URL del entorno, client_id y client_secret. Obtén el token mediante auth_api. La documentación pública no fija la cabecera del token para operaciones posteriores: confírmala con soporte antes de implementar esas llamadas.
2. Separa emisión y transmisión
Desde el evento de emisión de tu aplicación, guarda una tarea asociada a la factura. Un proceso de cola o cron enviará el registro. Así, una demora de la AEAT no bloquea la pantalla comercial. Utiliza los puntos de extensión de tu software para mantener la integración separada de su núcleo.
3. Persiste los identificadores
Almacena el identificador interno, el número de factura, queueId y el estado. Aplica una restricción única que impida crear dos tareas para la misma factura. No confíes en la memoria del proceso para evitar duplicados.
4. Verifica el resultado
Procesa las consultas y los webhooks con validación de autenticidad. Revisa rechazos y aceptaciones con errores. Si no recibes respuesta al envío, consulta por referencia antes de reintentar.
Ejemplo de autenticación PHP
El ejemplo descargable usa cURL con verificación TLS, tiempos límite y comprobación de JSON. Utiliza variables de entorno y no realiza llamadas hasta que lo ejecutes con la configuración del entorno de pruebas.
PHP · Autenticación ↓