Acesso ao Xero para o Data Foundation

O Data Foundation reúne os dados de todos os sistemas ERP e de contabilidade que ligar, em tantas instâncias quantas tiver, num único Common Finance Model. O Xero é um dos sistemas que lê diretamente, uma organização Xero por ligação. Esta página destina-se ao administrador do Xero que configura o acesso e ao utilizador do PlaidCloud que lho pede.

O PlaidCloud só lê dados. Ninguém envia uma palavra-passe por email.

Enviar o pedido de acesso

No separador Base do projeto, escolha Criar uma nova ligação e selecione Xero. O formulário mostra o pedido completo. Clique em Copiar pedido para o colar na sua própria mensagem, ou em Enviar pedido por email para o abrir no seu programa de correio com o assunto “Read-only Xero access for PlaidCloud.”

O que o administrador do Xero configura

1. Autorizar a aplicação Xero do PlaidCloud para cada organização sobre a qual reporta, com sessão iniciada como um utilizador com a função Standard ou Advanced. A aplicação pede apenas acesso de leitura:

   Âmbito	O que abrange
   accounting.settings.read	Organização, plano de contas, categorias de acompanhamento, artigos
   accounting.contacts.read	Clientes
   accounting.transactions.read	Faturas de venda e notas de crédito
   accounting.journals.read	O razão geral: todos os diários lançados
   accounting.reports.read	O balancete, para os saldos de abertura

   Sem accounting.journals.read, o razão geral não pode ser carregado. O plano de contas, os departamentos, os clientes e os produtos continuam a ser carregados.

2. Configurar as categorias de acompanhamento que o PlaidCloud lê, com estes nomes:

   • Department: uma opção por departamento, com o nome com que pretende que o respetivo código apareça.
   • Intercompany: uma opção por empresa do grupo, com o nome do código de entidade dessa empresa, nas linhas dos diários intercompanhia. Dê às contas intercompanhia nomes em que “Intercompany” faça parte do nome da conta.

O que enviar de volta

O administrador envia	Introduzido no PlaidCloud como
O ID do inquilino da organização (o Xero lista-o na ligação, ou em GET /connections)	Organisation (tenant) ID
Confirmação de que o fim do exercício financeiro e a data de bloqueio de períodos da organização estão definidos	Nada a introduzir: o PlaidCloud lê ambos do Xero

O utilizador do PlaidCloud cola por si próprio o Refresh token; é um segredo e nunca é enviado por email. Escolhe também a Organização com que a ligação é carregada.

Em System settings, Retained earnings account indica a conta de Capital próprio (Equity) em que a demonstração de resultados de abertura é agregada, quando os nomes das contas ainda não o dizem. É opcional.

Verificar o acesso

De volta ao PlaidCloud, clique em Testar ligação. Cada conjunto de dados aparece como Legível, Permissão em falta ou Erro:

Conjunto de dados	Âmbito de que necessita
Entidades	accounting.settings.read
Plano de contas	accounting.settings.read
Departamentos	accounting.settings.read (a categoria de acompanhamento Department)
Produtos	accounting.settings.read
Calendário fiscal	accounting.settings.read
Clientes	accounting.contacts.read
Razão geral	accounting.journals.read
Balancete	accounting.reports.read
Linhas de vendas (opcional)	accounting.transactions.read
Orçamento (opcional)	accounting.reports.read

Quando um conjunto de dados mostra Permissão em falta, o teste indica o âmbito a conceder. Autorize novamente a aplicação com ele e teste novamente. Uma organização Xero sem faturas de venda ou orçamentos carrega na mesma tudo o resto.

As taxas de câmbio não fazem parte deste acesso: o Xero não as publica. Forneça-as, em alternativa, num ficheiro de Taxas de câmbio.

Relacionados

• Data Foundation
• Ligar ao Xero