INTEGRAÇÃO COMEX (DATASUL) X CATÁLOGO DE PRODUTOS E OPERADORES ESTRANGEIROS (SISCOMEX)

Contexto de negócio (Introdução)

O sistema Catálogo de Produtos permite a manutenção de catálogos de produtos e operadores estrangeiros, individualizados por empresa, visando ao reuso das informações nas operações de comércio exterior.


Sistemas Envolvidos

  • Módulos de Comex do produto Datasul: Será o responsável pela criação dos produtos e operadores estrangeiros, consistência de alguns dados e integração dos mesmos com o Portal Único do Siscomex;
  • Portal Único do Siscomex: Responsável pelo recebimento, validação e registro dos produtos e operadores estrangeiros.

Integração

O Catálogo de Produto tem como finalidade principal auxiliar o preenchimento das DUIMP (Declaração Única de Importação), utilizando um banco de dados dos produtos e dos operadores estrangeiros presentes nas operações do importador. Esse banco de dados será gerido pelo próprio importador, atualizando-o com novos produtos ou novas informações dos produtos já cadastrados.

As informações sobre os produtos e operadores estrangeiros podem ser importadas de arquivos JSON, tanto pela interface Web, via upload de arquivo, quando pelo acionamento dos serviços REST. A estrutura do arquivo JSON é a mesma para as duas modalidades de uso.

No arquivo com os produtos a serem importados, além dos dados básicos, devem ser preenchidos os atributos associados ao código NCM de cada produto. Os atributos preenchidos para cada produto devem respeitar os códigos do respectivo ambiente - treinamento (validação) ou produção. Devem ser considerados somente os atributos que contenham o objetivo Produto.


Escopo

A integração do módulo de Comex com o Catálogo de Produtos do Portal Único Siscomex contempla a integração de duas entidades no sentido ERP para o Siscomex:


  • Fornecedores (Operador Estrangeiro):

  • Itens (Produtos):


Fora do escopo:

  • Atualização do ERP com dados de Operadores Estrangeiros e Produtos feitos diretamente no Portal Único do Siscomex.

No caso de dúvida sobre o escopo da integração e/ou necessidade diferenciada para sua empresa, favor entrar em contato com a equipe de produto. 


Pré-requisitos instalação/implantação/utilização

  • Aquisição de certificado digital: Para integração com o Siscomex é necessário possuir um certificado digital válido, sendo e-CPF, tipo A1. O arquivo do certificado deverá ser disponibilizado em um diretório onde todos os usuários que utilizarão os programas que integram com o Siscomex tenham permissão de acesso.
  • A conexão para validação do certificado será realizada de forma direta via webservice com conectores utilizando a linguagem .Net. Com isso o servidor utilizado para integração deverá utilizar o sistema operacional Windows;
  • Versão mínima do produto devido a dicionário de dados:
    • 12.1.2407.2 Progress 12;

    • 12.1.2403.8 Progress 12;

    • 12.1.2311.13 Progress 12;
    • Para versões anteriores, solicitar diretamente para equipe de produto para verificar a viabilidade de liberação.

