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:
Código do Evento | Descrição do Evento |
|---|---|
| RDO | Requisição de Pessoal |
| ADM | Admissão de Pessoal |
| CNC | Cancelamento de Requisição de Pessoal |
| TRF | Transferência de Pessoal |
| TRV | Transferência de Pessoal com Mudança no Orçamento |
| CAR | Inclusão /Alteração de Cargos |
| MPO | Mudança de Posição |
| MPV | Mudança de Posição com Mudança no Orçamento |
| PRO | Promoção |
| AUM | Aumento Salarial |
| DES | Desligamento de Pessoal |
| ENQ | Enquadramento Salarial |
| FER | FER Simulação de Férias |
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.