Automação

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

Um túnel de pedestres curvo, revestido de azulejos brancos, com corrimãos e iluminado por cima O Xero está ligado ao seu CRM?

Uma integração com Xero conecta o Xero a outro sistema para que faturas, contatos e pagamentos circulem entre eles sem que ninguém precise digitá-los de novo. Você tem três caminhos: um app da Xero App Store, uma ferramenta no-code como Zapier ou Make, ou uma integração sob medida construída sobre a API do Xero. Olhe a App Store primeiro. O Xero diz que lista centenas de apps, e um app listado que move os registros certos na direção certa costuma ser o caminho mais barato e mais rápido.

Uma integração sob medida com a API do Xero 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, e uma integração de toda a empresa em R$ 69.000, com preço fechado e acordado antes do início do trabalho. Este guia trata do que conectar ao Xero, de como escolher um caminho e do que envolve e quanto custa um desenvolvimento sob medida. Depois, trata dos limites da API do Xero, das armadilhas que pegam as equipes de surpresa e traz uma seção curta sobre o Sage.

Principais pontos

  • Comece pela Xero App Store. O Xero diz que lista centenas de apps, incluindo apps de CRM, e um app listado que move os registros certos na direção certa costuma ser o caminho mais barato.
  • Use uma ferramenta no-code quando os dois lados têm conectores e a lógica é um gatilho e uma ação simples. Desenvolva uma integração sob medida quando a lógica envolve vários sistemas, o volume é alto ou você precisa de uma trilha de auditoria.
  • Com a CodeLeap, conectar dois sistemas começa em R$ 35.000, e uma integração de toda a empresa em R$ 69.000, com suporte a partir de R$ 2.800 por mês depois da entrada no ar.
  • O Xero permite que um app faça 60 chamadas por minuto por organização, e 1.000 chamadas por dia no nível inicial ou 5.000 nos níveis superiores. Uma boa integração agrupa as chamadas em lotes e recua quando o Xero pede.
  • A maioria dos problemas de integração com o Xero são problemas de dados: contatos duplicados, faturas duplicadas depois de uma nova tentativa, tratamento de impostos e nenhuma fonte de verdade acordada. Resolva isso antes que alguém escreva código.

Ao que você pode conectar o Xero?

O Xero é a ponta financeira do stack, então a pergunta útil é qual sistema gera os eventos financeiros. Quatro grupos são os candidatos mais comuns.

  • CRM. O primeiro fluxo costuma ser um negócio ganho que gera uma fatura no Xero, com o status do pagamento voltando para que a equipe de vendas veja quem já pagou.
  • E-commerce e sistemas de reservas. Pedidos ou reservas viram faturas de venda, e os pagamentos são conciliados com elas depois.
  • Sistemas de trabalhos e projetos. Um trabalho concluído ou uma folha de horas aprovada vira uma fatura, então o faturamento não espera alguém digitá-lo.
  • Plataformas sob medida. Um portal do cliente ou um sistema interno que é seu. Nada na App Store conhece o seu modelo de dados, então o lado do Xero é 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 o Xero emite a fatura de venda automaticamente. São cerca de 500 faturas por mês que deixaram de ser digitadas à mão, com o fluxo indo do CRM até a contabilidade.

Se o seu problema são contas de fornecedores chegando ao Xero, 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, incluindo webhooks.

Xero App Store, ferramenta no-code 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 da App StoreO seu CRM ou sistema de reservas tem uma listagem que move os registros de que você precisaEle sincroniza o que o fabricante escolheu, na direção que ele escolheu
Ferramenta no-codeOs dois lados têm conectores e a lógica é um gatilho e uma ação simplesCobrança por tarefa, e um fluxo que vira crítico sem ninguém perceber
Desenvolvimento sob medida na API do XeroA 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

A própria página do Xero diz que, se os apps existentes não resolvem um problema, você pode criar um com a sua API aberta ou contratar um desenvolvedor certificado pelo Xero (Xero). Antes disso, pesquise na App Store o nome do seu CRM ou sistema de reservas. 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.

