Módulo de Catálogo

Este artigo explica em detalhes o módulo de Catálogo do sistema Flexus Comex Web: cadastro e estorno de mercadorias, os ambientes de Homologação e Produção, e todas as ferramentas disponíveis para gerenciar o catálogo de produtos e enviá-lo ao Portal Único.

💡 O catálogo de produtos é a base para a montagem dos processos de DUIMP — por isso, manter as mercadorias corretamente cadastradas e com os atributos preenchidos evita retrabalho e erros no envio ao Portal Único.

1. Home e navegação inicial

Após o login, o usuário acessa a Home do sistema, que exibe três indicadores principais:

• DUIMPs em Andamento
• Pushs Ativos
• DUIMPs Finalizadas

No menu lateral esquerdo ficam os cinco módulos do sistema: Cadastros, Catálogo, Movimentação, Integrações e Parâmetros.

Ao selecionar o módulo Catálogo, aparecem 4 submódulos: Cadastro de Mercadoria, Estornar Mercadoria, Homologação e Produção.

2. Cadastro de Mercadoria

Objetivo: listar todas as mercadorias presentes no banco de dados compartilhado com o iBroker, evitando a redigitação de produtos já existentes no Flexus Comex.

Como enviar uma mercadoria ao catálogo:

1. Use os filtros disponíveis: Mercadoria, NCM, Importador, Exportador, Grupo Cliente, Família e Processo.
2. Clique em Filtrar.
3. Selecione a(s) mercadoria(s) desejada(s) na lista.
4. Clique em Enviar Mercadorias para Homologação ou Enviar Mercadorias para Produção.

💡 Para ir para a DUIMP, a mercadoria precisa ter código interno e denominação preenchidos.

⚠️ Uma mercadoria que já está em Homologação ou Produção não aparece mais na lista de Cadastro de Mercadoria.

3. Estornar Mercadoria

Objetivo: retirar uma mercadoria dos ambientes de Homologação ou Produção.

Como estornar:

1. Use os filtros: Mercadoria, NCM, Importador, Grupo Cliente e Família.
2. Clique em Filtrar.
3. Selecione a(s) mercadoria(s) e clique em Estornar Mercadorias.

4. Ambientes: Homologação e Produção

Os módulos de Homologação e Produção servem para criar o catálogo de mercadorias — permitindo alterar dados básicos, descrições, incluir fabricantes/produtores, vincular atributos e enviar o catálogo ao Portal Único.

⚠️ Atenção: os ambientes são estruturalmente idênticos, mas os atributos são independentes entre eles — os atributos gerados para uma mercadoria em Homologação são diferentes dos atributos da mesma mercadoria em Produção. Ao mudar uma mercadoria de ambiente, os atributos vinculados são removidos e precisam ser reincluídos.

A tela de cada ambiente tem 3 áreas principais:

1. Atalhos (ícones à esquerda de cada mercadoria)
2. Filtro (campo de busca)
3. Ferramentas e Módulos (barra superior)

4.1 Atalhos (por mercadoria)

Cada mercadoria tem três ícones de ação:

🟢 Alterar Produto Abre a edição completa da mercadoria, dividida em 4 abas:

• Dados Básicos — campos obrigatórios: Situação Catálogo do Produto, Modalidade, Ambiente, Denominação/Mercadoria, Importador e NCM. Os demais campos não são obrigatórios, mas são importantes.
• Descrição Mercadoria — descrição da mercadoria e descrição para nota fiscal.
• Fabricante/Produtor — clique em + Incluir Fabricante/Produtor para adicionar um fabricante (é possível incluir quantos forem necessários). Se o fabricante for desconhecido, ative a opção Fabricante Desconhecido — nesse caso, o país do fabricante passa a ser obrigatório.
• Atributos — veja a seção 4.3 abaixo para os 3 métodos de vinculação.

Para salvar as alterações, a mercadoria precisa estar desbloqueada e todos os campos obrigatórios preenchidos. Use os botões Salvar ou Cancelar.

🟡 Deletar Produto Apaga a mercadoria por completo, inclusive do banco de dados. Diferente do Estorno (que só retira do catálogo), aqui não há volta — se precisar da mercadoria de novo, será necessário cadastrá-la como nova.

🟣 Bloquear/Desbloquear

⚠️ A mercadoria precisa estar bloqueada para: gerar planilha de atributos (XLS) ou enviar a mercadoria ao Portal Único.

4.2 Filtro

