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. ComponentesComponente | 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. | MRPesagemVeiculoCarga.bpl | Responsável por buscar as informações referente a pesagem 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 componentesPara 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. ![](/download/attachments/577627578/image2020-12-11_18-45-23.png?version=1&modificationDate=1607726724877&api=v2)
Instalação do Open SSLA 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. ![](/download/attachments/577627578/image2019-5-29_11-7-27.png?version=1&modificationDate=1607724058680&api=v2)
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 |
---|
| [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 RecintosPara 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, Pesagem de Veículos e Cargas |
---|
ids | CredenciamentoPessoa,AcessoPessoa,CredenciamentoVeiculo,AgendamentoVeiculo,AcessoVeiculo,PesagemVeiculoCarga |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | CredenciamentoPessoa |
---|
| ObjetivoEfetuar 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 exclusão do credenciamento de pessoas. A integração será realizada quando: - Na inclusão de uma pessoa. Nesta operação será realizada a integração de INCLUSÃO.
- Na edição de uma pessoa. Nesta operação será realizada a integração de RETIFICAÇÃO.
- Na exclusão de uma pessoa. Nesta operação será realizada a integração de CANCELAMENTOEXCLUSÃO.
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 TLRA 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_10 Pré-requisitosPara que a integração seja realizada, será necessário um mapeamento DE-PARA para a informação do PAÍS. O sistema PUCOMEX espera um código de país conforme tabela abaixo: View file |
---|
name | Pucomex_Pais.pdf |
---|
height | 150 |
---|
|
O registro DE-PARA, deverá ser realizado por meio do módulo SISTEMA, menu CADASTRO | DE-PARA. Deverá ser informado o nome do PAÍS registrado no sistema TLRA e o código do país conforme tabela do SISCOMEX. No processo de instalação, existe um script que irá incluir de forma automática os países da América do Sul, caso necessite da inclusão de mais países, este registro poderá ser feito de forma manual. ![](/download/attachments/577627578/image2021-1-12_11-32-2.png?version=1&modificationDate=1610461923303&api=v2)
Procedimento de Utilização (Sistema TLRA)- No sistema TLRA, efetuar o registro, edição ou cancelamento exclusão do cadastro 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 |
---|
| ObjetivoEfetuar 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: - Na entrada de uma pessoa no recinto aduaneiro. Nesta operação será realizada a integração de INCLUSÃO.
- Na saída de uma pessoa no recinto aduaneiro. Nesta operação também será realizada a integração de INCLUSÃO.
NOTA: Por meio do sistema atualmente não é possível retificar ou cancelar uma entrada ou saída de pessoas.
Independente da rotina de registro de acesso, a integração será gerada por meio das triggers 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_7 Procedimento de Utilização (Sistema TLRA)- No sistema TLRA, efetuar o registro de um acesso de entrada ou saída 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 |
---|
| ObjetivoEfetuar 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 exclusão do credenciamento de veículos (Rodoviário ou Ferroviário). A integração será realizada quando: - Na inclusão de uma veículo (rodoviário ou ferroviário). Nesta operação será realizada a integração de INCLUSÃO.
- Na edição de uma veículo (rodoviário ou ferroviário). Nesta operação será realizada a integração de RETIFICAÇÃO.
- Na exclusão de um veículo (rodoviário ou ferroviário). Nesta operação será realizada a integração de CANCELAMENTOEXCLUSÃO.
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_11 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 |
---|
| ObjetivoEfetuar 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 exclusão 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 exclusão 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 exclusão 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 das triggers de "insert, update ou delete" vinculada a tabela "tab_programacao".
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.
Para o agendamento de veículo, a API de integração é o mesmo "endpoint" da API de acesso de veículos. 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_8 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 |
---|
| ObjetivoEfetuar 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 exclusão 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 a exclusão 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 das triggers de "insert, update ou delete" vinculada a tabela "tab_cesv".
Para a geração da pendência, o registro de entrada ou saída de veículos deverá possuir as seguintes informações: - Modal deverá ser rodoviário ou ferroviário.
- Possuir entrada ou saída do recinto.
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_8 Procedimento de Utilização (Sistema TLRA)- No sistema TLRA, efetuar a entrada ou a saída de veículo no recinto.
- Para a retificação complementando as informações de documentos, contêineres entre outros, efetuar a ordem de serviço vinculada a entrada do veículo (Descarga ou Carga).
- 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 | PesagemVeiculoCarga |
---|
| ObjetivoEfetuar o envio das informações referente ao processo de pesagem de veículos e cargas em balança rodoviária para o Módulo Recintos do PUCOMEX. Estão previstas as operações de inclusão, retificação e exclusão de todas as pesagens realizadas para veículos em balança rodoviária. A integração será realizada quando: - Registrar ou retificar uma pesagem de veículo do recinto aduaneiro por meio do sistema TLRA, antes SARA.
- Para cada pesagem será realizada uma integração, seja ela de entrada ou saída do veículo.
- Efetuar a exclusão de uma pesagem, desta forma o sistema irá gerar uma integração para a exclusão da pesagem.
A pendência para a integração da pesagem de veículos será gerada por meio das triggers de "insert, update ou delete" vinculada a tabela "tab_balanca".
Para a geração da pendência atualmente não existirá nenhuma validação, ou seja, qualquer veículo rodoviário que efetue a pesagem em balança rodoviária será gerada uma pendência para a integração.
Manual da API de integração referente ao Agendamento de Veículos: https://hom.pucomex.serpro.gov.br/docs/api-docs/swagger/rcnt.html#/Servi%C3%A7os%20destinados%20%C3%A0%20recep%C3%A7%C3%A3o%20de%20eventos%20aduaneiros./incluir_18 Procedimento de Utilização (Sistema TLRA)- No sistema TLRA, registrar a pesagem para um veículo rodoviário no módulo portaria, função "Pesagem".
- Para uma retificação, efetuar a edição de um registro de pesagem.
- Para uma exclusão, efetuar a exclusão de um registro de pesagem.
- 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.
|
|
|
|