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, 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 (mais informações https://portalunico.siscomex.gov.br/portal/);
    • 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.3 Progress 12;

    • 12.1.2403.9 Progress 12;

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



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 integração com Portal Único, deverão seguir os procedimentos descritos abaixo:

  • Conectar o banco "mgcex" na base de dados;
  • Módulo de Importação nos Parâmetros Globais (CD0101) não pode estar marcado;
  • Parâmetros do Siscomex (CD2511): selecionar a opção "Histórico envio" e informar o diretório para geração dos arquivos JSON.

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

Próximas fases são restritas somente a clientes que possuem o módulo de importação implantado:

  • 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

Instalação/Atualização


PARÂMETROS DO SISCOMEX - CD2511

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


MANUTENÇÃO USUÁRIOS DE IMPORTAÇÃO - IM0001

  • 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). 
  • 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.

MANUTENÇÃO CLASSIFICAÇÃO FISCAL - CD0603

  • 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 (Programa Portal Único Siscomex).
    • O arquivo acima, deverá ser importado via programa CD0603, através do botão "Importar Atributos" (imagem abaixo) e deve ser informado o tipo do arquivo e o arquivo para realizar a importação dos dados.
      • Importante:
        • A importação é realizada independente da NCM posicionada no programa. Os dados importados e atualizados ficam disponíveis para consulta no próprio programa (CD0603), aba "Atributos".
        • Somente são importados os dados de atributos caso exista a classificação fiscal correspondente.


ITENS COMEX - CD2510

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


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


  • Na aba "Atributos" deverão ser relacionados os atributos pertinentes àquele item dentro da classificação fiscal a qual pertence.


  • Na aba "Fabricantes", deverão ser informados os dados dos fabricantes daquele item que é importado.


  • 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:

Observação: quando a opção "Somente gera JSON local" estiver selecionada, o arquivo com os dados extraídos do sistema para envio ao Siscomex será gerado no diretório informado e o mesmo não será integrado de forma automática ao Portal Único.

Arquivo contendo as informações extraídas conforme seleção informada na tela de Integração de Produtos:

Quando o item for integrado com sucesso com o sistema Siscomex, o sistema irá atualizar automaticamente os campos: Código OPE Siscomex e versão OPE, com os valores retornados pelo Siscomex.



  • 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).
  • Quando o fornecedor estrangeiro tiver sido integrado com o Siscomex, a informação "Integrado Siscomex" estará marcada (imagem abaixo).

  • 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", 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:

Observação: quando a opção "Somente gera JSON local" estiver selecionada, o arquivo com os dados extraídos do sistema para envio ao Siscomex será gerado no diretório informado e o mesmo não será integrado de forma automática ao Portal Único.

Arquivo contendo as informações extraídas conforme seleção informada na tela de Integração de Operadores Estrangeiros:

Quando o operador estrangeiro for integrado com sucesso com o sistema Siscomex, o sistema irá atualizar automaticamente os campos: Código OPE Siscomex e versão OPE, na aba SiscomexII na rtotina CD2510, com os valores retornados pelo Siscomex.

Facilitador Cadastros Siscomex - spp/imp/spim043.r

  • Facilitador Cadastros Siscomex: Seu objetivo é preencher a aba Siscomex da rotina CD2510 e CD2576 com os dados já existentes no cadastro de Emitente e Itens do sistema;
  • Liberação: Esta rotina foi liberada a partir do pacote 12.1.2311;

 

    • Aba "OperEstrangeiro":
      • Para executar a criação ou atualização do cadastro de Operadores Estrangeiros ao clicar no botão "Executar", deve-se marcar o check-box "Cria/Atualiza - Fornecedores Estrangeiros", as informações atualizadas serão: Nome, endereço, cidade, cep e país;
      • Pode ser utilizada a execução por faixa de fornecedores, preenchendo o filtro por Código de Fornecedor ou Nome Abreviado;
      • Opção de "Criar dados" quando ainda não há informações preenchidas, "Atualiza sobrepondo todas as informações" para preencher novamente todas as informações sobrepondo as existentes, e "Atualiza somente informações novas" atualiza somente as informações que tiveram alteração no seu cadastro de origem;

    • Aba "Itens":
      • Para executar a criação ou atualização do cadastro de Itens Comex, deve-se marcar o check-box "Cria/Atualiza - Itens Comex", as informações atualizadas, ao clicar no botão "Executar",  serão: código comex, descrição, situação e modalidade;
      • Pode ser utilizada a opção de execução por faixa de Itens, com as opções de filtro: Código Item Comex, origem do item, grupo de estoque, família material e forma de obtenção;
      • Opção de "Criar dados" quando ainda não há informações preenchidas, "Atualiza sobrepondo todas as informações" para preencher novamente todas as informações sobrepondo as existentes, e "Atualiza somente informações novas" atualiza somente as informações que tiveram alteração no seu cadastro de origem;




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

Todas as informações necessárias são enviadas diretamente ao Portal Único do Siscomex. 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 "Programa Portal Único Siscomex";
    • 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;


Vídeo How to DUIMP - primeira fase: Comunica Suprimentos/Importação Datasul#MIM