Automação Xero

Automatize operações de contabilidade Xero, incluindo gerenciamento de faturas, contatos, pagamentos, transações bancárias e plano de contas para contabilidade de pequenas empresas.

Documentação do Toolkit: composio.dev/toolkits/xero

Configuração

Esta habilidade requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que existe uma conexão ativa para o toolkit xero. Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Multi-tenant: Se você gerencia várias organizações Xero, primeiro chame XERO_GET_CONNECTIONS para listar os tenants ativos e obter o tenant_id correto para chamadas subsequentes.

Fluxos de Trabalho Principais

1. Listar e Filtrar Faturas

Recupere faturas com filtragem por status, contato, intervalo de datas e paginação.

Ferramenta: XERO_LIST_INVOICES

Parâmetros Principais:

• Statuses -- Filtro de status separado por vírgula: "DRAFT", "SUBMITTED", "AUTHORISED", "PAID"
• ContactIDs -- IDs de Contato separados por vírgula para filtrar
• InvoiceIDs -- IDs de Fatura separados por vírgula para filtrar
• where -- Filtro no estilo OData, por exemplo, "Status==\"AUTHORISED\" AND Total>100"
• order -- Expressão de ordenação, por exemplo, "Date DESC", "InvoiceNumber ASC"
• page -- Número da página para paginação
• If-Modified-Since -- Timestamp UTC; retorna apenas faturas modificadas desde esta data
• tenant_id -- ID da organização Xero (usa o primeiro tenant se omitido)

Exemplo:

Tool: XERO_LIST_INVOICES
Arguments:
  Statuses: "AUTHORISED,PAID"
  order: "Date DESC"
  page: 1

2. Gerenciar Contatos

Recupere e pesquise contatos para uso em faturas e transações.

Ferramenta: XERO_GET_CONTACTS

Parâmetros Principais:

• searchTerm -- Pesquisa insensível a maiúsculas e minúsculas em Nome, PrimeiroNome, Sobrenome, Email, NumeroContato
• ContactID -- Busca um único contato por ID
• where -- Filtro OData, por exemplo, "ContactStatus==\"ACTIVE\""
• page, pageSize -- Controles de paginação
• order -- Ordenação, por exemplo, "UpdatedDateUTC DESC"
• includeArchived -- Inclui contatos arquivados quando true
• summaryOnly -- Resposta leve quando true

Exemplo:

Tool: XERO_GET_CONTACTS
Arguments:
  searchTerm: "acme"
  page: 1
  pageSize: 25

Nota: Em contas com alto volume, alguns filtros where (por exemplo, IsCustomer, IsSupplier) podem ser rejeitados pelo Xero. Volte para searchTerm ou paginação.

3. Criar Pagamentos

Vincule uma fatura a uma conta bancária criando um registro de pagamento.

Ferramenta: XERO_CREATE_PAYMENT

Parâmetros Principais:

• InvoiceID (obrigatório) -- ID da Fatura Xero à qual o pagamento se aplica
• AccountID (obrigatório) -- ID da conta bancária para o pagamento
• Amount (obrigatório) -- Valor do pagamento (número)
• Date -- Data do pagamento no formato YYYY-MM-DD
• Reference -- Referência ou descrição do pagamento
• CurrencyRate -- Taxa de câmbio para pagamentos em moeda estrangeira

Exemplo:

Tool: XERO_CREATE_PAYMENT
Arguments:
  InvoiceID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  AccountID: "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  Amount: 1500.00
  Date: "2026-02-11"
  Reference: "Payment for INV-0042"

4. Criar Transações Bancárias

Registre despesas (pagamentos efetuados) ou recebimentos (dinheiro recebido) em transações bancárias.

Ferramenta: XERO_CREATE_BANK_TRANSACTION

Parâmetros Principais:

• Type (obrigatório) -- "SPEND" (pagamento efetuado) ou "RECEIVE" (dinheiro recebido)
• ContactID (obrigatório) -- ID do Contato Xero
• BankAccountCode (obrigatório) -- Código da conta bancária do plano de contas
• LineItems (obrigatório) -- Array de itens de linha, cada um com:
  • Description (obrigatório) -- Descrição do item de linha
  • UnitAmount (obrigatório) -- Preço unitário
  • AccountCode (obrigatório) -- Código da conta para categorização
  • Quantity -- Quantidade (padrão 1)
  • TaxType -- Tipo de imposto: "OUTPUT", "INPUT", "NONE"
• Date -- Data da transação no formato YYYY-MM-DD
• Reference -- Referência da transação
• Status -- "AUTHORISED" ou "DELETED"
• CurrencyCode -- por exemplo, "USD", "EUR"

Exemplo:

Tool: XERO_CREATE_BANK_TRANSACTION
Arguments:
  Type: "SPEND"
  ContactID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  BankAccountCode: "090"
  LineItems: [
    {
      "Description": "Office supplies",
      "UnitAmount": 75.00,
      "AccountCode": "429",
      "Quantity": 1,
      "TaxType": "INPUT"
    }
  ]
  Date: "2026-02-11"
  Reference: "Feb office supplies"

5. Listar Pagamentos e Transações Bancárias

Revise pagamentos existentes e histórico de transações bancárias.

Ferramentas:

…