Histórico da Página
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.
| Aviso | ||
|---|---|---|
| ||
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:
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 |
Instalação/Atualização
| Totvs custom tabs box | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||
|
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 "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. | |
| 55967 | Erro 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;
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas