API
La API pública de Faxtal permite a tu programa emitir y registrar facturas, llevarlas a VeriFactu o SII e importar históricos sin pasar por la aplicación.
- Si empiezas: Introducción → Primeros pasos → Autenticación.
- Si integras de verdad: el formato canónico
json_1_1es el contrato que hay que entender. - Si buscas un caso concreto: las recetas encadenan las operaciones de principio a fin.
- Si algo falla: errores.
- Explorador interactivo: Referencia API, generada del
openapi.json.
Datos básicos
| Dato | Valor |
|---|---|
| URL base | https://app.faxtal.com/api/v1.1 |
| Autenticación | Cabecera X-API-Key |
| Empresa | Cada API key trabaja sobre una sola empresa, que no viaja en la URL |
| Versión | v1.1 (ver versionado) |
Endpoints por recurso
Las rutas son relativas a la URL base. Cada grupo aparece con el mismo nombre en la Referencia API, donde están los parámetros y esquemas de cada operación.
| Grupo | Rutas | Qué puedes hacer | Guía |
|---|---|---|---|
| General | /health | Comprobar que la API responde | Referencia |
| Empresas | /company, /companies, /certificates | Ver la empresa de la API key y sus certificados | Multiempresa |
| Borradores | /drafts | Crear y actualizar borradores, uno a uno o en bloque; validarlos, consultarlos, eliminarlos y ver su histórico | Borradores |
| Facturas emitidas | /issued-invoices | Emitir un borrador, importar emitidas (una o en bloque), anular, enviar por email, exportar a XML, descargar el PDF, adjuntar documentos y ver el histórico | Emitidas |
| Facturas recibidas | /received-invoices | Registrar o actualizar, importar XML, validar, eliminar, descargar el PDF, adjuntar documentos y ver el histórico | Recibidas |
| Terceros y productos | /third-parties, /products, /received-invoices/recognize | Buscar terceros y darlos de alta por NIF, buscar productos y reconocer una factura recibida desde un PDF o una imagen | Terceros y productos |
| VeriFactu | /verifactu, /invoices/{invoice_id}/verifactu | Configuración, registros y XML por factura, registros en la AEAT por periodo, envíos, incidencias y eventos SIF | Cumplimiento |
| SII | /sii, /invoices/{invoice_id}/sii | Configuración, facturas pendientes y próximas a vencer, envíos y estado por factura | Cumplimiento |
Fuera de la referencia OpenAPI:
- El servidor MCP ofrece operaciones de la API a asistentes de IA (ChatGPT, Claude, Cursor o un agente propio).
- Los webhooks están en el roadmap.