Cada tenant TradelyHQ conecta sua PRÓPRIA conta QuickBooks Online via OAuth. Nós nunca vemos seus dados do QBO; você nunca vê os de outro tenant. A conexão é por tenant, escopada e revogável.
Conectando o QuickBooks
- Abra Configurações → Integrações no portal de administração
- Clique em Conectar QuickBooks
- Você será redirecionado para o fluxo OAuth da Intuit — faça login com suas credenciais de administrador QBO
- Aprove a conexão. A Intuit redireciona você de volta ao TradelyHQ
- Você está conectado. Os tokens ficam criptografados em repouso em
tenant_provider_keys
O que sincroniza automaticamente
- Envio de faturas: ao clicar em "Autorizar e Enviar" numa fatura no TradelyHQ, ela é criada no QBO imediatamente
- Status de pagamento: webhooks do QBO retornam quando um pagamento é registrado; o TradelyHQ muda o status para "pago" automaticamente
- Espelho de clientes: na primeira vez que você envia uma fatura para um cliente, esse cliente é espelhado como um registro Customer no QBO
- Espelho de itens: linhas de item são espelhadas como QBO Items na primeira vez que aparecem em uma fatura
A reconciliação noturna
Às 2h da manhã no fuso do seu tenant, um cron job percorre cada fatura e verifica se a visão do QBO bate com a do TradelyHQ. Se algo divergiu (alguém editou manualmente a fatura no QBO, soluço de rede no envio original, etc.), a discrepância vai para o painel Erros de Sincronização para um administrador revisar.
O que NÃO é bidirecional
Hoje, só faturas sincronizam do TradelyHQ → QBO. Não puxamos clientes, itens ou plano de contas do QBO para o TradelyHQ. Dois motivos:
- Nomes de Customer/Item se sobrepõem de forma desajeitada com nossos conceitos de cliente/OS
- Geralmente você quer o TradelyHQ como sistema-de-registro para serviços e fluxo de faturamento; o QBO como sistema-de-registro para o livro razão
Desconectando
Mesmo painel Configurações → Integrações. Os tokens são revogados no lado da Intuit E apagados de tenant_provider_keys. Faturas existentes já enviadas permanecem no QBO sem alteração.
Se algo parecer errado
O painel Erros de Sincronização mostra cada fatura onde TradelyHQ e QBO discordam. Causas mais comuns: (1) você editou manualmente uma fatura no QBO, (2) sua assinatura do QBO venceu e o token OAuth foi revogado, (3) um erro de rede transitório. Clique no erro para uma opção de re-sincronização.
Se seu token de conexão com o QBO expirar ou for revogado, você verá uma faixa "Reconectar QuickBooks" no topo do painel Erros de Sincronização. Refazer o fluxo OAuth restaura a conexão sem mexer em faturas existentes.