La API pública de FacturaDirecta te permite integrar tu software con el sistema de facturación. Automatiza la gestión de tu negocio conectando FacturaDirecta con otras herramientas: crea facturas automáticamente desde tu CRM, sincroniza contactos con tu ERP, o genera informes personalizados con los datos de tu contabilidad.
💡 Recomendación: Antes de empezar a desarrollar, te recomendamos crear un entorno de pruebas (sandbox) para hacer tus primeras llamadas sin afectar tus datos reales.
Recursos disponibles
La API ofrece acceso a los siguientes recursos:
Recurso | Descripción |
Profile | Información del perfil del usuario y empresas accesibles |
Contacts | Gestión de contactos (clientes, proveedores, empleados) |
Products | Catálogo de productos y servicios |
Invoices | Facturas emitidas |
Recurring Invoices | Facturas recurrentes (automatizaciones) |
Estimates | Presupuestos y proformas |
Delivery Notes | Albaranes de entrega |
Bills | Facturas de compra y gastos |
Payrolls | Nóminas de empleados |
Banks | Cuentas bancarias |
Payment Methods | Métodos de pago |
Accounting | Asientos contables |
Settings | Configuración de la empresa |
Especificación OpenAPI
La documentación técnica completa de la API está disponible en formato OpenAPI 3.0:
Especificación: https://www.facturadirecta.com/api/
URL base:
https://app.facturadirecta.com/api
Puedes importar la especificación en herramientas como Postman, Insomnia o generar clientes automáticamente para tu lenguaje de programación.
Autenticación
Hay dos formas de autenticarte en la API:
1. API Key (recomendado para integraciones)
Crea una clave de API desde FacturaDirecta y añádela en la cabecera de tus peticiones:
facturadirecta-api-key: TU_CLAVE_API
Ventajas:
El acceso se controla por los permisos asignados a la clave
Cada clave da acceso únicamente a la empresa donde se creó
No depende de ningún usuario (no se ve afectada si se elimina un usuario)
2. OAuth2
Utiliza el flujo de Authorization Code para aplicaciones que necesitan acceder a múltiples empresas.
Ventajas:
Permite acceder a múltiples empresas con las mismas credenciales
El acceso combina los permisos del usuario y los scopes solicitados
Webhooks
Los webhooks te permiten recibir notificaciones en tiempo real cada vez que ocurre algo relevante en tu cuenta: una factura creada, un contacto modificado, un gasto archivado y más. En lugar de consultar la API repetidamente, FacturaDirecta envía la información directamente a tu servidor en el momento en que se produce el evento.
⚠️ Los webhooks están disponibles en los planes Avanzado y Total.
Los tipos de entidad soportados son:
Facturas
Gastos
Contactos
Presupuestos
Albaranes
Transacciones
Productos
Para más información, consulta los artículos de webhooks:
Webhooks: recibe notificaciones en tiempo real - visión general y catálogo de eventos
Cómo configurar webhooks - guía paso a paso para configurar endpoints desde el panel
Verificar la firma de webhooks - cómo verificar la autenticidad de las notificaciones
API: Webhooks (endpoints y eventos) - referencia de la API para gestionar webhooks por código