Skip to main content
Xero

Conecte o Xero ao OneSuite

Mantenha sua contabilidade em dia sem lançamento duplicado. Depois de conectar o Xero, o OneSuite copia automaticamente suas faturas para a sua organização do Xero quando você as finaliza e registra os pagamentos quando as faturas são pagas — assim sua contabilidade sempre corresponde ao faturamento no OneSuite.

OAuth 2.0 Incluído na sua assinatura ~2 min de configuração
Integração do Xero conectada nas configurações do OneSuite
O que faz

O que esta integração faz

O OneSuite envia seus dados de faturamento para o Xero por você.

Faturas copiadas automaticamente

Finalize uma fatura no OneSuite e uma fatura correspondente é criada na sua organização do Xero.

Pagamentos registrados automaticamente

Marque uma fatura como paga no OneSuite e o pagamento é registrado na fatura do Xero, na conta de pagamento que você escolher.

Atualizações permanecem sincronizadas

Edite uma fatura já copiada e o OneSuite reenvia as alterações para o Xero.

Copie faturas antigas quando quiser

Envie manualmente para o Xero qualquer fatura antiga ou não enviada, a qualquer momento.

Principais recursos e benefícios

  • Sem lançamento duplicado — faturas e pagamentos criados no OneSuite aparecem no Xero automaticamente.
  • Lançamento na conta certa — cada linha da fatura é registrada na conta de receita do Xero que você escolher (a padrão é 200 - Sales).
  • Escolha suas contas — selecione a conta de receita para as linhas da fatura e a conta em que os pagamentos são depositados.
  • Rastreamento por cliente, opcional — marque automaticamente cada linha da fatura com uma categoria de rastreamento do Xero com o nome do cliente para relatórios por cliente.
  • Compatível com multimoeda — a moeda da fatura é levada ao Xero (a organização precisa ter essa moeda habilitada).
  • Conexão segura em um clique — conecte via OAuth 2.0; as credenciais nunca são armazenadas no OneSuite.
  • Controle total — ative ou desative a cópia de pagamentos e o rastreamento, e desconecte quando quiser.
Antes de começar

Pré-requisitos

Garanta que você tem o seguinte antes de iniciar a configuração.

OneSuite

Plataforma

OneSuite

  • Uma conta empresarial ativa no OneSuite
  • Uma assinatura ativa do OneSuite
  • Acesso de administrador ou às configurações
  • Acesso a Configurações → Integrações → Contabilidade
Xero

Integração

Xero

  • Uma organização ativa no Xero
  • Uma conta do Xero com a qual você consiga entrar
  • Permissão para autorizar conexões de aplicativos
  • A moeda da fatura adicionada em Configurações do Xero → Moedas (moedas estrangeiras exigem um plano do Xero compatível com multimoeda)
Cada empresa do OneSuite se conecta a uma organização do Xero. Uma empresa pode usar apenas uma integração contábil por vez — se o QuickBooks estiver conectado, desconecte-o antes de conectar o Xero.
Guia de configuração

Instalação

Siga estes quatro passos para conectar sua organização do Xero ao OneSuite. A configuração leva cerca de dois minutos.

  1. Abra Contabilidade em Integrações

    No OneSuite, vá em Configurações → Integrações → Contabilidade. Localize o cartão do Xero e clique em Conectar.

    Dica: use o atalho de teclado ⌘K e pesquise por “Contabilidade” para chegar mais rápido.
    Abra Contabilidade em Integrações
  2. Autorize o OneSuite no Xero

    O Xero abre uma tela de consentimento confirmando que o Onesuite Accounting App está se conectando à sua organização e solicitando acesso a Contatos, Configurações da organização, Faturas e documentos relacionados, e Pagamentos. Revise as permissões, confirme a organização exibida em “Dados da organização” e clique em Permitir acesso.

    Suas credenciais do Xero nunca são armazenadas no OneSuite — a conexão usa tokens OAuth 2.0, e você pode desconectar o OneSuite a qualquer momento em Aplicativos conectados nas configurações do Xero.
    Autorize o OneSuite no Xero
  3. Escolha suas contas e salve

    Você volta ao OneSuite, na página de Configurações do Xero. Defina sua conta de receita padrão, a conta de pagamento e o comportamento das categorias de rastreamento e clique em Salvar configurações.

    O OneSuite pré-seleciona a conta de receita padrão do Xero 200 - Sales — confirme-a (ou escolha outra) antes de a sua primeira fatura ser copiada.
    Escolha suas contas e salve
  4. Confirme o status Conectado

    De volta a Configurações → Integrações → Contabilidade, o cartão do Xero agora exibe um selo verde de Conectado, com um ícone de engrenagem para reabrir suas configurações quando quiser.

    Confirme o status Conectado
Configuração

Configurações que você pode ajustar

Na página de Configurações do Xero você pode definir o seguinte.

Página de Configurações do Xero no OneSuite
Conta de receita padrão
No Xero, cada linha da fatura é lançada em uma conta do seu plano de contas. O OneSuite usa a conta de receita já definida nos seus itens ou contatos do Xero; se não houver nenhuma, ele lança a linha nesta conta de receita padrão — assim uma cópia nunca falha por falta de conta. A conta de vendas padrão do Xero é 200 - Sales, pré-selecionada para você.
Conta de pagamento padrão
Escolha “Copiar pagamentos para” e selecione a conta do Xero em que os pagamentos entram, ou selecione “Não copiar pagamentos para o Xero” para desativar totalmente a cópia de pagamentos (desativada por padrão). Apenas contas habilitadas para pagamentos no Xero podem receber um pagamento, então esta lista mostra somente essas — normalmente sua conta bancária.
Categorias de rastreamento
Escolha “Preencher categorias de rastreamento no Xero com base no cliente” para marcar cada linha da fatura com sua categoria de rastreamento do Xero com o nome do cliente (criada automaticamente no Xero caso ainda não exista), ou “Não preencher categorias de rastreamento no Xero com base no cliente”. Isso exige uma categoria de rastreamento ativa na sua organização do Xero (Configurações → Avançado → Categorias de rastreamento).
Como funciona

Uso

Depois de conectado, o Xero funciona de duas maneiras, dependendo de a fatura ter sido criada antes ou depois de você conectar sua organização.

Novas faturas sincronizam sozinhas

Com o Xero conectado, qualquer fatura que você criar exibe um selo azul “Será sincronizada com o Xero” no editor de faturas, ao lado de Salvar. Clicar em Salvar é o que dispara a sincronização: salve a fatura e uma fatura correspondente é criada na sua organização do Xero. Quando você depois marcá-la como paga, o pagamento é registrado na conta de pagamento escolhida. Edite uma fatura já sincronizada, clique em Salvar novamente e os dados atualizados também são enviados.

Selo “Será sincronizada com o Xero” exibido ao editar uma fatura do OneSuite
Como o Xero exige uma data de vencimento, o OneSuite pede que você defina uma antes de salvar sempre que o Xero estiver conectado.

Faturas antigas são copiadas manualmente

Faturas criadas antes de você conectar o Xero não sincronizam sozinhas. Para copiar uma, vá em Faturas, localize a fatura desejada, clique no menu de três pontos (⋮) daquela linha e selecione Copiar para o Xero.

Ação Copiar para o Xero na lista de faturas do OneSuite
Depois que a fatura é copiada, o menu passa a exibir “Já sincronizada com o Xero”, então você nunca cria uma duplicata.

Como a fatura aparece no Xero

Os dois caminhos produzem o mesmo resultado: uma fatura normal na sua organização do Xero — aprovada, aguardando pagamento e editável como qualquer outra. O contato, o número da fatura, as datas, os itens e os totais chegam preenchidos, com cada linha lançada na sua conta de receita.

