Esta documentación de la API VeriFactu Online explica cómo enviar tus registros de facturación a la AEAT desde cualquier software. Así, en lugar de integrarte directamente con la API de la administración, envías tus peticiones en JSON y evitas su complejidad técnica.
Estos son los endpoints disponibles. Además, cada uno enlaza con su documentación técnica.
La API está pensada para que integres tu software en poco tiempo. Por eso, la documentación de la API VeriFactu Online incluye ejemplos y colecciones Postman. Si aún no conoces el servicio, consulta antes qué es la API VeriFactu Online.
Antes de programar, repasa cómo funciona un envío y los puntos clave de la integración.
Primero, tu software envía una petición con la API Key del emisor y un JSON con los datos de la factura.
Después, la API responde de inmediato con el QR en Base64, listo para incluirlo en la factura.
Luego, VeriFactu Online transmite la información a la API de la administración en un plazo de 4 a 100 segundos.
Finalmente, consultas la respuesta para confirmar si la factura fue aceptada o requiere correcciones.
La API es RESTful y trabaja en JSON. Por tanto, antes de empezar confirma que tu entorno de desarrollo y tu lenguaje soportan peticiones REST.
Cada llamada incluye una API Key, que identifica al contribuyente, y un cuerpo JSON con la información fiscal. Así puedes crear facturas, emitir rectificativas o subsanar registros.
La API Key define también si trabajas en pruebas o en producción. Por tanto, valida primero tu integración en el entorno de pruebas con actividad real.
Las respuestas de la administración no son síncronas: tardan entre 4 y 100 segundos. Por eso, debes consultar el estado de cada petición para confirmar que se procesó o corregir errores a tiempo.
El QR es una URL única de la AEAT en la que el receptor comprueba que la factura fue comunicada. Se forma con el NIF del emisor, la serie, el número, la fecha y el importe. Aunque la API lo devuelve al instante, también puedes generarlo tú con cualquier librería de QR.
En modo VeriFactu no es obligatorio conservar los registros de facturación (los XML de petición y respuesta), porque ya se han remitido a la administración. Aun así, puedes descargarlos mediante la API. Sin embargo, la obligación de conservar las facturas sigue vigente.
La administración exige una declaración responsable visible para los usuarios y referida a la numeración vigente del software. Por eso, VeriFactu Online la publica en el pie de esta web y, además, en un endpoint específico de la API.
Nuestra API replica los endpoints, la estructura de las llamadas y los mensajes de error de la administración. De este modo, cualquier error que recibas procede, salvo excepciones, directamente de ella y puedes corregirlo sin intermediarios.
Crea tu cuenta y, después, valida tu integración en el entorno de pruebas.
A continuación tienes la documentación de la API VeriFactu, endpoint a endpoint. Despliega cada apartado para ver sus parámetros y ejemplos.
