TOTVS Logística Recintos Aduaneiros

Árvore de páginas

Versões comparadas

Versão antiga 11

changes.mady.by.user Rodrigo Azanha

Gravado em

comparado com

Nova versão 12

changes.mady.by.user Rodrigo Azanha

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsInstalação e Configuração, Eventos (Mensagens))
idsinstalacao,eventos
Totvs custom tabs box items
defaultyes
referenciainstalacao

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

ComponenteDescriçã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.bplResponsá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.bplResponsável por buscar as informações referente ao credenciamento de veículos e gerar a mensagem JSON para envio ao PUCOMEX.
MRAcessoVeiculo.bplResponsá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.iniArquivo 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
titlePuSiscomex.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
languagesql
titleAtivar 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
languagesql
titleComando 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
defaultno
referenciaeventos
Totvs custom tabs box
tabsCredenciamento de Pessoas, Acesso de Pessoas, Credenciamento de Veículos, Agendamento de Veículos, Acesso de Veículos
idsCredenciamentoPessoa,AcessoPessoa,CredenciamentoVeiculo,AgendamentoVeiculo,AcessoVeiculo
Totvs custom tabs box items
defaultyes
referenciaCredenciamentoPessoa

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)

  1. No sistema TLRA, efetuar o registro de uma pessoa por meio dos módulos controle de acesso ou portaria. 
  2. 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
defaultno
referenciaAcessoPessoa

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)

  1. 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.).
  2. 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
defaultno
referenciaAcessoPessoaCredenciamentoVeiculo

Objetivo

Efetuar a recepção de carga por Contêiner no módulo CCT de forma integrada e automática, por meio da utilização do sistema SARA no processo de descarga de mercadorias destinadas a exportação em um recinto alfandegado.

NOTA: Para a realização desta integração, o serviço EAIService deverá estar instalado e configurado conforme o Manual de instalação do EAIService e Manual de Instalação da Integração com o CCT.

Para mais informações sobre a Recepção por Contêiner no CCT, acessar o link http://portal.siscomex.gov.br/conheca-o-portal/principais-funcionalidades-do-modulo-cct.

Manual da API de integração referente a Recepção por Contêiner: https://docs.portalunico.siscomex.gov.br/swagger/cct-ext.html#/Carga/recepcionarConteiner

Procedimento de Utilização (Sistema SARA)

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)

  1. 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.
  2. 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
  3. No sistema SARA, para um processo de exportação, efetuar o recebimento completo das mercadorias tendo como documento de entrada uma DU-E. Para a recepção por contêiner a carga deverá estar unitizada em contêiner e o terminal de envio deverá pertencer a mesma jurisdição aduaneira do terminal de recebimento.
    1. Geração da CESV para a operação de descarga de contêiner. (Recebimento)
    2. Registro do documento de entrada (Módulo expedição ou pré-cadastro) sendo o tipo de documento de entrada a DU-E.
      1. Para a geração da pendência de envio para o CCT, a DU-E deve ser recebida como contêiner.
    3. Geração e fechamento da Ordem de serviço de descarga de contêiner.
    4. Fechamento da CESV de descarga de contêiner.
  4. O sistema SARA somente irá disparar a rotina para validar a geração da pendência de envio após o encerramento da OS e CESV. 
  5. A informação do peso aferido para envio, será considerado o peso aferido do contêiner. 
  6. No processo de integração, será realizada uma recepção para cada contêiner.
Totvs custom tabs box items
defaultno
referenciaCredenciamentoVeiculo

Objetivo

Efetuar a recepção de carga por DU-E ou RUC no módulo CCT de forma integrada e automática, por meio da utilização do sistema SARA no processo de descarga de mercadorias destinadas a exportação em um recinto alfandegado.

NOTA: Para a realização desta integração, o serviço EAIService deverá estar instalado e configurado conforme o Manual de instalação do EAIService e Manual de Instalação da Integração com o CCT.

Para mais informações sobre a Recepção de carga por DU-E ou RUC no CCT, acessar o link http://portal.siscomex.gov.br/conheca-o-portal/principais-funcionalidades-do-modulo-cct.

Manual da API de integração referente a Recepção de Carga por DU-E ou RUC: https://docs.portalunico.siscomex.gov.br/swagger/cct-ext.html#/Carga/recepcionarDocumentoCarga