Uma fatura sincronizada aberta no Xero, mostrando o contato, o número da fatura, as datas de emissão e vencimento, linhas apenas com descrição lançadas na conta de receita e o total da fatura
A coluna Item fica em branco — isso é esperado: as linhas de fatura do Xero só precisam de uma descrição e de uma conta, não de um item de estoque. O número da fatura do OneSuite passa a ser o número da fatura no Xero, e junto com ele vão a data de emissão e a de vencimento. Se o rastreamento por cliente estiver ativo, cada linha mostra o nome do cliente na sua categoria de rastreamento.

O que é copiado

Veja exatamente o que o OneSuite envia quando uma fatura é copiada, por qualquer um dos caminhos.

Faturas

  • Contato (associado a um contato existente do Xero ou criado se necessário)
  • Linhas apenas com descrição, cada uma lançada na sua conta de receita padrão
  • Valores, descontos e a moeda da fatura
  • Data de vencimento
  • Categoria de rastreamento opcional com o nome do cliente

Pagamentos

  • Registrados na fatura correspondente do Xero
  • Lançados na conta de pagamento que você escolheu
No Xero, o pagamento aparece na fatura como uma linha “Payment” e na conta de pagamento que você escolheu.

Onde aparece

Configurações

Configurações → Integrações → Contabilidade

Conecte, configure e desconecte sua organização do Xero, e veja o status atual da conexão.

Faturas

Lista de faturas (menu ⋮)

A ação Copiar para o Xero, para enviar manualmente faturas antigas ou não enviadas.

Por fatura

Detalhes da fatura

Status e histórico de sincronização com o Xero daquela fatura específica, para confirmar o que foi copiado e quando.

Removendo a integração

Desinstalação

Desconecte sempre que precisar.

  1. Desconectar no OneSuite

    Vá em Configurações → Integrações → Contabilidade, abra as configurações do Xero, clique em Desconectar Xero no canto superior direito e confirme. Isso revoga imediatamente a conexão com sua organização do Xero.

Ajuda e perguntas frequentes

Solução de problemas

Problemas comuns e como resolvê-los.

“Reconecte sua organização do Xero”
Sua conexão expirou ou foi revogada no Xero. Vá em Configurações → Integrações → Contabilidade e clique em Conectar no cartão do Xero novamente.
Uma fatura não foi copiada
Verifique se o Xero está conectado, depois abra a lista de faturas e use a ação ⋮ → Copiar para o Xero para copiá-la manualmente.
“A organização não está inscrita nessa moeda”
Sua organização do Xero não tem a moeda da fatura habilitada. Adicione-a em Configurações do Xero → Moedas (multimoeda exige um plano do Xero compatível), ou fature na moeda base da sua organização.
“É necessária uma data de vencimento”
O Xero rejeita faturas sem data de vencimento. Defina uma data de vencimento antes de salvar — enquanto o Xero estiver conectado, o OneSuite bloqueia o salvamento até que você faça isso.
Um pagamento não está aparecendo
O pagamento é lançado na fatura do Xero e cai na conta de pagamento que você escolheu — verifique se essa conta está habilitada para pagamentos no Xero.
A categoria de rastreamento está vazia
Preencher o rastreamento exige uma categoria de rastreamento ativa na sua organização do Xero. Crie uma em Configurações → Avançado → Categorias de rastreamento e sincronize a fatura novamente.
A coluna Item está em branco
Isso é esperado — as linhas de fatura do Xero não exigem um item, apenas uma descrição e uma conta. Suas linhas estão completas e lançadas corretamente.
Cliquei em “Copiar para o Xero” mas nada mudou
Se a fatura já tinha sido copiada, o menu exibe “Já sincronizada com o Xero” — a cópia não será duplicada.

Ainda com dificuldade?

Nossa equipe de suporte terá prazer em ajudar. Inclua o número da sua fatura e uma captura de tela do erro.

Falar com o suporte
Comece agora

Pronto para conectar o Xero?

Comece seu teste gratuito e configure a integração do Xero em cerca de dois minutos.