---
title: Senior eDocs
slug: senior-edocs
docTags: 
createdAt: 2024-01-22T17:28:52.672Z
---

## Resumo

O conector e-Docs foi desenvolvido para integrar a API de e-Docs da Senior com a Fluid API, proporcionando uma interface simplificada para manipulação de documentos fiscais eletrônicos. Este documento descreve os passos necessários para configurar e utilizar o conector, alinhando-se aos padrões estabelecidos pela documentação da Fluid.

## 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. Criar 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.

![image.png](https://prod-files-secure.s3.us-west-2.amazonaws.com/759152ae-96cd-4952-93c3-57c520687cc9/429e38c4-074c-4ec0-b7ca-e9de0f51ce8c/image.png "image.png")

### 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.

- **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.

### 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`).

A URL final para o Web Service terá o formato para Cloud:

A URL final para o Web Service terá o formato para On-Premise:

### 7. 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.

### 8. 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

### Operações disponíveis

O conector implementa as seguintes funcionalidades principais:

### 1. Baixar PDF

- **Descrição**: Recupera a representação em PDF de um documento fiscal.
- **Parâmetros**:
  - `Int32`: Tipo do documento que se deseja obter o PDF.
  - `String`: Chave do documento que se deseja obter o PDF.
  - `Int32`: Tipo de processamento do documento que se deseja obter o PDF (1 - emissão e 2 - recebimento).
  - `String`: Adicionais, indica que PDFs adicionais se deseja gerar além do documento.

### 2. Baixar XML

- **Descrição**: Recupera a representação XML de um documento fiscal.
- **Parâmetros**:
  - `Int32`: Tipo do documento que se deseja obter o PDF.
  - `String`: Chave do documento que se deseja obter o PDF.

### 3. Consultar retorno de recebimento

- **Descrição**: Consulta o status de envio e processamento de documentos.
- **Parâmetros**:
  - `Int32`: Tipo do documento que se deseja obter o PDF.
  - `Int64`: Documento Filial, CNPJ/CPF da filial vinculada aos documentos que se deseja consultar.

## Conclusão

O conector e-Docs da Senior foi desenvolvido para atender às necessidades de automação e gestão de documentos fiscais eletrônicos, integrando funcionalidades críticas da API SOAP da Senior em uma interface simplificada e alinhada aos padrões da Fluid API. Com suporte à conversão de dados XML para JSON, configurações de segurança flexíveis e documentação detalhada, o conector garante facilidade de uso, eficiência operacional e conformidade fiscal. Este recurso é essencial para empresas que buscam otimizar seus processos e assegurar integração direta com as soluções da Senior.
