INTEGRAÇÃO SARA X DTE ABTRA 

Contexto de negócio (Introdução)

Os recintos alfandegados integrados ao porto de Santos devem utilizar o sistema DTE (Declaração de Transferência Eletrônica), criado e mantido pela ABTRA(Associação de Terminais e Recintos Alfandegados) com apoio da alfândega da Receita Federal do Porto de Santos, e que tem como objetivo principal acompanhar e controlar a transferência dos contêineres e de carga geral de importação que passam pelo Porto de Santos.

Sistemas Envolvidos

• SARA
• Sistema DTE ABTRA

Integração 

Cada etapa operacional executada no recinto alfandegado relacionada a contêineres e carga é considerado um evento e deve ser cadastrado no sistema DTE.  

Para evitar a necessidade de realizar a digitação dos mesmos dados em dois sistemas distintos, o sistema DTE proporciona a integração via arquivos eletrônicos com estrutura pré-definida.

O Sistema SARA está preparado para realizar esta integração.

Escopo

Após cadastrar uma operação no sistema SARA que possui um evento equivalente no sistema DTE, é disparada uma solicitação ao modulo EDI para geração do arquivo em uma pasta definida. O modulo EDI que deve estar sempre ativo no servidor, realiza a geração do arquivo de forma automática.

O Sistema DTE por sua vez, processa o arquivo gerado pelo sistema SARA e posteriormente cria um arquivo de retorno contendo o status do processamento do arquivo.

O modulo EDI periodicamente processa os arquivos de retorno e disponibiliza as informações no modulo ABTRA que também permite configurar o sistema para repetir a geração de arquivos.

Eventos:

É necessária a importação dos processos para Integração do módulo Gestão de Quadro de Pessoal do HCM com o ECM. É necessário importar os processos:

Instalação/Atualização

SARA

Parâmetros do sistema:

• UNIDADE_ENVIA_DADOS_ABTRA : Parâmetro que indica a integração com o sistema DTE ABTRA. Deve estar configurado com o valor S.
• EDI_DIRETORIO_SAIDA :  Diretório onde os arquivos que serão importados pelo sistema DTE ABTRA são gerados.
• EDI_DIRETORIO_SAIDA_BKP :  Diretório de backup dos arquivos gerados.
• EDI_DIRETORIO_ENTRADA : Diretório onde o sistema DTE ABTRA deve gravar os arquivos de retorno.
• EDI_DIRETORIO_ENTRADA_BKP : Diretório de backup dos arquivos de retorno processados com sucesso.
• EDI_DIRETORIO_LOG : Diretório onde são armazenados o log de erros na geração / importação de arquivos.
• EDI_DIRETORIO_ENTRADA_NAOLIDO : Diretório onde são movidos os arquivos que não eram esperados na pasta entrada.
• EDI_DIRETORIO_ENTRADA_ERRO : Diretório onde ficam os arquivos de retorno que não foram processados devido a erros.
• EDI_DIRETORIO_SAIDA_FAT : Diretório onde ficam os arquivos de faturamento gerados pelo modulo EDI.
  
  

Configuração dos eventos:

• A configuração dos eventos que devem ser gerados na integração com o sistema DTE ABTRA deve ser realizada de maneira manual no banco de dados do sistema SARA, inserindo o código do evento, descrição do evento e extensão do arquivo na tabela tab_abtra_evento.
  
  

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

• Identificar o funcionamento da integração;
• Identificar a ocorrências de problemas;
• Coletar evidências do mau funcionamento relatado pelo cliente;
• Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos