API Pública de FacturaDirecta
La API pública de FacturaDirecta te permite integrar tu software con el sistema de facturación. Está disponible en todos los planes, incluido Gratis. Cada plan aplica su propio límite de peticiones por minuto: 30 en Gratis, 60 en Bronce, 120 en Plata, 300 en Oro y 600 en Diamante. El detalle y las cabeceras que devuelve la API están en Autenticación.
Algunos recursos dependen además del plan contratado: los pedidos, las órdenes de compra y el control de stock de los productos forman parte del Módulo Inventario.
Puedes automatizar procesos como crear facturas desde un CRM, sincronizar contactos con un ERP, conectar una tienda online o generar informes personalizados con datos de facturación y contabilidad.
La API es REST, usa JSON y se documenta mediante OpenAPI.
Recomendación: antes de empezar a desarrollar, crea un entorno de pruebas (sandbox) para hacer tus primeras llamadas sin afectar a los datos reales de tu empresa.
URL base y referencia OpenAPI
Todas las URLs de la API pública en producción tienen este prefijo:
https://app.facturadirecta.com/api
Recursos técnicos:
Swagger UI / referencia navegable:
https://www.facturadirecta.com/apiOpenAPI crudo:
https://app.facturadirecta.com/openapi.json
Puedes importar el OpenAPI en herramientas como Postman o Insomnia, o generar clientes automáticamente con herramientas tipo OpenAPI Generator.
Autenticación
La API admite dos métodos de autenticación:
API key
Recomendado para integraciones de una empresa concreta: scripts internos, conectores, plugins o automatizaciones.
Crea la clave desde FacturaDirecta y envíala en la cabecera:
facturadirecta-api-key: TU_CLAVE_API
Ventajas:
El acceso se limita a los permisos asignados a la clave.
Cada clave pertenece a la empresa donde se creó.
No depende de una sesión de usuario.
Consulta API keys para la referencia técnica y API keys en Ajustes para crear la clave desde la interfaz.
OAuth2
Recomendado para aplicaciones que conectan con empresas de terceros o necesitan que un usuario autorice scopes concretos.
Usa el flujo Authorization Code con PKCE y envía el token en la cabecera:
Authorization: Bearer access_token
Consulta Autenticación para el detalle del flujo OAuth2, scopes y endpoints de autorización.
Abrir un resultado en FacturaDirecta
Las respuestas de documentos, contactos, productos y bancos incluyen el campo opcional webUrl. Es la URL de la ficha del elemento en la aplicación web. Puedes mostrarla como enlace para que el usuario pase de tu integración al elemento correspondiente sin construir rutas internas.
webUrl requiere una sesión de FacturaDirecta con acceso a la empresa y no es un endpoint de la API. No envíes $ACCESS_TOKEN a esa URL. Los recursos sin ficha propia, como métodos de pago, extractos, campos personalizados, webhooks, claves de API, uploads e inbox, no incluyen este campo.
Recursos disponibles
La API ofrece acceso, entre otros, a estos recursos:
Recurso | Para qué sirve |
Información del usuario autenticado y empresas accesibles. | |
Encontrar contactos, documentos y productos a partir de un texto, en todos los tipos a la vez. | |
Clientes, proveedores, empleados y otros contactos. | |
Catálogo de productos y servicios. | |
Crear, consultar, actualizar, enviar, anular o descargar facturas. | |
Automatizaciones de facturación recurrente. | |
Presupuestos y proformas. | |
Albaranes de entrega. | |
Encargos de clientes, con estado por línea. Requiere el Módulo Inventario. | |
Encargos a proveedores, con estado por línea. Requiere el Módulo Inventario. | |
Gastos, compras y tickets. | |
Nóminas de empleados. | |
Cuentas bancarias y tesorería. | |
Extractos y conciliación. | |
Métodos de cobro y pago. | |
Asientos y movimientos contables. | |
Modelos de impuestos generados (303, 347, 390…): casillas, PDF y fichero de presentación. Solo lectura. | |
Totales, rankings y comparativas de facturas, compras, contactos y diario en una sola llamada, para informes propios y agentes de IA. Solo lectura. | |
Series, impuestos, plantillas y configuración fiscal. | |
Procesamiento de documentos recibidos. | |
Subida de archivos. | |
Endpoints y eventos para recibir cambios en tiempo real. |
API pública y Zapier no tienen el mismo alcance: Zapier expone solo algunas acciones de FacturaDirecta. Aunque la API pública incluye Albaranes, Zapier no permite crear albaranes. Usa la API pública directamente si necesitas automatizar ese recurso.
Webhooks
Los webhooks permiten recibir notificaciones en tiempo real cuando ocurre un cambio relevante en tu empresa: una factura creada, un contacto modificado, un gasto borrado, etc.
En lugar de consultar la API periódicamente, configuras una URL HTTPS y FacturaDirecta envía un POST a tu servidor cuando se produce un evento al que estás suscrito.
Los webhooks están disponibles en todos los planes, incluido Gratis.
Consulta:
Webhooks — payload, catálogo de eventos, firma y referencia técnica de endpoints/eventos.
Configurar webhooks — cómo crear endpoints desde Ajustes.
Primeros pasos recomendados
Crea o selecciona un sandbox.
Crea una API key con los permisos mínimos necesarios.
Haz una primera llamada de lectura, por ejemplo listar facturas o contactos.
Prueba una operación de escritura en sandbox.
Si tu integración necesita reaccionar a cambios, configura webhooks.
Consulta Inicio rápido con la API para una primera conexión paso a paso.