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

# QuickBooks (vía Rutter)

> Conecta QuickBooks, empareja tus registros y exporta Liquidaciones como facturas y cuentas por pagar.

Exporta las [Liquidaciones](/es/concepts/settlements-driver-pay) aprobadas directamente a QuickBooks como facturas y cuentas por pagar — sin reingresar datos en tu sistema contable. Funciona con QuickBooks Online y QuickBooks Desktop.

## Requisitos previos

* Acceso de **Company Admin** en Tread. Si no ves estas opciones, pide a tu representante de Tread que habilite la integración.
* Tus credenciales de administrador de QuickBooks.
* Ventanas emergentes permitidas para la app de Tread. La ventana de conexión se abre como pop-up.
* Tread admite una conexión contable por empresa.

## Conecta tu cuenta de QuickBooks

Configuración única. Una vez vinculada, Tread trae tus clientes, proveedores, artículos y plan de cuentas de QuickBooks.

<Steps>
  <Step title="Abre Integraciones">
    Ve a **Configuración → Integraciones**, bajo **AI & Integrations**.
  </Step>

  <Step title="Administra la integración de Rutter">
    En la tarjeta **Rutter: Accounting Integrations**, haz clic en **Manage**. Rutter es el servicio que Tread usa para conectarse a QuickBooks.
  </Step>

  <Step title="Vincula tu cuenta">
    Haz clic en **Link account**. La ventana de conexión se abre como pop-up.

    <img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-connect-popup.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=97e82e86161664ce1461ea409ad741f6" alt="Pop-up de conexión de Rutter titulado Connect with Tread, con un botón Continue" width="300" data-path="images/integrations/quickbooks-connect-popup.png" />
  </Step>

  <Step title="Autoriza a Tread">
    Haz clic en **Continue**, elige tu producto de QuickBooks e inicia sesión con tus credenciales de administrador de QuickBooks. Sigue los pasos del diálogo.

    Para QuickBooks Desktop, completa estos pasos en el servidor o equipo donde esté abierto tu archivo de empresa.
  </Step>

  <Step title="Cierra el pop-up">
    Al ver "Authentication Complete!", cierra el pop-up. Tu conexión aparece en la tabla y la primera sincronización comienza automáticamente.

    <img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-connection-active.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=4fa3b8792ec65740a32802b7c1440b80" alt="Tabla de conexiones de Rutter con una conexión de QuickBooks Desktop en estado Active y su última sincronización" width="2102" height="1708" data-path="images/integrations/quickbooks-connection-active.png" />
  </Step>
</Steps>

<Note>
  La primera sincronización toma unos minutos en QuickBooks Online. QuickBooks Desktop se sincroniza cuando corre tu Web Connector — hasta un día.
</Note>

<Tip>
  ¿Cerraste el pop-up antes de tiempo? La fila de conexión muestra *Awaiting authorization* — haz clic en la fila para reabrir el inicio de sesión y terminar.
</Tip>

## Empareja tus datos de QuickBooks

Empareja cada registro importado de QuickBooks con su contraparte en Tread, para que las facturas y cuentas por pagar exportadas lleguen a los registros correctos en QuickBooks.

Abre **Configuración → Integraciones → Rutter** y haz clic en tu conexión. Verás cuatro pestañas — **Customer**, **Vendors**, **Items**, **Ledger** — más **Refresh All Data** para traer los registros más recientes de QuickBooks en cualquier momento.

### Pestaña Customer

En la columna **Tread Name**, elige el cliente de Tread correspondiente. El emparejamiento se guarda de inmediato. Usa **+ Create Account** si el cliente aún no existe en Tread. Cada cliente de QuickBooks se empareja con exactamente un cliente de Tread.

<img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-customer-tab.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=03b7f1bff383b0c9902498c058097471" alt="Pestaña Customer con clientes de QuickBooks y un menú Tread Name para emparejar cada uno con un cliente de Tread" width="2102" height="1708" data-path="images/integrations/quickbooks-customer-tab.png" />

### Pestaña Vendors

Funciona igual: empareja cada proveedor de QuickBooks en la columna **Tread Name**, o usa **+ Create Vendor**. Un [Proveedor](/es/concepts/dispatching-drivers-vendors) es una cuenta a la que envías despachos. Los emparejamientos de proveedores permiten exportar las Liquidaciones de proveedores como cuentas por pagar.

### Pestaña Items

Cada cargo de una Liquidación necesita un artículo de QuickBooks donde registrarse. Asigna cada artículo a **una** de dos opciones: un **Line Item Type** (*Freight* o *Material*) **o** un **Add On** (un recargo de combustible, por ejemplo) — una u otra, nunca ambas.

<img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-items-tab.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=127983c3de73f8da33f2480b14b6cec3" alt="Pestaña Items con artículos de QuickBooks asignados a Freight, Material y un Add On de Dump Fee" width="2102" height="1708" data-path="images/integrations/quickbooks-items-tab.png" />

