Integración Xero n8nAutomatiza Xero con n8n.
Copiar facturas a mano no es trabajo, es desgaste. La integración Xero n8n reúne 8 operaciones repartidas en 2 recursos, contactos y facturas, detrás de una sola credencial OAuth2. No hay nodo trigger de Xero, así que el flujo arranca con un Schedule o con un Webhook.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve la integración Xero n8n?
La integración Xero n8n es un nodo que viene incluido en n8n y que habla con la API contable de Xero por ti. Reúne 8 operaciones repartidas en 2 recursos: Contact e Invoice. Puedes crear un contacto, consultarlo, listar varios y actualizarlo, y hacer lo mismo con las facturas. Cada llamada apunta a una organización de Xero concreta que eliges en el nodo, así que ningún flujo escribe en los libros equivocados.
El primer escenario es el clásico de cualquier tienda: convertir cobros en facturas. El pago entra, el flujo identifica al comprador y invoice.create registra una factura de venta con Type en ACCREC. Quien cobra con Stripe suele encadenar los dos nodos y dejar Status en DRAFT hasta que contabilidad revisa el lote.
El segundo es el informe que nadie quiere montar a mano. Con Return All activado, invoice.getAll recorre todas las páginas que devuelve la API, de modo que una ejecución nocturna vuelca el libro completo en Google Sheets y deja el resumen en Slack. Si solo te interesan las facturas autorizadas, Statuses recorta el lote; y cuando el filtro que necesitas no tiene campo propio, queda Where.
El tercero mira hacia los contactos. contact.getAll saca la ficha de clientes y proveedores, Include Archived decide si aparecen también los archivados, y contact.update devuelve las correcciones: un Email corregido, un Tax Number que faltaba, un Contact Status que pasa a ARCHIVED. Nada espectacular, pero evita que una declaración se atasque por fichas incompletas.
Conviene saber dónde termina el nodo. Contactos y facturas, y nada más: pagos, notas de crédito, movimientos bancarios e informes no tienen operación aquí. El nodo HTTP Request llega igualmente a todos ellos, porque llama a cualquier endpoint de la API de Xero reutilizando la misma credencial mediante la autenticación predefinida. Tampoco hay trigger de Xero: lo que va por horario arranca con un Schedule Trigger y lo que va por evento con un nodo Webhook, es decir una URL que n8n publica y que otro servicio llama.
Si todavía estás comparando herramientas contables, el nodo de Quickbooks cubre un terreno parecido con otros recursos. Y si lo nuevo para ti es n8n, el Curso n8n repasa credenciales, expresiones y control de errores antes de apuntar un flujo a una contabilidad real.
¿Cómo se conecta Xero con n8n?
- 01
Registra una app custom connection en Xero
Entra en My Apps, dentro del portal de desarrolladores de Xero, y crea una aplicación OAuth2 de tipo custom connection. Elige Web app en Integration Type y escribe en Company or Application URL la dirección de tu servidor n8n o de su proxy inverso, que en la versión alojada tiene la forma
https://tu-usuario.app.n8n.cloud/. Ojo con un detalle: Xero no admite nombres de aplicación que contengann8n. - 02
Haz coincidir la URL de redirección
En n8n, abre Credentials y empieza una credencial de Xero. Una credencial es el bloque de acceso que configuras una vez y que después reutilizan todos tus flujos. Ahí aparece una OAuth Redirect URL: cópiala en tu aplicación de Xero como OAuth 2.0 redirect URI, guarda, y trae de vuelta a n8n el Client ID y el Client Secret que la aplicación ha generado.
- 03
Añade los scopes y elige la organización
Los scopes marcan hasta dónde puede llegar la conexión. Añade
accounting.contactsyaccounting.transactionsa la aplicación para cubrir todo lo que hace el nodo y completa la autorización OAuth2 desde n8n. Ya en el nodo, la lista Organization Name or ID muestra las organizaciones de Xero a las que llega la conexión, y ese campo es obligatorio en las 8 operaciones.
Lo que hace el nodo Xero
El nodo Xero expone 8 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
Contact
4 operacionesCreate a contact
contact.createLo que ves en n8n
Notas y casos de uso
Da de alta una ficha de cliente o proveedor en Xero y devuelve el identificador que necesitan las operaciones posteriores.
Parámetros clave
- Organization Name or ID: la organización de Xero donde se escribe la ficha, elegida en la lista o construida con una expresión como
{{ $json.orgId }}. - Name: el nombre completo de la persona o la empresa, el único campo descriptivo que Xero exige.
- Additional Fields: la colección con Email, Tax Number o Default Currency, entre 15 campos opcionales.
Get a contact
contact.getLo que ves en n8n
Notas y casos de uso
Recupera una ficha concreta con todo su contenido: direcciones, datos bancarios y cuentas por defecto.
Parámetros clave
- Organization Name or ID: los libros donde buscar, obligatorio también aquí.
- Contact ID: el identificador de Xero de la ficha, nunca el nombre visible. Suele venir del nodo anterior como
{{ $json.ContactID }}.
Get many contacts
contact.getAllLo que ves en n8n
Notas y casos de uso
Lista los contactos de la organización y saca un item de n8n por cada ficha.
Parámetros clave
- Return All: activado, n8n recorre todas las páginas hasta el último contacto; desactivado, Limit fija cuántas fichas vuelven.
- Include Archived: decide si los contactos en
ARCHIVEDaparecen junto a los activos. - Where y Order By: una condición de filtrado y el elemento por el que ordenar el resultado.
Update a contact
contact.updateLo que ves en n8n
Notas y casos de uso
Modifica una ficha existente. Solo viajan a Xero los campos que rellenas, el resto queda intacto.
Parámetros clave
- Contact ID: señala la ficha que se corrige, y sin él la operación no sabe sobre qué actuar.
- Update Fields: 16 campos opcionales, entre ellos Name, Account Number, Bank Account Details y Contact Status.
- Contact Status: el valor
GDPRREQUESTmarca una ficha afectada por una solicitud de borrado.
Invoice
4 operacionesCreate an invoice
invoice.createLo que ves en n8n
Notas y casos de uso
Emite una factura nueva y devuelve su identificador en Xero junto con su número.
Parámetros clave
- Type:
ACCRECpara una factura de venta,ACCPAYpara una factura de compra. No hay valor por defecto, elegir es obligatorio. - Contact ID: a quién pertenece la factura, normalmente el identificador que devolvió una operación de contacto anterior.
- Line Items: cada línea lleva Description, Quantity y Unit Amount.
- Status:
DRAFTla deja fuera del libro,AUTHORISEDla confirma.
Get an invoice
invoice.getLo que ves en n8n
Notas y casos de uso
Trae una factura suelta con sus líneas, sus totales y el estado que tiene en ese momento.
Parámetros clave
- Organization Name or ID: la organización que guarda la factura, tomada de la lista o calculada con una expresión.
- Invoice ID: el identificador técnico de Xero, que no coincide con el número de factura impreso en el documento.
Get many invoices
invoice.getAllLo que ves en n8n
Notas y casos de uso
Devuelve un lote de facturas listo para filtrar, sumar o exportar en los nodos siguientes.
Parámetros clave
- Return All: desactivado por defecto, y entonces manda Limit. Activado, n8n pide páginas hasta agotar el libro.
- Statuses: selección múltiple entre
DRAFT,SUBMITTEDyAUTHORISED. - Created By My App: reduce el resultado a las facturas creadas por tu propia conexión.
Update an invoice
invoice.updateLo que ves en n8n
Notas y casos de uso
Retoca una factura que ya está en Xero, incluido su estado.
Parámetros clave
- Invoice ID: la factura que se modifica, campo obligatorio.
- Update Fields: 15 campos opcionales, como Due Date, Reference, Currency Rate o Line Items.
- Send To Contact: marca la factura como enviada en Xero, y solo funciona sobre facturas ya aprobadas.
AUTHORISED un grupo de borradores cuando el responsable ya ha dado el visto bueno.¿Necesitas ayuda para automatizar Xero con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
