Automatizar Lexoffice con n8n: comprobantes, facturas, contactos

Lexoffice se puede automatizar con n8n, aunque no existe un node n8n oficial para Lexoffice: la solución es el node HTTP Request, que se comunica directamente con la API pública de Lexoffice y allí recupera comprobantes, crea facturas o sincroniza contactos. Para ello se necesita una clave API personal de la cuenta de Lexoffice, que n8n envía como token bearer en el encabezado Authorization, así como una credencial Header Auth almacenada en el node HTTP Request. La API de producción funciona desde mayo de 2025 bajo el dominio api.lexware.io y está limitada a un máximo de dos solicitudes por segundo. Estado: julio de 2026.

¿Por qué no existe un node n8n nativo para Lexoffice?

Lexoffice no forma parte de los servicios integrados oficialmente por n8n, por lo que los workflows deben usar el node HTTP Request genérico en lugar de un node Lexoffice ya hecho. Para estos casos, n8n admite varios métodos de autenticación genéricos en el node HTTP Request, entre ellos Header Auth, Basic Auth, OAuth2 y Query Auth (documentación de n8n sobre el node HTTP Request). Para Lexoffice, Header Auth es la elección adecuada, porque la API exige autenticación por token bearer mediante el encabezado Authorization. El precio de esta flexibilidad: los endpoints, los campos y el manejo de errores deben reconstruirse manualmente, y ante cambios de la API por parte de Lexoffice, el workflow debe mantenerse de forma independiente en lugar de funcionar automáticamente con una actualización del node.

¿Cómo se autentica n8n frente a la API de Lexoffice?

La autenticación se realiza mediante una clave API personal, que usted genera en la cuenta de Lexoffice en la configuración de la API pública y que envía como token bearer en el encabezado Authorization de cada solicitud (documentación de la API de Lexware). En n8n, para ello crea en el node HTTP Request una credencial Header Auth llamada Authorization con el valor Bearer seguido de la clave. Dos puntos técnicos son importantes para la planificación del workflow:

• URL base: Desde el 26 de mayo de 2025, la API de producción funciona bajo https://api.lexware.io; la antigua dirección lexoffice.io ha sido sustituida desde entonces.
• Límite de tasa: La API permite un máximo de dos solicitudes por segundo; si se supera, responde con HTTP 429, por lo que las sincronizaciones más grandes necesitan un bucle limitado o un node Wait en el workflow.

¿Cómo se recuperan nuevos comprobantes de Lexoffice con n8n?

Los nuevos comprobantes se pueden recuperar mediante el endpoint GET /v1/voucherlist, que se puede filtrar por parámetros de consulta según el tipo de comprobante, el estado y la fecha de creación o modificación. En n8n se configura el node HTTP Request con el método GET y la URL https://api.lexware.io/v1/voucherlist, complementada con parámetros como voucherType, voucherStatus y createdDateFrom, por ejemplo para obtener solo las facturas abiertas de las últimas 24 horas. La respuesta está paginada, con un tamaño predeterminado de 25 entradas por página y campos como totalPages y totalElements, por lo que una sincronización completa necesita un bucle de paginación. Un patrón típico: un trigger cron inicia el workflow cada hora, recupera comprobantes nuevos o modificados y los escribe en una tabla o un dashboard interno.

¿Cómo se crean nuevas facturas en Lexoffice mediante n8n?

Las nuevas facturas se crean mediante una solicitud POST a /v1/invoices, donde el cuerpo JSON contiene el cliente, las líneas de factura y los tipos de impuesto. En el node HTTP Request se selecciona el método POST, se establece el Content-Type en application/json y se transmite el cuerpo de la factura ya sea desde datos previos del workflow o desde un node Set que compone los campos según el esquema de Lexoffice. Un ejemplo práctico: la finalización de un pedido en una tienda online desencadena mediante webhook un workflow de n8n que transfiere automáticamente los datos del cliente y las líneas al formato esperado por Lexoffice y crea la factura. La API valida el esquema de forma estricta, por lo que conviene hacer pruebas con datos de prueba reales antes de poner en producción un workflow así.

¿Cómo se sincronizan los contactos entre n8n y Lexoffice?

Los contactos se pueden consultar mediante GET /v1/contacts con filtros como el correo electrónico o el nombre y crear mediante POST /v1/contacts, lo que permite una sincronización entre Lexoffice y un CRM o una tabla. Un patrón habitual comprueba mediante GET si ya existe un contacto con una dirección de correo determinada, y solo lo crea mediante POST si es necesario, para evitar duplicados. Para las empresas que usan Lexoffice como contabilidad junto a un CRM independiente, esto ahorra el doble mantenimiento manual de los datos de contacto. Quien quiera operar de forma duradera este tipo de workflows de varios pasos con manejo de errores, control del límite de tasa y monitorización, encontrará en NordFlux apoyo para la creación de workflows de n8n, incluida la evaluación de qué procesos merecen la pena técnica y económicamente.

Preguntas frecuentes sobre Lexoffice y n8n

¿Existe un node oficial de Lexoffice para n8n?

No, n8n no ofrece un node oficial y nativo para Lexoffice, por lo que la conexión se realiza mediante el node HTTP Request genérico contra la API pública de Lexoffice. Esto significa más esfuerzo de configuración que con un node ya hecho, pero técnicamente todas las funciones principales, como comprobantes, facturas y contactos, son accesibles mediante la API. Con una credencial Header Auth configurada una sola vez, cualquier número de pasos del workflow puede apoyarse en el mismo acceso.

¿Cuál es el límite de tasa de la API de Lexoffice?

La API de Lexoffice limita las solicitudes a un máximo de dos solicitudes por segundo; si se supera, responde con el código de estado HTTP 429. En workflows de n8n con muchos registros conviene, por tanto, incorporar un node Wait o un bucle limitado para no superar el límite. En sincronizaciones más grandes, por ejemplo varios cientos de contactos, esto se nota en el tiempo de ejecución y debe tenerse en cuenta en la planificación del workflow.

¿Qué URL base utiliza actualmente la API de Lexoffice?

Desde el 26 de mayo de 2025, la API de producción de Lexoffice funciona bajo el dominio api.lexware.io; la antigua dirección bajo lexoffice.io ha sido sustituida desde entonces. Los workflows de n8n que todavía usen la URL antigua deberían cambiarse a la nueva URL base para evitar errores. La propia clave API no se ve afectada y sigue gestionándose en la cuenta de Lexoffice.

¿Qué ocurre si Lexoffice cambia la API?

Dado que la conexión se realiza mediante solicitudes HTTP construidas manualmente en lugar de mediante un node de n8n mantenido, el workflow debe adaptarse manualmente ante cambios de esquema o de endpoints. Ese es el precio de la flexibilidad de un patrón individual: no existe un mecanismo de actualización automática como el que tendría un node mantenido oficialmente. Quien no quiera asumir este esfuerzo de mantenimiento por su cuenta debería tenerlo firmemente en cuenta en la planificación.