Automação

Integração com QuickBooks: como conectar o QuickBooks ao seu CRM e a outros sistemas

Uma calculadora, um par de óculos e uma pilha de pastas de documentos sobre uma mesa branca Digite uma vez, use em todo lugar.

Uma integração com QuickBooks conecta o QuickBooks a outro sistema para que clientes, faturas e pagamentos circulem entre eles sem que ninguém precise digitá-los de novo. Você tem três caminhos: um app do marketplace de apps da Intuit, uma ferramenta no-code como Zapier ou Make, ou um desenvolvimento sob medida na QuickBooks Online Accounting API. O caminho certo depende do seu volume, de quantos registros precisam ser correspondidos entre os sistemas e de você precisar ou não de sincronização nos dois sentidos.

Olhe o marketplace primeiro. A Intuit diz que o QuickBooks se conecta a mais de 800 apps empresariais populares, e um app listado que move os registros certos na direção certa costuma ser o caminho mais barato e mais rápido. Um desenvolvimento sob medida compensa o custo quando a lógica envolve vários sistemas, o volume é alto ou nada do que está listado se encaixa no seu jeito de trabalhar. Conosco, conectar dois sistemas começa em R$ 35.000, com preço fechado e acordado antes do início do trabalho.

Este guia trata do que conectar ao QuickBooks, de como escolher um caminho, do que envolve e quanto custa um desenvolvimento na API, dos limites e das taxas definidos pela Intuit e dos problemas que pegam as equipes de surpresa. É um guia neutro entre comprar e desenvolver, então ele vai dizer quando um conector pronto é a melhor resposta.

Ao que você pode conectar o QuickBooks?

O QuickBooks é a ponta financeira do stack, então a pergunta útil é qual sistema gera os eventos financeiros. Muitos CRMs e plataformas de e-commerce oferecem algum tipo de conector, então procure uma listagem antes de planejar um desenvolvimento. A tabela mostra os candidatos mais comuns.

Tipo de sistemaExemplosFluxo de dados típico
CRMHubSpot, SalesforceClientes e negócios ganhos entram no QuickBooks como faturas; o status do pagamento volta
E-commerceShopifyPedidos e repasses entram no QuickBooks
PagamentosProcessadores de cartão, links de pagamentoPagamentos conciliados com faturas em aberto
Serviços de campo e gestão de trabalhosFerramentas de trabalhos, agendamento e controle de horasTrabalhos concluídos ou horas aprovadas viram faturas
Sua própria plataformaPortal do cliente, sistema internoO que o seu modelo de dados gerar, desenvolvido sobre a API

Para e-commerce, a Intuit lista o Shopify Connector by QuickBooks entre as suas integrações, então essa é a primeira coisa a testar se você vende no Shopify. Para um CRM, o primeiro fluxo costuma ser um negócio ganho gerando uma fatura, com o status do pagamento voltando para que a equipe de vendas veja quem já pagou.

Uma plataforma sob medida é diferente. Nada no marketplace conhece o seu modelo de dados, então o lado do QuickBooks é desenvolvido sobre a API. Para um grupo internacional de eventos, conectamos Pipedrive, SmartDocs e Xero sem substituir nenhum deles. Quando um contrato é assinado, o CRM é atualizado e a fatura de venda é emitida automaticamente. Esse projeto usou o Xero, não o QuickBooks, e o mesmo padrão de contrato assinado que vira fatura vale para os dois.

Se o seu problema são contas de fornecedores chegando ao QuickBooks, isso é um problema de captura antes de ser um problema de integração, e nosso guia de automação de contas a pagar compara as ferramentas. Nosso guia de integração de APIs trata da mecânica geral de conectar quaisquer dois sistemas, e nosso guia de integração de ERP trata de parques de sistemas maiores.

App do marketplace, Zapier/Make ou desenvolvimento sob medida na API?

O caminho mais barato que resolve costuma ser o certo. Percorra a tabela em ordem e pare na primeira linha que se encaixa.

