Cada tenant TradelyHQ conecta su PROPIA cuenta de QuickBooks Online vía OAuth. Nosotros nunca vemos sus datos de QBO; usted nunca ve los de otro tenant. La conexión es por tenant, limitada y revocable.
Conectando QuickBooks
- Abra Configuración → Integraciones en su portal de administración
- Haga clic en Conectar QuickBooks
- Será redirigido al flujo de OAuth de Intuit — inicie sesión con sus credenciales de administrador de QBO
- Apruebe la conexión. Intuit lo redirige de regreso a TradelyHQ
- Está conectado. Los tokens están encriptados en reposo en
tenant_provider_keys
Lo que se sincroniza automáticamente
- Envío de facturas: al hacer clic en "Autorizar y enviar" en una factura en TradelyHQ, se crea inmediatamente en QBO
- Estado de pagos: los webhooks de QBO devuelven cuando se registra un pago; TradelyHQ cambia automáticamente el estado a "pagado"
- Espejo de clientes: la primera vez que envía una factura para un cliente, ese cliente se replica como un registro Customer de QBO
- Espejo de items: las líneas se replican como QBO Items la primera vez que aparecen en una factura
La reconciliación nocturna
A las 2 AM hora local de su tenant, un cron job recorre cada factura y verifica que la vista de QBO coincida con la de TradelyHQ. Si algo se desvió (alguien editó manualmente la factura en QBO, hubo un hipo de red durante el envío original, etc.), la discrepancia aparece en el panel de Errores de Sincronización para que un administrador la revise.
Lo que NO es bidireccional
Hoy, solo las facturas se sincronizan de TradelyHQ → QBO. No traemos clientes, items o plan de cuentas de QBO a TradelyHQ. Dos razones:
- Los nombres de cliente/item se traslapan de forma incómoda con nuestros conceptos de cliente/OT
- Generalmente quiere a TradelyHQ como sistema-de-registro para trabajos y flujo de facturación; QBO como sistema-de-registro para el libro mayor
Desconectar
Mismo panel de Configuración → Integraciones. Los tokens son revocados del lado de Intuit Y eliminados de tenant_provider_keys. Las facturas existentes ya enviadas se quedan en QBO sin cambios.
Si algo se ve mal
El panel Errores de Sincronización muestra cada factura donde TradelyHQ y QBO no coinciden. Causas más comunes: (1) editó manualmente una factura en QBO, (2) su suscripción de QBO caducó y el token OAuth fue revocado, (3) un error de red transitorio. Haga clic en el error para una opción de re-sincronización.
Si su token de conexión a QBO expira o es revocado, verá un banner "Reconectar QuickBooks" en la parte superior del panel de Errores de Sincronización. Rehacer el flujo OAuth restaura la conexión sin tocar las facturas existentes.