Etapa ERP

A etapa ERP conecta o fluxo de preparação de dados diretamente ao seu ERP e extrai relatórios prontos — balancetes, títulos, cadastros — pelas APIs oficiais do sistema, sem exportação manual de arquivos. Use quando o dado que você precisa estiver disponível nos relatórios do conector nativo. A ERP fica na categoria Fonte de Dados da barra de ferramentas e está disponível nos processos Turbo AI.

Você seleciona o ERP, informa uma credencial, escolhe o relatório e preenche os filtros de negócio — a plataforma cuida do resto: autenticação, chamadas à API, paginação e parâmetros técnicos são gerenciados automaticamente. A cada execução do processo, os dados são buscados novamente no ERP, com os filtros de data preenchidos a partir da data de referência.

Os ERPs disponíveis são: SAP S/4HANA, SAP Business One, Microsoft Dynamics 365 Finance & Operations, Microsoft Dynamics 365 Business Central, Oracle NetSuite, Oracle E-Business Suite e Sankhya. Outros conectores aparecem na lista com a indicação Em breve e ainda não podem ser configurados.

Antes de começar: acessos e segurança no lado do ERP

Esta preparação normalmente envolve o time que administra o ERP e a segurança da informação da sua empresa. Antes de tudo, vale conhecer o modelo de segurança da integração:

• Sentido único, de saída da plataforma: é a Dattos que chama a API do ERP — o ERP não precisa iniciar nenhuma conexão nem instalar nada.

• Somente leitura: a etapa apenas consulta os relatórios selecionados. Nenhum dado é gravado ou alterado no ERP.

• Sempre por HTTPS: toda a comunicação é criptografada em trânsito.

• Credenciais protegidas: os campos sensíveis (senhas, segredos, tokens) são criptografados no armazenamento e mascarados na interface; perfis de privacidade controlam quem pode usar cada credencial; e o acesso é revogável a qualquer momento — inativando a credencial na plataforma ou desativando o usuário de integração no próprio ERP.

O que o time do ERP precisa liberar:

• Usuário/aplicativo de integração dedicado: uma conta exclusiva para a integração (não a conta de uma pessoa), com perfil somente de leitura, restrito às entidades dos relatórios que serão consumidos.

• API do ERP habilitada: o serviço de API usado pela integração precisa estar ativo — por exemplo, os serviços OData no SAP S/4HANA e o Service Layer no SAP Business One.

• Acesso de rede à API: a plataforma precisa alcançar o endpoint da API. Sistemas em nuvem (Dynamics 365, NetSuite, Sankhya W) já são acessíveis pela internet; sistemas na rede interna (SAP on-premise, middleware do Oracle EBS) exigem liberação no firewall ou VPN/VPC — acione o suporte da Dattos para configurar a opção adequada.

• Credenciais geradas e entregues com segurança: as chaves e senhas do usuário de integração são o que você cadastra na plataforma.

O que preparar em cada ERP (o artigo de cada conector detalha o passo a passo e todos os campos):

• SAP S/4HANA: usuário de integração com autorização nos objetos das APIs OData utilizadas (ex.: /IWFND/ e /IWBEP/). Autenticação por login básico SAP ou OAuth 2.0.

• SAP Business One: usuário de integração dedicado com permissão nas entidades consultadas, via Service Layer (usuário e senha).

• Dynamics 365 Finance & Operations: aplicativo registrado no Azure AD com a permissão Dynamics ERP - Runtime Service, autorizado como usuário de integração no ambiente.

• Dynamics 365 Business Central: aplicativo registrado no Azure AD com permissão API.ReadWrite.All, autorizado em Configurações > Permissões de API do Business Central. O nome do escopo é o padrão da Microsoft — a integração executa apenas leituras.

• Oracle NetSuite: integração com Token-Based Authentication (TBA) habilitado e access token gerado para o usuário de integração.

• Oracle E-Business Suite: camada intermediária de integração (ex.: Oracle Integration Cloud) expondo os dados do EBS via REST, com usuário e senha do servidor de integração.

• Sankhya: aplicativo criado no portal Sankhya W (Configurações > Integrações > Aplicativos), com permissão nas entidades consultadas.

Como configurar

A configuração abre em tela cheia, em dois passos.

Passo 1 — Conexão

• Selecione o ERP: escolha o conector na lista de ERPs disponíveis.

• Credencial: selecione uma credencial já cadastrada ou clique em + Adicionar credencial ERP para cadastrar uma nova, com os dados preparados no lado do ERP. Os campos variam por ERP.

• Próxima Etapa: ao avançar, a plataforma valida a autenticação com o ERP. Se algo estiver errado, você verá o aviso "Falha na autenticação. Verifique a credencial e tente novamente."

Passo 2 — Configuração

• Relatório: selecione o relatório na lista, organizada por módulo de negócio (Contabilidade, Contas a Pagar, Vendas, entre outros).

• Parâmetros: preencha os filtros do relatório (empresa, período, status). Só parâmetros de negócio aparecem aqui — os parâmetros técnicos da API são gerenciados automaticamente.

• Registros de Amostra: quantidade de registros trazida para a amostra de dados durante a construção do fluxo.

• Finalizar: salva a etapa. Depois, conecte a saída dela às próximas etapas do fluxo, como qualquer outra fonte de dados.

Parâmetros de data marcados como preenchidos automaticamente usam a data de referência da execução — por exemplo, ano e mês fiscais, primeiro e último dia do mês. Isso torna o processo recorrente sem ajuste manual: a cada fechamento, a execução busca o período correto. Você pode sobrescrever os valores quando precisar de um período específico.

Exemplo de utilização

Um time contábil precisa do balancete do SAP S/4HANA todo mês. Na etapa ERP, seleciona o SAP S/4HANA e a credencial de integração, escolhe o relatório Saldo Contábil (Balancete) no módulo Contabilidade e mantém os parâmetros de período preenchidos automaticamente pela data de referência. A cada execução mensal do processo, o balancete do mês de competência chega ao fluxo sem nenhuma exportação manual — pronto para alimentar uma conciliação ou uma análise.

Boas práticas

• Volume de dados: as integrações nativas são chamadas de API encapsuladas — o desempenho e o volume suportado dependem dos limites da API de cada ERP. Para extrações muito volumosas, prefira a etapa Banco de Dados ou a troca de arquivos.

• Relatório indisponível no conector: as etapas API Rest e Banco de Dados obtêm dados de qualquer sistema que disponibilize API ou acesso SQL.

• Erro de autorização no relatório: verifique com o time do ERP se o usuário de integração tem permissão nas entidades daquele relatório específico.

Artigos relacionados

• Introdução às integrações

• Integração ERP: SAP S/4HANA · SAP Business One · Dynamics 365 Finance & Operations · Dynamics 365 Business Central · Oracle NetSuite · Oracle E-Business Suite · Sankhya

• Etapa API Rest

• Etapa Banco de Dados