TOTVS Logística Recintos Aduaneiros

Árvore de páginas

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;