A conexão com o QuickBooks Online é feita pelo login da Intuit: você é direcionado à tela da Intuit, escolhe a empresa que quer conectar, autoriza o acesso e volta à Toca. Nenhuma chave é digitada à mão.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- A integração é com o QuickBooks Online, e vale também para o Intuit Enterprise Suite, que usa a mesma base. O QuickBooks Desktop não conecta.
- Entre com um usuário que tenha acesso à empresa e permissão para autorizar aplicativos nela.
- Se você tem mais de uma empresa no QuickBooks, saiba qual vai conectar: a Toca conecta uma empresa por vez.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card QuickBooks e clique em Conectar.
- Na tela da Intuit, entre com a sua conta e escolha a empresa que quer conectar.
- Autorize o acesso. De volta à Toca, o card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê faturas, recebimentos, recibos de venda e notas de crédito, contas a pagar, despesas e pedidos de compra, clientes, fornecedores, itens e estoque, o plano de contas, os lançamentos e os relatórios financeiros (resultado, balanço, fluxo de caixa e contas a receber e a pagar por vencimento).
A Toca também altera: cria e altera lançamentos (faturas, recebimentos, despesas, contas a pagar, lançamentos contábeis), exclui e anula documentos, cria e altera cadastros (clientes, fornecedores, itens, contas), envia documentos por e-mail ao cliente e ajusta dados e preferências da empresa. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat. Excluir e anular não têm volta no QuickBooks: o documento anulado fica zerado.
Ficam de fora o QuickBooks Payments (cobrança no cartão do cliente) e o envio de arquivos para anexo.
Manutenção da conexão
A Toca renova a autorização automaticamente. Se a renovação for recusada — por exemplo, quando o acesso é revogado na Intuit ou a conexão fica tempo demais sem uso —, a Toca avisa no chat que é preciso reconectar. Para isso, use Excluir integração no menu ⋯ do card e conecte de novo. Para os prazos de validade da autorização, confirme na documentação oficial da Intuit.
Problemas comuns
- Conectou a empresa errada — use Excluir integração no menu ⋯ do card e conecte de novo, escolhendo a empresa certa na tela da Intuit.
- Valores em outra moeda — o QuickBooks guarda os valores na moeda da empresa, que nem sempre é o real. Em empresa com várias moedas, cada documento traz a própria moeda e o câmbio.
- Consultas esbarram em limite — a Intuit aceita até 500 chamadas por minuto e 10 por segundo para cada empresa. Quando o limite estoura, é preciso esperar cerca de um minuto antes de tentar de novo.
- Alteração recusada depois da aprovação — o QuickBooks só aceita alterar a versão mais recente do documento. Se alguém editou o documento no meio do caminho, peça para a Toca ler de novo e refazer a proposta.