Histórico da Página

...

Totvs custom tabs box

tabs	Instalação e Configuração, Eventos (Mensagens)
ids	instalacao,eventos

Totvs custom tabs box items

default	yes
referencia	instalacao

Guia para a instalação e configuração da integração do sistema SARA com o PUCOMEX - Módulo Recintos.

NOTA: Para instalação e configuração da integração com o Módulo Recintos, é requisito possuir a instalação do EAIService do sistema SARA. Para sua instalação consulte a documentação EAI Service | Serviço de Integração.

Componentes

Componente	Descrição
PuSiscomexRequest.bpl	Responsável pela autenticação, envio e recebimento de mensagens para o PUCOMEX \| Módulo Recintos.
MRCredenciamentoPessoa.bpl	Responsável por buscar as informações referente ao credenciamento de pessoas e gerar a mensagem JSON para envio ao PUCOMEX.
MRAcessoPessoa.bpl	Responsável por buscar as informações referente ao acesso de pessoas (entrada e saída) e gerar a mensagem JSON para envio ao PUCOMEX.
MRCredenciamentoVeiculo.bpl	Responsável por buscar as informações referente ao credenciamento de veículos e gerar a mensagem JSON para envio ao PUCOMEX.
MRAcessoVeiculo.bpl	Responsável por buscar as informações referente ao acesso de veículos (Entrada e Saída) e gerar a mensagem JSON para envio ao PUCOMEX.
MRAgendamentoVeiculo.bpl	Responsável por buscar as informações referente ao agendamento de veículos e gerar a mensagem JSON para envio ao PUCOMEX.
PuSiscomex.ini	Arquivo de configuração para a autenticação com o PUCOMEX contendo o perfil do interveniente e o caminho das chaves do certificado digital para autenticação por E-CPF ou E-CNPJ.

Instalação dos componentes

Para a instalação dos componentes basta efetuar a cópia dos arquivos mencionados acima para a pasta de instalação do serviço do EAIService.

Instalação do Open SSL

A autenticação com os serviços do sistema PUCOMEX é realizada de forma segura por autenticação SSL, portanto para que isso ocorra deverá ser instalado o pacote de drivers do OpenSSL.

Para a instalação deverá ser executado o arquivo "Win32Install_OpenSSL_Silent_Mode.bat" como administrador no servidor onde foi instalado o serviço EAIService. Este arquivo estará localizado na pasta EXECUTAVEIS do sistema SARA juntamente com o arquivo Win32OpenSSL-1_0_2q.exe.

Configuração do arquivo .INI

O arquivo PuSiscomex.INI deverá ser criado na pasta CONFIG, localizado no diretório SERVICES/Config.

Neste arquivo deverá ser configurado o perfil do interveniente e o caminho das chaves da certificação digital A1 (e-CPF ou e-CNPJ) para autenticação no PUCOMEX.

Ver a lista de perfis de intervenientes disponíveis em https://docs.portalunico.siscomex.gov.br/.

As chaves do certificado digital A1 deverão estar em arquivos no formato .PEM. Para a geração dos arquivos seguir as orientações em "Geração dos arquivos .PEM de um certificado digital".

NOTA: Atualmente a certificação digital está disponível somente no modelo A1.

Painel

title	PuSiscomex.INI

[PROFILE_E-CPF_A1]
RoleType=DEPOSIT

[CERTIFICATE_E-CPF_A1]
SiscomexCertFile=C:\TFS\SARA\Services\config\CertificadoDigital\CCT\cert.pem
SiscomexKeyFile=C:\TFS\SARA\Services\config\CertificadoDigital\CCT\privatekey.pem
SiscomexRootCertFile=C:\TFS\SARA\Services\config\CertificadoDigital\CCT\publiccert.pem

[PROFILE_E-CNPJ_A1]
RoleType=DEPOSIT

