¿Qué permisos hay que pedir?

El catálogo está cerrado y usa permisos del tipo invoices:write o series:read. Se eligen al crear la clave. Para el quickstart solo se piden los necesarios. Si solicitas uno que tu plan no incluye, el error aparece al crear la clave y no a mitad de la integración.

¿La API cubre lo mismo que el programa?

Los 50 recursos van de los presupuestos al cierre mensual del control horario y a los proyectos y tareas, pasando por VeriFactu, la factura electrónica para la Administración y los informes de impuestos. La regla es simple: lo que no está en el OpenAPI público no está en la API.

¿Se puede integrar sin escribir código?

Sí, por el servidor MCP: son 581 herramientas que un agente puede usar directamente, y 468 si la conexión es de una aplicación de terceros por OAuth. Es la misma API con los mismos permisos, llamada desde otro sitio.

¿Cuánto cuesta la API?

API y MCP están incluidos. La prueba permite 10 peticiones por minuto y 100 al mes; Esencial, 30 y 5.000; Profesional y Avanzado, 300 y 50.000. Enterprise según contrato. El caudal sigue el plan; los webhooks dependen del plan y los permisos.

Developers · API de facturación

API de facturación.Integrada en tu software.

Integra facturas, clientes, PDF y Verifactu en tu ERP, SaaS o tienda online. Trabaja con REST, SDK oficiales o MCP y valida el recorrido en un entorno de pruebas.

Crear mi cuenta de pruebas Seguir el Quickstart

API y MCP incluidos en los planes de pago. Límites según el plan.

Integraciones y formatos compatibles

Factuarea APIv1

GET/v1/invoices invoices:read

1curl --fail-with-body --silent --show-error \2  "https://api.factuarea.com/v1/invoices" \3  --header "Authorization: Bearer $FACTUAREA_API_KEY"

1import { Factuarea } from "@factuarea/sdk";23const factuarea = new Factuarea({4  apiKey: process.env.FACTUAREA_API_KEY!,5});67const invoices = await factuarea.invoices.list();89for await (const item of invoices) {10  const invoice = item as { id: string };11  console.log(invoice.id);12}

1use Factuarea\Sdk\Custom\FactuareaClient;2use Factuarea\Sdk\Custom\Pagination\PageIterator;3use Factuarea\Sdk\Models\Operations\PublicApiV1InvoicesListRequest;45$factuarea = FactuareaClient::create(getenv('FACTUAREA_API_KEY'));6$pages = new PageIterator(7  fn (?string $cursor) => $factuarea->invoices->publicApiV1InvoicesList(8    new PublicApiV1InvoicesListRequest(startingAfter: $cursor),9  )->rawResponse,10);11foreach ($pages->items() as $invoice) {12  echo $invoice['id'], PHP_EOL;13}

Extracto de respuesta 200 OK

FAC-2026-00042Acme Soluciones SL

1.210,00 €status: paid

Tu aplicaciónFactuarea APIRespuesta JSON

Usa una clave con permiso invoices:read en tu servidor. El código consulta tus facturas; no crea documentos.

Elige cómo integrar

Una cuenta. Tu forma de construir.

Conecta tu software, recibe eventos o da acceso a un asistente. Cada recorrido tiene su guía, permisos y ejemplos.

API REST

Los documentos de tu negocio, desde tu código.

Crea clientes y borradores, emite facturas y recupera su PDF. El contrato OpenAPI documenta los campos, permisos y errores de cada operación.

1GET    /v1/contacts2POST   /v1/invoices3POST   /v1/invoices/{id}/send4GET    /v1/invoices/{id}/pdf

Clientes, catálogo, ventas, gastos e informes en una misma API.

Explorar la API REST

480 rutas publicadas50 recursos

Consultar la referencia completa

Prueba antes de emitir

El mismo contrato. Dos entornos separados.

Prueba tu integración con una clave fact_test_. Cuando esté lista, configura la empresa, revisa los permisos y utiliza una clave de producción.

1Crea una clave con los permisos necesarios.
2Prepara cliente, serie e impuestos.
3Recorre borrador, emisión y descarga del PDF.

Conocer el sandbox Recorrer mi primera factura

api.factuarea.com/v1

Pruebas

fact_test_•••• •••• ••••

Documentos de prueba, sin remisión fiscal real. Los cobros y WhatsApp están restringidos.

Producción

fact_live_•••• •••• ••••

Documentos y operaciones reales, sujetos a la configuración de tu empresa y a tu plan.

Control en cada petición

Diseñada también para los reintentos.

Una integración necesita saber qué ocurrió, qué puede repetir y cuándo debe esperar. Estas señales están documentadas y se pueden comprobar.

Una operación, incluso si reintentas

Petición originalPOST /invoices

Misma clave y mismo cuerpoIdempotency-Key

Mismo resultado · sin duplicar el documento

Evita duplicados: Usa Idempotency-Key en las operaciones compatibles. Un cuerpo distinto con la misma clave devuelve un 409.
Acceso limitado: Asigna scopes a cada clave. Tu integración recibe los permisos que necesita para su trabajo.
Cuotas visibles: Consulta X-RateLimit-Remaining. Si recibes un 429, respeta Retry-After antes de volver a intentarlo.
Eventos verificables: Comprueba Factuarea-Signature sobre el cuerpo original del webhook antes de procesarlo.

Revisar autenticación y garantías Consultar planes y límites

Elige cómo conectar

Una integración que encaja con tu stack

Trabaja con un SDK, consulta el contrato de la API o conecta tu asistente. Elige tu herramienta para encontrar el punto de partida y la documentación que necesitas.

Tecnologías y clientes compatibles

Tu herramienta → Factuarea

SDK oficial

Tu integración, en TypeScript

Instala el SDK oficial para trabajar con la API desde Node.js. Incluye reintentos, paginación y verificación de la firma de webhooks.

npm install @factuarea/sdkConectar TypeScript

operaciones API: 595
recursos: 50
herramientas MCP: 581
páginas de documentación: 1306

Preguntas

Lo que se pregunta antes de escribir la primera línea

Crea tu cuenta y una clave de pruebas en los ajustes de developers. El Quickstart explica los permisos, los datos previos y las peticiones necesarias para recorrer una factura hasta su PDF.

Tu negocio, mejor conectado

Tu próxima integración empieza con una clave.

Crea tu cuenta, elige los permisos y sigue el Quickstart hasta tu primera factura en el entorno de pruebas.

Empezar gratis Ir al quickstart