CaminhoVence quandoAtenção a
App do marketplaceO seu CRM ou plataforma de e-commerce tem uma listagem que move os registros de que você precisaEle sincroniza o que o fabricante escolheu, na direção que ele escolheu
Zapier ou MakeOs dois lados têm conectores e a lógica é um gatilho e uma ação simplesCobrança por uso, e um fluxo que vira crítico sem ninguém perceber
Desenvolvimento sob medida na APIA lógica envolve vários sistemas, os volumes são altos ou nada listado se encaixaExige um desenvolvimento de verdade e alguém para cuidar dele

Pesquise no diretório de integrações da Intuit o nome do seu CRM ou da sua plataforma de e-commerce. Para cada listagem, verifique quais registros ela sincroniza, em que direção e o que faz quando um registro já existe ou uma chamada falha. Teste em uma cópia dos seus dados antes de se comprometer.

Ferramentas no-code são o passo intermediário. A integração do Zapier com o QuickBooks Online lista dezenas de gatilhos e ações. O Make tem um app do QuickBooks que inclui um módulo para fazer as suas próprias chamadas de API. Isso é útil quando um módulo padrão não cobre o registro de que você precisa.

Essas ferramentas falham em quatro pontos:

  • Regras de correspondência personalizadas. Decidir que dois cadastros de cliente são a mesma pessoa exige mais do que um gatilho e uma ação.
  • Volume alto. O preço por uso sobe, e um fluxo que tenta de novo às cegas pode atingir os limites da Intuit.
  • Conflitos nos dois sentidos. Quando os dois sistemas podem editar um registro, fluxos simples sobrescrevem um ao outro.
  • Sua própria plataforma. Não existe conector para um software que só você usa, então a API é a única porta de entrada.

Nossa página de integração de sistemas assume a mesma posição: se dois dos seus sistemas já sincronizam de forma nativa, vamos dizer para você ativar isso.

O que envolve uma integração com a API do QuickBooks?

Uma integração sob medida é um código que conversa com o QuickBooks por você, com regras sobre o que enviar, quando e o que acontece quando algo falha. O lado técnico é convencional. A QuickBooks Online Accounting API é uma API REST que usa JSON. Webhooks avisam o seu sistema sempre que os dados mudam, então você não precisa consultar o QuickBooks o dia inteiro para descobrir.

Acerte a autenticação primeiro. O FAQ de OAuth da Intuit define as regras dos tokens:

  • Access tokens valem por 3.600 segundos, ou seja, uma hora.
  • Refresh tokens expiram de forma contínua, 100 dias depois do último uso.
  • Rotação do refresh token. A Intuit atualiza o valor do refresh token a cada 24 horas, então a sua integração precisa sempre guardar o mais recente.
  • Validade máxima. Todos os refresh tokens têm validade máxima de cinco anos.

A regra de rotação tem uma consequência prática. Se o seu código renova o access token mas descarta o novo refresh token, uma renovação posterior falha e a sincronização para. Guarde sempre o token mais recente, em um lugar seguro, e avise alguém se uma renovação falhar.

Qualquer que seja o caminho, o trabalho de desenvolvimento tem o mesmo formato:

  • Mapeie um fluxo primeiro. Defina o gatilho, os campos que se movem e a direção, como um negócio ganho gerando uma fatura. Adicione o próximo fluxo só quando o primeiro estiver no ar.
  • Crie as regras de correspondência. Decida como um registro em um sistema é reconhecido no outro. Guarde o ID de cada sistema no outro e faça a correspondência por eles.
  • Torne cada chamada segura para repetir. Uma nova tentativa nunca pode criar uma segunda fatura.
  • Adicione uma fila de erros. Um registro com falha vai para uma fila revisada por uma pessoa definida, para que um cliente problemático não trave os demais.
  • Teste com dados bagunçados. Use clientes reais sem código postal, com caracteres estranhos no nome e com faturas pagas em parte.
  • Gere um relatório de conciliação. Um relatório simples mostrando o que foi transferido, o que falhou e o que está aguardando permite que o financeiro confie na sincronização.
  • Entre no ar em etapas. Comece com um fluxo e um curto período rodando em paralelo com o processo manual.