[CERTIFICATE_E-CNPJ_A1]
SiscomexCertFile=C:\TFS\SARA\Services\config\CertificadoDigital\MR\cert.pem
SiscomexKeyFile=C:\TFS\SARA\Services\config\CertificadoDigital\MR\privatekey.pem
SiscomexRootCertFile=C:\TFS\SARA\Services\config\CertificadoDigital\MR\publiccert.pem

NOTA: É possível ativar ou desativar uma ou mais mensagens de integração com o Módulo Recintos, abaixo segue alguns exemplos:

Bloco de código

language	sql
title	Ativar ou Desativar Mensagens

/*Desativar a integração de todas as mensagens do CCT*/
update tab_eai_external_application set eea_active = 1 where eea_id = 2

/*Desativar a integração da mensagem da Unitização de Carga*/
update tab_eai_transaction set et_active = 1 where eea_id = 2 and et_id = 10

Parametrização do endereço base para a integração com o PUCOMEX - Módulo Recintos

Para informar o endereço base para a integração com o PUCOMEX, basta realizar o comando SQL abaixo informando o endereço no campo eea_address_base.

Bloco de código

language	sql
title	Comando SQL

update tab_eai_external_application 
	set eea_address_base = 'https://val.portalunico.siscomex.gov.br' 
where eea_id = 2

Totvs custom tabs box items

default	no
referencia	eventos

Totvs custom tabs box

tabs	Credenciamento de Pessoas, Acesso de Pessoas, Credenciamento de Veículos, Agendamento de Veículos, Acesso de Veículos
ids	CredenciamentoPessoa,AcessoPessoa,CredenciamentoVeiculo,AgendamentoVeiculo,AcessoVeiculo

Totvs custom tabs box items

default	yes
referencia	CredenciamentoPessoa

Objetivo

Efetuar o envio das informações referente ao credenciamento de pessoas para o Módulo Recintos do PUCOMEX.

Estão previstas as operações de inclusão, retificação e cancelamento do credenciamento de pessoas.

A integração será realizada quando:

Incluir, editar ou excluir uma pessoa no registro de pessoas do sistema TLRA, antes SARA.

Independente da rotina de cadastro, a pendência para a integração será gerada por meio da trigger de insert, update ou delete vinculada a tabela "tab_pessoas".

Atualmente não existe nenhuma restrição quando ao registro de pessoas, ou seja, qualquer pessoa cadastrada no sistema TRLA deverá ser realizada a integração com o módulo recintos.

Manual da API de integração referente ao Credenciamento de Pessoas https://docs.portalunico.siscomex.gov.br/swagger/rcnt.html#/Servi%C3%A7os%20destinados%20%C3%A0%20recep%C3%A7%C3%A3o%20de%20eventos%20aduaneiros./incluir_6

Procedimento de Utilização (Sistema TLRA)

No sistema TLRA, efetuar o registro de uma pessoa por meio dos módulos controle de acesso ou portaria.
Acessar o EAIMonitor para identificar se a integração foi realizada com o módulo recintos. Em caso de dúvidas, acessar o manual técnico referente ao módulo EAI Monitor por meio do link EAI Monitor Viewer | Manual Técnico.

Totvs custom tabs box items

default	no
referencia	AcessoPessoa

Objetivo

Efetuar o envio das informações referente ao acesso de pessoas para o Módulo Recintos do PUCOMEX.

Estão previstas as operações de registro de entrada ou saída de uma pessoa do recinto de forma manual ou automática por meio de pontos de acesso eletrônicos (Catracas, Torniquetes entre outros).

A integração será realizada quando:

Efetuar uma entrada ou saída de uma pessoa do recinto aduaneiro por meio de registros no sistema TLRA, antes SARA.

Independente da rotina de registro de acesso, a integração será gerada por meio da trigger de "insert ou update" vinculada a tabela "tab_acessos".

Atualmente não existe nenhuma restrição quando ao registro de acesso de pessoas, ou seja, qualquer pessoa que entrar ou sair do recinto deverá ser realizada a integração com o módulo recintos, independe do tipo de acesso (motorista, funcionário, Fiscal da RFB, despachante entre outros.)