### Pestaña Ledger

Marca tu cuenta de **Accounts Receivable** (usada por las facturas) y tu cuenta de **Accounts Payable** (usada por las cuentas por pagar). Se define exactamente una de cada una — las demás filas quedan deshabilitadas.

<Tip>
  ¿Agregaste registros en QuickBooks? Haz clic en **Refresh All Data** y empareja las filas nuevas.
</Tip>

<Warning>
  Desconectar borra todos los emparejamientos. Después de reconectar, deberás rehacer el emparejamiento de clientes, proveedores, artículos y ledger.
</Warning>

## Exporta Liquidaciones a QuickBooks

Las Liquidaciones de clientes se exportan como **facturas**. Las Liquidaciones de proveedores se exportan como **cuentas por pagar**.

<Steps>
  <Step title="Abre Liquidaciones">
    Ve a **Aprobaciones → Cuentas por cobrar** (o **Cuentas por pagar**) → **Liquidaciones**.
  </Step>

  <Step title="Aprueba la Liquidación">
    Las Liquidaciones pendientes no se pueden exportar — apruébalas primero.
  </Step>

  <Step title="Haz clic en Export">
    Haz clic en **Export** en la fila de la Liquidación.

    <img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-settlements-exported.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=2892843e7ceaea57132a4fc5d9b4e99d" alt="Pestaña de Liquidaciones con una Liquidación pendiente de aprobación y dos ya exportadas a contabilidad" width="2102" height="1708" data-path="images/integrations/quickbooks-settlements-exported.png" />
  </Step>

  <Step title="Confirma la exportación">
    Verifica el ID de la Liquidación, el cliente y el total en el diálogo. Una Liquidación solo se exporta una vez.

    <img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-export-dialog.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=9496668129d395849e8b98dc405f6d91" alt="Diálogo Export to Accounting System con el ID de la Liquidación, el cliente, el total y una advertencia de acción única" width="2102" height="1708" data-path="images/integrations/quickbooks-export-dialog.png" />
  </Step>

  <Step title="Observa la columna Exported">
    Se actualiza cuando QuickBooks acepta el documento.
  </Step>
</Steps>

### Cómo leer la columna Exported

| Qué ves                | Qué significa                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| **Accounting pending** | En camino a QuickBooks. Las exportaciones a Desktop quedan pendientes hasta que corra tu Web Connector. |
| **Accounting • fecha** | La factura o cuenta por pagar se creó en QuickBooks en esa fecha.                                       |
| **Accounting failed**  | Algo bloqueó la exportación — revisa las razones abajo, corrígelo y exporta de nuevo.                   |

<Note>
  El número de documento en QuickBooks es el ID de la Liquidación. Cada línea lleva los detalles de job, [Ticket](/es/concepts/tickets-timesheets), camión y [Material](/es/concepts/materials), registrados contra tus artículos emparejados.
</Note>

## Por qué falla una exportación

Casi siempre es una de estas siete razones. Corrige la causa y haz clic en **Export** de nuevo — las exportaciones fallidas se pueden reintentar.

1. **La conexión de QuickBooks aún no termina de sincronizarse con Tread.** Revisa **Configuración → Integraciones → Rutter** y busca una hora de Last Sync.
2. **La Liquidación aún no está aprobada.** Apruébala primero y luego exporta.
3. **El cliente o proveedor de la Liquidación aún no está emparejado con un cliente o proveedor de QuickBooks** (pestañas Customer / Vendors).
4. **Un tipo de cargo de la Liquidación aún no está asignado a un artículo de QuickBooks** — freight, material y cada add-on necesitan uno (pestaña Items).
5. **Tu ledger de A/R o A/P aún no está emparejado con una cuenta del plan de cuentas de QuickBooks** (pestaña Ledger).
6. **La Liquidación ya se exportó una vez.** Las exportaciones son únicas — QuickBooks nunca recibe un duplicado.
7. **Un artículo no está definido correctamente del lado de QuickBooks.** En Products and Services de QuickBooks, los artículos usados en facturas necesitan *"I sell this product/service to my customers"* marcado. Los usados en cuentas por pagar necesitan *"I purchase this product/service from a vendor"* marcado.

<img src="https://mintcdn.com/treadtechnologiesinc/7b_jhfZPinSHSrJQ/images/integrations/quickbooks-item-settings.png?fit=max&auto=format&n=7b_jhfZPinSHSrJQ&q=85&s=d4e303f4e204143946839c6fcd229e3e" alt="Configuración de un artículo de QuickBooks con las casillas de venta a clientes y compra a proveedores resaltadas" width="300" data-path="images/integrations/quickbooks-item-settings.png" />

¿Sigues atascado? Contacta a tu representante de Tread con el ID de la Liquidación y el mensaje exacto que viste.
