> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com Xero

> Integre o Gorelo ao Xero para sincronizar clientes, faturas, taxas de impostos e pagamentos, com configuração OAuth passo a passo e mapeamento por conta.

O Gorelo integra-se ao Xero, permitindo sincronizar clientes, faturas, taxas de impostos, pagamentos e muito mais!

<Steps>
  <Step title="Acesse Configurações > Integrações." />

  <Step title="Clique no ícone ⚙️engrenagem para configurar o Xero." />

  <Step title="Clique no botão Conectar ao Xero.">
    <Frame>
      <img src="https://mintcdn.com/gorelo/lSDtopHHxQOVmW9k/images/image-147.png?fit=max&auto=format&n=lSDtopHHxQOVmW9k&q=85&s=8e2ddb01dfecc0d433c57926aedbd59b" alt="Image 147" width="758" height="220" data-path="images/image-147.png" />
    </Frame>
  </Step>

  <Step title="Faça login com sua conta do Xero.">
    Selecione a organização apropriada (se houver várias) e clique em **Permitir Acesso**. Você será redirecionado de volta ao Gorelo com uma mensagem de sucesso.

    <Frame>
      <img src="https://mintcdn.com/gorelo/qTZ5d9j_QXZjqXH8/images/image-148.png?fit=max&auto=format&n=qTZ5d9j_QXZjqXH8&q=85&s=bad6792eb70acdf5a7ba1c771a270aa3" alt="Image 148" width="1375" height="661" data-path="images/image-148.png" />
    </Frame>
  </Step>

  <Step title="Selecione um código padrão de Plano de Contas (COA) na lista.">
    * Será usado para qualquer item sincronizado do Gorelo para o Xero que **não** tenha um código COA aplicado automaticamente ao produto/pacote/categoria.
    * Recomenda-se criar um novo código COA, como "**4444 Não codificado do Gorelo**", para deixar evidente quando algo sincroniza sem um COA legítimo. Se esse código foi criado agora, pressione F5 na tela "*Integração com Xero bem-sucedida*" para que apareça, ou inicie a integração novamente.
  </Step>

  <Step title="Clique no botão Concluir Integração com Xero." />

  <Step title="Volte para Configurações > Integrações." />

  <Step title="Clique no ícone ⚙️engrenagem para configurar o Xero." />

  <Step title="Clique no botão Ver Clientes." />

  <Step title="Mapeie quaisquer clientes restantes no Gorelo para contatos no Xero." />

  <Step title="Clique em Atualizar." />
</Steps>

<Tip>
  **Dicas!**

  * ***Clientes*** no Gorelo com nomes idênticos aos ***Contatos*** no Xero serão mapeados automaticamente.
  * Códigos do Plano de Contas (COA) podem ser definidos individualmente nos seguintes níveis:
    * Produtos
    * Pacotes
  * Códigos do Plano de Contas (COA) podem ser definidos via [**Categorias de Produto**](https://app.gorelo.io/Admin/admin-settings#billing#productcategories) e Subcategorias — produtos/pacotes herdarão esses códigos COA.
</Tip>

## Definir a taxa de imposto padrão

<Steps>
  <Step title="Acesse Configurações > Faturamento > Configurações de Fatura" />

  <Step title="Clique no botão Sincronizar no canto superior direito para ressincronizar." />

  <Step title="Defina sua taxa de imposto padrão.">
    Clique no botão **Marcar como padrão** à direita da taxa de imposto escolhida.
  </Step>
</Steps>

<Tip>
  **Dicas!**

  * Taxas de imposto podem ser definidas individualmente nos seguintes níveis:
    * Produtos
    * Pacotes
    * Itens de linha de contrato
    * Itens de linha de fatura
  * Taxas de imposto podem ser definidas via [**Categorias de Produto**](https://app.gorelo.io/Admin/admin-settings#billing#productcategories) e Subcategorias — produtos/pacotes herdarão essas taxas
</Tip>

## Como o Gorelo sincroniza com o Xero

A tabela a seguir explica como usar faturas no Gorelo para garantir que sejam sincronizadas no Xero, e vice-versa.

| Ação                           | Faça pelo      |
| ------------------------------ | -------------- |
| Criar uma fatura               | Gorelo         |
| Aprovar uma fatura em rascunho | Gorelo ou Xero |
| Enviar uma fatura              | Gorelo         |
| Lançar um pagamento            | Xero           |