Módulo de API Portal Único

Este artigo explica o módulo de API Portal Único, dentro de Integrações, que permite importar o catálogo de produtos de um importador diretamente do Portal Único para o sistema Flexus Comex Web.

⚠️ Leia isto antes de usar o módulo pela primeira vez: esse módulo pode gerar duplicidade de operadores estrangeiros e mercadorias se o cadastro no Flexus não estiver alinhado com o Portal Único. Corrigir duplicidade em massa é muito mais trabalhoso do que revisar o catálogo antes de importar — veja a seção 4 antes de rodar uma importação completa.

1. O que o módulo faz

Permite importar, direto do Portal Único, para um importador específico:

• Todos os operadores estrangeiros;
• O catálogo de produtos;
• O vínculo entre fabricante e importador (criado automaticamente).

2. Formas de importar

O módulo oferece 4 formas de importação, dependendo do que você precisa:

Importar o catálogo completo

1. Acesse Integrações → API Portal Único.
2. Selecione o importador, o tipo de ambiente (Homologação/Produção) e o certificado.
3. Clique em Executar.

Isso importa automaticamente todos os operadores estrangeiros e o catálogo de produtos, já vinculando fabricante e importador.

Importar apenas uma mercadoria

1. Selecione o importador, ambiente e certificado.
2. Preencha o filtro Código do Catálogo com o código da mercadoria desejada.
3. Clique em Executar.

Apenas aquela mercadoria (e o operador vinculado a ela, se ainda não existir) será importada — o restante do catálogo não é tocado.

3. Como funciona o vínculo (evitar duplicidade)

Este é o ponto mais importante do módulo. Para que a importação vincule corretamente ao invés de duplicar, alguns dados precisam estar idênticos entre o Portal Único e o Flexus.

Vínculo de Operador Estrangeiro

O sistema faz a verificação em duas etapas:

1. 1ª verificação: código interno + nome do operador — se ambos forem iguais ao Portal Único, o operador é vinculado.
2. 2ª verificação (se o código interno divergir): nome + endereço do operador.

Resumindo a regra:

• O nome do operador precisa sempre estar escrito exatamente igual ao Portal Único.
• E pelo menos um entre código interno OU endereço também precisa estar igual.

💡 Diferença entre maiúsculas/minúsculas não quebra o vínculo do nome — mas qualquer outra divergência de escrita (faltar uma letra, um número diferente, espaço a mais) quebra.

Se o nome estiver divergente, ou se nome estiver certo mas código e endereço estiverem os dois errados → o operador é duplicado na importação.

Vínculo de Mercadoria (Catálogo)

Regra semelhante, mas com critérios próprios:

1. O CNPJ do importador precisa estar igual ao Portal Único (obrigatório, sempre).
2. E pelo menos um entre código interno OU código do catálogo também precisa estar igual.

Se os dois (código interno e código do catálogo) estiverem diferentes do Portal Único → a mercadoria é duplicada.

📌 Essas regras de vínculo valem igualmente para os dois ambientes: Homologação e Produção.

4. Recomendação: revise o catálogo antes de importar

Antes de rodar uma importação (principalmente do catálogo completo), é recomendado fazer uma revisão prévia, conferindo se os operadores e mercadorias já cadastrados no Flexus batem com o Portal Único nos critérios acima.

⚠️ O impacto de pular essa revisão escala rápido: em um catálogo com 1.000 mercadorias, se 50% estiverem com dados divergentes do Portal Único, isso significa 500 mercadorias duplicadas de uma vez. Corrigir isso depois é muito mais trabalhoso do que revisar antes.

5. O que fazer se já duplicou um operador ou mercadoria

Depois de uma importação que gerou duplicidade, você não consegue simplesmente excluir o registro duplicado se ele já estiver vinculado a algo:

• Um operador não pode ser excluído se estiver vinculado a uma mercadoria do catálogo.
• Uma mercadoria não pode ser excluída se já estiver vinculada a um processo de DUIMP.

Solução: desativar em vez de excluir

Para um operador estrangeiro:

1. Acesse Cadastros → Operador Estrangeiro.
2. Localize o operador duplicado → Alterar Operador.
3. Desmarque a opção Ativo.
4. Clique em Salvar.

O mesmo processo (desativar em vez de excluir) vale para mercadorias duplicadas no catálogo.

6. Opção "Alterar Descrição Produto"

Essa opção, disponível no filtro de importação por Produto, serve para sincronizar a denominação e a descrição completa da mercadoria com o que está cadastrado no Portal Único.

Como funciona:

• Se você importar com essa opção marcada, a denominação e a descrição completa da mercadoria são sobrescritas pelos dados do Portal Único (só funciona em mercadorias que conseguiram ser vinculadas — mercadorias que duplicaram por falta de vínculo mantêm os dados que estavam no Flexus).
• Se importar sem marcar essa opção, apenas os dados de vínculo/atributos são atualizados, sem mexer em denominação e descrição.

Resumo — checklist antes de importar

• Nome do operador estrangeiro está idêntico ao Portal Único (maiúscula/minúscula não importa, o resto sim)?
• Código interno ou endereço do operador batem com o Portal Único?
• CNPJ do importador está correto?
• Código interno ou código do catálogo da mercadoria batem com o Portal Único?
• Fez uma prévia revisão do catálogo antes de importar tudo de uma vez?

Se todos os itens acima estiverem certos, a importação vincula corretamente, sem gerar duplicidade.

Ficou com alguma dúvida? Entre em contato com o nosso suporte: suporte@flexuscomex.com.br