Manual da API de integração referente Acesso de Pessoas https://docs.portalunico.siscomex.gov.br/swagger/rcnt.html#/Servi%C3%A7os%20destinados%20%C3%A0%20recep%C3%A7%C3%A3o%20de%20eventos%20aduaneiros./incluir_3

Procedimento de Utilização (Sistema TLRA)

No sistema TLRA, efetuar o registro de um acesso para uma pessoa por meio dos módulos controle de acesso (manual) ou de forma automática por meio dos pontos de acesso eletrônicos (catracas/torniquetes entre outros.).
Acessar o EAIMonitor para identificar se a integração foi realizada com o módulo recintos. Em caso de dúvidas, acessar o manual técnico referente ao módulo EAI Monitor por meio do link EAI Monitor Viewer | Manual Técnico.

Totvs custom tabs box items

default	no
referencia	CredenciamentoVeiculo

Objetivo

Efetuar o envio das informações referente ao credenciamento de veículos (Rodoviário ou Ferroviário) para o Módulo Recintos do PUCOMEX.

Estão previstas as operações de inclusão, retificação e cancelamento do credenciamento de veículos (Rodoviário ou Ferroviário).

A integração será realizada quando:

Incluir, editar ou excluir um veículo (Rodoviário ou Ferroviário) no registro de pessoas do sistema TLRA, antes SARA.

Independente da rotina de cadastro, a pendência para a integração será gerada por meio da trigger de insert, update ou delete vinculada a tabela "tab_veiculos".

Para a geração da pendência, o registro de veículos deverá possuir as seguintes informações:

Modal deverá ser rodoviário ou ferroviário.
Para veículos rodoviários deverão ser transmitidos veículos motorizados (trator) ou semireboques.
Para veículos ferroviários deverão ser transmitidos os vagões e as locomotivas (se for o caso).
Deverá ser enviado um evento por placa credenciada.

Manual da API de integração referente ao Credenciamento de Veículos: https://docs.portalunico.siscomex.gov.br/swagger/rcnt.html#/Servi%C3%A7os%20destinados%20%C3%A0%20recep%C3%A7%C3%A3o%20de%20eventos%20aduaneiros./incluir_7

Procedimento de Utilização (Sistema TLRA)

No sistema TLRA, efetuar o registro de um veículo por meio dos módulos portaria, Portal WEB (Agendamento de veículos), ou outra rotina que efetue a inclusão de um veículo de transporte.
Acessar o EAIMonitor para identificar se a integração foi realizada com o módulo recintos. Em caso de dúvidas, acessar o manual técnico referente ao módulo EAI Monitor por meio do link EAI Monitor Viewer | Manual Técnico.

Totvs custom tabs box items

default	no
referencia	AgendamentoVeiculo

Objetivo

Efetuar o envio das informações referente ao agendamento de veículos (Rodoviário ou Ferroviário) para o Módulo Recintos do PUCOMEX.

Estão previstas as operações de inclusão, retificação e cancelamento do agendamento de veículos (Rodoviário ou Ferroviário).

A integração será realizada quando:

Efetuar a liberação de um agendamento para um veículo (Rodoviário ou Ferroviário) na rotina de liberação de agendamentos. No sistema TRLA, a liberação de agendamentos está disponível no processo de agendamento do Portal WEB, no Transit-time triagem do módulo portaria ou na API de liberação de agendamento.
Ao efetuar um estorno da liberação do agendamento, o sistema efetuará uma integração de cancelamento do agendamento. Após nova liberação será realizada a inclusão de um novo registro de agendamento.
Ao efetuar um cancelamento de um agendamento de veículos (Rodoviário ou Ferroviário), o sistema efetuará uma integração de cancelamento do agendamento.
Ao editar alguma informação de um agendamento já liberado, o sistema irá gerar uma retificação do agendamento.
Ao efetuar um estorno de um cancelamento de agendamento, o sistema efetuará novamente a integração de inclusão de um novo agendamento.

