Saltar para o conteúdo

Faturação

Integração Xero

Faturas, contactos e pagamentos no Xero sincronizados com vendas e cobranças, para entidades no Reino Unido, Irlanda e outros mercados.

Visão geral

Xero

O Xero é um software de contabilidade na nuvem muito usado no Reino Unido, na Irlanda, na Austrália e na Nova Zelândia. Empresas portuguesas com filial nesses países, ou grupos que consolidam contas em inglês, acabam muitas vezes com o Xero de um lado e as vendas noutro.

A Tejobit liga-se à API do Xero com OAuth 2.0 e trabalha com os objetos de contabilidade: Contacts, Invoices, Payments, Items e contas do plano. Os webhooks do Xero avisam quando contactos ou faturas são criados ou alterados; a notificação traz apenas a referência, e a ligação vai buscar o registo completo.

Uma nota importante: o Xero não é software de faturação certificado pela AT. Para uma entidade portuguesa, as faturas legais têm de vir de um programa certificado, e o Xero pode receber esses dados como registo contabilístico. Para entidades estrangeiras, o Xero pode ser o próprio sistema de faturação.

Casos de uso

Para que serve

  • Filial em Londres que vende subscrições por Stripe e quer cada invoice.paid registada como fatura e pagamento no Xero.
  • Loja Shopify com mercado no Reino Unido em que as encomendas passam ao Xero com a conta de vendas e o imposto corretos.
  • Negócio fechado no HubSpot que cria o contacto e uma fatura em rascunho no Xero para aprovação.
  • Pagamentos marcados no Xero que atualizam o estado do cliente no CRM.
  • Taxas de processamento do Stripe registadas como despesa para o saldo da conta bater certo.
IN

O que a ligação escuta

  • Webhooks do Xero para criação e alteração de contactos e faturas.
  • Eventos do Stripe como invoice.paid ou charge.refunded.
  • Encomenda paga no Shopify.
  • Negócio ganho no CRM.
OUT

O que a ligação faz

  • Cria ou atualiza o contacto com nome, email, morada e número de IVA.
  • Cria a fatura (rascunho, para aprovação ou aprovada) com itens, conta de proveitos e tax rate.
  • Regista o pagamento na conta bancária certa e o reembolso como nota de crédito.
  • Lê faturas e pagamentos para atualizar o CRM ou um painel.
  • Junta o PDF ou o recibo da origem como anexo, quando útil.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Autorização OAuth à organização Xero por um utilizador com permissões de consultor ou administrador.
  • Plano de contas, tax rates e contas bancárias definidos.
  • Decisão sobre o estado em que as faturas entram: rascunho, a aprovar ou aprovadas.
  • Lista de entidades e moedas envolvidas, se houver mais do que uma organização.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A API do Xero tem limites por organização, por minuto e por dia; grandes importações históricas são feitas em lotes.
  • Desde 2026 o Xero cobra o acesso à API por escalões de ligações e volume de dados, o que pode afetar integrações com muitas organizações.
  • O Xero não é certificado pela AT, por isso não substitui o programa de faturação de uma empresa portuguesa.

Perguntas frequentes

Antes de começar

Posso usar o Xero para faturar clientes em Portugal?

Não como software de faturação de uma entidade portuguesa, porque não é certificado pela AT. Pode usá-lo para a contabilidade de entidades estrangeiras ou receber cópia das faturas emitidas noutro programa.

As faturas entram aprovadas ou em rascunho?

Escolhe a equipa. Muitas empresas preferem rascunho nas primeiras semanas e passam a aprovação automática quando confiam nos dados.

Funciona com várias moedas?

Sim, se a organização Xero tiver multimoeda. A ligação envia a moeda da venda e o Xero aplica a taxa de câmbio.

O que acontece se a autorização expirar?

A ligação renova os tokens automaticamente. Se um utilizador revogar o acesso, a Tejobit recebe o alerta e pede nova autorização.

Ativar a integração Xero?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.