Limites da API do QuickBooks e o que eles significam para o seu desenvolvimento

A Intuit define limites e throttling para a API do QuickBooks Online. Cada empresa, identificada pelo seu realm ID, permite 500 requisições por minuto. Um segundo limite permite 10 requisições por segundo para cada combinação de empresa e app. A Intuit recomenda no máximo 30 operações em uma única requisição em lote.

Quando você ultrapassa um limite, o QuickBooks retorna uma resposta HTTP 429. Uma integração bem feita coloca as chamadas em fila, espera, tenta de novo com back-off e segue em frente, em vez de falhar. Os lotes também ajudam, porque uma requisição em lote pode levar até 30 operações.

Dois exemplos mostram a escala. Os dois usam aritmética simples sobre os limites publicados.

  • Dia a dia. Emitir 500 faturas por mês, com uma chamada cada, é um fluxo pequeno. Mesmo com 22 dias úteis, são cerca de 23 chamadas por dia, muito abaixo de 500 por minuto.
  • Fechamento do mês e carga retroativa. Enviar 10.000 registros de uma vez é outro trabalho. A 500 requisições por minuto, com uma operação por requisição, são pelo menos 20 minutos de chamadas. Lotes de 30 operações reduzem o número de requisições para cerca de 334. Em qualquer caso, rode como uma tarefa agendada e cadenciada que monitora respostas 429.

A lição é cadenciar o trabalho em massa. O fechamento do mês é quando o financeiro quer tudo sincronizado de uma vez, e também é quando uma integração ingênua atinge os limites. Coloque o trabalho em fila e distribua-o no tempo.

As taxas de desenvolvedor da Intuit (o App Partner Program)

A Intuit cobra dos desenvolvedores por meio do seu App Partner Program. A taxa depende de quantas chamadas de API o app faz. No momento em que escrevemos (novembro de 2026), os valores nos EUA são:

NívelTaxa mensalChamadas CorePlus de API incluídas
BuilderSem custo500.000
SilverUS$ 3001 milhão
GoldUS$ 1.70010 milhões
PlatinumUS$ 4.50075 milhões

A Intuit divide as chamadas de API em dois grupos. As chamadas Core não têm limite. As chamadas CorePlus são descontadas dos créditos da tabela, então confira na página da Intuit quais chamadas ficam em cada grupo. A página de limites informa 500.000 chamadas CorePlus por workspace por mês no nível Builder.

Para uma integração de uma única empresa, 500.000 chamadas CorePlus por mês é uma franquia grande, então o nível gratuito Builder costuma bastar. As taxas ficam com quem é dono do app, o que, em um desenvolvimento sob medida, pode ser você. Pergunte a qualquer integrador em qual nível o app dele está e quem paga se ele subir de nível. Os preços mudam, então confira a página da Intuit antes de fazer o orçamento.

Quanto custa uma integração com QuickBooks?

São dois custos: o plano do QuickBooks que você já paga e a integração por cima. Para referência, a página de preços da Intuit lista o QuickBooks Online a US$ 38 por mês no Simple Start, US$ 85 no Essentials, US$ 140 no Plus e US$ 340 no Advanced, no momento em que escrevemos (novembro de 2026). A Intuit também está oferecendo 50% de desconto nos três primeiros meses, então o preço que você paga pode ser diferente.

Para a integração em si, os caminhos no-code custam a assinatura de uma ferramenta mais o tempo para configurar e testar. Os apps do marketplace são assinaturas com preços definidos pelos fabricantes.

Conosco, conectar dois sistemas que você já usa, como o seu CRM e o QuickBooks, começa em R$ 35.000 e inclui sincronização nos dois sentidos com verificações. Uma integração de toda a empresa entre as suas ferramentas principais começa em R$ 69.000. Cada preço é fechado e acordado antes do início do trabalho. Depois da entrada no ar, o suporte começa em R$ 2.800 por mês.

