Senior
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.
- Faça login na plataforma Fluid.
- No painel à esquerda, vá para "Criar & Executar" > "Conexões" e clique para visualizar as opções.
No canto superior direito da tela de Conexões, clique em "Nova Conexão".
- Na tela de configuração, procure pela opção "Configure uma nova conexão".
- No menu suspenso, selecione "Senior" para iniciar a configuração específica.
- 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.
Defina o tipo de ambiente em que o cliente opera, indicando se utiliza uma solução On-Premise (local) ou baseada em Cloud.
- Ambiente Cloud: Para clientes que utilizam soluções baseadas em nuvem, insira o identificador conforme o exemplo:
- Ambiente On-Premise (Local): Para clientes que utilizam soluções locais, selecione o protocolo apropriado utilizado no ambiente On-Premise:
- HTTP: Utilize este protocolo se o ambiente local não possui certificados SSL/TLS configurados.
- HTTPS: Selecione este protocolo se o ambiente local possui certificados SSL/TLS devidamente configurados, garantindo uma comunicação segura.
- 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:
- 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.
- O parâmetro permite desativar a verificação de certificados SSL na conexão com os serviços da Senior. Esta opção é útil em ambientes onde a validação do certificado pode não ser necessária.
- No editor de fluxo, crie um novo fluxo e arraste o conector Senior para o canvas.
- Com o conector selecionado, vá até a aba "Parametrizações" para configurar os campos de integração.
- No template, utilize a estrutura XML completa do Web Service fornecida pela Senior.
- 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:
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.
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.