Independente da rotina de cadastro, a pendência para a integração será gerada por meio da trigger de insert, update ou delete vinculada a tabela "tab_veiculos".

Para a geração da pendência, o registro do agendamento de veículos deverá possuir as seguintes informações:

Modal deverá ser rodoviário ou ferroviário.
Deverá ser executada a rotina de liberação do agendamento.

Manual da API de integração referente ao Agendamento de Veículos: https://docs.portalunico.siscomex.gov.br/swagger/rcnt.html#/Servi%C3%A7os%20destinados%20%C3%A0%20recep%C3%A7%C3%A3o%20de%20eventos%20aduaneiros./incluir_4

Procedimento de Utilização (Sistema TLRA)

No sistema TLRA, efetuar a liberação de um agendamento de veículo. No sistema TRLA, a liberação de agendamentos está disponível no processo de agendamento do Portal WEB, no Transit-time triagem do módulo portaria ou na API de liberação de agendamento.
Acessar o EAIMonitor para identificar se a integração foi realizada com o módulo recintos. Em caso de dúvidas, acessar o manual técnico referente ao módulo EAI Monitor por meio do link EAI Monitor Viewer | Manual Técnico.

Totvs custom tabs box items

default	no
referencia	AcessoVeiculo

Objetivo

Efetuar o envio das informações referente ao acesso de veículos (Rodoviário ou Ferroviário) para o Módulo Recintos do PUCOMEX.

Estão previstas as operações de entrada e saída, retificação e cancelamento do acesso de veículos (Rodoviário ou Ferroviário).

A integração será realizada quando:

Efetuar a entrada ou a saída de veículo (rodoviário ou ferroviário) do recinto por meio do sistema TLRA, antes SARA.
Efetuar um cancelamento do CESV (Controle de entrada ou saída de veículos), desta forma o sistema irá gerar uma integração para o cancelamento do acesso.
Efetuar o fechamento de uma ordem de serviço (Descarga ou Carga) vinculada ao veículo. Desta forma o sistema efetuará a integração com a operação "Retificação" da entrada complementando as informações relacionadas a entrada do veículo.
Ao efetuar a saída de um veículo do recinto.

Independente da rotina de entrada ou saída de veículos, a pendência para a integração será gerada por meio da trigger de insert, update ou delete vinculada a tabela "tab_cesv".

Para a geração da pendência, o registro do agendamento de veículos deverá possuir as seguintes informações:

Modal deverá ser rodoviário ou ferroviário.
Deverá ser executada a rotina de liberação do agendamento.

Manual da API de integração referente ao Agendamento de Veículos: https://docs.portalunico.siscomex.gov.br/swagger/rcnt.html#/Servi%C3%A7os%20destinados%20%C3%A0%20recep%C3%A7%C3%A3o%20de%20eventos%20aduaneiros./incluir_4

Procedimento de Utilização (Sistema TLRA)

No sistema TLRA, efetuar a liberação de um agendamento de veículo. No sistema TRLA, a liberação de agendamentos está disponível no processo de agendamento do Portal WEB, no Transit-time triagem do módulo portaria ou na API de liberação de agendamento.
Acessar o EAIMonitor para identificar se a integração foi realizada com o módulo recintos. Em caso de dúvidas, acessar o manual técnico referente ao módulo EAI Monitor por meio do link EAI Monitor Viewer | Manual Técnico.

Templatedocumentos

HTML

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

Árvore de páginas

Versões comparadas

Versão antiga 15

Nova versão 16

Chave

Componentes

Instalação dos componentes

Instalação do Open SSL

Configuração do arquivo .INI

Parametrização do endereço base para a integração com o PUCOMEX - Módulo Recintos

Objetivo

Procedimento de Utilização (Sistema TLRA)

Objetivo

Procedimento de Utilização (Sistema TLRA)

Objetivo

Procedimento de Utilização (Sistema TLRA)

Objetivo

Procedimento de Utilização (Sistema TLRA)

Objetivo

Procedimento de Utilização (Sistema TLRA)