Procedimento de Utilização (Sistema SARA)

  1. No sistema SARA, para um processo de exportação, efetuar o recebimento completo das mercadorias tendo como documento de entrada uma DU-E referente a mercadoria solta. Para a recepção por DU-E a carga não poderá estar unitizada em contêiner, somente como mercadoria solta.
    1. Geração da CESV para a operação de descarga de mercadoria solta (Recebimento)
    2. Registro do documento de entrada (Módulo expedição ou pré-cadastro) sendo o tipo de documento de entrada a DU-E.
      1. Para a geração da pendência de envio para o CCT, a DU-E deve ser recebida como mercadoria solta, não podendo existir vínculo com contêiner na recepção.
    3. Geração e fechamento da Ordem de serviço de descarga de mercadoria solta.
    4. Fechamento da CESV de descarga de mercadoria solta.
  2. O sistema SARA somente irá disparar a rotina para validar a geração da pendência de envio após o encerramento da OS e CESV. 
  3. A informação do peso aferido para envio, será considerado o peso aferido do veículo de transporte. Até o momento o Siscomex - CCT não recepciona o peso aferido por documento.
  4. No processo de integração, será realizada uma recepção para cada DU-E.
Totvs custom tabs box items
defaultno
referenciaAgendamentoVeiculo

Objetivo

Efetuar a Unitização de Carga no módulo CCT de forma integrada e automática, por meio da utilização do sistema SARA no processo de unitizações de mercadorias em contêineres (estufagem) destinadas a exportação em um recinto alfandegado.

NOTA: Para a realização desta integração, o serviço EAIService deverá estar instalado e configurado conforme o Manual de instalação do EAIService e Manual de Instalação da Integração com o CCT.

Para mais informações sobre a Unitização de Carga no CCT, acessar o link http://portal.siscomex.gov.br/conheca-o-portal/principais-funcionalidades-do-modulo-cct.

Manual da API de integração referente a Unitização de Carga: https://docs.portalunico.siscomex.gov.br/swagger/cct-ext.html#/Carga/unitizar

Procedimento de Utilização (Sistema SARA)

  1. Para o envio das informações de unitização, o sistema SARA efetuará a validação para a geração das pendências (fila) em dois momentos:
    1. Fechamento da OS de OVA pós desembaraço.
    2. Liberação do documento de saída (DU-E).
  2. Se a unitização for realizada antes do registro do documento de saída, a geração da pendência para envio ao CCT ocorrerá somente após o registro do desembaraço da DU-E. Se a DU-E estiver unitizada em mais de um contêiner, o sistema deverá gerar as pendências somente quando for realizado o registro do desembaraço do último documento.
  3. Se a unitização ocorrer após o desembaraço, a geração da pendência para o envio ao CCT ocorrerá após o fechamento da OS de OVA pós desembaraço. Em caso de mais de um contêiner para estufagem, a pendência será gerada somente após o fechamento da última OS.
  4. Para o processo de exportação (Unitização), o sistema deverá gerar um único arquivo XML contendo os documentos e os contêineres. 
  5. Para unitizações de um documento (DU-e) em mais de um contêiner, a chave para a geração da pendência de integração será o "Código do documento de saída", por meio desta o sistema irá consultar todos os contêineres unitizados e efetuará a geração de um único arquivo XML para a integração.
  6. Para unitizações de vários documentos (DU-e) em um único contêiner, a chave para a geração da pendência de integração será o "Código de movimentação do contêiner", por meio deste o sistema irá consultar todos os documentos (DU-e) que foram unitizados e efetuará a geração de um único arquivo XML para a integração.
  7. Para que o CCT aceite a unitização de forma correta, as notas fiscais (NF-e) vinculadas a DU-E,  deverão estar recepcionadas no CCT.
Totvs custom tabs box items
defaultno
referenciaAcessoVeiculo

Objetivo

Efetuar a Desunitização de Carga no módulo CCT de forma integrada e automática, por meio da utilização do sistema SARA no processo de desunitizações de contêineres (desovas) relacionadas ao processo de exportação em um recinto alfandegado.

NOTA: Para a realização desta integração, o serviço EAIService deverá estar instalado e configurado conforme o Manual de instalação do EAIService e Manual de Instalação da Integração com o CCT.

Para mais informações sobre a Desunitização de Carga no CCT, acessar o link http://portal.siscomex.gov.br/conheca-o-portal/principais-funcionalidades-do-modulo-cct.

Manual da API de integração referente a Unitização de Carga: https://docs.portalunico.siscomex.gov.br/swagger/cct-ext.html#/Carga/desunitizarCarga

Procedimento de Utilização (Sistema SARA)

  1. Para o envio das informações de desunitização, o sistema SARA efetuará a validação para a geração das pendências quando:
    1. Fechamento da OS de Desova Pós Desembaraço.
  2. A chave para a geração da pendência o contêiner que estiver vinculado na ordem de serviço de desova.
  3. Para o CCT, devemos enviar um arquivo por contêiner, podendo conter mais de um documento DU-E desovados.
  4. Para que o CCT efetue a desunitização de forma correta, é necessário que as informações de uma unitização já tenha sido registrada.

...