# FacturaDirecta para desarrolladores > FacturaDirecta es un programa online de facturación, impuestos y contabilidad para autónomos y pequeñas empresas en España. Se conecta con asistentes de IA mediante un servidor MCP, con la terminal y los agentes de código mediante un CLI, y con cualquier software mediante una API REST y webhooks. Todo está disponible en todos los planes, también en el Gratis. - API REST v1.0.10: 187 operaciones. URL base: https://app.facturadirecta.com/api. OpenAPI: https://app.facturadirecta.com/openapi.json - Webhooks: 41 eventos. AsyncAPI: https://app.facturadirecta.com/asyncapi.json - Servidor MCP v0.4.3: https://mcp.facturadirecta.com (OAuth 2.1, Streamable HTTP), 35 herramientas. Catálogo en JSON: https://mcp.facturadirecta.com/tools.json - CLI v0.17.0: `curl -fsSL https://raw.githubusercontent.com/facturadirecta/cli/main/install.sh | sh`. Comandos en JSON: https://github.com/facturadirecta/cli/releases/latest/download/commands.json - Cada página de esta documentación tiene su versión Markdown en `index.md`. ## Conecta tu IA (servidor MCP) - [Servidor MCP](https://www.facturadirecta.com/desarrolladores/mcp/index.md): Conecta Claude, ChatGPT, Codex, Cursor o cualquier asistente compatible con MCP a tu cuenta de FacturaDirecta con una sola URL. Consulta facturas, gastos y contabilidad en lenguaje natural. - [Herramientas del servidor MCP](https://www.facturadirecta.com/desarrolladores/mcp/herramientas/index.md): Todas las herramientas del servidor MCP de FacturaDirecta: qué hace cada una, qué acciones expone, si solo consulta o modifica datos y qué permisos necesita. ## Terminal y agentes de código (CLI) - [CLI](https://www.facturadirecta.com/desarrolladores/cli/index.md): Instala el CLI de FacturaDirecta para consultar y automatizar facturas, gastos, contactos y contabilidad desde la terminal, en scripts o con agentes de código como Claude Code y Codex. - [Comandos del CLI](https://www.facturadirecta.com/desarrolladores/cli/comandos/index.md): Todos los comandos del CLI de FacturaDirecta con sus opciones: facturas, presupuestos, gastos, contactos, productos, contabilidad, webhooks y más. ## API REST - [API REST](https://www.facturadirecta.com/desarrolladores/api/index.md): API REST de FacturaDirecta: guías de autenticación, paginación, errores e idempotencia, y referencia de cada recurso con ejemplos listos para copiar. - [Explorador de la API](https://www.facturadirecta.com/desarrolladores/api/explorador/): Explora la especificación OpenAPI de FacturaDirecta y prueba cada operación desde el navegador con tu usuario o tu API key. - [Especificación OpenAPI](https://app.facturadirecta.com/openapi.json): contrato completo de la API en OpenAPI 3.0. ## Guías de la API - [API Pública de FacturaDirecta](https://www.facturadirecta.com/desarrolladores/api/guias/overview/index.md): Conecta tu software con FacturaDirecta mediante la API REST pública. Accede a contactos, productos, facturas, presupuestos, albaranes, gastos, bancos, webhooks y más. - [Inicio rápido con la API](https://www.facturadirecta.com/desarrolladores/api/guias/quickstart/index.md): Haz tu primera llamada a la API de FacturaDirecta en minutos. Guía paso a paso con ejemplos de cURL. - [Autenticación](https://www.facturadirecta.com/desarrolladores/api/guias/authentication/index.md): La API pública de FacturaDirecta soporta dos métodos de autenticación, OAuth2 y API key. - [Paginación y filtros estándar](https://www.facturadirecta.com/desarrolladores/api/guias/pagination/index.md): 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 el recurso. - [Errores y validaciones](https://www.facturadirecta.com/desarrolladores/api/guias/errors/index.md): Las respuestas de error de la API pública siguen siempre la misma forma base, independientemente del recurso. - [Idempotencia y reintentos seguros](https://www.facturadirecta.com/desarrolladores/api/guias/idempotency/index.md): 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](https://www.facturadirecta.com/desarrolladores/api/guias/document-versions/index.md): Cada vez que se crea, modifica, elimina o recupera un documento, FacturaDirecta guarda una copia completa de cómo queda. - [Catálogo de impuestos](https://www.facturadirecta.com/desarrolladores/api/guias/taxes/index.md): Esta guía trata los tipos impositivos que se aplican a las líneas de los documentos (IVA, IRPF, IGIC…). - [VeriFactu](https://www.facturadirecta.com/desarrolladores/api/guias/verifactu/index.md): Esta guía cubre cómo se integra VeriFactu con la API pública de FacturaDirecta. - [TicketBAI](https://www.facturadirecta.com/desarrolladores/api/guias/ticketbai/index.md): Esta guía cubre cómo se integra TicketBAI con la API pública de FacturaDirecta. - [Facturas rectificativas](https://www.facturadirecta.com/desarrolladores/api/guias/invoices-rectificativas/index.md): Una factura rectificativa corrige una factura emitida previamente. - [Facturas sustitutivas (F3)](https://www.facturadirecta.com/desarrolladores/api/guias/invoices-sustitutivas/index.md): Una factura sustitutiva es una factura completa que reemplaza a un conjunto de facturas simplificadas previamente emitidas. - [Flujo de pedidos y órdenes de compra](https://www.facturadirecta.com/desarrolladores/api/guias/orders-flow/index.md): El pedido de cliente (clientOrder) registra un encargo en firme de un cliente antes de su entrega y facturación. ## Referencia de la API: Ventas - [Facturas de venta](https://www.facturadirecta.com/desarrolladores/api/referencia/invoices/index.md): Una factura de venta (invoice) es el documento fiscal que emite la empresa para cobrar a sus clientes. (16 operaciones) - [Facturas de venta recurrentes](https://www.facturadirecta.com/desarrolladores/api/referencia/recurring/index.md): Una factura recurrente es una plantilla de factura programada: cuando llega el momento configurado, FacturaDirecta genera automáticamente la factura real a partir de la plantilla. (10 operaciones) - [Presupuestos](https://www.facturadirecta.com/desarrolladores/api/referencia/estimates/index.md): Un presupuesto es una propuesta económica que envías a un cliente antes de emitir la factura correspondiente. (13 operaciones) - [Albaranes](https://www.facturadirecta.com/desarrolladores/api/referencia/delivery-notes/index.md): Un albarán documenta la entrega de bienes o servicios a un cliente. (13 operaciones) - [Pedidos](https://www.facturadirecta.com/desarrolladores/api/referencia/client-orders/index.md): Un pedido de cliente registra un encargo en firme de un cliente antes de su entrega y facturación. (13 operaciones) ## Referencia de la API: Compras y gastos - [Facturas de compra y tickets](https://www.facturadirecta.com/desarrolladores/api/referencia/bills/index.md): Una factura de compra representa un gasto: una factura que has recibido de un proveedor, o un ticket de caja (con o sin identificación fiscal del proveedor). (12 operaciones) - [Órdenes de compra](https://www.facturadirecta.com/desarrolladores/api/referencia/purchase-orders/index.md): Una orden de compra registra un encargo en firme a un proveedor antes de la recepción de la mercancía y su facturación. (13 operaciones) - [Bandeja de entrada](https://www.facturadirecta.com/desarrolladores/api/referencia/inbox/index.md): La bandeja de entrada (inbox) es el flujo para incorporar documentos externos (PDFs de facturas de proveedores, tickets escaneados o ficheros Facturae, además de nóminas) y convertirlos… (7 operaciones) - [Uploads (subida de archivos)](https://www.facturadirecta.com/desarrolladores/api/referencia/uploads/index.md): El recurso uploads permite subir archivos binarios a FacturaDirecta para luego vincularlos como adjuntos a documentos (facturas, gastos, presupuestos, albaranes, nóminas, facturas recurrentes) o… (2 operaciones) ## Referencia de la API: Contactos y productos - [Contactos](https://www.facturadirecta.com/desarrolladores/api/referencia/contacts/index.md): Un contacto representa una persona física o empresa con la que mantienes una relación contable: clientes a los que facturas, proveedores de los que recibes gastos y empleados a los que pagas nóminas. (8 operaciones) - [Productos](https://www.facturadirecta.com/desarrolladores/api/referencia/products/index.md): Un producto es un concepto facturable preconfigurado que se reutiliza en líneas de documentos (facturas, presupuestos, albaranes, facturas de compra). (10 operaciones) - [Campos personalizados](https://www.facturadirecta.com/desarrolladores/api/referencia/custom-fields/index.md): El recurso customFields permite descubrir y gestionar las definiciones de campos personalizados de una empresa. (6 operaciones) ## Referencia de la API: Tesorería - [Bancos y cuentas de tesorería](https://www.facturadirecta.com/desarrolladores/api/referencia/banks/index.md): Un banco (bank) en FacturaDirecta es una cuenta de tesorería de la empresa: una cuenta corriente con IBAN, una cuenta de tarjeta o una caja en efectivo. (4 operaciones) - [Extractos bancarios](https://www.facturadirecta.com/desarrolladores/api/referencia/statements/index.md): Un extracto bancario (statement) es un movimiento individual de una cuenta bancaria sincronizada con FacturaDirecta. (5 operaciones) - [Métodos de pago](https://www.facturadirecta.com/desarrolladores/api/referencia/payment-methods/index.md): Un método de pago describe cómo se cobra o se paga un documento. (7 operaciones) ## Referencia de la API: Contabilidad, impuestos y nóminas - [Diario contable](https://www.facturadirecta.com/desarrolladores/api/referencia/journal/index.md): El diario contable es la lista cronológica de apuntes (líneas de asiento) generados por todos los documentos contabilizables de la empresa: facturas de venta, facturas de compra, nóminas, asientos… (1 operaciones) - [Informes](https://www.facturadirecta.com/desarrolladores/api/referencia/reports/index.md): Los informes devuelven, ya calculadas, las mismas cifras que los informes de la web. Son de solo lectura y se generan en el momento a partir de la contabilidad de la empresa. (5 operaciones) - [Declaraciones de impuestos](https://www.facturadirecta.com/desarrolladores/api/referencia/tax-declarations/index.md): Una declaración de impuestos (taxDeclaration) es un modelo de impuestos que el usuario ha generado y guardado en FacturaDirecta desde la sección Impuestos: un 303 trimestral, un 347 anual, un 130…… (5 operaciones) - [Nóminas](https://www.facturadirecta.com/desarrolladores/api/referencia/payrolls/index.md): Una nómina (payroll) representa la retribución mensual a un empleado: salario bruto, deducciones, retenciones de IRPF y aportaciones de Seguridad Social, tanto del trabajador como de la empresa. (12 operaciones) ## Referencia de la API: Cuenta y configuración - [Configuración de la empresa](https://www.facturadirecta.com/desarrolladores/api/referencia/settings/index.md): Bajo /settings/... vive la configuración de la empresa que la API pública expone como solo lectura: la ficha de la empresa y su forma de trabajar, los impuestos disponibles, las series de… (5 operaciones) - [Perfil de usuario](https://www.facturadirecta.com/desarrolladores/api/referencia/profile/index.md): El recurso profile devuelve los datos básicos del usuario autenticado y las empresas disponibles para la credencial actual. (1 operaciones) - [API keys](https://www.facturadirecta.com/desarrolladores/api/referencia/api-keys/index.md): Una API key es una credencial por empresa para autenticar integraciones de máquina a máquina. (5 operaciones) - [Actividad](https://www.facturadirecta.com/desarrolladores/api/referencia/activity/index.md): El registro de actividad es el historial de lo que pasa en la empresa: altas, modificaciones y eliminaciones de documentos, envíos por email y su entrega, accesos de los usuarios, sincronizaciones… (1 operaciones) ## Referencia de la API: Búsqueda y análisis - [Búsqueda](https://www.facturadirecta.com/desarrolladores/api/referencia/search/index.md): La búsqueda global localiza en una sola llamada cualquier elemento de la empresa a partir de un texto: un cliente por su nombre o su NIF, una factura por su número, un producto por su referencia o… (1 operaciones) - [Consulta analítica](https://www.facturadirecta.com/desarrolladores/api/referencia/query/index.md): La consulta analítica agrega los datos de la empresa en una sola llamada: eliges una fuente, las medidas que quieres sumar, las dimensiones por las que agrupar, un periodo y unos filtros, y la API… (1 operaciones) ## Webhooks - [Webhooks](https://www.facturadirecta.com/desarrolladores/webhooks/index.md): Los webhooks notifican en tiempo real cuando ocurren cambios en los recursos de tu empresa. - [Especificación AsyncAPI](https://app.facturadirecta.com/asyncapi.json): los 41 eventos y sus payloads. ## Optional - [llms-full.txt](https://www.facturadirecta.com/desarrolladores/llms-full.txt): toda la documentación de esta sección en un solo fichero. - [FacturaDirecta](https://www.facturadirecta.com/llms.txt): el producto, los planes y los precios.