QuickBooks Online

SettleWise soporta una integracion enfocada con QuickBooks Online para flujos financieros operativos. Ayuda a mantener alineados entre sistemas los clientes, productos, facturas, pagos, documentos de credito compatibles y datos de registros / cuentas. No es un reemplazo completo para todos los flujos contables de QuickBooks.

Descripcion General

SettleWise se sincroniza automaticamente con QuickBooks Online para mantener actualizados los datos operativos compatibles. Una vez conectados, las entidades compatibles fluyen entre ambos sistemas sin exportaciones manuales ni doble carga.

Soporte Actual

Area	Estado	Detalles
Clientes	Soportado en core	Los cambios compatibles de clientes se sincronizan entre sistemas.
Productos / items	Soportado en core	Los productos y servicios compatibles se sincronizan como Items de QuickBooks.
Facturas	Soportado en core	La creacion y actualizacion de facturas compatibles se sincroniza con protecciones segun el sistema de origen.
Pagos	Soportado en core	El posting de pagos y las actualizaciones de pagos entrantes compatibles se sincronizan entre sistemas.
Notas de credito / reembolsos	Soportado en core	Se sincronizan las notas de credito y los refund receipts compatibles. Transfer Credit entre clientes no se sincroniza con QuickBooks.
Registros / plan de cuentas	Soportado en core	Las cuentas de QuickBooks pueden sincronizarse hacia los registros de SettleWise, y cierta actividad relacionada puede reflejarse en SettleWise.
Sincronizacion de payouts / gastos de proveedores	Soporte acotado	Disponible solo en flujos especificos como el add-on de Payouts. No forma parte de la promesa core de QuickBooks.
QuickBooks Desktop	No soportado	SettleWise soporta solo QuickBooks Online.
Reemplazo completo de QuickBooks	No soportado	Payroll, cuentas por pagar / bills, impuestos, cierres, contabilidad mas amplia y una migracion self-serve para dejar QuickBooks estan fuera de alcance hoy.

Los registros originados en QuickBooks siguen siendo sensibles al sistema de origen. Algunas acciones de edicion o eliminacion sobre registros originados en QB todavia deben resolverse en QuickBooks.

Configuracion

Consulta Conexion con QuickBooks para el recorrido completo de configuracion OAuth con la guia en video.

Importante: en QuickBooks, manten desactivada la opcion Automatically apply credits en Configuracion -> Cuenta y configuracion -> Avanzado -> Automatizacion. Si QuickBooks aplica creditos automaticamente, la sincronizacion de creditos de SettleWise puede desalinearse.

Transfer Credit entre clientes es un ajuste solo de SettleWise. No crea un CreditMemo en QuickBooks ni mueve credito entre clientes de QuickBooks.

Mapeo de Campos

SettleWise mapea sus datos a los campos de QuickBooks de la siguiente manera:

Campo de SettleWise	Campo de QuickBooks
Nombre del Cliente	Customer Display Name
Correo del Cliente	Primary Email
Numero de Factura	Doc Number
Monto de la Factura	Total Amount
Fecha de Vencimiento de la Factura	Due Date
Monto del Pago	Payment Amount
Metodo de Pago	Payment Method Ref
Fecha del Pago	Txn Date
Monto de la Nota de Credito	Credit Memo Total

Comportamiento de la Sincronizacion

Asincrona y orientada a eventos: La mayoria de los cambios compatibles se sincroniza automaticamente despues de la accion que los dispara
Normalmente rapida: Muchas sincronizaciones terminan en segundos, pero las sincronizaciones iniciales o completas pueden tardar mas
No bloqueante: El trabajo en SettleWise suele completarse aunque QuickBooks este temporalmente no disponible
Con reintentos: Muchos fallos transitorios se reintentan automaticamente, pero los errores persistentes de conexion, validacion o mapeo siguen necesitando accion manual
Idempotente: Re-sincronizar los mismos datos no deberia crear duplicados

No todas las funciones de QuickBooks se sincronizan. Usa la tabla de Soporte Actual de esta pagina como limite de lo que SettleWise soporta hoy.

Solucion de Problemas

Conexion Expirada

Los tokens OAuth de QuickBooks expiran periodicamente. Si la sincronizacion deja de funcionar:

Ve a Ajustes → Integraciones → QuickBooks
Haz clic en Reconectar para re-autorizar
Sigue el flujo de inicio de sesion de QuickBooks
La sincronizacion compatible se reanuda una vez reconectado

Clientes Duplicados

Si un cliente existe en ambos sistemas antes de conectar, SettleWise intenta emparejar por nombre y correo electronico. Los duplicados sin emparejar pueden necesitar fusion manual:

Identifica el duplicado en el historial de sincronizacion
Fusiona los clientes en QuickBooks
Re-sincroniza para actualizar el mapeo

Errores de Sincronizacion

Errores comunes de sincronizacion y soluciones:

Error	Causa	Solucion
Autorizacion expirada	Token OAuth expirado	Reconecta QuickBooks en Configuracion
Nombre duplicado	El nombre del cliente ya existe en QB	Fusiona o renombra el cliente
Cuenta invalida	Cuenta mapeada eliminada en QB	Actualiza el mapeo de cuentas en Configuracion
Limite de solicitudes	Demasiadas llamadas a la API	Espera y deja que terminen los reintentos automaticos; si persiste, vuelve a intentar cuando la conexion se estabilice

Resolucion de Conflictos de Sincronizacion

Cuando el mismo cliente se actualiza en ambos sistemas simultaneamente:

Gana la ultima escritura para campos simples (nombre, correo electronico, telefono)
Aplica la propiedad segun el sistema de origen para los registros operativos compatibles creados en SettleWise vs QuickBooks
QuickBooks sigue siendo la fuente de verdad para el plan de cuentas, configuraciones fiscales y configuracion contable exclusiva de QB

Proveedor en la moneda equivocada

Cuando un egreso se paga desde una caja que no está en USD (por ejemplo, ARS) a un proveedor que todavía no existe en QuickBooks, QuickBooks crea los proveedores nuevos en USD. SettleWise desactiva ese proveedor con la moneda equivocada y la sincronización del egreso muestra un error que te pide actuar. Para resolverlo:

En QuickBooks, agrega el proveedor con el mismo nombre y la moneda de la caja.
En SettleWise, reintenta la sincronización del egreso.