Uma ferramenta no-code é o passo intermediário. Confirme que ela tem um conector para o Xero e que o conector consegue gravar os registros de que você precisa, além de lê-los. Nossa própria 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 Xero?

Uma integração sob medida é um código que conversa com a API do Xero por você, com regras sobre o que enviar, quando e o que acontece quando algo falha. Para uma empresa, há duas formas de conectá-la ao Xero.

Uma conexão de app padrão. Um usuário autorizado aprova a integração na tela de consentimento do Xero. Novos apps começam no nível Starter do Xero, que permite 5 conexões. O Xero também limita cada organização a cinco apps não certificados, então conte os apps que já estão conectados (Xero). Uma integração para uma organização precisa de uma conexão.

Uma Custom Connection. O Xero a descreve como uma opção premium que dá a uma integração acesso a uma única organização. Ela exige uma assinatura mensal adicional e está disponível para organizações no Reino Unido. Não conta para o limite de cinco apps, e você pode construí-la e testá-la de graça com a Demo Company do Xero (Xero).

Qual delas se encaixa depende de quantas organizações a integração atende e de quantos apps a sua já tem. Peça ao seu integrador que diga por escrito qual está usando e quem paga qualquer assinatura do Xero.

Qualquer que seja a conexão, o trabalho tem o mesmo formato.

  • Mapeie um fluxo primeiro. Defina o gatilho, os campos que se movem e a direção, como um contrato assinado gerando uma fatura de venda. 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. As armadilhas abaixo mostram por que esta etapa define se você terá duplicatas.
  • Torne cada chamada segura para repetir. Uma nova tentativa nunca pode criar uma segunda fatura.
  • Teste com dados bagunçados. Use clientes reais sem código postal, com caracteres estranhos no nome e com faturas pagas em parte.
  • Alerte uma pessoa definida. Nossa integração de toda a empresa inclui alertas automáticos quando uma sincronização falha, e alguém precisa recebê-los.
  • Entre no ar em etapas. Entregamos a integração do grupo de eventos em três fases.

Quanto custa uma integração com Xero?

Conosco, conectar dois sistemas que você já usa, como o seu CRM e o Xero, começa em R$ 35.000. Uma integração de toda a empresa entre todos os sistemas principais começa em R$ 69.000. Cada preço é fechado e acordado antes do início do trabalho, e você paga por marcos de entrega, conforme cada etapa é entregue. Você pode cancelar um desenvolvimento nos primeiros 21 dias e receber seu dinheiro de volta integralmente. Todo o código e a propriedade intelectual são seus depois que o trabalho é entregue e pago. 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 desenvolvimento da integração começa em R$ 69.000.

O lado do Xero tem custos próprios. A tabela de preços para desenvolvedores do Xero entrou em vigor em 2 de março de 2026 e é cotada em dólares australianos, sem impostos (Xero Developer). No momento em que escrevemos (outubro de 2026), o plano Starter não tem mensalidade, permite até 5 conexões e dá 1.000 chamadas por dia por organização. O plano Core custa AUD 35 por mês. Ele permite até 50 conexões, dá 5.000 chamadas por dia por organização e inclui 10 GB de dados baixados do Xero por mês. Dados extras custam AUD 2,40 por GB. Uma Custom Connection exige uma assinatura mensal própria, então confirme o preço com o Xero antes de fazer o orçamento. Os apps da App Store e os planos do seu outro sistema têm preços definidos pelos respectivos fornecedores.

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

  • Quantos sistemas e fluxos. Um fluxo de faturas do CRM para o Xero é um trabalho. Um sistema de reservas ou uma segunda organização no Xero traz os próprios mapeamentos, testes e casos de falha.
  • Direção. Enviar faturas para o Xero é mais simples do que também gravar de volta no CRM os pagamentos e as 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 Xero precisam ser limpas antes de poderem ser correspondidas.
  • Histórico. Copiar anos de faturas passadas é um trabalho separado de sincronizar as novas.
  • Volume. Perto do limite diário do Xero, o desenvolvimento precisa de lotes, de uma fila e de back-off que siga o cabeçalho Retry-After.

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

