Guia ObjetivoServir de guia para a instalação e configuração da integração do sistema SARA com o PUCOMEX - CCT | Controle de Carga e Trânsito. NOTA: Para instalação e configuração da integração com o CCT, é requisito possuir a instalação do EAIService do sistema SARA. Para sua instalação consulte o Manual Técnico do EAIServicea documentação EAI Service | Serviço de Integração. ComponentesComponente | Descrição |
---|
CCTRequest.bpl | Responsável pela autenticação, envio e recebimento de mensagens para o sistema PUCOMEX - CCT. | RecepcaoNFE.bpl | Responsável por buscar as informações necessárias referente a Recepção por Nota Fiscal Eletrônica e gerar a mensagem XML para envio ao CCT. | RecepcaoDueRuc.bpl | Responsável por buscar as informações necessárias referente a Recepção por DU-E ou RUC e gerar a mensagem XML para envio ao CCT. | RecepcaoDocumentoTransporte.bpl | Responsável por buscar as informações necessárias referente a Recepção por Documento de Transporte e gerar a mensagem XML para envio ao CCT. | RecepcaoConteiner.bpl | Responsável por buscar as informações necessárias referente a Recepção por Contêiner e gerar a mensagem XML para envio ao CCT. | Unitizacao.bpl | Responsável por buscar as informações necessárias referente ao processo de Unitização e gerar a mensagem XML para envio ao CCT. | Desunitizacao.bpl | Responsável por buscar as informações necessárias referente ao processo de Desunitização e gerar a mensagem XML para o envio ao CCT. | EntregaConteiner.bpl | Responsável por buscar as informações necessárias referente ao processo de Entrega de Contêiner e gerar a mensagem XML para envio ao CCT. | EntregaDueRuc.bpl | Responsável por buscar as informações necessárias referente ao processo de Entrega de mercadorias solta por DUE ou RUC e gerar a mensagem XML para envio ao CCT. | EntregaDocumentoTransporte.bpl | Responsável por buscar as informações necessárias referente ao processo de Entrega por Documento de Transporte e gerar a mensagem XML para envio ao CCT. | CCTSiscomex.ini | Arquivo de configuração para a integração com o CCT contendo o perfil do interveniente e o caminho das chaves do certificado digital para autenticação. |
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.
Instalação do OpenSSLOpen 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.
Configuração do arquivo .INI O arquivo CCTSiscomex.INI deverá ser criado na pasta CONFIG, localizado no diretório SERVICES. Neste arquivo deverá ser configurado o perfil do interveniente e o caminho das chaves da certificação digital A1 para autenticação no CCT. Ver a lista de perfis de intervenientes disponíveis em https://val.portalunico.siscomex.gov.br/docs/api/#autenticacao. 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".
NOTANOTAS: Atualmente a certificação digital está disponível somente no modelo A1. Em caso de ERRO na autenticação, atualmente o sistema manter o "status" da mensagem como pendente para serem reenviadas e os erros ficarão registrados no arquivo de LOG DE ERROS parametrizado no arquivo INI.
Painel |
---|
| [PROFILE] RoleType=DEPOSIT [ | Painel |
---|
| [PROFILE] RoleType=DEPOSIT [CERTIFICATE] SiscomexCertFile=C:\TOTVS 12\SARA\SARA Server\SARA_10\SERVICES\config\CertificadoDigital\CCT\cert.pem SiscomexKeyFile=C:\TOTVS 12\SARA\SARA Server\SARA_10\SERVICES\config\CertificadoDigital\CCT\privatekey.pem SiscomexRootCertFile=C:\TOTVS 12\SARA\SARA Server\SARA_10\SERVICES\config\CertificadoDigital\CCT\publiccert.pem |
Inclusão de registros nas tabelas do SARA | EAIService.A inclusão de registros nas tabelas do EAIService deverá ser realizada manualmente por meio de uma ferramenta de manipulação de banco de dados. (Ex. Manegement Studio do SQL SERVER). Abaixo segue as scripts contendo os comandos SQL para inclusão. View file |
---|
name | EAIService - CCT - Inclusão de registros.zip |
---|
height | 150 |
---|
|
NOTA: É possível ativar ou desativar uma ou mais mensagens de integração com o CCT, abaixo segue alguns exemplos:
NOTA: É possível ativar ou desativar uma ou mais mensagens de integração com o CCT, abaixo segue alguns exemplos:
Bloco de código |
---|
| 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 = 10 where eea_id = 1
/*Desativar a integração da mensagem da Unitização de Carga*/
update tab_eai_transaction set et_active = 10 where et_id = 2
|
Inclusão de registros no cadastro DE-PARA (Módulo Sistema)Para algumas integrações é necessário registrar o mapeamento DE-PARA de alguns registros chaves de tabelas de domínio do CCT com o SARA. No sistema SARA, o registro deverá ser realizado no módulo sistema, no menu Cadastro | De-Para quando houver a necessidade. Os registros de tabelas de domínio do CCT poderão ser encontrados em no link https://www35.receita.fazenda.gov.br/tabaduaneiras-web/public/pages/security/login_publico.jsf.
Abaixo, segue os tipos de dados que devem estar mapeados: - Tipos de Embalagem
- Tipos de Documento de Transporte
- Via de Transporte
- Documentos Aduaneiros
Abaixo segue as scripts contendo os comandos SQL para inclusão: View file |
---|
name | insert_tab_de_para_sistemas.sql |
---|
height | 150 |
---|
| Parametrização do endereço base para
Parametrização do endereço base para a integração com o PUCOMEX - CCTPara 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 = 1 |
Procedimentos de utilizaçãoPara a utilização da integração com o CCT, acessar o manual Integrações CCT - Controle de Carga e Trãnsito. |