O campo de busca (Localizar) permite filtrar mercadorias por: Código, Denominação, Importador e NCM. O botão Limpar Filtro apaga o campo de busca e desmarca as mercadorias selecionadas.

4.3 Vinculando atributos às mercadorias — 3 métodos

Os atributos ficam dentro de Alterar Produto → Atributos. Existem três formas de vinculá-los:

Método 1 — Botão "Incluir Atributo" (dentro da mercadoria) Permite incluir manualmente, um a um, cada atributo ligado ao NCM da mercadoria.

Método 2 — Botão "Vincular Atributos" (na barra superior) Vincula automaticamente todos os atributos ligados ao NCM das mercadorias selecionadas na lista. Depois de vinculados, ainda é preciso preencher os atributos manualmente.

Método 3 — Planilha de Atributos (XLS) Veja o passo a passo completo na seção 6.

Sobre o preenchimento dos atributos: Existem 3 tipos de atributo:

• Alguns atributos de domínio geram subatributos condicionais — por exemplo, ao selecionar a opção "999 - Outros (especifique)", o sistema exige o preenchimento de um subatributo com texto livre detalhando a informação. O mesmo vale para domínios em cadeia, como um atributo "Uso aeronáutico? Sim/Não" que, se "Sim", abre outros subatributos obrigatórios (ex: indicação de CESAR e registro de certificado).
• Em atributos multivalorados, clique no campo para abrir as opções, selecione todas as que se aplicam (elas ficam listadas), e para remover uma opção já selecionada, clique nela novamente ou no "x" ao lado.

Exemplo prático (do manual): Mercadoria "Papel para Embalagem" → atributos Forma de Apresentação (domínio: Rolos / Folhas / Outros) e Gramatura (caixa de texto, g/m²). Se "Forma de Apresentação" = "999 - Outros", é obrigatório preencher o subatributo "Especifique forma de apresentação".

4.4 Indicadores visuais de atributos

Na lista do catálogo, ícones ao lado de cada mercadoria sinalizam pendências nos atributos (não preenchidos, alterados, ou necessidade de reenvio ao Portal Único).

📎 Veja também: O que significam os indicadores de atributo no Catálogo? — artigo dedicado com a explicação de cada indicador e o que fazer em cada caso.

4.5 Incluir/Atualizar e Excluir atributos em massa (por NCM)

Além dos 3 métodos acima (que agem sobre mercadorias específicas), existem duas ferramentas que atuam sobre todas as mercadorias de um mesmo NCM de uma vez:

Incluir/Atualizar Atributos

1. Informe o NCM desejado e clique em Filtrar.
2. São listados todos os atributos vinculados a esse NCM.
3. Selecione os atributos e, se quiser, já preencha os valores.
4. Ao confirmar, todas as mercadorias com esse NCM recebem/atualizam esses atributos de uma vez — sem precisar editar mercadoria por mercadoria.

Excluir Atributos

1. Informe o NCM desejado e clique em Filtrar.
2. São listados os atributos disponíveis para exclusão.
3. Selecione os atributos a remover.
4. Útil quando um atributo foi descontinuado e não se aplica mais às mercadorias daquele NCM.

⚠️ Essas duas ferramentas afetam todas as mercadorias vinculadas ao NCM informado — use com atenção, principalmente em bases com muitas mercadorias.

5. Ferramentas e Módulos (barra superior do Catálogo)

A barra superior de Homologação/Produção reúne 6 ferramentas:

5.1 Novo Produto

Abre a tela de cadastro de mercadoria (mesmos campos de "Alterar Produto", descritos na seção 4.1).

5.2 Enviar Catálogo

Pré-requisito: a mercadoria precisa estar bloqueada.

Filtros disponíveis: Mercadoria, NCM, Importador, Grupo Cliente, Família, Processo, Enviado, Bloqueado e Situação Catálogo do Produto.

A tela oferece 3 opções de envio, dependendo da situação da mercadoria (nova, já enviada, ou apenas vinculação de fabricante).

📎 Veja também: Qual opção usar para enviar minha mercadoria ao Portal Único? — artigo dedicado com a tabela de decisão entre as 3 opções e o passo a passo completo.

5.3 Repasse (alteração em lote)

Permite alterar várias mercadorias de uma só vez.

Filtros disponíveis: Mercadoria, NCM, Importador, Família, Processo, Enviado, Bloqueado e Situação Catálogo do Produto.

