Contabilidade

Visão geral

Canais e integrações → Contabilidade (/pt/integrations/accounting) conecta seu sistema de contabilidade para que os pedidos pagos se tornem faturas.

• Xero e QuickBooks Online — faça login com sua conta Xero ou Intuit. O OrderInChat cria contatos e faturas pelas APIs oficiais do Xero e do QuickBooks.
• Zoho Books — se conecta pelo Zoho MCP. Copie sua Server URL em Zoho MCP (seu servidor → Connect). O OrderInChat não hospeda essa URL.

Se um cartão indicar que o fornecedor ainda não está configurado no OrderInChat, a equipe do OrderInChat ainda não o ativou para a plataforma. Entre em contato com o suporte.

Conectar

1. Abra Canais e integrações → Contabilidade.
2. Para o Xero ou o QuickBooks, clique em Conectar com OAuth, faça login e aprove o acesso. Se você aprovar mais de uma organização Xero, escolha a que recebe as faturas em Organização Xero.
3. Para o Zoho Books, abra Zoho MCP, escolha seu servidor, abra Connect e copie a Server URL. Ela é exclusiva desse servidor e tem o formato https://….zohomcp.com/mcp/…/message. Outros centros de dados usam mcp.zoho.eu, mcp.zoho.in, mcp.zoho.com.au ou mcp.zoho.jp. Cole a URL, salve e clique em Conectar com OAuth. Trate a URL como uma senha.
4. Defina as opções de fatura e clique em Salvar configurações da fatura:
   • Xero: status da fatura (Rascunho ou Aprovado) e o código da conta de vendas — o código do plano de contas em cada linha da fatura (geralmente 200). Ele já precisa existir nessa organização Xero. Se você deixar em branco, o OrderInChat envia 200.
   • QuickBooks: Produto/serviço para as linhas da fatura — cada linha usa este produto ou serviço. Deixe em branco para usar "Sales"; se não existir, o OrderInChat o cria como serviço na sua conta de receitas. O QuickBooks Online não tem faturas em rascunho.
   • Zoho Books: status da fatura e ID da organização (Zoho Books → Settings → Organization Profile).
5. Ative Ativo e, se quiser, Criar fatura quando o pedido for pago.
6. Clique em Testar. No Xero e no QuickBooks, a mensagem mostra o nome da organização ou empresa conectada.

Use Desconectar para remover a conexão. No Xero e no QuickBooks, isso também revoga o acesso do OrderInChat no seu sistema de contabilidade.

Sincronização de pedidos pagos

Com a sincronização automática ativa, cada pedido pago cria uma única fatura no seu sistema de contabilidade:

• Cliente: associado pelo e-mail e depois pelo nome; criado quando não há correspondência.
• Linhas: produtos, envio, impostos e descontos são linhas separadas, para que o total da fatura seja igual ao total do pedido. Não é acrescentado imposto adicional. No QuickBooks, os descontos aparecem em uma única linha de desconto.
• Referência: no Xero, a referência da fatura é o número do pedido. No QuickBooks, o número do pedido passa a ser o número da fatura quando os números de transação personalizados estão ativos, e sempre aparece na observação da fatura.
• Nunca duas vezes: um pedido nunca recebe uma segunda fatura. Uma nova tentativa encontra a fatura existente e a reutiliza.
• Moeda: a moeda do pedido precisa ser a da organização, ou o recurso multimoeda precisa estar ativo no seu sistema de contabilidade.
• Quando é executado: os pagamentos com cartão e os pagamentos que você confirma no próprio pedido (transferência, dinheiro) criam a fatura. A sincronização automática fica ativa na primeira conexão; desative-a para parar de criar faturas.
• Zoho Books: no seu servidor Zoho MCP, ative list_contacts, create_contact, create_invoice, list_invoices (necessário para que um pedido nunca seja faturado duas vezes) e mark_invoice_sent, e ainda list_currencies para pedidos em outras moedas. Um cliente já faturado em outra moeda recebe um segundo contato chamado "Nome (EUR)".
• O QuickBooks Online está disponível: as empresas reais do QuickBooks podem se conectar. Somente se o cartão do QuickBooks mostrar um selo Sandbox, a plataforma está no ambiente de teste da Intuit, onde só empresas sandbox da Intuit podem se conectar.
• Conexão sempre ativa: o OrderInChat renova a conexão pelo menos a cada 20 dias, para que não expire sem pedidos. Se o QuickBooks ou o Xero deixar de aceitar a autorização (expirada ou revogada), o cartão mostra Reconexão necessária e o botão muda para Reconectar; ao reconectar, o aviso desaparece. Uma falha temporária do fornecedor não pede nova conexão: a renovação e a fatura são repetidas automaticamente.

Os problemas aparecem em Trabalhos de sincronização de faturas com a mensagem do próprio sistema de contabilidade (por exemplo, um código de conta desconhecido). Corrija a causa e clique em Tentar novamente. A nova tentativa é executada imediatamente e mostra o resultado; cada tarefa tem um link para o pedido correspondente.