Para um parque de sistemas maior, com um ERP e vários outros sistemas, a integração de software corporativo começa com uma auditoria e um plano de integração a partir de R$ 28.000.

O que muda o preço de um desenvolvimento sob medida:

  • Quantos sistemas e fluxos. Um fluxo de faturas do CRM para o QuickBooks é um trabalho. Um segundo sistema traz os próprios mapeamentos, testes e casos de falha.
  • Direção. Enviar faturas para o QuickBooks é mais simples do que também gravar de volta pagamentos e alterações de contatos, o que exige uma regra para quando os dois lados editam um registro.
  • Qualidade dos dados. Duplicatas que já estão no seu CRM ou no QuickBooks precisam ser limpas antes de poderem ser correspondidas.
  • Histórico. Copiar anos de transações passadas é um trabalho separado de sincronizar as novas.
  • Volume. Cargas em massa e de fechamento do mês precisam de lotes, de uma fila e de back-off.

QuickBooks Desktop ou QuickBooks Online?

Desenvolva novas integrações sobre o QuickBooks Online. Desde 30 de setembro de 2024, a Intuit parou de vender novas assinaturas nos EUA do QuickBooks Desktop Pro Plus, Premier Plus, Mac Plus e Enhanced Payroll. Os assinantes atuais não são afetados, e o Desktop Enterprise continua à venda.

As integrações com o Desktop funcionam de outro jeito, porque não existe uma API em nuvem como a que o Online oferece. Se você usa o Desktop hoje, o caminho de integração depende da sua versão e da sua configuração, então peça ao seu integrador que confirme o que é possível antes de definir qualquer escopo. Se você está pensando em migrar para o Online, trate isso como uma decisão separada e faça a migração antes de desenvolver, para não integrar duas vezes.

O que dá errado nas integrações com QuickBooks?

Esses problemas aparecem depois da entrada no ar, então resolva-os no início. Para polling, webhooks e alertas em geral, veja nosso guia de integração de APIs.

Clientes duplicados por correspondência frouxa. Fazer a correspondência por nome ou e-mail cria duplicatas, porque as pessoas digitam “Acme Inc.” e “ACME Incorporated” e usam mais de um e-mail. Guarde o ID de cada sistema no outro e faça a correspondência por eles.

Um refresh token que não é guardado depois da rotação. A Intuit faz a rotação do refresh token, então um código que continua usando o antigo funciona por um tempo e depois para. A sincronização falha em silêncio, e ninguém percebe até o financeiro perguntar por que faltam faturas. Guarde sempre o token mais recente e gere um alerta em qualquer renovação que falhar.

Throttling no fechamento do mês. Sincronizações em massa perto do fechamento do mês esbarram nos limites por minuto e por segundo. Cadencie o trabalho por meio de uma fila e tente de novo as respostas 429 com back-off.

Conflitos de sincronização nos dois sentidos. Quando os dois sistemas podem editar um registro, um sobrescreve o outro. Decida qual sistema prevalece em cada campo e registre isso por escrito. Este é o padrão de onde partimos:

RegistroNormalmente pertence aPor quê
Negócio, etapa, contratoO CRMA equipe de vendas trabalha lá
Fatura, impostos, status do pagamentoQuickBooksO financeiro gera relatórios a partir dele
Nome e endereço do clienteUm sistema, escolhido de antemãoDois editores sobrescrevem um ao outro

Mude isso onde a sua empresa for diferente.

Sincronizar relatórios resumidos em vez de transações. Um relatório mostra totais, e totais não podem ser associados de volta ao negócio ou pedido que os gerou. Sincronize as transações individuais e monte os relatórios a partir delas.