Dados que podem ser repassados em lote:

• Importador
• Fabricante/Produtor
• Família
• Status Catálogo
• Modalidade

Preencha os novos valores e clique em Repassar Dados Catálogo.

💡 Marque a opção "Repassar apenas para campos em branco" se quiser que a alteração só afete mercadorias que ainda não têm aquele dado preenchido — mercadorias que já têm o campo preenchido não serão sobrescritas. Sem marcar essa opção, o repasse substitui o valor em todas as mercadorias selecionadas, mesmo as que já tinham dado preenchido.

Ações em lote adicionais:

• 🔒 Bloquear
• 🔓 Desbloquear
• 🗑️ Remover Fabricante Produto
• 📤 Enviar Produção

⚠️ Ao usar Enviar Produção em lote, lembre-se: mudar o ambiente de uma mercadoria remove os atributos vinculados a ela — será preciso vinculá-los novamente no novo ambiente.

5.4 Vincular Atributos (em lote)

Mesmo funcionamento do Método 2 da seção 4.3, mas aplicado a todas as mercadorias selecionadas na lista de uma vez.

6. Planilha de Atributos (Gerar XLS Catálogo + Retorno XLS)

Use esta planilha para vincular e preencher atributos de mercadorias já existentes.

Passo 1 — Gerar a planilha

1. A mercadoria precisa estar bloqueada.
2. Clique em Gerar XLS Catálogo.
3. Filtre por: mercadoria, NCM, importador, família, fabricante/produtor, adquirente, processo, ou se a mercadoria já foi enviada ou não.
4. A planilha é baixada automaticamente no computador.

Passo 2 — Entender as cores da planilha

• Se a planilha tiver mais de uma mercadoria, elas ficam organizadas em guias separadas por NCM na parte inferior — mercadorias só compartilham a guia se tiverem o mesmo NCM.

Passo 3 — Preencher e retornar

1. Preencha os campos verdes, amarelos e laranjas conforme necessário.
2. Salve a planilha.
3. No sistema, clique em + Retorno XLS.
4. Selecione o arquivo preenchido.
5. Confirmação esperada: "Retorno XLS efetuado com sucesso".

🚫 Regra crítica: não inclua novas linhas nem novas colunas nesta planilha. O objetivo dela é apenas vincular/preencher atributos das mercadorias já listadas — qualquer alteração na estrutura gera erro de leitura e os dados não são vinculados.

7. Importar XLS (cadastro de novas mercadorias)

Use esta ferramenta para incluir mercadorias novas no catálogo, a partir de um modelo de planilha padrão.

Campos da planilha (nesta ordem obrigatória)

🚫 Regra crítica: respeite a ordem das colunas do modelo — o sistema lê os dados pela posição. Você pode incluir apenas novas linhas, nunca novas colunas.

⚠️ Atenção máxima: digitação idêntica ao sistema

Os dados do Operador Estrangeiro (nome, endereço, CEP, cidade e país) precisam ser digitados na planilha exatamente como estão cadastrados no sistema — incluindo maiúsculas e minúsculas.

Exemplo do manual:

• Cadastro no sistema: EMPRESA ESTRANGEIRA
• Planilha digitada como EMPRESA ESTRANGEIRA → ✅ vincula ao operador já existente.
• Planilha digitada como EMPRESA ESTRANGEIRa (um "a" minúsculo) → ❌ cria um novo operador duplicado.

Mesmo não sendo obrigatórios, é recomendado preencher CEP, cidade e país — sem eles, o envio ao Portal Único pode retornar erro por falta de sigla de país.

Passo a passo para importar

1. Preencha a planilha modelo com as mercadorias (respeitando ordem de colunas e grafia idêntica ao sistema).
2. Clique em Importar XLS.
3. Informe a Linha Inicial — geralmente "2", já que a linha 1 costuma ser o cabeçalho.
4. Escolha a opção de Agregar Dados:
   • Agregar código do produto à descrição resumida;
   • Agregar código do produto à descrição completa;
   • Não agregar o código do produto.
5. Opcional: marcar "Utilizar a Descrição do item em Português para Descrição Resumida".
6. Selecione o arquivo da planilha preenchida.
7. Confirmação esperada: "Importar XLS efetuado com sucesso".

Resumo rápido — Planilha de Atributos vs. Importar XLS

Suporte

Em caso de dúvida, entre em contato com nossa equipe de suporte pelo e-mail suporte@flexuscomex.com.br.