API REST
Tu software factura. Faxtal cumple.
Una API REST con JSON para guardar borradores, emitir, registrar recibidas y consultar su estado ante la AEAT. Tu sistema sigue siendo el tuyo.
Incluido en los planes Pro y Business.
Lo que necesitas para integrar, sin sorpresas.
Una clave por empresa
Autenticación con API key en la cabecera X-API-Key. La empresa sale de la clave, no de la URL. La creas, la rotas y la revocas desde la aplicación.
Un solo formato de factura
Borradores, emitidas y recibidas usan el mismo JSON. Tu sistema aprende un contrato y lo usa para todo.
Valida antes de guardar
Envía una factura a validar y recibe cada error con su código y la ruta del campo. No se guarda, no se numera y no se envía nada a Hacienda.
Reintentos sin duplicados
Cada borrador lleva tu referencia externa. Si repites la llamada, se actualiza el mismo borrador. Emitir dos veces la misma factura no es posible.
Estado ante la AEAT
Consulta los registros VeriFactu, los envíos al SII y las incidencias de cada factura. Sin webhooks por ahora: el estado se pide por la API.
Límites claros
120 peticiones por minuto por clave. Para volúmenes grandes, lotes de borradores y de importación. Al pasarte, la respuesta te dice cuánto esperar.
De la clave a la primera llamada.
Crea la clave en Configuración → API Keys y pide los datos de tu empresa. Si responde, ya estás dentro.
curl -s https://app.faxtal.com/api/v1.1/company \
-H "X-API-Key: $FAXTAL_API_KEY"Preguntas sobre la API.
¿Qué plan necesito?
Pro o Business, o una licencia de gestoría. La API va incluida en el plan, sin coste por llamada: cuentan las facturas del plan, no las peticiones.
¿Hay un entorno de pruebas?
No hay un entorno de pruebas de la API. Las llamadas trabajan con los datos reales de tu empresa, así que para probar una factura sin guardar nada usa la validación.
¿Qué puedo hacer con la API?
Guardar y emitir facturas, rectificarlas y anularlas, descargarlas en PDF, FacturaE, UBL o CII, registrar recibidas, gestionar terceros, productos, cobros y pagos, y consultar VeriFactu y el SII.
¿Hay SDKs?
Todavía no. La referencia interactiva se genera de la especificación OpenAPI, y con ella puedes generar un cliente en tu lenguaje o importarla en Postman.
¿Envía webhooks?
Todavía no. El estado de cada factura y de cada envío se consulta por la API.
Llevo varias empresas, ¿cómo lo hago?
Con una clave por empresa. Cada clave solo ve los datos de la suya, y los de otra empresa no existen para ella.
¿La API puede cambiar y romper mi integración?
Dentro de /api/v1.1 solo llegan cambios compatibles, como campos u operaciones nuevas. Un cambio incompatible iría en una ruta nueva.