Configurações de impostos e moeda diferentes entre os sistemas. Se o seu CRM guarda preços com impostos incluídos, ou faz orçamentos em outra moeda, uma fatura no QuickBooks pode ficar diferente do orçamento, a menos que o mapeamento seja feito de propósito. Peça ao seu contador que confirme o tratamento de impostos e moeda de cada linha de produto antes da entrada no ar. Esta é uma informação geral, não uma orientação tributária.

Usa o Xero?

Muitos dos mesmos padrões valem para o Xero. Nosso guia de integração com Xero trata da Xero App Store, dos limites da API e das armadilhas específicas do Xero.

Se o trabalho for mais amplo do que uma conexão, como faturamento, cobrança de pagamentos ou conciliação, comece pelo nosso serviço de automação de processos de negócio.

Um próximo passo sensato

Diga quais são os dois sistemas que você quer conectar e o fluxo que mais toma o seu tempo, como um negócio ganho que vira fatura no QuickBooks. A partir disso, podemos dizer se um app do marketplace, uma ferramenta no-code ou um desenvolvimento sob medida é o mais adequado, e se um app resolver, vamos dizer isso.

Para dois sistemas, comece pelo nosso serviço de integração de sistemas, a partir de R$ 35.000. Para um ERP e vários outros sistemas, nosso trabalho de integração de software corporativo começa com uma auditoria e um plano a partir de R$ 28.000.

Perguntas frequentes

O QuickBooks tem API?

Sim. A QuickBooks Online Accounting API é uma API REST que troca dados em JSON e suporta webhooks que avisam o seu sistema quando os dados mudam. A sua integração faz login com OAuth 2.0, cria e lê registros como clientes e faturas e opera dentro dos limites de requisições publicados. Ela cobre o QuickBooks Online, que é a versão que recomendamos para novos projetos.

Quanto custa uma integração com QuickBooks?

Um app do marketplace ou uma ferramenta no-code custa uma assinatura mais o tempo de configuração. Uma integração sob medida conosco começa em R$ 35.000 para dois sistemas e em R$ 69.000 para a empresa inteira, com preço fechado e acordado antes, e suporte a partir de R$ 2.800 por mês. As taxas de desenvolvedor da Intuit ficam com quem é dono do app, então pergunte quem será.

O Zapier consegue conectar o QuickBooks ao meu CRM?

Muitas vezes, sim. O Zapier lista uma integração com o QuickBooks Online com dezenas de gatilhos e ações, então um fluxo simples, como um negócio ganho gerando uma fatura, é realista. Confirme que o seu CRM tem um conector no Zapier e que os dois lados conseguem gravar os registros de que você precisa. Regras de correspondência, volumes altos e sincronização nos dois sentidos são onde um desenvolvimento sob medida começa a compensar.

Quais são os limites de requisições da API do QuickBooks?

A Intuit permite 500 requisições por minuto por empresa e 10 requisições por segundo por empresa e app. Ela recomenda lotes de no máximo 30 operações. Ultrapassar o limite retorna uma resposta HTTP 429, então uma boa integração coloca as chamadas em fila e tenta de novo com back-off. Tarefas em massa, como uma sincronização de fechamento do mês, são a forma mais provável de atingir esses limites.

A Intuit cobra pelo acesso à API do QuickBooks?

A Intuit mantém um App Partner Program para desenvolvedores. No momento em que escrevemos (novembro de 2026), o nível Builder não tem custo e inclui 500.000 chamadas CorePlus de API por mês. Os níveis pagos vão de US$ 300 a US$ 4.500 por mês. As taxas ficam com quem é dono do app, e uma integração para uma única empresa provavelmente fica dentro do nível gratuito.

Quer construir algo assim?

Agende uma consultoria gratuita de 30 minutos e vamos ajudar você a descobrir onde a automação traz retorno.

Agende uma consultoria Peça um orçamento grátis

Continue explorando

Voltar para todos os artigos

Agende uma conversa gratuita com Matt

Product Owner e cofundador · São Paulo

Peça para ligarmos para você

Deixe seu nome e telefone e nós ligamos para você.