Objetivo

Exemplificar o cadastro de um layout EDI DEPOT.

Instalando e configurando o serviço para execução

1. Instalar o Serviço

   O executável para instalação se encontra na pasta de arquivos executáveis do SARA, executar o comando conforme imagem abaixo;

   
   

   
   

2. Configurar o registro do serviço

   No (Regedit) Registro do Windows, caminho HKEY_LOCAL_MACHINE/SYSTEM/ControlSet001/services/SARA_EdiDepot_Servico, configurar os itens obrigatórios abaixo:
   Arquivo ini: Arquivo ini de configuração com o banco de dados do SARA;
   Usuário e senha do banco de dados (User sa);
   Intervalo: Período em minutos que para o serviço gerar os arquivos

   

   
   

3. Iniciando serviço - Após a instalação do serviço, iniciar a execução do serviço;
   Executar (Windows + R) “Services.msc”, pesquisar pelo serviço instalado SARA – EDI DEPOT e inicia-lo;
   

Criando um layout EDI

1. Versão arquivo x armador

   No módulo Sistema acessar a tela Versão arquivo x armador (configuração)
   
   
   Clicar em Inserir;
   Em versão do arquivo, escolher a opção de desejada, os EDI podem ser de Gate in, Gate out, Estimativa, Reparo, entre outros, no exemplo abaixo foi selecionado o Gate-In:

   

   
   

   Em Armador, selecionar o armador que utilizara esse layout:

   
   
   

   Inserir as demais informações conforme abaixo:
   Intervalo de tempo: Tempo para verificar e processar arquivos;
   Diretório onde será gerado o Arquivo principal, o Backup e o Log de erro;

   Extensão do arquivo: Essa informação deve ser verificada com o armador (o arquivo é tipo texto independente da extensão cadastrada, no nosso exemplo a extensão é TXT);
   

2. Grupo
   Acessar a tela de Grupos, em Configuração arquivo/cliente pesquisar o item “Versão arquivo x armador” criado:
   
   
   

   Selecionar um grupo pai, se houver;
   Selecionar o tipo de grupo: Cabeçalho; Grupo; Rodapé etc;

   
   
   Inserir uma descrição do grupo e clicar em gravar;
   
   
   
3. Linha
   Acessar a tela de “Linha”;
   
   
   Clicar no botão para selecionar o Armador;
   
   
   Selecionar o Armador cadastrado;
   
   
   

   Selecionar o grupo cadastrado e clicar em Inserir;

   
   
   Inserir o Identificador de Linha, uma Descrição e se é Linha dinâmica ou não;

   Breve descrição do que se trata o campo: Essa informação não aparece no arquivo EDI;
   Linha Dinâmica: Se marcado, habilita o campo abaixo para a inclusão de um script sql, existe ainda a opção de incluir os parâmetros do código do armador e/ou mcnt_id;
   Exemplo de Linha Dinâmica:
   

   

   Identificador: Essa informação pode ser verificada no PDF anexo, para cada armador deve ser consultada a documentação própria:
   
   

   • Inserir a Descrição do campo;
   • Tipo de separador;
   • Tipo de valor, fixo, linha dinâmica ou outro.
   O valor do campo, se fixo, o quer estiver nesse campo será mostrado no arquivo sem alteração (exatamente como escrito no campo), se for dinâmico, habilitará o botão para escolha de um dos campos que o script retorna.

   

   
   

   Exemplo com linha dinâmica
   Inserir a Descrição, selecionar o tipo de campo, selecionar o tipo “Valor de linha dinâmica”, e clicar no botão Buscar Campo Linha;

   
   
   Será aberta uma caixa com os campos retornados do script SQL configurado;
   
   
   Selecionar qual a informação desejada e clicar em “Selecionar”;
   
   
   A informação selecionada será mostrada no campo Valor, clicar em Gravar;
   
   
   

   Dessa forma, nossa primeira linha foi configurada com duas informações fixas e uma informação dinâmica, ficando assim no arquivo EDI:

   
   
   

   Onde:
   UNB é o identificador da Linha: Cada linha do arquivo possui um identificador que possui 3 caracteres;
   +INFORMACAOFIXA: + (Mais) é o separador de campo e INFORMACAOFIXA, é o primeiro campo configurado como informação fixa;
   :SEPARADORSUBCAMPO: : (dois pontos) é o separador de subcampo e SEPARADORSUBCAMPO é a informação fixa configurada para o segundo campo;

   
   

4. Campo
   Acessar a tela Campo;
   
   
   Clicar no botão para selecionar o Armador;
   
   
   Depois selecionar a linha que será configurada e clicar em Inserir:
   
   
   

5. Importando um layout pronto (layout genérico);

   Criar o arquivo para um novo armador; Clicar no botão Importar

     
   
   Selecionar de qual layout deseja efetuar a cópia e clicar em Copiar layout de EDI;
   
   
   O armador Grimaldi Lines possui o layout importado igual ao armador Beneficiário Genérico;
   
   
   

   Os EDI´s importados devem ser alterados conforme as necessidades de cliente.

Exportação/Importação Layout via JSON

1. Módulo Sistema - Acessar a tela para exportar/importar Layouts EDI DEPOT de modelos prontos;

   No menu DEPOT/EDIFACT/Versão arquivo x armador (Configuração)/Importar/Exportar JSON de EDI;

   
   Exportação
   
   

   
   

2. Na parte de exportação, clicar na lupa para pesquisar um layout pronto que será usado como modelo para ser exportado, selecione um registro;
   
   
   
3. Clicar no botão Gerar JSON do EDI para gerar os dados, as informações podem ser verificadas na tela;
   
   
   
4. Clicar no botão Exportar JSON para o arquivo para criar o arquivo em formato JSON e salvar no computador;
   Será sugerido o nome para salvar o arquivo como EDIConfig.json, esse nome de arquivo pode ser alterado por outro qualquer, porém para ser possível a importação, não se deve alterar a extensão do arquivo;
   
   
   

5. Módulo Sistema - Acessar a tela para exportar/importar Layouts EDI DEPOT de modelos prontos;

   No menu DEPOT/EDIFACT/Versão arquivo x armador (Configuração)/Importar/Exportar JSON de EDI;

   
   Importação
   
   
   
6. Na parte de importação, clicar no botão Abrir Arquivo JSON de EDI;
   
   
   
7. Selecionar o arquivo para importação, será carregada as informações do Json na tela;
   
   
   
8. Clicar no botão Importar JSON para o SARA;
   
   
9. O Layout EDI DEPOT foi importado com sucesso com as informações do modelo exportado e com Armador genérico;
   Necessário entrar na configuração do Layout EDI e editar os dados conforme as orientações do Armador e as configurações básicas do cliente, como local de geração do arquivo e outras configurações básicas;