Árvore de páginas

Versões comparadas

Chave

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

...

Totvs custom tabs box
tabsInstalação e Configuração, Eventos (Mensagens))
ids1,2
Totvs custom tabs box items
defaultyes
referencia1

Objetivo

Servir 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 EAIService.

Componentes

ComponenteDescriçã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.bplResponsá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.bplResponsá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.bplResponsá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.bplResponsá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.bplResponsá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.bplResponsá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.iniArquivo 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 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 OpenSSL

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 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".


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


Painel
titleCCTSiscomex.INI

[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
nameEAIService - CCT - Inclusão de registros.zip
height150


NOTA: É possível ativar ou desativar uma ou mais mensagens de integração com o CCT, 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 = 1

/*Desativar a integração da mensagem da Unitização de Carga*/
update tab_eai_transaction set et_active = 1 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:

  1. Tipos de Embalagem
  2. Tipos de Documento de Transporte
  3. Via de Transporte
  4. Documentos Aduaneiros



Abaixo segue as scripts contendo os comandos SQL para inclusão:

View file
nameinsert_tab_de_para_sistemas.sql
height150


Parametrização do endereço base para a integração com o PUCOMEX - CCT

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 = 1


Procedimentos de utilização

Para a utilização da integração com o CCT, acessar o manual Integrações CCT - Controle de Carga e Trãnsito.


Totvs custom tabs box items
defaultno
referencia2
Totvs custom tabs box
tabsRecepção por NF-e (Nota Fiscal Eletrônica), Recepção por Documento de Transporte, Recepção por Contêiner, Recepção por DUE/RUC
idsrecepcaoNfe,recepcaoDocTransporte,recepcaoConteiner,recepcaoDueRuc
Totvs custom tabs box items
defaultyes
referenciarecepcaoNfe

Objetivo

Efetuar a recepção por nota fiscal eletrônica (NF-e) 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 Nota Fiscal Eletrônica 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 Nota Fiscal Eletrônica: https://val.portalunico.siscomex.gov.br/docs/api/#recepcionar-por-nota-fiscal-eletronica-nf-e

Procedimento de Utilização (Sistema SARA)

  1. No sistema SARA, para um processo de exportação, efetuar o recebimento completo de uma ou mais notas ficais (NF-e), com ou sem contêiner vinculado.
    1. Geração da CESV para a operação de descarga (Recebimento)
    2. Registro do documento de entrada (Módulo expedição, pré-cadastro ou importação do XML da NF-e)
      1. Para a geração da pendência de envio para o CCT, a NF deverá possuir as seguintes informações:
        1. Campo "Chave de acesso (NF-e)" preenchido na aba "Cadastro complementar"
        2. O CFOP da nota fiscal deverá estar configurado no SARA com a operação "EXPORTAÇÃO".
    3. Geração e fechamento da Ordem de serviço de descarga.
    4. Fechamento da CESV de descarga, mas somente se o processo não for armazenagem sobre-rodas.
  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 exceto para operações com armazenagem sobre-rodas onde o veículo de transporte ainda permanece dentro do recinto após o recebimento.
  3. Para armazenagem sobre-rodas, a pendência será gerada após o fechamento da OS de Descarga.
  4. 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. Para o processo de armazenagem sobre-rodas, o peso aferido do veículo não será enviado , e o motivo da não-pesagem será informado "A ARMAZENAGEM FOI REALIZADA SOBRE-RODAS".
  5. No processo de integração, será realizada uma recepção para cada Nota Fiscal.
Totvs custom tabs box items
defaultno
referenciarecepcaoDocTransporte

Objetivo

Efetuar a recepção de carga por Documento de Transporte 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 Documento de Transporte 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 Documento de Transporte: https://val.portalunico.siscomex.gov.br/docs/api/#recepcionar-versao-a-ser-implantada-no-dia-24-06-2018

Procedimento de Utilização (Sistema SARA)

  1. No sistema SARA, para um processo de exportação, efetuar o recebimento completo das mercadorias ou contêineres tendo como documento de entrada um DAT - Documento de Acompanhamento de Transporte ou uma MIC-DTA (Manifesto Internacional de Carga).
  2. Para a recepção por documento de transporte a carga poderá ser solta ou unitizada em contêiner e o terminal de envio não poderá pertencer a mesma jurisdição aduaneira do terminal de recebimento. 
  3. Deverá ser executado os seguintes processos: 
    1. Geração da CESV para a operação de descarga de contêiner ou carga solta. (Recebimento)
    2. Registro do documento de entrada (Módulo expedição ou pré-cadastro) sendo o tipo de documento de entrada um DAT ou MIC-DTA.
      1. Para a geração da pendência de envio para o CCT, o DAT ou MIC-DTA poderá ser referente a mercadoria solta ou unitizada em contêiner.
    3. Geração e fechamento da Ordem de serviço de descarga de carga solta ou contêiner.
    4. Fechamento da CESV de descarga de mercadoria solta ou 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, mas somente em um processo que não for sobre-rodas. 
  5. Para processos sobre-rodas, a pendência será disparada após o fechamento da ordem de serviço de descarga.
  6. A informação do peso aferido para envio, será considerado o peso aferido do veículo de transporte.
  7. No processo de integração, será realizada uma recepção para cada documento de transporte.
Totvs custom tabs box items
defaultno
referenciarecepcaoConteiner

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://val.portalunico.siscomex.gov.br/docs/api/#recepcionar-por-conteiner

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. 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.
  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 contêiner. 
  4. No processo de integração, será realizada uma recepção para cada contêiner.
Totvs custom tabs box items
defaultno
referenciarecepcaoDueRuc

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://val.portalunico.siscomex.gov.br/docs/api/#recepcionar-carga-por-du-e-ruc

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.





...