- Central de conhecimento
- Conta e configuração
- Integrações
- Conectar o HubSpot e o QuickBooks Online
Conectar o HubSpot e o QuickBooks Online
Ultima atualização: 19 de Setembro de 2025
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
Conecte sua conta da HubSpot ao QuickBooks Online com sincronização de dados. Depois de conectar suas contas, você poderá sincronizar contatos, produtos e faturas entre os dois sistemas. Você também poderá ver os detalhes do pagamento na linha do tempo do registro do negócio. Consulte este artigo se estiver usando a integração HubSpot-QuickBooks Online herdada.
Observe: é recomendável consultar suas equipes contábeis e jurídicas sobre a adequação dessa funcionalidade para suas necessidades, antes de conectar a integração.
Para obter uma visão geral da integração do HubSpot com o QuickBooks Online, assista a este vídeo:
Antes de começar
Limitações
- Edição de faturas no QuickBooks Online: algumas edições não podem ser feitas em faturas criadas no HubSpot a partir do QuickBooks Online. As edições que não podem ser feitas são adicionar ou remover itens de linha, atualizar preços, remover um pagamento ou adicionar informações fiscais. Se a edição não for feita no HubSpot, a fatura não será sincronizada. Você pode atualizar campos de fatura, adicionar pagamentos ou créditos e adicionar datas de serviço ao item de linha em uma fatura gerada pelo HubSpot de dentro do QuickBooks Online. Finalmente, as faturas criadas no QuickBooks Online podem ser editadas dentro do QuickBooks Online.
- Cobrança de imposto: se você é um Superadministrador , você pode optar por sua conta naCobrança Automática de Imposto sobre Vendas Isso permite sincronizar dados de impostos automatizados do HubSpot com o QuickBooks Online, ao criar faturas com impostos automatizados no HubSpot.
- Contas QuickBooks Online fora dos EUA: a maioria das versões do QuickBooks Online fora dos EUA exige que as faturas sincronizadas incluam impostos (por exemplo, IVA, HST, GST, etc.). As faturas da HubSpot não podem ser criadas com impostos, portanto, usuários com contas QuickBooks Online fora dos EUA não poderão usar esse recurso.
- Reconhecimento de receita: as faturas do HubSpot não aceitam a adição de uma Data de serviço para a linha de Itens no HubSpot, o que é necessário ao usar a funcionalidade Reconhecimento de Receita do QuickBooks Online.
- Propriedade do negócio contábil: o aplicativo QuickBooks Online não grava dados no Contabilidade grupo de propriedades de negociação. É recomendado usar o objeto fatura ao criar relatórios e acionar fluxos de trabalho se você tiver este aplicativo conectado.
- Divisão de Pagamentos entre NFFs: no QuickBooks Online, um pagamento pode ser anexado a várias NFFs. No entanto, no HubSpot, o pagamentos não pode ser dividido entre faturas. Portanto, os pagamentos que têm várias faturas associadas no QuickBooks Online não serão sincronizados com o HubSpot.
Recomendações antes de usar a integração
- Desative o número de transação personalizada no QuickBooks Online: verifique se o seu número de transação personalizado está ativado. É recomendado que esta configuração seja alternada desligado. Se deixadas ativadas, as faturas criadas no QuickBooks Online adotarão automaticamente o prefixo de faturas HubSpot, que pode ser lead para números de fatura conflitantes.
- Bloquear períodos contábeis fechados: ative a configuração que bloqueia automaticamente períodos contábeis fechados no QuickBooks Online. Isso garante que quaisquer períodos contábeis encerrados estejam protegidos contra alterações.
- Sincronizar produtos: é recomendável sincronizar seus produtos do QuickBooks Online para o HubSpot e usar esses produtos ao criar faturas, cotações e links de pagamento. Isso garantirá que, quando as faturas e o pagamentos forem sincronizados com o QuickBooks Online, eles serão vinculados corretamente às contas de receita e despesa que você configurou.
Observação:
- A sincronização do produto usa a propriedade SKU para correspondência. Para evitar a duplicação de produtos, a sincronização de produtos sincroniza apenas produtos com SKUs por padrão. É recomendável adicionar SKUs aos produtos no QuickBooks Online que você gostaria de sincronizar.
- Se uma fatura tiver itens de linha que não podem ser correspondidos a um produto no QuickBooks Online, um produto chamado Item de linha Personalizado será criado no QuickBooks Online, e itens de linha sem correspondência serão correspondidos a esse produto. Você define a qual conta de receitas esse produto de item de linha personalizado será vinculado no Configurar etapa de sincronização da fatura.
- Sincronize todos os clientes: eué recomendado sincronizar todos os clientes do QuickBooks Online para o HubSpot como contatos. Ao criar uma fatura para um cliente existente, certifique-se de usar o contato sincronizado do QuickBooks Online. Isso garantirá que todas as faturas criadas estejam conectadas ao cliente certo no QuickBooks Online. Ao faturar um novo cliente, verifique se o contato na fatura é o contato de cobrança, cujo endereço de e-mail você deseja conectar ao cliente no QuickBooks Online.
- Atualizar Criar fatura paga e Criar recibo de vendas pago ações do fluxo de trabalho: se estiver usando sincronização bidirecional de faturas, é recomendável atualizar seu fluxo de trabalho para filtrar pagamentos provenientes de faturas (por exemplo, pagamentos cuja origem = fatura). Se o fluxo de trabalho não for atualizado, ocorrerá duplicação, porque os pagamentos de faturas também acionarão a criação de faturas pagas. Somente um pagamento ocorrerá, mas haverá duas faturas para o pagamento.
Conectar o aplicativo
Para conectar o aplicativo, você deve ser um Superadministrador ou ter Permissões do App Marketplace na sua conta HubSpot.
- Na sua conta HubSpot, clique no ícone do Marketplace marketplace na barra de navegação superior e selecione HubSpot Marketplace.
- Pesquise QuickBooks Online e selecione-o nos resultados.
- Insira seus detalhes de login do QuickBooks Online e clique em Instalar aplicativo.
Configurar sua sincronização com a Configuração Guiada
Ao instalar a integração do QuickBooks Online, você será redirecionado para a página Configuração Guiada . Este é um fluxo de uma página que o orienta pelas etapas para configurar sua fatura, Contato e sincronizações de produto entre o HubSpot e o QuickBooks.
Para revisar as configurações de sincronização de cada objeto:
- Clique na seta para a direita de cada sincronização de objeto para exibir as configurações de sincronização. As configurações de sincronização para cada objeto incluirão:
-
- Direção de sincronização: você pode configurar a sincronização para ser unidirecional ou bidirecional.
- Resolução de conflitos de dados: você pode selecionar qual aplicativo substituirá o outro quando não estiver claro qual aplicativo tem as informações mais atualizadas.
- Mapeamentos de campo: você pode configurar o mapeamentos de campo.
- Filtros de sincronização: você pode adicionar filtros para limitar quais registros serão sincronizados.
- Se houver erros nas configurações de sincronização que exijam sua atenção, eles serão mostrados na parte inferior de cada seção de sincronização de objeto.
- Se você deseja personalizar ainda mais suas configurações de sincronização, clique em Ir para configurações avançadas.
- Para concluir a configuração e começar a sincronizar dados, no canto superior direito, clique em Salvar e inicie a sincronização.
Definir as configurações de sincronização
Para ativar a sincronização de dados:
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- Navegar para Integrações > Aplicativos conectados na barra lateral esquerda.
- Clique em QuickBooks Online.
- Clique na guia
- Clique em Configurar sincronização.
- No Selecione os dados que você deseja sincronizar página, clique no QuickBooks on-line menu suspenso e selecione o objeto você gostaria de sincronizar com o HubSpot. O HubSpot O menu suspenso será atualizado automaticamente.
- Clique no setas de direção de sincronização e selecione um direção de sincronização. Você pode sincronizar os seguintes objetos:
HubSpot | QuickBooks Online | |
Contato | ✓ | Cliente |
Produto | ✓ | Produtos e serviços |
Fatura | ✓ | Fatura |
Observação:
- Quando uma fatura é sincronizada do QuickBooks Online para o HubSpot, a fatura será associada à empresa principal do contato na fatura. Se um contato tiver mais de uma empresa associada no HubSpot, o empresa principal será associado à fatura. Se o contato não tiver nenhuma empresa associada, nenhuma empresa estará associada à fatura. Uma vez associada uma empresa, ela pode ser atualizado manualmente.
- Quando uma fatura paga é sincronizada do HubSpot para o QuickBooks Online, as taxas de processamento associadas para o seu processador de pagamentos escolhido no HubSpot, seja Stripe ou HubSpot pagamentos , não criarão uma despesa de contabilidade no QuickBooks Online automaticamente. Para contabilizar isso, você pode criar um relatório de todas as NFFs e de todos os pagamentos recebidos e somar as Taxas de processamento e Taxas de Plataforma de processamento, e informar o valor total como uma despesa no QuickBooks Online.
- Os clientes sincronizados do HubSpot com QuickBooks Online terão o nome do registro da empresa associado definido como Nome de exibição. Se o contato não tiver uma empresa associada no HubSpot, o Nome para Exibição no QuickBooks Online usará, por padrão, as propriedades Nome e Sobrenome. Aprenda como modificar isso.
- Para faturas de sincronização bidirecional, as atualizações das propriedades mapeadas só poderão ser sincronizadas com o QuickBooks Online se a fatura tiver sido criada no HubSpot e sincronizada com o QuickBooks Online.
- Se um pagamento feito através da ACH ainda estiver sendo processado, mesmo que sua fatura tenha sido marcada como paga no HubSpot, ela só será marcada como paga no QuickBooks Online depois que o pagamento for concluído com êxito.
- No canto superior direito, clique em Próximo.
- Clique no Resolução de conflitos de dados menu suspenso e selecione se deseja Use dados do HubSpot ou Use QuickBooks on-line dados.
- No Campos mapeados seção, alterne os interruptores desligado para excluí-los da sincronização. Saiba mais sobre o mapeamento de campos de sincronização de dados.
-
- Usuários em um Iniciador de Hub de Dados, Professional ou EnterpriseEnterprise podem adicionar mais campos clicando em Adicionar a mapeamento abaixo dos campos predefinidos.
- Selecione os Campos nos menus suspensos e clique em Criar ou clique em delete excluir para remover o mapeamento.
- Para editar ou remover um mapeamento adicionado, clique em Ações , então clique Editar ou Excluir.
- Usuários em um Iniciador de Hub de Dados, Professional ou EnterpriseEnterprise podem adicionar mais campos clicando em Adicionar a mapeamento abaixo dos campos predefinidos.
Observação:
- Para que um campo personalizado do QuickBooks Online esteja disponível para o HubSpot criar mapeamentos de campos de fatura personalizados, no QuickBooks Online, o tipo de campo personalizado deve ser Texto e Número, na categoria Transação, ser Imprimir Ativado e estar ativado para todos os Formulários de Vendas, o que inclui faturas, estimativas e recebimentos de vendas.
- Depois que um mapeamento de campo personalizado for configurado e a sincronização estiver ativada, as faturas correspondentes, Incluindo faturas históricas serão sincronizadas.
- Somente os três primeiros campos personalizados da fatura criados no QuickBooks Online estão visíveis. Veja o Documentação da API do QuickBooks para maiores informações.
- No canto superior direito, clique em Próximo.
- Na tela Limite , os filtros recomendados serão automaticamente definidos para você, com base na data em que você estiver configurando a sincronização. Os filtros são configurados para diminuir a "sincronização excessiva" de dados, principalmente ao sincronizar do HubSpot com QuickBooks Online. Revise o HubSpot filtros de sincronização recomendados.
- Os filtros de sincronização (exceto sincronização de faturas de saída) podem ser editados. Para editar os filtros de sincronização:
-
- Sob Filtros, clique Editar ao lado do filtro de sincronização.
-
- Selecione seu propriedades e critérios de filtro.
- Clique Aplicar critérios , então clique Feito.
Uma vez ativada a sincronização, os dados serão sincronizados automaticamente entre os dois sistemas. Após a conclusão da primeira sincronização, os registros serão sincronizados em intervalos regulares. Os dados também podem ser sincronizados sob demanda através do botão Sincronizar agora na guia Visão geral da sincronização.
Filtros de sincronização recomendados
Ao configurar uma sincronização, os filtros recomendados serão configurados automaticamente para você, com base na data em que você estiver configurando a sincronização. Os filtros são configurados para diminuir a "sincronização excessiva" de dados, principalmente ao sincronizar do HubSpot com QuickBooks Online. Eles podem ser editados se necessário
Os filtros recomendados que são definidos automaticamente são:
- Contatos: sincronização bidirecional com os seguintes filtros para evitar que contatos desnecessários sejam sincronizados do HubSpot para QuickBooks Online:
- QuickBooks on-line → HubSpot: filtro está configurado para Todos clientes.
- HubSpot → QuickBooks on-line: no primeiro grupo de filtros, os filtros O status da fatura não é Rascunho e A data de criação é posterior a [data de hoje] e A origem da fatura é qualquer uma HubSpot estão prontos.
- Faturas: sem a definição de um filtro, todas as faturas serão sincronizadas entre QuickBooks Online e o HubSpot será sincronizado. Este filtro configura uma sincronização unidirecional do QuickBooks Online para o HubSpot com O horário de criação é depois de [data de hoje às 12h] filtro. A data é definida como o dia atual.
- Produtos: sincronização unidirecional do QuickBooks Online para o HubSpot com o padrão Todos os & serviços de produtos conjunto de filtros.
Defina o nome de exibição nos clientes
Os clientes sincronizados do HubSpot com QuickBooks Online terão o nome do registro da empresa associado definido como Nome de exibição. Se o contato não tiver uma empresa associada no HubSpot, o Nome para Exibição no QuickBooks Online usará, por padrão, as propriedades de nome e sobrenome.
Para modificar isso:
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- Navegar para Integrações > Aplicativos conectados na barra lateral esquerda.
- Clique em QuickBooks Online.
- Clique na guia
- Clique Sincronização de contatos.
- Na tela Configurar , na seção Campos mapeados, clique para alternar a opção Gerenciar nome de exibição ← Nome da empresa associada mapeamento de campo desativada.