O Xero aplica os seus limites a cada organização, que ele chama de tenant. Um app pode ter 5 chamadas em andamento ao mesmo tempo e fazer 60 chamadas por minuto. O limite diário é de 1.000 chamadas no nível inicial e de 5.000 nos níveis superiores. Um limite separado, de 10.000 chamadas por minuto, vale para o app somando todas as suas organizações (Xero).

Ultrapasse um limite e o Xero retorna uma resposta HTTP 429. Para os limites por minuto e diário, ele também envia um cabeçalho Retry-After, e o Xero recomenda usar esse cabeçalho para saber quando você pode voltar a fazer chamadas. Uma integração bem feita coloca as chamadas em fila, respeita o cabeçalho e segue em frente, em vez de falhar.

Os lotes ajudam. O Xero diz que é possível criar mais de uma fatura em uma única chamada, e que cerca de 50 por requisição é um número prático (Xero).

Dois exemplos mostram a escala:

  • Dia a dia. Emitir 500 faturas por mês, com uma chamada cada, ao longo de 22 dias úteis, dá cerca de 23 chamadas por dia. É uma pequena fração das 1.000 por dia do nível inicial.
  • Carga retroativa. Ler do Xero 30.000 faturas históricas com os seus itens de linha, por exemplo para um CRM, é outro trabalho. O Xero diz que a sua paginação retorna os itens de linha de 100 faturas por vez (Xero), então são 300 chamadas (30.000 divididos por 100). A 60 chamadas por minuto, são pelo menos cinco minutos de chamadas e 30% da cota diária do nível inicial, então rode isso como uma tarefa agendada. Gravá-las no Xero, a cerca de 50 por requisição, leva cerca de 600 chamadas, ou 60% de um dia do nível inicial.

O Xero também diz que foi projetado para até 5.000 faturas de venda e 5.000 contas de compra por mês (Xero). O número depende de com que frequência você fatura, de quanto os valores variam e de com que frequência você declara o imposto sobre vendas. Uma empresa muito acima disso deve conversar com o Xero antes de desenvolver qualquer coisa.

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

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.

Contatos duplicados. A documentação de contatos do Xero recomenda que os desenvolvedores usem o ContactID para referenciar um contato, e não dependam do nome dele. Ela alerta que o nome pode deixar de ser um campo único no futuro. O Xero também tem um campo ContactNumber para um identificador vindo de outro sistema, e o próprio exemplo do Xero é o número de cliente de um CRM (Xero). Guarde o ID do CRM no Xero e o ContactID do Xero no CRM, e faça a correspondência por eles, nunca por nome ou e-mail.

Faturas duplicadas depois de uma nova tentativa. Uma falha de rede depois que o Xero criou uma fatura, mas antes que o seu sistema fique sabendo, é como surgem duas faturas. O Xero suporta um cabeçalho Idempotency-Key em requisições POST, PUT e PATCH, para que uma requisição repetida retorne a primeira resposta. Ele guarda as chaves por apenas 6 minutos (Xero). Por isso, a integração também deve registrar o ID da fatura do Xero junto ao negócio ou pedido e verificar se ele existe antes de criar qualquer coisa.

Categorias de rastreamento. Uma organização no Xero pode ter no máximo duas categorias de rastreamento (tracking categories) ativas, e quatro no total, incluindo as arquivadas. O Xero recomenda um limite flexível de 100 opções por categoria, porque mais do que isso pode deixar os relatórios lentos (Xero). Se o seu CRM tem departamentos, regiões, projetos e linhas de produto, combine com o financeiro quais são as duas que importam antes de desenvolver.

