⚙
Conectar mis cuentas
Aquí enlazas las cuentas del banco para que los saldos y movimientos se actualicen automáticamente, sin tener que escribir nada a mano. Nunca vemos tu contraseña — el banco te pide que confirmes el acceso directamente con ellos.
⚙
Conectar QuickBooks
QuickBooks ya tiene clasificadas las categorías del negocio (renta, software, comidas, payroll, etc.). Al conectarlo, el sistema lee directamente esas categorías y el P&L mensual del negocio — no hay que volver a categorizar nada a mano.
→
Cuentas conectadas
⚒
Detalles técnicos · sólo operador
Esta sección sólo la ve Luisinho. El resto de la familia no la ve para no llenar la pantalla de jerga.
Plaid (bancos · raw transactions).
Plaid manda webhooks cada vez que hay transacciones nuevas o cambios en saldos. La función
plaid-webhook verifica la firma criptográfica (ES256), trae los datos via
/transactions/sync, e inserta filas en transactions. Los saldos en
accounts se actualizan al mismo tiempo. La columna plaid_account_id es el puente —
cualquier cuenta con ese valor seteado recibe los updates, sea una fila auto-creada o una cuenta
manual vinculada.
QuickBooks (negocio · categorized data).
Flujo OAuth 2.0 vía Intuit. quickbooks-oauth-start mina un state token en
oauth_states, devuelve la URL de autorización; el navegador se redirige a Intuit;
Intuit regresa con code + realmId a quickbooks-oauth-callback; ese intercambia
por access + refresh tokens (HTTP Basic con client_id:client_secret), guarda ambos en Vault
(QUICKBOOKS_ACCESS_TOKEN_<realm> + QUICKBOOKS_REFRESH_TOKEN_<realm>),
e inserta integrations row. quickbooks-sync hace el refresh-token dance cuando expiran
(access ~1h, refresh ~100 días) y jala /companyinfo de Intuit. Próximo paso (filed como
L follow-up): P&L mensual + mapeo de cuentas QB → cubetas Mocker.