Instalação/Atualização

  • Preenchimento dos dados de "Siscomex" nos parâmetros do Siscomex: Para configuração desta integração, existe um novo programa que realiza essa configuração: CD2511 - Parâmetros do Siscomex. Os dados neste programa devem ser preenchidos para ser possível a integração via API REST com o Portal Único. É importante selecionar a opção de Histórico de Envio e informar o diretório onde os arquivos JSON serão gerados inclusive para que seja possível realizar o upload dos arquivos diretamente no Siscomex.
  • Preenchimento informações Certificado (por usuário): Se a transmissão dos arquivos for realizada pelo usuário de Importação e de forma automática junto ao Siscomex, deverão ser preenchidas as informações referentes ao Certificado (IM0001). 
  • Geração dados Catálogo de Produtos: para que o arquivo contendo os dados do Catálogo de Produtos seja gerado com as informações completas, deverão ser atualizadas algumas informações no sistema ERP:
    • Importação dos dados de Atributos da Classificação Fiscal: O arquivo a ser utilizado para importação dos atributos da classificação fiscal (tanto .XML quanto .JSON) deve ser realizado o download no site Siscomex. Este arquivo é atualizado diariamente (https://www.gov.br/siscomex/pt-br/conheca-o-programa/integre-seu-sistema). A importação é realizada somente uma única vez, independente da NCM posicionada no programa. Os dados importados e atualizados ficam disponíveis para consulta no próprio programa (CD0603), aba "Atributos".
      • Importante: Somente são importados os dados de atributos caso exista a classificação fiscal correspondente.
    • Itens Comex: algumas informações dos itens também deverão ser preenchidas para composição do arquivo de Catálogo de Produtos. Desta forma, no programa de Itens COMEX (CD2510), aba "Siscomex II" deverão ser preenchidas as informações solicitadas. Na aba "Atributos" deverão ser relacionados os atributos pertinentes àquele item dentro da classificação fiscal a qual pertence. Já na aba "Fabricantes", deverão ser informados os dados dos fabricantes daquele item que é importado.
      • Importante:
        • Quanto à descrição do item, a informação considerada nos arquivos JSON que são utilizados para importação das informações no Portal do SISCOMEX, é a que for inserida no campo "Descrição" da aba "Siscomex II" do programa CD2510.
    • Uma vez os dados acima preenchidos, para geração do arquivo em diretório especificado e/ou integração automática junto ao Portal, basta acessar o botão "Envio Siscomex" do programa CD2510, localizado na parte superior à direita da tela. Ao término da execução será aberto um relatório com a listagem de informações consistentes e/ou inconsistentes.
  • Geração dados Operadores Estrangeiros: as informações extraídas que contemplam o arquivo referente aos Operadores Estrangeiros devem ser informadas no cadastro de Fornecedores Estrangeiros (CD2576), aba "Siscomex". Caso o cadastro já exista para os fornecedores, as informações contidas nesta aba serão automaticamente preenchidas e sugeridas de acordo com o informado no cadastro do fornecedor (CD0401).


Os clientes que não possuem o módulo de Importação e precisam estar gerando os dados de Catálogo de Produtos e Operadores Estrangeiros para realizar upload no Portal Único, deverão seguir os procedimentos descritos abaixo:

  • Conectar o banco "mgcex" na base de dados;
  • Parâmetros do Siscomex (CD2511): selecionar a opção "Histórico envio" e informar o diretório para geração dos arquivos JSON para posterior upload no Siscomex.

Fase 1: Geração dados Catálogo de Produtos e Operadores Estrangeiros;

Fase 2: Integração da DI gerada no Datasul com o SISCOMEX;

Fase 3: Exportação do arquivo JSON da DI para importação no SISCOMEX;

Fase 4: Importação do arquivo JSON da DI gerada no SISCOMEX para o ERP criando toda estrutura de dados

Suporte

O suporte a esta integração é de responsabilidade  da equipe TOTVS (módulo de Importação).


Transações/Entidades/Mensagens únicas

O ERP envia o arquivo diretamente para o Portal Único do Siscomex onde o mesmo é consistido. Se os dados estiverem corretos, a integração do registro é realizada e automaticamente setado para "Integrado Siscomex" = sim. 

No caso de consistência do Siscomex, elas são apresentadas ao usuário, que deve realizar os ajustes e reenviar os arquivos.


Cadastros

No caso desta integração não existe envio/recebimento de cadastros individualmente, todas as informações necessárias são enviadas diretamente na DU-E. Apenas é necessário atualizar/cadastrar corretamente as entidades citadas na parte de instalação/atualização: 

  • Parâmetros Siscomex (CD2511);
  • Manutenção Usuários de Importação (IM0001);
  • Cadastro de Fornecedores Estrangeiros (CD2576);
  • Manutenção de Classificação Fiscal (CD0603);
  • Itens Comex (CD2510).


Limitações / Restrições Gerais

  • Utilização de sistema operacional Windows, em função do uso de bibliotecas utilizadas no desenvolvimento da parte de conexão;

Como fazer

Cadastro e integração dos Catálogos de Produtos e Operadores Estrangeiros:

Para realizar a integração das informações de Catálogos de Produtos e Operadores Estrangeiros com o Siscomex, deve-se seguir os seguintes passos:

Obs.: Garantir que os pré-requisitos estejam atendidos e os itens de instalação/atualização já tenham sido realizados.

  • No Datasul:
    • Acessar a rotina de Parâmetros do Siscomex e informar os dados solicitados;
    • Para os usuários de Importação (IM0001), deverão ser inseridos os dados de Certificados (em caso de transmissão direta com o Portal Único);
    • Para os Fornecedores Estrangeiros (CD2576), inserir as informações solicitadas na aba "Siscomex". Para geração do arquivo, acessar o botão "Envia para o Siscomex" localizado na parte superior à direita do programa CD2576;
    • Para as Classificações Fiscais (CD0603), deverá ser importado o arquivo "Lista de Atributos por NCM, em produção" ou "Lista de Atributos por NCM, em treinamento" dependendo do ambiente de Transmissão que o cliente está realizando a integração dos dados e o arquivo é baixado do site "https://www.gov.br/siscomex/pt-br/conheca-o-programa/integre-seu-sistema";
    • Para os itens que são importados (CD2510), deverão ser relacionados os atributos e fabricantes pertinentes a cada item para composição do arquivo a ser enviado ao Portal. Para geração do arquivo, acessar o botão "Envia para o Siscomex" localizado na parte superior à direita do programa CD2510.

Situações comuns 


Erro

Mensagem

Motivo/Solução

55967

Erro na integração com o Siscomex: Verifique se os dados para a conexão foram informados corretamente para o usuário <código do usuário>

Erro ocorre quando a integração não consegue encontrar os dados do usuário no IM0001, verificar se foram informados corretamente.

55967

Erro na integração com o Siscomex: Verifique se o certificado digital e senha foram informados corretamente para o usuário <código do usuário>

Erro ocorre quando o certificado informado no IM0001 não é encontrado ou a senha do certificado está incorreta, confira e ajuste as informações no IM0001.

56834

Dados do Siscomex para o item não foram informados.

Ocorre quando no programa CD2510, os dados do item na pasta Siscomex II não foram informados. 

55967

Erro na integração com o Siscomex: Campo <nome do campo> está inválido.


55967

Erro na integração com o Siscomex: Campo <nome do campo> é obrigatório.


55967Erro na integração com o Siscomex: O Atributo <código do atributo> não existe ou não está vinculado ao código NCM <código NCM>.

Checklist de suporte da aplicação

  • Conferir se o cliente atende aos pré-requisitos listados neste documento;
  • Conferir se foram executados os passos de instalação/configuração listados neste documento;
  • No caso de erros de integração com o Siscomex:
    • Confirmar se o sistema do Siscomex está no ar;
    • Configurar para gerar o XML localmente para facilitar a análise do problema;
    • Conferir as situações comuns;