Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Solucionar problemas de integração de sincronização de dados do QuickBooks Online

Ultima atualização: 10 de Setembro de 2025

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Revise os possíveis motivos pelos quais os registros não estão sincronizando entre HubSpot e QuickBooks. 

Erros comuns

Se você não estiver vendo a sincronização da sua fatura com o QuickBooks Online dentro de alguns minutos, há vários motivos pelos quais a sincronização pode falhar.

  • Se alguma fatura não for sincronizada, um banner será exibido no topo da página de índice de faturas. Clicar em Detalhes da falha de sincronização abrirá o painel Falha na sincronização nas configurações de integração do menuQuickBooks.
  • Você também pode verificar se a sincronização da fatura foi bem-sucedida verificando o Placa de sincronização de integrações no painel de visualização de fatura.

Captura de tela mostrando o cartão de sincronização de integrações em um registro de fatura no HubSpot.

Captura de tela mostrando a contagem de faturas com falha na página de sincronização de QBO no HubSpot.

Abaixo estão alguns erros comuns que você pode encontrar e como resolvê-los.

Uma fatura deve ter um cliente associado. Certifique-se de que o cliente associado esteja presente no HubSpot e no QuickBooks Online para sincronizar esta fatura

Este erro ocorre porque o contato na fatura não foi encontrado no QuickBooks Online quando a fatura tentou sincronizar. Na maioria das vezes, isso ocorre porque o contato na fatura não compartilha o endereço de e-mail do cliente no QuickBooks. Se você alterar o contato na fatura no HubSpot para o contato que corresponde ao e-mail do cliente no QuickBooks, a fatura será sincronizada.

O nome de exibição é uma duplicata

Os campos Nome para Exibição devem ser exclusivos no QuickBooks Online. O primeiro contato de uma empresa terá seu Nome de exibição definido como o nome da empresa, mas todos os contatos dessa empresa que tentarem sincronizar com QuickBooks Online após o primeiro contato não conseguirão sincronizar, porque seus Nome de exibição já está em uso. Saiba mais sobre como definir o nome para exibição nos clientes.

Erro de validação comercial: insira uma data de serviço para o item de linha de reconhecimento de receita

Este erro poderá ocorrer se você estiver usando a funcionalidade de Reconhecimento de Receita do QuickBooks Online. O reconhecimento de receita exige que todos os itens de linha de uma fatura tenham uma data de serviço. Não é possível adicionar uma data de serviço aos itens de linha HubSpot. É recomendável desativar a configuração de reconhecimento de receita no QuickBooks e gerar relatórios de reconhecimento de receita separadamente. 

Modificações de itens de linha ou valores de faturas em faturas nativas da HubSpot não podem ser feitas por meio de aplicativos externos. Faça as alterações necessárias diretamente no HubSpot

Este erro ocorre porque uma fatura criada no HubSpot foi alterada no QuickBooks Online. Reverta as alterações na fatura no QuickBooks e faça esses ajustes na fatura no HubSpot para continuar a sincronização.

Erro de número de documento duplicado: você deve especificar um número diferente. Este número já foi usado

Esse erro ocorre quando a integração tenta enviar uma fatura para o QuickBooks Online com um número de fatura que já está sendo usado por outra fatura ou aviso de crédito no QuickBooks. Na maioria das vezes, isso ocorre porque você tem a configuração Número de transação personalizado ativada, o que faz com que o QuickBooks adote o prefixo e o número do HubSpot automaticamente. Para corrigir esse erro, é recomendável atualizar os números nas faturas ou nos avisos de crédito no QuickBooks Online para permitir que as faturas do HubSpot sejam sincronizadas com o QuickBooks e, em seguida, desativar a configuração Números de Transação Personalizados.

Modificações de item de linha ou valor da fatura em faturas nativas da HubSpot não podem ser feitas por meio de aplicativos externos. Faça as alterações necessárias diretamente no HubSpot

Esse erro mostra que uma fatura criada no HubSpot e sincronizada com o QuickBooks Online teve informações financeiras (por exemplo, itens de linha, imposto) adicionadas, removidas ou modificadas no QuickBooks. Essas alterações não podem ser sincronizadas novamente no HubSpot, portanto, a sincronização da fatura está falhando. Para corrigir o erro, reverta as alterações no QuickBooks. Se você precisar modificar os detalhes financeiros de uma fatura do HubSpot, é recomendável fazer essa alteração no HubSpot e, em seguida, permitir que ele seja sincronizado com o QuickBooks.

Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.