Observe: Os campos de nome de 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 seu nome de exibição já está em uso. Recomenda-se usar um contato em uma empresa como contato de cobrança para quaisquer faturas ou pagamentos para evitar erros de sincronização. Faturas, links de pagamentos ou cotações podem ser enviados para qualquer número de contatos, mas apenas um contato (correspondente ao cliente no QuickBooks Online) deve ser formalmente associado.
Editar sincronização de dados
Para editar uma sincronização de dados existente:
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- Navegar para Integrações > Aplicativos conectados na barra lateral esquerda.
- Clique em QuickBooks Online.
- Clique na guia
- Pairar sobre Sincronização de contatos, Sincronização de produto, ou Sincronização de fatura e clique Editar.
- Faça suas alterações seguindo as etapas como se estivesse configurando a sincronização pela primeira vez.
Revise os status de sincronização
Para revisar uma lista de registros e seu status de sincronização:
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- Navegar para Integrações > Aplicativos conectados na barra lateral esquerda.
- Clique em QuickBooks Online.
- Clique na guia
-
- Clique em Exibição de Objeto para ver o número de registros que estão sendo sincronizados, falhando ou excluídos. Para editar as colunas exibidas na tabela, no canto superior direito da tabela, clique em Mais , então clique Editar colunas.
- Clique Todos os objetos ao lado de Filtrar por: para filtrar por objeto.
- Clique na contagem de registros em cada coluna para ver mais informações sobre os registros que estão sendo sincronizados, falhando ou excluídos.
- Clique em Exibição de Objeto para ver o número de registros que estão sendo sincronizados, falhando ou excluídos. Para editar as colunas exibidas na tabela, no canto superior direito da tabela, clique em Mais , então clique Editar colunas.
-
- Clique Visualização de registro para visualizar uma lista de registros.
- Para editar as colunas exibidas na tabela, no canto superior direito da tabela, clique em Mais , então clique Editar colunas.
- Use o filtros acima da tabela para filtrar os registros.
- Use o navegação na página na parte inferior da tabela para navegar pelos registros.
- Sob Sincronizar atividade , Clique no seta para ver mais informações sobre a atividade em um registro.
- Clique Visualização de registro para visualizar uma lista de registros.
Exportar registros de sincronização
Para exportar registros de sincronização:
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- Navegar para Integrações > Aplicativos conectados na barra lateral esquerda.
- Clique QuickBooks on-line.
- Clique na guia
- Clique Visualização de registro.
- Para editar as colunas exibidas na tabela, no canto superior direito da tabela, clique em Mais , então clique Editar colunas.
- Use o filtros acima da tabela para filtrar os registros.
- Quando você tiver filtrado os registros, na parte superior direita da tabela, clique em Mais e em Exportar.
- Selecione seu formato de arquivo , então clique Exportar.
- O arquivo de exportação será enviado para o e-mail da sua conta. Você também receberá uma notificação no aplicativo quando a exportação estiver pronta.
Desative ou exclua a sincronização de dados
- Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
- Navegar para Integrações > Aplicativos conectados na barra lateral esquerda.
- Clique em QuickBooks Online.
- Clique na guia
- Passe o mouse sobre a sincronização de objetos que você deseja desativar e clique em Mais e selecione Desativar sincronização.
- Isso impedirá que os registros sejam sincronizados entre o HubSpot e o QuickBooks Online. Depois que a sincronização estiver desativada, você pode clicar Editar configurações de sincronização para ligá-lo novamente.
- Clique Excluir sincronização para excluir a sincronização.