Guías de la API
Guías de la API de FacturaDirecta: inicio rápido, autenticación, paginación, errores, idempotencia, impuestos, VeriFactu, TicketBAI y flujos habituales.
API Pública de FacturaDirecta
Conecta tu software con FacturaDirecta mediante la API REST pública. Accede a contactos, productos, facturas, presupuestos, albaranes, …
Inicio rápido con la API
Haz tu primera llamada a la API de FacturaDirecta en minutos. Guía paso a paso con ejemplos de cURL.
Autenticación
La API pública de FacturaDirecta soporta dos métodos de autenticación, OAuth2 y API key.
Paginación y filtros estándar
La API pública usa tres patrones de listado distintos, no uno. Cada operación que devuelve una lista escoge el patrón que mejor encaja con …
Errores y validaciones
Las respuestas de error de la API pública siguen siempre la misma forma base, independientemente del recurso.
Idempotencia y reintentos seguros
Cuando una petición que modifica datos termina en timeout o se corta la conexión, no sabes si el servidor llegó a ejecutarla.
Versiones de documentos
Cada vez que se crea, modifica, elimina o recupera un documento, FacturaDirecta guarda una copia completa de cómo queda.
Catálogo de impuestos
Esta guía trata los tipos impositivos que se aplican a las líneas de los documentos (IVA, IRPF, IGIC…).
VeriFactu
Esta guía cubre cómo se integra VeriFactu con la API pública de FacturaDirecta.
TicketBAI
Esta guía cubre cómo se integra TicketBAI con la API pública de FacturaDirecta.
Facturas rectificativas
Una factura rectificativa corrige una factura emitida previamente.
Facturas sustitutivas (F3)
Una factura sustitutiva es una factura completa que reemplaza a un conjunto de facturas simplificadas previamente emitidas.
Flujo de pedidos y órdenes de compra
El pedido de cliente (clientOrder) registra un encargo en firme de un cliente antes de su entrega y facturación.