Conectores
ERP

Senior

13min

Objetivo/Resumo

O conector Senior na plataforma Fluid permite integrar sistemas externos ao ambiente Senior, facilitando a comunicação e automação de processos entre os dois sistemas. Esta integração é realizada por meio de Web Services, onde os dados são enviados e recebidos em formato XML e convertido em Json. O conector é configurado com parâmetros específicos de autenticação e criptografia para garantir segurança e controle.

A API da Senior sempre retorna o código de status HTTP 200, mesmo quando ocorre um erro. Atualmente, o conector não trata esse comportamento, portanto, é necessário verificar o conteúdo da resposta para identificar possíveis mensagens de erro da API Senior após a recepção.

Como Configurar a Conexão com Senior

1. Acessar o Painel Principal

  1. Faça login na plataforma Fluid.
  2. No painel à esquerda, vá para "Criar & Executar" > "Conexões" e clique para visualizar as opções.

2. Iniciar Nova Conexão

No canto superior direito da tela de Conexões, clique em "Nova Conexão".

3. Seleção do Tipo de Conexão

  1. Na tela de configuração, procure pela opção "Configure uma nova conexão".
  2. No menu suspenso, selecione "Senior" para iniciar a configuração específica.

4. Nome e Descrição da Conexão

  • Nome da Conexão: Insira um nome descritivo para a conexão, como "Conexão Senior ERP".
  • Descrição: Forneça uma breve descrição para ajudar na identificação e propósito da conexão.

5. Identificação do Sistema e Porta

  • Identificação do Sistema: Insira o identificador conforme o exemplo https://{identificador}.seniorcloud.com.br:{porta}.
  • Porta: Informe a porta especificada (ex.: 8080).

O URL final para o Web Service terá o formato:

CSS


6. Autenticação e Criptografia

  • Usuário: Insira o nome do usuário para autenticação, que será utilizado no corpo da requisição XML.
  • Senha: Insira a senha correspondente, também usada na autenticação XML.
  • Versão de Criptografia: Escolha a versão apropriada (normalmente utilizamos a opção “0”):
    • 0: Strings abertas com padrão "texto - utf8".
    • 1: Criptografia proprietária da Senior.
    • 2: Token de autenticação (logon integrado).
    • 3: Token do serviço de usuários G7.

Criando um Fluxo Utilizando o Conector Senior

Passo 1: Configurar o Fluxo Senior

  1. No editor de fluxo, crie um novo fluxo e arraste o conector Senior para o canvas.
  2. Com o conector selecionado, vá até a aba "Parametrizações" para configurar os campos de integração.

Passo 2: Especificar o Web Service

Passo 3: Configurar o Template de Requisição

  1. No template, utilize a estrutura XML completa do Web Service fornecida pela Senior.
  2. Remova os elementos <user>, <password>, e <encryption> do XML, pois esses serão automaticamente preenchidos pelo conector.

Exemplo de estrutura XML básica para o template:

XML


Passo 4: Verificação da Resposta da API

Como a API da Senior sempre retorna um status 200, é necessário verificar o conteúdo da resposta para identificar mensagens de erro específicas. O conector, atualmente, não realiza esse tratamento de mensagens, então é essencial incluir um passo extra no fluxo para processar o conteúdo da resposta e assegurar que não houve erro.

Conclusão

Com o conector Senior, a Fluid proporciona uma forma prática e segura de integrar sistemas externos com o ambiente Senior. Configurando a conexão e o fluxo de maneira adequada, a integração torna-se eficiente, automatizando processos e melhorando a comunicação entre sistemas, além de manter a segurança dos dados com opções de criptografia.

Updated 06 Nov 2024
Doc contributor
Doc contributor
Doc contributor
Did this page help you?