> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Xero

> Envía tus facturas de Chateea a Xero con contacto, impuestos, moneda y estado, e importa tus contactos.

Si llevas tu contabilidad en Xero, conectar Chateea te ahorra volver a escribir cada factura. Las facturas que creas en Chateea se publican solas en Xero, con su contacto, sus líneas, sus impuestos, su moneda y su estado, y tu contador trabaja siempre con datos al día.

## Cómo funciona la sincronización

La integración es **unidireccional** para las facturas:

* **Contactos (Xero → Chateea):** al conectar, Chateea importa los contactos activos de Xero para poder asociar cada factura con el contacto correcto.
* **Facturas (Chateea → Xero):** cada factura que creas en Chateea se crea automáticamente en Xero. Si su cliente no coincide con ningún contacto importado, se crea un contacto nuevo en Xero durante la sincronización.

### Qué se sincroniza

| Elemento | Qué pasa en Xero |
| - | - |
| **Contacto** | Se usa el contacto coincidente o se crea uno nuevo |
| **Líneas de la factura** | Se envían nombre, cantidad, importe y descuentos. Los productos no se crean en el catálogo de Xero |
| **Impuestos** | Si la tasa ya existe en Xero, se aplica. Si no existe, se crea y se usa en la factura |
| **Moneda** | Se envía la moneda de la factura. Si no está habilitada en tu organización, se agrega |
| **Estado** | Los cambios de estado se reflejan en Xero, por ejemplo Enviada, Pagada parcialmente o Anulada |

### Qué no se sincroniza

| Elemento | Detalle |
| - | - |
| **Recibos** | No se envían recibos ni sus PDF |
| **Catálogo de productos** | No se crean ni se actualizan productos o artículos en Xero. Las líneas viven solo dentro de la factura |
| **Facturas anteriores a la conexión** | Por lo general, solo se sincronizan las facturas creadas después de conectar Xero |

> [!WARNING]
>
> Para facturar en varias monedas, tu plan de Xero debe admitir **multidivisa**. Si no lo admite, la factura fallará con un error de moneda no suscrita.

## Ventajas

* **Sin doble captura:** las facturas aparecen en Xero en cuanto las creas en Chateea.
* **Contactos consistentes:** se asocian con los existentes o se crean al vuelo.
* **Impuestos correctos:** las tasas se asignan con precisión, incluso con estructuras de varios componentes.
* **Estados al día:** los pagos parciales o las anulaciones se reflejan en Xero y facilitan la conciliación.
* **Cuentas filtradas:** al elegir la cuenta predeterminada solo ves las que tienen pagos habilitados.

## Cómo conectar Xero

**1. Abre la integración**

En Chateea, ve a **Configuración → Integraciones** y busca **Xero**.

**2. Conecta**

Haz clic en el mosaico de Xero y luego en **Conectar**. Se abrirá una ventana segura de Xero.

**3. Inicia sesión y autoriza**

Inicia sesión en Xero si te lo pide, elige la organización que quieres conectar y haz clic en **Permitir acceso**. Chateea solo solicita los permisos necesarios para leer contactos y configuración, y crear transacciones de facturación.

**4. Confirma la conexión**

De vuelta en Chateea, verás el nombre de la organización conectada y el estado de la conexión en **Configuración → Integraciones → Xero**.

**5. Elige la cuenta predeterminada**

En los ajustes de Xero dentro de Chateea, selecciona la organización y la cuenta donde se publicarán las facturas.

> [!NOTE]
>
> En la lista de cuentas solo aparecen las que tienen **pagos habilitados** en Xero. Si no ves la que necesitas, sigue los pasos de [Ver todo el plan de cuentas de Xero en Chateea](https://help.chateea.com/docs/pagos/plan-de-cuentas-xero.md).

## Ejemplo práctico

Emites una factura de 1.200 EUR a un cliente que aún no existe en Xero, con un impuesto del 18 % que tampoco está configurado allí.

| Situación | Qué hace la integración |
| - | - |
| El contacto no existe en Xero | Lo crea automáticamente |
| La tasa del 18 % no existe | Crea la tasa durante la sincronización |
| La moneda EUR no está habilitada | La agrega a tu organización, si tu plan admite multidivisa |
| Las líneas del servicio | Aparecen dentro de la factura, sin crear productos |
| Marcas la factura como enviada | El estado se refleja en Xero |

## Buenas prácticas

* Si usas categorías de seguimiento o cuentas de ingresos específicas en Xero, elige con cuidado la **cuenta predeterminada** para publicar facturas.
* No asignes **cuentas bancarias** a las líneas de factura: Xero rechaza esas facturas con errores de validación.
* Haz una factura de prueba después de conectar y revisa en Xero que el contacto, el impuesto y la moneda quedaron como esperabas.

## Desconectar y volver a conectar

Desde **Configuración → Integraciones → Xero** puedes ver el estado, desconectar la integración y volver a conectarla con **Conectar**. Al reconectar, vuelves a autenticarte y elegir tu organización.

## Preguntas frecuentes

> **¿La sincronización es en un sentido o en los dos?**
>
> En un sentido. Los contactos se importan de Xero a Chateea para asociarlos, y las facturas viajan de Chateea a Xero.

> **¿Chateea crea contactos nuevos en Xero?**
>
> Sí. Si el cliente de la factura no coincide con ningún contacto importado, se crea en Xero al sincronizar.

> **¿Se crean productos o artículos en Xero?**
>
> No. Las líneas se publican solo dentro de la factura.

> **¿Cómo se manejan los impuestos?**
>
> Si la tasa asignada ya existe en Xero, se usa esa. Si no existe, se crea y se aplica a la factura.

> **¿Se sincronizan los recibos?**
>
> No, la integración no incluye recibos.

> **¿Puedo conectar varias organizaciones de Xero a mi cuenta?**
>
> No. Cada cuenta de Chateea se conecta a una sola organización de Xero a la vez.

> **Me aparece "Organisation is not subscribed to currency XXX". ¿Qué hago?**
>
> La moneda de la factura no está habilitada en tu organización de Xero. Activa la multidivisa en Xero (o esa moneda en concreto) y vuelve a intentarlo.

> **¿Se sincronizan las facturas creadas antes de conectar Xero?**
>
> Por lo general no. La sincronización automática aplica a las facturas creadas después de conectar la integración.

Si una factura no llega a Xero o ves un error de validación, escribe a soporte de Chateea en **[help@chateea.com](mailto:help@chateea.com)** con el número de la factura y el mensaje de error exacto.

## Artículos relacionados

> **[Ver todo el plan de cuentas de Xero](https://help.chateea.com/docs/pagos/plan-de-cuentas-xero.md)**
>
> Habilita las cuentas que quieres usar en Chateea.

> **[Integración con QuickBooks](https://help.chateea.com/docs/pagos/integracion-quickbooks.md)**
>
> La alternativa si llevas tu contabilidad en QuickBooks.

> **[Integración con Wave](https://help.chateea.com/docs/pagos/integracion-wave.md)**
>
> Envía tus facturas a Wave.

> **[Crea y envía facturas](https://help.chateea.com/docs/pagos/crear-y-enviar-facturas.md)**
>
> Configura y emite tus facturas en Chateea.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.