Este artigo explica dois processos que usam planilhas XLS no sistema Flexus Comex Web:
- Vincular atributos a mercadorias já existentes no catálogo;
- Importar novas mercadorias ao catálogo de produtos.
Ambos os processos são feitos a partir do módulo de Catálogo, nos ambientes de Homologação ou Produção (o processo é o mesmo nos dois ambientes).
⚠️ Se você transferir uma mercadoria de ambiente (Homologação ↔ Produção), os atributos vinculados são desvinculados e precisam ser inseridos novamente.
1. Vincular atributos via Planilha de Atributos
Passo 1 — Bloquear a mercadoria
A mercadoria precisa estar bloqueada para gerar a planilha de atributos.
- Localize a mercadoria e use a ferramenta Bloquear (ícone de cadeado).
Passo 2 — Gerar a planilha
- Acesse a ferramenta Gerar XLS catálogo.
- Filtre por: mercadoria, NCM, importador, família, fabricante/produtor, adquirente, processo ou enviado — use o filtro que melhor atende sua necessidade:
- Uma mercadoria específica → filtre por mercadoria.
- Todas as mercadorias de um NCM → filtre por NCM.
- Todas as mercadorias de um importador → filtre por importador.
- Clique em Gerar XLS — a planilha será baixada no seu computador.
Passo 3 — Preencher a planilha
A planilha vem organizada por cores, indicando o que pode ou não ser alterado:
| Cor | Pode alterar? | Conteúdo |
|---|---|---|
| Vermelho | ❌ Não | Código do produto (PK) e NCM |
| Verde | ✅ Sim | Denominação e descrição completa do produto |
| Amarelo / laranja | ✅ Sim | Atributos da mercadoria (obrigatórios e sub-atributos) |
🚫 Regra importante: nesta planilha, não inclua novas linhas nem novas colunas. Se isso acontecer, o sistema apresentará erro de leitura ao tentar retornar os dados, e as informações não serão vinculadas corretamente.
Sobre os atributos:
- Podem ser do tipo domínio (lista de opções pré-definidas) ou texto livre.
- Alguns atributos têm sub-atributos (destacados em amarelo) que só precisam ser preenchidos em condições específicas — passe o cursor sobre o campo para ver a regra (ex: "se o atributo X for igual a 999/Outros, especifique o formato").
Quando a planilha reúne várias mercadorias:
- Os produtos aparecem agrupados por NCM — mercadorias com NCMs diferentes ficam em blocos separados dentro da planilha.
Passo 4 — Retornar a planilha ao sistema
- Salve a planilha preenchida.
- No sistema, acesse Catálogo de produtos → Retorno de XLS.
- Selecione a planilha preenchida.
- Aguarde a confirmação: "Retorno de XLS efetuado com sucesso".
Passo 5 — Conferir o resultado
- Edite a mercadoria e acesse Descrição e Atributos para confirmar que as informações foram vinculadas corretamente.
2. Importar novas mercadorias via Planilha XLS
Use a ferramenta Importar XLS para incluir mercadorias novas no catálogo (diferente da planilha de atributos, que serve para mercadorias já existentes).
🚫 Regra importante: nesta planilha, você pode incluir apenas novas linhas — não inclua novas colunas.
Campos da planilha de importação
Dados do produto:
| Campo | Obrigatório? |
|---|---|
| CNPJ do importador | ✅ Sim |
| Código do item | ✅ Sim |
| Denominação (até 100 caracteres) | ✅ Sim |
| Descrição completa | ✅ Sim |
| Descrição da nota fiscal | ❌ Não |
| Classificação (NCM) | ✅ Sim |
| Peso líquido | ❌ Não |
| Código da unidade de medida | ❌ Não |
| Código da unidade de peso | ❌ Não |
Dados do operador estrangeiro:
| Campo | Obrigatório? |
|---|---|
| Nome do operador | ✅ Sim |
| Endereço | ✅ Sim |
| CEP | ❌ Não (recomendado) |
| Cidade | ❌ Não (recomendado) |
| País | ❌ Não (recomendado) |
| Código TIM do operador | ❌ Não |
| Demais campos (em amarelo) | ❌ Não (opcionais) |
⚠️ Atenção máxima: digitação idêntica ao sistema
Este é o ponto que mais gera erro nesse processo:
Nome do operador, endereço, CEP, cidade e país devem ser digitados na planilha exatamente como já estão cadastrados no sistema — incluindo maiúsculas/minúsculas.
- Se houver qualquer diferença na grafia (ex: uma letra minúscula onde no sistema está maiúscula), o sistema vai entender que é um operador diferente e criará um novo operador estrangeiro duplicado, em vez de vincular a mercadoria ao operador já existente.
- Antes de preencher a planilha, confira o cadastro exato do operador em Cadastros → Operador estrangeiro → Editar, e copie a grafia exatamente como está lá (nome, endereço, CEP, cidade e país, geralmente em maiúsculas).
Mesmo não sendo obrigatórios, recomendamos sempre preencher cidade e país do operador — sem esses dados, o Portal Único pode retornar erro de sigla de país ausente ao tentar enviar a mercadoria.
Passo a passo para importar
- Preencha a planilha com os dados das mercadorias (respeitando as regras acima).
- Salve a planilha.
- No sistema, acesse Catálogo → escolha o ambiente (Homologação ou Produção).
- Use a ferramenta Importar XLS.
- Informe a linha inicial da planilha (ex: se a primeira mercadoria começa na linha 2, informe "2").
- Escolha a opção de agregar dados, se necessário:
- Agregar código do produto à descrição resumida;
- Agregar código do produto à descrição completa;
- Não agregar o código do produto.
- Opcional: usar a descrição do item em português como descrição resumida.
- Selecione o arquivo da planilha preenchida.
- Aguarde a confirmação: "Importação de XLS efetuada com sucesso".
Conferindo o resultado
- Volte ao Catálogo de produtos e localize as mercadorias recém-importadas.
- Confira o campo Fabricante — se o operador foi digitado corretamente (igual ao sistema), ele já aparecerá vinculado automaticamente, sem duplicação.
Resumo rápido — diferenças entre as duas planilhas
| Planilha de Atributos | Planilha de Importação | |
|---|---|---|
| Finalidade | Vincular atributos a mercadorias já existentes | Cadastrar mercadorias novas |
| Pode incluir linhas? | ❌ Não | ✅ Sim |
| Pode incluir colunas? | ❌ Não | ❌ Não |
| Exige mercadoria bloqueada? | ✅ Sim | Não se aplica |
| Risco comum de erro | Adicionar linha/coluna → erro de leitura | Digitar operador diferente do sistema → duplicação |
Ficou com alguma dúvida? Entre em contato com o nosso suporte.
Comentários
0 comentário
Por favor, entre para comentar.