--- title: Senior slug: senior docTags: createdAt: 2024-01-22T17:28:52.672Z --- ## 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. :::hint{type="warning"} 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". ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/_SfgJu1tcAR8DnWTmqwiU_image.png" size="60" width="862" height="917" position="center" showCaption="false"} ### 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. Tipo de Ambiente do Cliente Defina o tipo de ambiente em que o cliente opera, indicando se utiliza uma solução On-Premise (local) ou baseada em Cloud. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/togEDrePzjbWORjIE7uzj_image.png" size="50" width="863" height="917" position="center" showCaption="false"} - **Ambiente Cloud**: Para clientes que utilizam soluções baseadas em nuvem, insira o identificador conforme o exemplo: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/y13IsuVVwG5VRxQ9d63g2_image.png) - **Ambiente On-Premise (Local)**: Para clientes que utilizam soluções locais, selecione o protocolo apropriado utilizado no ambiente On-Premise: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/YvLsJVXoUFS42jjvIkd8M_image.png) - **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. ### 6. 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 https://{identificador}.seniorcloud.com.br:{porta}/{webservice} ``` ### 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. ### 7. Ignorar validação de segurança - 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. ## 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 - Insira o Web Service desejado de acordo com a [documentação da Senior](https://documentacao.senior.com.br/gestaoempresarialerp/5.10.3/webservices/indice-web-services.htm). ### 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 ``, ``, e `` do XML, pois esses serão automaticamente preenchidos pelo conector. Exemplo de estrutura XML básica para o template: ```xml xml Copiar código Integer String Integer String Integer String ``` ### 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.