TOTVS Logística Recintos Aduaneiros

Árvore de páginas


01. DADOS GERAIS

Produto:

TOTVS Logística Recintos Aduaneiros

Linha de Produto:

Linha Logix

Segmento:

Logística

Módulo:Serviço de Integração - Recintos Aduaneiros
Função:Serviço de Notificação da Integração do Pré-Cadastro
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :

DLOGPORTOS-17270


02. SITUAÇÃO/REQUISITO

Atualmente os clientes do Totvs Logística Recintos Aduaneiros utilizam o SYNC, produto desenvolvido pela FSW Totvs, para automatizar o registro de documentos no pré-cadastro. O sistema considera uma imagem do MANTRA a partir da qual se faz o filtro das informações para o cadastro dos documentos.

Com a entrada do CCT de importação modal aéreo, o IATA e a RFB passam a disponibilizar API´s para que os recintos possam buscar as informações quando a carga ainda está sobre nuvem e, antecipar seus processos internos e assim, gerenciar suas necessidades e trazer mais fluidez ao processo.

As API´s de consulta de viagem e consulta de conhecimento de carga permitem fazer a busca das informações e após isto, pode-se utilizar o serviço de notificação de push e, para tanto, deve-se prever um serviço que "escute" as notificações e atualize as informações.

https://api-docs.portalunico.siscomex.gov.br/swagger/ccta.html

Considerando que as informações da viagem são disponibilizadas com antecedência, as mesmas podem sofrer alterações que podem influenciar os processos em andamento dentro do TOTVS Logística Recintos Aduaneiros e demandar retificações da API Recintos ou mesmo do CCT aéreo. Assim, deve-se observar os eventuais impactos e necessidades adicionais para garantir que todas as informações transmitidas e registradas no sistema estejam corretas.  Neste sentido, avaliar a viabilidade de rastrear as retificações decorrentes destas alterações para efeito de auditoria.

03. SOLUÇÃO

A solução, um módulo para o servidor web Apache, deve ser instalado e configurado em servidor com acesso externo para o consumo da API pelo sistema de notificação do Siscomex.

  1. Sistema operacional Microsoft Windows Server 2012 64 bits ou superior;
  2. 25MB de espaço em disco;
  3. Apache Server 2.4 para ambientes Windows 64 bits;
  4. REDIS 5.0.14 ou superior para ambientes Windows 64 bits.

Nota: Tanto o servidor web Apache quanto o servidor de banco de dados REDIS devem ser instalados previamente. Para mais informações sobre como instalar cada um destes requisitos, consulte a seção Demais Informações deste documento.

Para a instalação da solução, basta copiar o módulo mod_ccta_push_v1.so para o diretório modules do Apache e incluir no arquivo conf\httpd.conf as configurações do módulo, como segue:

LoadModule ccta_push_v1_module modules/mod_ccta_push_v1.so
<Location /api/sara/pushservice/v1>
   SetHandler mod_ccta_push_v1-handler
</Location>

Configurar o módulo através de um arquivo de configuração com o nome "ccta_push_v1.conf", na pasta "C:\TOTVS\SARA\etc\", como segue:

Hostname=HostSQLServerSARA  (Host do Servidor SQL Server com o banco de dados do SARA)
DriverID=MSSQL
Port=1433
Database=sara_db
Username=usuario_push  (usuário para login no banco)
Password=senha_usuario_push (senha para login no banco)
CharSet=SQL_Latin1_General_CP1_CI_AS
ChaveSecreta=palavra_passe_para_push (chave string para validação das mensagens de notificação enviadas pela Siscomex, conforme orientação da documentação do serviço)

Após efetuada a configuração dos parâmetros de operação do serviço, basta acessar o gestor de serviços do servidor e comandar a inicialização da instância do servidor Apache.


04. DEMAIS INFORMAÇÕES

Para uma perfeita integração com o sistema TOTVS Recintos Aduaneiros, este deve estar em sua versão 12.1.2311 ou superior.

Sobre o Apache para Windows: https://simplificandoredes.com/instalar-apache-em-windows/

Sobre o REDIS para Windows: https://github.com/tporadowski/redis/releases