Ligar ao Sage Intacct

Ligue o PlaidCloud ao Sage Intacct e extraia dados financeiros e contabilísticos. Este guia leva-o das credenciais de Web Services até uma extração funcional. Para a referência de campos, consulte o conector REST Sage Intacct.

Pré-requisitos

No Sage Intacct, é necessário:

• Web Services ativados para a sua empresa — o suporte da Sage disponibiliza o seu Sender ID e a palavra-passe do remetente, que passam a ser o ID do cliente e o Segredo do cliente da ligação.
• Um utilizador de serviço Web para o PlaidCloud, com permissões sobre todos os objetos que as suas consultas vão ler.
• O seu ID da empresa.

Registe o ID da empresa, o Nome de utilizador do utilizador de serviço Web, o ID do cliente (Sender ID) e o Segredo do cliente (palavra-passe do remetente) antes de começar.

Cuidado

O ID do cliente/Segredo do cliente e o Nome de utilizador do utilizador de serviço Web são distintos. O ID do cliente/Segredo do cliente autenticam a aplicação perante a Sage; o Nome de utilizador do utilizador de serviço Web, combinado com o ID da empresa, autentica o início de sessão na sua empresa. Os três são obrigatórios e o ID do cliente/Segredo do cliente são segredos.

Criar a Ligação

O Intacct é uma ligação da família REST. O PlaidCloud disponibiliza uma variante Intacct dedicada (apresentada como REST - Intacct) que preenche previamente o endpoint de token OAuth2 e recolhe apenas os quatro campos de credenciais abaixo; internamente, é uma ligação REST que se autentica com credenciais de cliente OAuth2 na API REST do Intacct.

1. Abra Tools > Connections e clique em New Connection.

2. Em REST, escolha Intacct (apresentado no menu como REST - Intacct).

3. Preencha os campos:

   Campo	Valor
   Nome	Um nome intuitivo, por exemplo Intacct Prod.
   ID do cliente	O Sender ID do seu Intacct.
   Segredo do cliente	A palavra-passe do remetente do seu Intacct.
   Nome de utilizador do utilizador de serviço Web	O início de sessão do utilizador de Web Services.
   ID da empresa	A empresa Intacct à qual está a ligar.

4. Clique em Create.

Testar a Ligação

Confirme que as credenciais funcionam antes de construir sobre elas.

1. Adicione um passo Pedido REST a um fluxo de trabalho e defina Ligação com a sua ligação Sage Intacct.

2. Aponte-o para uma leitura pequena e delimitada de um objeto que o seu utilizador consiga ver.

3. Clique em Enviar pedido de teste.

Cuidado

Utilize Enviar pedido de teste, não o separador de pré-visualização. Um resultado verde significa que o ID do cliente/Segredo do cliente e o Nome de utilizador do utilizador de serviço Web foram ambos autenticados. Se falhar, a mensagem inclui o detalhe da própria Sage — normalmente uma falta de permissões do utilizador de Web Services ou um ID do cliente/Segredo do cliente incorreto.

Nota

Os pedidos ao Sage Intacct são de pedido único — não há paginação para configurar. Deixe os controlos de paginação como estão.

Extrair Dados

Para extrações de rotina, o Sage Intacct dispõe de passos de importação dedicados que mapeiam diretamente para objetos do Intacct:

• Import Sage AP — cabeçalhos de faturas de contas a pagar
• Import Sage AP Lines — detalhe de linhas de faturas de contas a pagar
• Import Sage Intacct Query — uma consulta a qualquer objeto do Intacct
• Import Intacct Entity — detalhe do razão geral, saldos de contas, lançamentos de diário e dimensões mestre (localização, departamento, classe), e documentos de encomendas de venda, com paginação readMore automática para grandes conjuntos de resultados e filtros de intervalo ge/le

Escolha o passo, selecione a sua ligação Sage Intacct, defina o objeto ou a consulta e execute-o. Tal como em qualquer importação, defina as colunas de montantes e de datas com os tipos reais, para que cheguem com tipo em vez de texto.

Verificar e Agendar

1. Execute o passo e verifique a tabela de destino — contagens de linhas e tipos de colunas.

2. Para um alimentador contínuo, agende o fluxo de trabalho.

Resolução de Problemas

Sintoma	Causa provável
Falha de autenticação	Um ID do cliente/Segredo do cliente incorreto (disponibilizado pela Sage) ou um Nome de utilizador do utilizador de serviço Web incorreto.
Erro de permissão / objeto não encontrado	O utilizador de Web Services não tem permissão sobre o objeto que está a ser lido.
Resultado vazio ou inesperado	Um ID da empresa incorreto.

Relacionado

• Analisar as finanças do Sage Intacct — tutorial para o primeiro dia: extraia um balancete e transforme-o numa demonstração de resultados departamental num painel de controlo.
• Conector REST Sage Intacct — referência de campos.
• Passo Pedido REST
• Criar e gerir uma ligação