cloudfactu.

Mándanos JSON.
Del XML nos ocupamos nosotros.

Una API REST, SDKs oficiales y un sandbox conectado al entorno de pruebas de la AEAT. Sin encadenar hashes a mano, sin XAdES, sin SOAP.

Pedir acceso al sandbox

La documentación completa se publica con el acceso. Mientras, esto es lo que vas a encontrar.

Cómo es la integración

  1. Alta del NIF. POST /v1/nifs con los datos del obligado y la modalidad (VeriFactu o No VeriFactu; TicketBAI si es foral).
  2. Certificado o representación. Subes el certificado a la bóveda una vez, o el cliente firma el modelo de representación desde el enlace que te devolvemos.
  3. Registro por factura. POST /v1/registros con el JSON de la factura. Devolvemos huella, QR y estado. Anulaciones con POST /v1/registros/{id}/anular.
  4. Webhooks. Cada respuesta de la AEAT llega firmada a tu endpoint, con reintentos e idempotencia.
PHP / LaravelNode / TSPython.NETWooCommercePrestaShopShopifyOdooStripe
# Alta de un registro de facturación POST https://api.cloudfactu.com/v1/registros Authorization: Bearer cf_live_… { "nif_emisor": "B12345678", "serie": "F2026", "numero": "000420", "fecha": "2026-09-16", "destinatario": { "nif": "12345678Z", "nombre": "María Ibarra" }, "lineas": [{ "base": 79.75, "iva": 21 }], "modalidad": "verifactu" } # 201 Created { "estado": "aceptado", "huella": "C2E0771B…5F08", "qr_url": "https://…/cotejo?…" } # Webhook firmado (HMAC-SHA256) POST https://tu-servidor.com/webhooks/cloudfactu X-CF-Signature: t=1758012345,v1=… { "evento": "registro.aceptado", "id": "reg_01J…" }

Lo que nos preguntan los developers

¿Tengo que implementar el encadenado de huellas?

No. Lo hacemos nosotros por NIF y serie, y garantizamos la continuidad de la cadena. Si vienes de otro proveedor, importamos tu última huella para no romperla.

¿Y la declaración responsable?

Te damos la plantilla adaptada a una arquitectura mixta (tu software + nuestro componente) y revisamos contigo lo que firmas. La responsabilidad legal del SIF es compartida y está documentada en las condiciones.

¿Puedo probar con mi NIF real?

Sí, en el sandbox, que apunta al entorno de pruebas de la AEAT. Nada se envía a producción hasta que activas el NIF y pagas.

¿Qué límites tiene la API?

5.000 facturas por NIF y mes incluidas; por encima, 1 € por cada 1.000. Sin límite de llamadas de consulta razonable; te avisamos antes de aplicar cualquier throttling.