Impostos e arredondamento. O Xero trata os valores das linhas como sem impostos, a menos que a requisição diga o contrário. Ele pega o tratamento tributário do código da conta, a menos que você o substitua por um tipo de imposto. Por padrão, arredonda os valores unitários para duas casas decimais, com quatro disponíveis sob pedido (Xero). Se o seu CRM guarda preços com VAT (o imposto sobre valor agregado do Reino Unido) incluído, ou faz orçamentos com quatro casas decimais, uma fatura no Xero 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 VAT de cada linha de produto antes da entrada no ar. Esta é uma informação geral, não uma orientação tributária.

Nenhuma fonte de verdade acordada. Quando dois sistemas podem editar um registro, um vai sobrescrever o outro. Decida quem é dono de quê antes de desenvolver. 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 pagamentoXeroO 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 e registre a decisão por escrito.

E a integração com Sage?

Quem pesquisa integração com Sage normalmente quer o mesmo trabalho em outro sistema contábil. O portal de desenvolvedores do Sage tem seções separadas para o Sage Accounting e o Sage Intacct. A seção de contabilidade lista a API Sage Business Cloud Accounting v3.1, diz que as versões 1 e 2 estão obsoletas e inclui um guia para se conectar pelo Zapier. A seção do Intacct lista uma API REST.

Os padrões acima continuam valendo. Escolha uma fonte de verdade para cada registro, faça a correspondência por IDs armazenados em vez de nomes, torne as novas tentativas seguras e alerte alguém quando algo falhar. Autenticação, limites e modelos de dados são diferentes, então leia a documentação atual do seu produto Sage antes de definir o escopo do trabalho.

No nosso trabalho de automação de processos de negócio, faturamento, cobrança de pagamentos e conciliação no Xero, no Sage ou no QuickBooks são primeiros projetos comuns. Se o trabalho for mais amplo do que uma conexã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 contrato assinado que vira fatura no Xero. A partir disso, podemos dizer se um app da App Store, 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 que é uma integração com a API do Xero?

Uma integração com a API do Xero é um software que conecta o Xero a outro sistema por meio da API que o Xero publica para outros softwares. Ela pode criar contatos e faturas no Xero e trazer de volta o status de pagamento para um CRM, seguindo regras que você define. Olhe a Xero App Store primeiro, porque um app listado costuma ser mais barato. Um desenvolvimento sob medida é indicado para lógicas que envolvem vários sistemas, volumes altos ou uma plataforma que nada listado suporta.

O Xero se integra ao meu CRM?

Muitas vezes, sim. O Xero diz que a sua App Store tem centenas de apps, e há uma categoria para apps de CRM. Pesquise na loja o nome do seu CRM e depois verifique quais registros cada listagem sincroniza, em que direção e o que acontece quando uma chamada falha. Se nada servir, uma ferramenta no-code ou uma integração sob medida pela API do Xero pode resolver. Conosco, conectar dois sistemas começa em R$ 35.000.

Quanto custa uma integração com Xero?

Um app da App Store é uma assinatura com preço definido pelo fabricante. 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 do início do trabalho, e suporte a partir de R$ 2.800 por mês. Os planos de desenvolvedor do próprio Xero começam com o plano Starter, sem mensalidade, e o Core aparece a AUD 35 por mês sem impostos, no momento em que escrevemos (outubro de 2026).

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

Para cada organização, o Xero permite 5 chamadas em andamento ao mesmo tempo, 60 chamadas por minuto e um limite diário de 1.000 chamadas no nível inicial ou 5.000 nos níveis superiores. Cada app também tem um limite de 10.000 chamadas por minuto somando todas as organizações. Ultrapassar o limite retorna uma resposta HTTP 429, e o cabeçalho Retry-After informa quanto tempo esperar. Agrupar várias faturas em uma única chamada ajuda.

Em que uma integração com Sage difere de uma integração com Xero?

O trabalho é o mesmo: decidir qual sistema é dono de cada registro, fazer a correspondência por IDs armazenados e tornar as novas tentativas seguras. As interfaces são diferentes. O portal de desenvolvedores do Sage tem seções separadas para o Sage Accounting e o Sage Intacct, cada um com a sua API e a sua documentação. Verifique qual produto você usa e leia os limites atuais dele antes de definir o escopo do trabalho.

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ê.