Qué cambia en Factuarea.
Versiones, cambios de contrato y novedades de las herramientas para tu integración.
Un empleado dado de baja es de solo lectura
Fichar la entrada, asignar un horario o una política de ausencias, aprobar una ausencia que pasa de la baja e invitar al portal a un empleado dado de baja responden 422 con el subcode employee_inactive. El resumen de equipo lista a todo empleado de alta en el mes, tenga o no horario.
Leer novedadEndpoints actualizados7Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/time-entries/clock-in | Fichar la entrada de un empleado |
POST/v1/companies/{company}/work-schedules/{schedule}/assign | Asignar un horario a un empleado |
POST/v1/companies/{company}/absence-policies/{absence_policy}/assign | Asignar una política a empleados |
Plazas contratadas, paquetes de oferta y prueba
La factura sigue las plazas que contratas: crear un empleado ocupa una plaza libre, reducir tiene efecto en la renovación sin abono y eliges a quién se desactiva. Cuatro operaciones nuevas fijan y previsualizan las plazas, la API REST y el MCP compran solos las plazas que faltan, los paquetes de oferta conservan sus precios mientras se mantienen sus mínimos y la prueba responde con su propio motivo.
Leer novedadNuevos endpoints4Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/accounts/{account}/additional-nif-seats | Obtener las plazas de NIF adicional |
PATCH/v1/accounts/{account}/additional-nif-seats | Fijar las plazas de NIF adicional contratadas |
PATCH/v1/accounts/{account}/employee-seats | Fijar las plazas de empleado contratadas |
Endpoints actualizados98Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/accounts/{account}/nif-transfers/accept | Aceptar un traspaso de NIF |
POST/v1/accounts/{account}/companies/activate | Activar varios NIF de la cuenta |
POST/v1/accounts/{account}/companies/{company}/activate | Activar un NIF de la cuenta |
Envía cada factura automática a quien paga
Las cuentas conectadas de Stripe aceptan email_invoice_to_payer, que envía por email cada factura que Factuarea emite automáticamente a la dirección que llega con el cobro. Tres operaciones actualizadas y una tool MCP actualizada.
Leer novedadEndpoints actualizados3
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/connected-accounts | Listar cuentas Stripe conectadas |
GET/v1/companies/{company}/connected-accounts/{account} | Obtener una cuenta Stripe conectada |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualizar una cuenta Stripe conectada |
Coherencia de la causa de exención y conflicto al generar recurrentes
Cambian tres operaciones: la vista previa de la factura acepta un exemption_reason opcional, guardar o emitir una factura con causa de cabecera sin IVA y líneas con IVA responde 422 exemption_cause_contradicts_taxed_lines, y generar una factura recurrente puede responder un 409 reintentable recurring_presentation_activation_changed.
Leer novedadEndpoints actualizados6Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/pdf-template-previews | Crear una vista previa de plantilla de PDF |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/generate | Genera una factura a partir de una plantilla recurrente |
PATCH/v1/companies/{company}/invoices/{invoice} | Actualizar una factura |
Biblioteca de plantillas PDF y facturas estructuradas
Gestiona plantillas PDF e identidades de marca, elige la presentación de cada documento, prepara artefactos PDF exactos y lleva calendarios de pagos, referencias y centros DIR3 en las facturas. Cincuenta operaciones nuevas, los scopes pdf_templates y un bloque pdf_output_state en cada documento.
Leer novedadNuevos endpoints50Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/pdf-commercial-identities/{identity}/archive | Archivar una identidad comercial de PDF |
POST/v1/companies/{company}/pdf-templates/{template}/archive | Archivar una plantilla de PDF |
GET/v1/companies/{company}/delivery-notes/{delivery_note}/presentation | Obtener la presentación del albarán |
Endpoints actualizados137Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/proformas/{proforma}/accept | Aceptar una proforma |
POST/v1/companies/{company}/quotes/{quote}/accept | Aceptar un presupuesto |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/activate | Activar factura recurrente |
Los documentos de control usan la biblioteca de plantillas PDF
El PDF del documento de control de transporte (DeCA) toma su diseño de la biblioteca de plantillas. El default de documentos de control se fija en PATCH /v1/companies/{company}/pdf-templates/defaults y en la tool MCP, y cada versión del DeCA informa del diseño con el que se pintó en versions[].presentation.
Leer novedadEndpoints actualizados15Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/transport-documents/{transport_document}/cancel | Anular un documento de control |
POST/v1/companies/{company}/transport-documents/{transport_document}/close | Cerrar un documento de control |
GET/v1/companies/{company}/transport-documents | Listar todos los documentos de control |
Las plantillas de documentos de control tienen su propio tipo
Las plantillas PDF y sus revisiones informan de document_kind (commercial o transport-document). Crear y duplicar lo aceptan, el listado filtra por él, y el default de documentos de control en PATCH /v1/companies/{company}/pdf-templates/defaults solo acepta plantillas del tipo transport-document.
Leer novedadEndpoints actualizados5Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/pdf-templates | Crear una plantilla de PDF |
POST/v1/companies/{company}/pdf-templates/{template}/duplicate | Duplicar una plantilla de PDF |
GET/v1/companies/{company}/pdf-templates | Listar las plantillas de PDF |
Opciones de maquetación de las plantillas PDF
La configuración de las plantillas PDF incorpora las claves de schema_version 2: cabecera y lado del logo, estilo y concepto de la tabla de líneas, pie legal, densidad de página, tamaño de letra por zona, colores de realce y de superficie, texto de privacidad, condiciones generales, títulos opcionales de bloque, el tamaño de marca xl y la columna de importe con impuesto. Las revisiones informan schema_version.
Leer novedadEndpoints actualizados10Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/pdf-templates | Crear una plantilla de PDF |
POST/v1/companies/{company}/pdf-templates/{template}/revisions | Publicar una revisión de plantilla de PDF |
POST/v1/companies/{company}/pdf-template-previews | Crear una vista previa de plantilla de PDF |
La personalización se aplica a la plantilla principal
En las empresas que ya usan la biblioteca de plantillas PDF, PATCH /v1/companies/{company}/personalization y update_account_personalization aplican el diseño y el color de acento a la plantilla principal, y personalization lee sus valores efectivos. El contrato no cambia; el error nuevo es 409 pdf_main_template_required.
Leer novedadEndpoints actualizados1
| Endpoint | Descripción |
|---|---|
PATCH/v1/companies/{company}/personalization | Actualiza la personalización de la cuenta |
Comisiones de Stripe como gasto y una liquidación más detallada
Las cuentas de Stripe conectadas pueden registrar cada mes sus comisiones de Stripe como gasto, los payouts detallan ahora todos los movimientos que liquidan y los gastos que autoliquidan su IVA ya no lo cuentan en el total. Nueve operaciones actualizadas, tres campos nuevos en la cuenta, tres campos nuevos en el payout y un método de conexión nuevo.
Leer novedadEndpoints actualizados9Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/connected-accounts | Listar cuentas Stripe conectadas |
GET/v1/companies/{company}/connected-accounts/{account} | Obtener una cuenta Stripe conectada |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualizar una cuenta Stripe conectada |
Las personas con acceso operate pueden recibir tareas
El listado de usuarios y el usuario actual incluyen ahora a las personas de otras cuentas que llegan a la empresa con acceso operate, y se les puede asignar una tarea. Tres operaciones actualizadas; ningún campo cambia.
Leer novedadEndpoints actualizados3
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/users | Listar usuarios |
GET/v1/companies/{company}/users/me | Obtener el usuario actual |
POST/v1/companies/{company}/tasks/{task}/assign | Asignar una tarea |
Un justificante por cada cobro
Los justificantes se emiten por cobro, también los parciales: las operaciones de justificante de facturas y gastos aceptan un payment_id opcional y sus tools MCP devuelven el número del justificante. Los PDF de documentos muestran el IBAN del emisor solo con formas de pago bancarias y usan 9 pt de tamaño base por defecto. Dos operaciones y dos tools MCP actualizadas.
Leer novedadEndpoints actualizados2
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/invoices/{invoice}/payment-receipt | Descargar el PDF del justificante de un cobro |
GET/v1/companies/{company}/purchase-invoices/{purchase_invoice}/payment-receipt | Descargar el PDF del justificante de un pago de un gasto |
Unidades contadas, peso por piezas y sustitución por cambio de unidad base
Vende en paquetes, cajas o piezas un producto medido en kilos o litros, registra las piezas en las líneas de peso variable, sustituye un producto por otro con distinta unidad base con vista previa y ejecución irreversible, y lee la unidad real en FacturaE y UBL. Dos operaciones nuevas, dos tools MCP, el evento product.replaced y campos nuevos en productos y líneas de documento.
Leer novedadNuevos endpoints2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/products/{product}/base-unit-replacement/preview | Vista previa de la sustitución por cambio de unidad base |
POST/v1/companies/{company}/products/{product}/base-unit-replacement | Sustituir un producto cambiando su unidad base |
Endpoints actualizados103Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/proformas/{proforma}/accept | Aceptar una proforma |
POST/v1/companies/{company}/quotes/{quote}/accept | Aceptar un presupuesto |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/activate | Activar factura recurrente |
Consentimiento OAuth: cuenta, nivel y permisos que ya no se conceden
La pantalla de consentimiento del MCP pide elegir cuenta y empresa, no concede escritura con nivel Ver ni los permisos de módulos vetados en Pruebas, y la solicitud caduca a los 5 minutos.
Leer novedadVista previa del alta y detalles de cuenta
Una operación nueva, la vista previa de lo que costaría una cuenta gestionada nueva, y campos nuevos en empresas, traspasos de NIF, cuentas gestionadas, cambio de plan, importación masiva y consolidado de RR. HH., y una caducidad del vale que ahora se devuelve siempre al reemitir.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
GET/v1/accounts/provisioning-preview | Previsualizar el alta de una cuenta gestionada |
Endpoints actualizados22Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/accounts/{account}/companies | Listar los NIF de tu cuenta |
GET/v1/accounts/{account}/companies/{company} | Obtener un NIF de la cuenta |
POST/v1/accounts/{account}/companies | Registrar un NIF en la cuenta |
Documento de control (DeCA) y peso de transporte
Nuevo recurso transport_documents con 17 endpoints para emitir, modificar, compartir y conservar el documento de control digital del transporte de mercancías por carretera, obligatorio desde el 5 de octubre de 2026; 15 tools MCP, 10 eventos transport_document.*, 24 códigos de error y peso bruto de transporte en productos, variantes, presentaciones y albaranes.
Leer novedadNuevos endpoints17Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/transport-documents | Listar todos los documentos de control |
GET/v1/companies/{company}/transport-documents/statuses | Listar los estados del documento de control |
GET/v1/companies/{company}/transport-documents/{transport_document} | Obtener un documento de control |
Endpoints actualizados21Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/products | Crear un producto |
PATCH/v1/companies/{company}/products/{product} | Actualizar un producto |
GET/v1/companies/{company}/products/{product} | Obtener un producto |
Equipo, claves y logs en el eje de cuenta
Una operación nueva, el uso diario de una API key, y campos nuevos en claves, miembros, invitaciones, logs de peticiones y dominios de retorno de Stripe Connect, además de la corrección sobre reactivar un endpoint de webhook de cuenta desactivado.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
GET/v1/accounts/{account}/api-keys/{api_key}/usage | Consultar el uso diario de una clave de API |
Endpoints actualizados19Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/accounts/{account}/api-keys | Listar tus API keys |
GET/v1/accounts/{account}/api-keys/{api_key} | Recuperar una API key |
POST/v1/accounts/{account}/api-keys | Crear una API key |
Devoluciones e importe neto de los cobros no facturados
Los cobros de Stripe que no se facturan llevan sus devoluciones y el importe neto que se queda el comercio, se pueden filtrar por fecha y llegan a la gestoría en el envío trimestral como CSV. Cuatro operaciones actualizadas y tres tools MCP actualizadas.
Leer novedadEndpoints actualizados4Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/connected-accounts/{account}/non-invoiced-charges | Listar los cobros sin facturar de una cuenta de Stripe conectada |
GET/v1/companies/{company}/invoices/quarterly/available-quarters | Listar los trimestres exportables |
POST/v1/companies/{company}/invoices/quarterly/download-zip | Generar archivo ZIP trimestral |
Impuestos propios de la empresa
Crea, edita y elimina tus propios impuestos junto al catálogo de Factuarea, que es de solo lectura, distínguelos con el nuevo campo ownership y fija los predeterminados solo para tu empresa. Dos tools MCP nuevas, un scope OAuth nuevo y dos códigos de error nuevos.
Leer novedadEndpoints actualizados14Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/taxes | Listar todos los impuestos |
POST/v1/companies/{company}/taxes | Crear un impuesto |
GET/v1/companies/{company}/taxes/{tax} | Obtener un impuesto |
Nota configurable en las facturas automáticas
Las cuentas conectadas y las tiendas aceptan una invoice_note que Factuarea escribe en las notas de las facturas que emite automáticamente, y esas facturas vencen a los 30 días por defecto. Siete operaciones actualizadas y dos tools MCP actualizadas.
Leer novedadEndpoints actualizados7Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/connected-accounts | Listar cuentas Stripe conectadas |
GET/v1/companies/{company}/connected-accounts/{account} | Obtener una cuenta Stripe conectada |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualizar una cuenta Stripe conectada |
Asientos de empleado cobrados siempre que el plan factura
Dar de alta o reactivar un empleado cobra un asiento siempre que el plan factura, también en past_due y en planes concedidos; los empleados de la prueba se desactivan al empezar el cobro, hay un 503 nuevo con los lotes activados y las ofertas de asientos sobre una suscripción activa empiezan en la siguiente renovación. Ocho operaciones actualizadas.
Leer novedadEndpoints actualizados8Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/employees | Crear un empleado |
POST/v1/companies/{company}/employees/{employee}/reactivate | Reactivar un empleado |
POST/v1/companies/{company}/employee-seat-offer-redemptions | Preparar un canje de oferta de plazas de empleados |
Ajustes del contrato de cuentas
Correcciones del contrato v1 tras la revisión del 6 de octubre, compras duraderas en el eje de empresa y la forma final de las cuentas gestionadas, el NIF adicional y el tope de usuarios.
Leer novedadEndpoints actualizados45Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/employee-batches | Listar un lote de empleados |
GET/v1/companies/{company}/employee-batches/{id} | Consultar un lote de empleados |
POST/v1/companies/{company}/employee-batches | Preparar un lote de empleados |
Cuentas de Stripe existentes y reglas de cobro
Conecta una cuenta de Stripe que ya tienes, decide por cuenta qué cobros se facturan y cuáles no, y consulta los cobros que quedaron fuera. Seis operaciones nuevas, tres campos nuevos en las cuentas conectadas y cinco motivos nuevos en la bandeja.
Leer novedadNuevos endpoints6Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/connected-accounts/{account}/charge-rules | Listar las reglas de tratamiento de cobros de una cuenta de Stripe conectada |
POST/v1/companies/{company}/connected-accounts/{account}/charge-rules | Crear una regla de tratamiento de cobros |
PUT/v1/companies/{company}/connected-accounts/{account}/charge-rules/order | Reordenar las reglas de tratamiento de cobros |
Endpoints actualizados3
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/connected-accounts | Listar cuentas Stripe conectadas |
GET/v1/companies/{company}/connected-accounts/{account} | Obtener una cuenta Stripe conectada |
PATCH/v1/companies/{company}/connected-accounts/{account} | Actualizar una cuenta Stripe conectada |
Las operaciones recientes pasan al eje
Las operaciones publicadas desde el 21 de septiembre —proyectos y tareas, el escáner de gastos, notificaciones, usuarios, la representación VeriFactu, emitir sin enviar y la edición de series— viven bajo /v1/companies/{company}, y ocho actualizaciones parciales pasan de PUT a PATCH.
Leer novedadEndpoints actualizados113Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/agenda | Listar elementos de la agenda |
POST/v1/companies/{company}/contacts/import | Importar contactos |
GET/v1/companies/{company}/contacts/import/template | Descargar la plantilla de importación de contactos |
Stripe Connect en marca blanca
Cuatro operaciones y cuatro códigos de error nuevos para que tus clientes conecten su propia cuenta de Stripe desde tu producto, con dominios de retorno que controlas tú.
Leer novedadNuevos endpoints4Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/accounts/{account}/connected-accounts/return-domains | Añadir un dominio de retorno de Stripe Connect |
DEL/v1/accounts/{account}/connected-accounts/return-domains/{return_domain} | Eliminar un dominio de retorno de Stripe Connect |
GET/v1/accounts/{account}/connected-accounts/return-domains | Listar los dominios de retorno de Stripe Connect |
Lotes de empleados y ofertas privadas de asientos
Nuevas operaciones duraderas para lotes de empleados y ofertas de asientos de empleados o empresas gestionadas dirigidas a una empresa.
Leer novedadNuevos endpoints18Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/employee-batches | Listar un lote de empleados |
POST/v1/companies/{company}/employee-batches | Preparar un lote de empleados |
GET/v1/companies/{company}/employee-batches/{id} | Consultar un lote de empleados |
Endpoints actualizados4Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/accounts/{account}/companies/seat-charge-preview | Previsualiza el cargo por asiento de añadir una empresa |
POST/v1/accounts/{account}/companies | Registrar un NIF en la cuenta |
POST/v1/accounts/{account}/companies/{company}/activate | Activar un NIF de la cuenta |
Resultados de importación, reintentos de tareas y campos nuevos
La importación de contactos informa de filas actualizadas, avisos y del motivo de cada fila omitida; la de tareas se reintenta sin duplicar; las facturas exponen origin; presupuestos y proformas exponen operation_regime.
Leer novedadEndpoints actualizados48Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/contacts/import/preview | Previsualizar una importación de contactos |
POST/v1/companies/{company}/contacts/import | Importar contactos |
GET/v1/companies/{company}/contacts/imports/{id} | Consultar una importación de contactos |
Rellena las plantillas de contactos antes de importar
Previsualiza plantillas vacías conservando sus columnas y gestiona empty_import antes de aplicar una importación.
Leer novedadEndpoints actualizados2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/contacts/import/preview | Previsualizar una importación de contactos |
POST/v1/companies/{company}/contacts/import | Importar contactos |
Edita series de numeración
Actualiza una serie con PUT /v1/series/{series} y la tool MCP update_series, bajo las mismas guardas fiscales que la aplicación web.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
PATCH/v1/companies/{company}/series/{series} | Actualizar una serie |
Endpoints actualizados3
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/series | Crea una serie |
GET/v1/companies/{company}/series/{series} | Obtener una serie |
POST/v1/companies/{company}/series/{series}/archive | Archivar una serie |
Actividad de la factura: resultados de la AEAT, correo y cobros
La línea de tiempo de la factura añade el resultado de cada envío a la AEAT, los correos no entregados, la primera visita diaria al enlace público y los eventos de cobro, cada uno con un contrato exacto de metadata.
Leer novedadEndpoints actualizados8Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/invoices/{invoice}/activities | Listar la actividad de la factura |
GET/v1/companies/{company}/invoices/{invoice}/verifactu | Recupera el registro VeriFactu de la factura |
POST/v1/companies/{company}/invoices/{invoice}/verifactu | Forzar la creación del registro VeriFactu de una factura |
Seguimiento y resultados íntegros de importaciones de contactos
Previsualiza archivos de contactos, consulta resultados confirmados por fila y descarga informes de errores autorizados.
Leer novedadNuevos endpoints2
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/contacts/imports/{id} | Consultar una importación de contactos |
GET/v1/companies/{company}/contacts/imports/{id}/errors.csv | Descargar errores de importación de contactos |
Endpoints actualizados2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/contacts/import/preview | Previsualizar una importación de contactos |
POST/v1/companies/{company}/contacts/import | Importar contactos |
Facturación desde terminales desatendidos
Una factura simplificada ya cobrada desde un cajero en una sola llamada idempotente, la remisión de VeriFactu a través de Factuarea, la subsanación de registros aceptados y errores por línea. Tres cambios que rompen: una línea sin tipo ya no toma el 21 %, emitir se rechaza cuando el registro no cabe en el esquema de la AEAT y, en modo NO VERI*FACTU, hace falta un certificado utilizable. POST /v1/verifactu/records/{id}/retry ya no responde max_retries_exceeded.
Leer novedadNuevos endpoints4Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/verifactu/records/retry-blocked | Reintentar todos los registros VeriFactu bloqueados |
GET/v1/companies/{company}/verifactu/representation | Recuperar la representación vigente |
POST/v1/companies/{company}/verifactu/representation | Registrar una representación |
Endpoints actualizados32Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/invoices | Crea una factura |
PATCH/v1/companies/{company}/invoices/{invoice} | Actualizar una factura |
POST/v1/companies/{company}/invoices/bulk-create | Crear facturas en bloque |
MCP: errores más claros, acceso desde ChatGPT y listas de tools más estables
Las tools MCP vuelven a informar de los errores de negocio, OAuth admite private_key_jwt para clientes como ChatGPT, los cursores de tools/list duran 24 horas y cuatro nombres antiguos de contactos se retiran el 15 de noviembre de 2026.
Leer novedadEscalera de planes: Esencial, Profesional, Avanzado y Enterprise
Nuevos nombres comerciales y Avanzado en el contrato de cuenta, con capacidad de API incluida en cada plan.
Leer novedadEndpoints actualizados2
| Endpoint | Descripción |
|---|---|
GET/v1/me | Obtener la credencial que llama |
GET/v1/companies/{company}/billing | Obtener los detalles de facturación de la cuenta |
Una sola ventana de rotura: eje y payload
Los recursos de empresa y de cuenta pasan a la URL, los importes viajan como cadenas decimales, la fecha de cobro cambia de nombre, X-Active-Profile se rechaza y la cuenta pasa a ser el cliente. Todas las operaciones que toca la ventana —519— recurso por recurso.
Leer novedadNuevos endpoints16Vista previa
| Endpoint | Descripción |
|---|---|
DEL/v1/accounts/{account}/invitations/{invitation} | Revocar una invitación de cuenta |
POST/v1/accounts/{account}/invitations | Enviar una invitación de cuenta |
GET/v1/accounts/{account}/invitations | Listar las invitaciones de la cuenta |
Endpoints actualizados455Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/absence-balances | Listar todos los saldos de ausencias |
GET/v1/companies/{company}/absence-balances/{absence_balance} | Obtener un saldo de ausencias |
GET/v1/companies/{company}/absence-calendar | Obtener el calendario de ausencias del equipo |
Modelo de cuentas
Cuentas, NIF, miembros, acceso cedido, cuentas gestionadas, importación masiva, webhooks de cuenta y las operaciones y campos que añaden o renombran.
Leer novedadNuevos endpoints33Vista previa
| Endpoint | Descripción |
|---|---|
PATCH/v1/accounts/{account}/api-keys/{api_key}/nif-scope | Cambiar los NIF a los que llega una API key |
GET/v1/accounts/{account}/invitations/{invitation} | Consultar una invitación de cuenta |
DEL/v1/accounts/{account}/members/{member}/grants/{company} | Revocar un grant de un miembro de la cuenta |
Endpoints actualizados39Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/accounts/{account}/api-keys | Crear una API key |
GET/v1/accounts/{account}/api-keys | Listar tus API keys |
POST/v1/accounts/{account}/api-keys/{api_key}/revoke | Revocar una API key |
Tope de automatizaciones activas
El tope de activas, el error de activación y el consumo active_rules en API y MCP.
Leer novedadEndpoints actualizados2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/automations/rules/{rule}/activate | Activar una regla de automatización |
GET/v1/companies/{company}/automations/usage | Obtener el consumo de automatizaciones |
Tope anual de documentos en la API y MCP
El tope anual, las operaciones v1 afectadas (14 en total), los errores MCP y la emisión automática.
Leer novedadEndpoints actualizados14Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/invoices | Crea una factura |
POST/v1/companies/{company}/invoices/{invoice}/duplicate | Duplicar una factura |
POST/v1/companies/{company}/invoices/{invoice}/corrective | Generar factura rectificativa |
Uso de la cuenta: mensaje de error genérico
El mensaje y la guía de storage_quota_exceeded remiten ahora a soporte sin cifras de uso.
Leer novedadEndpoints actualizados3
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/purchase-invoices/{purchase_invoice}/attach-file | Adjuntar un archivo a un gasto |
POST/v1/companies/{company}/verifactu/certificates | Sube un certificado de empresa |
POST/v1/companies/{company}/delivery-notes/{delivery_note}/sign | Firmar un albarán |
Ajustes de Tareas
Límites más precisos y errores más claros en Proyectos y Tareas: descripción de tarea de hasta 400.000 caracteres, tarifa por hora de hasta 99.999.999,99, vínculos que respetan los scopes, id de la tarea en las notificaciones, borrados bloqueados por horas facturadas y facturación de horas idempotente. users:read pasa a ser un scope sensible.
Leer novedadEndpoints actualizados15Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/tasks | Crear una tarea |
PATCH/v1/companies/{company}/tasks/{task} | Actualizar una tarea |
POST/v1/companies/{company}/tasks/bulk-delete | Eliminación masiva de tareas |
Proyectos y tareas
El módulo de tareas llega a la API: proyectos con su tablero, tareas, etiquetas, temporizadores, usuarios, notificaciones y la agenda — 80 endpoints nuevos, 21 eventos, 80 tools MCP y cuatro acciones de automatización.
Leer novedadNuevos endpoints80Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/projects | Listar proyectos |
POST/v1/companies/{company}/projects | Crear un proyecto |
GET/v1/companies/{company}/projects/{project} | Obtener un proyecto |
Escáner de gastos: original no disponible
Reintentar, convertir y restaurar identifican ahora cuándo ya no se conserva el archivo original del escaneo.
Leer novedadEndpoints actualizados3
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/purchase-scans/{purchase_scan}/retry | Reintentar un escaneo de compra fallido |
POST/v1/companies/{company}/purchase-scans/{purchase_scan}/convert | Crear el gasto de un escaneo |
POST/v1/companies/{company}/purchase-scans/{purchase_scan}/restore | Restaurar un escaneo de compra archivado |
Gastos y Facturas: nuevos nombres de producto
Las facturas de compra pasan a llamarse Gastos y las facturas de venta, Facturas. Las integraciones conservan sus interfaces.
Leer novedadEndpoints actualizados45Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/accounts/{account}/companies/{company}/activate | Activar un NIF de la cuenta |
POST/v1/accounts/{account}/companies/activate | Activar varios NIF de la cuenta |
POST/v1/accounts/{account}/companies | Registrar un NIF en la cuenta |
Emitida no es enviada: versión de la API 2026-10-01
Las facturas separan la emisión de la entrega. La versión opcional 2026-10-01 publica el estado issued con issued_at, is_sent y sent_via; nuevo POST /v1/invoices/{invoice}/issue; mark-sent registra una entrega manual desde esa versión; nuevos eventos invoice.issued, invoice.marked_sent e invoice.unsent, con invoice.sent como alias deprecado; payloads de webhook versionados por endpoint; las facturas recurrentes ganan generation_mode. La versión predeterminada no cambia.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/issue | Emite una factura |
Endpoints actualizados20Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/mark-sent | Marca una factura como enviada |
POST/v1/companies/{company}/invoices/{invoice}/unsend | Anular el envío de una factura |
POST/v1/companies/{company}/invoices/{invoice}/send | Envía la factura por email |
El control horario respeta el periodo de alta
Cambio que rompe: fichar antes de la fecha de alta de un empleado o después de su fecha de baja responde ahora 422 con el subcode clocking_outside_employment_period. Los saldos diarios añaden is_unscheduled e is_outside_employment, la hoja mensual y el resumen de equipo añaden un bloque to_date con los días cerrados, el horario del empleado acepta una fecha, hire_date pasa a ser editable, y reasignar o desasignar un horario que aún no ha empezado lo anula.
Leer novedadEndpoints actualizados13Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/time-entries/clock-in | Fichar la entrada de un empleado |
POST/v1/companies/{company}/time-entries/manual | Registrar una entrada manual retroactiva |
POST/v1/companies/{company}/time-corrections | Solicitar una corrección de fichaje |
Escaneos de compra: historial acotado, OCR aplazado y faceta de proveedores
El detalle del escaneo devuelve ahora los 50 intentos y eventos de auditoría más recientes con sus totales, los escaneos que esperan la cuota diaria de OCR lo indican y las estadísticas añaden una faceta por proveedor.
Leer novedadEndpoints actualizados3
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/purchase-scans | Listar escaneos de compras |
GET/v1/companies/{company}/purchase-scans/{purchase_scan} | Consultar un escaneo de compra |
GET/v1/companies/{company}/purchase-scans/stats | Consultar indicadores del escáner de compras |
Escáner de compras: API pública y MCP
Sube, revisa, resuelve duplicados y convierte escaneos de compra desde la API pública y MCP. Trece operaciones cubren todo el flujo, el buzón del escáner y las categorías de gasto.
Leer novedadNuevos endpoints13Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/purchase-invoices/expense-categories | Listar categorías de gastos |
GET/v1/companies/{company}/purchase-scan-emails | Listar correos del escáner de compras |
DEL/v1/companies/{company}/purchase-scans/{purchase_scan} | Archivar un escaneo de compra |
Endpoints actualizados2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/purchase-invoices | Crea un gasto |
PATCH/v1/companies/{company}/purchase-invoices/{purchase_invoice} | Actualizar un gasto |
Pausar y reanudar facturas recurrentes en bloque
Nueva operación POST /v1/recurring_invoices/bulk-status: mueve hasta 50 facturas recurrentes a active o paused con éxito parcial, con la tool MCP bulk_change_recurring_invoice_status como espejo. Reanudar una recurrencia completada responde ahora 422 recurring_invoice_completed_cannot_resume.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/recurring-invoices/bulk-status | Cambiar en bloque el estado de facturas recurrentes |
Endpoints actualizados2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/resume | Reanudar factura recurrente |
POST/v1/companies/{company}/recurring-invoices/{recurring_invoice}/activate | Activar factura recurrente |
Eliminar y archivar contactos
Cambio que rompe: DELETE /v1/contacts/{id} y POST /v1/contacts/bulk-delete eliminan en lugar de archivar, y la eliminación no se puede deshacer desde la API. Archivar pasa a POST /v1/contacts/{id}/archive, está siempre permitido y sigue siendo reversible. Se publica el evento webhook contact.deleted y desaparece el subcode contact_has_commercial_references.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/contacts/{contact}/archive | Archivar un contacto |
Endpoints actualizados3
| Endpoint | Descripción |
|---|---|
DEL/v1/companies/{company}/contacts/{contact} | Eliminar un contacto |
POST/v1/companies/{company}/contacts/bulk-delete | Eliminar contactos en lote |
POST/v1/companies/{company}/contacts/bulk/archive | Archivar contactos en lote |
Líneas de compra medidas
Las líneas de factura de compra registran ya los bultos recibidos, la unidad a la que se aplica el coste del proveedor y la medida real. El contrato añade un bloque de medida, persiste el descuento de línea, resuelve el coste desde la oferta del proveedor y duplica una compra desde un origen autorizado.
Leer novedadEndpoints actualizados4Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/purchase-invoices | Crea un gasto |
PATCH/v1/companies/{company}/purchase-invoices/{purchase_invoice} | Actualizar un gasto |
GET/v1/companies/{company}/purchase-invoices/{purchase_invoice} | Obtener un gasto |
Capacidades PDF en la cuenta
El recurso Account y el endpoint de plantillas exponen un bloque de capacidades de solo lectura: qué permite el plan en la marca de los documentos, qué plantillas pueden fijarse y qué plan desbloquea el editor. Las actualizaciones de personalización fuera del plan devuelven ya 403.
Leer novedadEndpoints actualizados3
| Endpoint | Descripción |
|---|---|
GET/v1/me | Obtener la credencial que llama |
GET/v1/companies/{company}/personalization/templates | Lista las plantillas de personalización disponibles |
PATCH/v1/companies/{company}/personalization | Actualiza la personalización de la cuenta |
API de contactos
Gestiona una sola identidad con roles acumulables de cliente, proveedor y lead. La API canónica ya cubre creación y archivado en lote, búsqueda por identificadores, verificación censal AEAT, estadísticas, actividad e importaciones.
Leer novedadNuevos endpoints26Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/contacts | Listar contactos |
POST/v1/companies/{company}/contacts | Crear un contacto |
GET/v1/companies/{company}/contacts/options | Listar opciones de filtros de contactos |
Tiendas, MCP y ejemplos completos de respuesta
Conecta tiendas WooCommerce y Shopify, trabaja con snapshots de pedidos y usa el transporte MCP actualizado. Cada respuesta documentada tiene un ejemplo explícito o la representación de descarga adecuada.
Leer novedadNuevos endpoints7Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/stores | Conectar una tienda |
GET/v1/companies/{company}/stores | Listar tiendas conectadas |
DEL/v1/companies/{company}/stores/{store} | Desconectar una tienda |
Selecciones configurables y precios exactos de catálogo
Configura qué combinaciones de producto se pueden vender y resuelve precios negociados exactos. La API incorpora consulta de selecciones, auditoría de stock y resolución de precios en lote.
Leer novedadNuevos endpoints8Vista previa
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/products/{product}/configurations | Listar combinaciones comerciales de un producto |
GET/v1/companies/{company}/products/{product}/options | Listar grupos de opciones de un producto |
GET/v1/companies/{company}/products/{product}/stock-movements | Listar movimientos de stock de un producto |
v1.13.0 — Paridad de contrato
Semántica de escritura de producto, consentimiento OAuth ampliado, capacidad API derivada del plan y notas multilínea en PDF.
Leer novedadEndpoints actualizados2
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/products | Crear un producto |
PATCH/v1/companies/{company}/products/{product} | Actualizar un producto |
Cobertura completa de catálogo y tarifas
Gestiona presentaciones, variantes, ofertas de proveedores y tarifas. Los documentos conservan snapshots de precio y hacen explícita la actualización de precios.
Leer novedadNuevos endpoints23Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/price-lists | Crear una tarifa |
GET/v1/companies/{company}/price-lists | Listar tarifas |
POST/v1/companies/{company}/products/{product}/presentations | Crear una presentación de producto |
Las tools MCP de envío masivo ya aplican el tope de 200 ids por lote
Las tools MCP de envío masivo rechazan los lotes de más de 200 IDs con un error claro. El comportamiento REST se mantiene.
Leer novedadAutomatizaciones
Crea reglas a partir de eventos, previsualiza sus efectos y consulta cada ejecución. Dieciocho operaciones cubren reglas, versiones, ejecuciones, relanzamiento y consumo.
Leer novedadNuevos endpoints18Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/automations/rules/{rule}/activate | Activar una regla de automatización |
POST/v1/companies/{company}/automations/rules | Crear una regla de automatización |
GET/v1/companies/{company}/automations/rules | Listar tus reglas de automatización |
Informes fiscales: libro de trabajo y tools para agentes
Los informes fiscales usan un libro de trabajo Excel y exponen nueve tools MCP. Los endpoints existentes documentan con precisión los formatos de salida admitidos.
Leer novedadEndpoints actualizados4Vista previa
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/tax-reports/130 | Generar Modelo 130 |
POST/v1/companies/{company}/tax-reports/303 | Generar Modelo 303 |
POST/v1/companies/{company}/tax-reports/347 | Generar Modelo 347 |
Anulación de cobros
Anula un cobro conservando el registro original y su trazabilidad. El saldo de la factura refleja la anulación y las integraciones reciben el evento correspondiente.
Leer novedadNuevos endpoints1
| Endpoint | Descripción |
|---|---|
POST/v1/companies/{company}/invoices/{invoice}/payments/{payment}/reversal | Anular un pago de una factura |
Control horario
Gestiona horarios, fichajes, ausencias, balances y presencia desde la API y MCP, con el mismo modelo de permisos que el resto de la plataforma.
Leer novedadAPI y MCP incluidos en todos los planes
El acceso a la API pública y MCP está incluido en todos los planes de Factuarea. Los límites de peticiones siguen el plan activo y también hay acceso durante el trial.
Leer novedadLanzamiento de la plataforma
La plataforma pública reúne la API REST v1, los SDKs oficiales de TypeScript y PHP, el CLI y MCP, con un sandbox aislado para probar integraciones.
Leer novedad