Senior eDocs
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
- Faça login na plataforma Fluid.
- 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
- 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.
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.