Requisitos previos
- Un sistema contable compatible con Agave con acceso de administrador. Confirma la compatibilidad con tu líder de implementación de Tread.
- Un usuario administrador de Tread con el permiso manage_accounting_integration.
- Clientes, proveedores y un plan de cuentas ya existentes en tu sistema contable. Tread se asocia con registros existentes — no los crea.
- Las liquidaciones que deseas exportar deben estar aprobadas en Tread. Consulta Liquidaciones y pago a conductores.
Cómo funciona
- Crear un link token — Tread solicita un token de un solo uso a Agave para la conexión.
- Autorizar a través de Agave — Se abre un modal. El cliente elige su sistema contable y aprueba el acceso.
- Importar datos maestros — Tread obtiene los clientes, proveedores, ítems (servicios, add-ons, tipos de línea) y cuentas contables del sistema conectado.
- Emparejar registros — Asocia cada cliente de Agave con una cuenta de cliente en Tread, cada proveedor de Agave con un proveedor en Tread y cada ítem de Agave con un servicio o add-on de Tread.
- Exportar liquidaciones — Las liquidaciones de cliente aprobadas se envían como facturas de AR. Las liquidaciones de proveedor se envían como cuentas por pagar de AP.
Qué fluye y hacia dónde
| Dato | Dirección | Frecuencia |
|---|---|---|
| Clientes | Agave → Tread | Al importar |
| Proveedores | Agave → Tread | Al importar |
| Ítems (servicios, add-ons) | Agave → Tread | Al importar |
| Cuentas contables | Agave → Tread | Al importar |
| Facturas de clientes (AR) | Tread → Agave | Al exportar liquidación |
| Cuentas por pagar de proveedores (AP) | Tread → Agave | Al exportar liquidación |
Configuración
Elige tu sistema contable
Selecciona tu plataforma (QuickBooks Online, Sage Intacct, NetSuite, etc.) dentro del modal de Agave y aprueba el acceso con credenciales de administrador.
Ejecuta la importación
Haz clic en Importar. Tread encola un trabajo que trae clientes, proveedores, ítems y cuentas contables. Los conjuntos de datos grandes pueden tomar varios minutos.
Empareja clientes y proveedores
Abre la página de configuración de Agave. Asocia cada cliente y proveedor importado con su contraparte en Tread.
Empareja ítems y cuentas contables
Asocia los ítems de Agave con los servicios y add-ons de Tread. Designa una cuenta contable como AR y otra como AP.
Cuándo usar Agave vs una integración directa
| Usa Agave cuando | Usa una integración directa cuando |
|---|---|
| Tu sistema contable está en la lista de Agave | Estás en Sage 300, Vista, Foundation o Spectrum |
| Quieres una conexión API en vivo | Una exportación CSV basada en archivos es suficiente |
| Gestionas múltiples backends contables | Estás atado a un solo ERP |
Limitaciones
- Una conexión con Agave por empresa de Tread. Las jerarquías padre/hijo en Tread requieren una conexión por cada hijo.
- Tread no envía las liquidaciones de conductores a través de Agave — solo las liquidaciones de clientes (AR) y proveedores (AP).
- Tread no trae a Tread las facturas creadas directamente en el sistema contable.
- Los clientes y proveedores deben existir antes en el sistema contable. Tread los asocia; no los crea.
- Una liquidación que ya se exportó no puede volver a exportarse. Crea una nueva liquidación en su lugar.
Solución de problemas
Token de cuenta expirado (401)- Ve a Configuración → Integraciones → Agave.
- Haz clic en Reconectar y vuelve a autorizar a través del modal de Agave.
- Abre la liquidación fallida.
- Encuentra la cuenta no emparejada en el error.
- Empareja en la página de configuración de Agave y haz clic en Reintentar exportación.
- El error nombra el tipo de línea o add-on (por ejemplo,
Fuel Surcharge). - Empareja con un ítem de Agave.
- Vuelve a exportar.
- En la página de configuración de Agave, define una cuenta contable como AccountsReceivable y otra como AccountsPayable.
- Vuelve a exportar.