API Pública de FacturaDirecta

La API pública de FacturaDirecta te permite integrar tu software con el sistema de facturación. 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/api
OpenAPI 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.

Recursos disponibles

La API ofrece acceso, entre otros, a estos recursos:

Recurso	Para qué sirve
Perfil	Información del usuario autenticado y empresas accesibles.
Contactos	Clientes, proveedores, empleados y otros contactos.
Productos	Catálogo de productos y servicios.
Facturas de venta	Crear, consultar, actualizar, enviar, anular o descargar facturas.
Facturas recurrentes	Automatizaciones de facturación recurrente.
Presupuestos	Presupuestos y proformas.
Albaranes	Albaranes de entrega.
Facturas de compra y tickets	Gastos, compras y tickets.
Nóminas	Nóminas de empleados.
Bancos	Cuentas bancarias y tesorería.
Extractos bancarios	Extractos y conciliación.
Métodos de pago	Métodos de cobro y pago.
Diario contable	Asientos y movimientos contables.
Configuración	Series, impuestos, plantillas y configuración fiscal.
Bandeja de entrada	Procesamiento de documentos recibidos.
Uploads	Subida de archivos.
Webhooks	Endpoints y eventos para recibir cambios en tiempo real.

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 archivado, 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 los planes Avanzado y Total.

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.