API REST de facturación
Crea y envía facturas, registra cobros y conecta clientes, catálogo y workflows con tu ERP, tienda o aplicación. Una API REST de facturación con VeriFactu y FacturaE, sobre los mismos datos que usa tu equipo.
Integraciones y formatos compatibles
WhatsApp
POST/v1/invoices
{
"client_id": "f58fbf7f-333f-499b-affc-c0d396cbd83f",
"series_id": "019e5584-7a72-7038-a8f6-561ed180b699",
"issued_on": "2026-09-22", "due_on": "2026-10-22",
"external_id": "order_1042",
"lines": [{
"description": "Consultoría",
"quantity": 2, "unit_price": 150, "tax_rate": 21
}]
}Lo que puedes construir
Conecta tu ERP, tienda o aplicación con los mismos documentos y datos que usa tu equipo en Factuarea. Explora el alcance real antes de escribir la integración.
Crea facturas, convierte presupuestos y trabaja con proformas, albaranes y recurrentes. Numera, envía, descarga el PDF y registra cobros o rectificativas.
POST /invoicesPOST /quotes/{quote}/convertPOST /recurring_invoicesSincroniza contactos, productos, variantes y tarifas. Consulta existencias y movimientos de stock para conectar la venta con tu catálogo.
POST /contactsGET /productsGET /price-listsRegistra gastos, consulta su detalle y anota pagos. Mantén los documentos de proveedor relacionados con tu gestión de gastos.
POST /purchase_invoicesPOST /purchase_invoices/{purchase_invoice}/paymentsAccede a registros y estados de VeriFactu, genera XML FacturaE y presenta facturas en FACe cuando la empresa dispone de la configuración y el certificado necesarios.
GET /invoices/{invoice}/facturaePOST /invoices/{invoice}/face-submissionsConsulta el catálogo de disparadores y acciones, crea reglas, prueba su ejecución con dry run y revisa cada ejecución. Usa webhooks para continuar el flujo en tu sistema.
POST /automations/rulesPOST /automations/rules/{rule}/dry_runGET /automations/runsIntegra empleados, jornadas, fichajes, ausencias y cierres mensuales. Cada recurso utiliza los permisos y módulos habilitados en la empresa.
GET /employeesGET /time-entriesGET /absence-requestsCrea tareas, muévelas por las columnas del proyecto e imputa el tiempo con el temporizador. Las horas facturables se convierten en una factura borrador.
POST /tasksPOST /tasks/{task}/timer/startPOST /projects/{project}/time-invoicesEl alcance de cada clave depende de sus permisos, del plan y de los módulos activos. La referencia indica los requisitos de cada operación.
Integraciones con un propósito
La API REST te permite decidir cuándo crear un documento, qué datos lleva y cómo continúa el trabajo. Estos son tres recorridos que puedes construir sobre las operaciones disponibles.
order_1042POST /contactsPOST /invoicesPOST /invoices/{id}/sendCada flujo requiere una clave con los permisos adecuados y la configuración de los recursos que utiliza.
Aceptado/invoices/{invoice}/verifactuFacturación en España
Una API de facturación con VeriFactu debe explicar qué documento se crea y qué ocurre después. Factuarea mantiene el registro, el formato y los estados dentro de la empresa que emite.
Al emitir se aplica la configuración fiscal de la empresa. Si VeriFactu está activo, se genera y remite el registro; puedes consultar sus estados desde la API. Usar REST no activa VeriFactu por sí solo.
Descarga el XML FacturaE de una factura emitida. Para firmar y presentar en FACe necesitas un certificado activo y los tres códigos DIR3 del cliente. El registro de presentación queda unido a la factura.
Modo pruebas de Factuarea
Una cantidad incorrecta también falla en sandbox. Comprueba la respuesta de la API con fact_test_ y prepara tu aplicación para gestionar tanto el resultado correcto como el rechazo.
fact_test_…"lines": [{
"quantity": 2,
"unit_price": 150,
"tax_rate": 21
}]{
"data": {
"status": "draft",
"number": null,
"total": 363,
"currency": "EUR"
}
}Borrador creado: 300,00 € de base y 63,00 € de IVA. Todavía no consume número.
El sandbox hereda tu plan. El acceso y los límites de API siguen aplicándose.
Ver el sandbox de la APIPreparada para integrar
El contrato técnico acompaña al resultado: autenticación, permisos, idempotencia, límites y versión. Puedes comprobarlo en la documentación antes de conectar datos reales.
201 Created data.id: 01931b3e…8a42
1 intento, una factura. La misma clave y el mismo cuerpo recuperan la primera respuesta durante 24 horas.
Cómo aplicar la idempotenciaAutentica desde tu servidor y concede solo los permisos necesarios. Cada operación respeta el acceso de la clave y el contexto de empresa.
Configurar claves y permisosLas claves fact_test_ trabajan en una empresa de pruebas. No se entregan correos reales ni registros a la AEAT; los webhooks de eventos no salen al receptor. El ping explícito de un webhook sí realiza una petición externa.
Explorar el sandboxFija la versión de API y consulta las cabeceras de límite. Ante un 429, Retry-After indica cuánto esperar. Los cupos dependen del plan y la configuración.
Ver el versionado de la APIUsa HTTP o los SDK de TypeScript y PHP. Crea tu primer documento, revisa su resultado y amplía el flujo a medida que lo necesites.
Dudas
Crear, numerar y enviar facturas, recuperar PDF, registrar cobros y emitir rectificativas. También puedes trabajar con clientes, catálogo, compras, presupuestos, recurrentes y workflows. Cada recurso requiere sus permisos y los módulos correspondientes.
Tu negocio, mejor conectadoExplora el sandbox, crea una factura de prueba y conecta las operaciones que necesita tu negocio.
Resolvemos tus dudas sobre planes, funciones o cómo cambiar de programa.