Importar produtos em massa

Dá para cadastrar muitos produtos de uma vez subindo uma planilha. Para isso dar certo, o cabeçalho precisa usar exatamente os nomes de coluna que o sistema reconhece.

O sistema não adivinha colunas

O H4ND usa um layout fixo com nomes de coluna exatos na primeira linha da planilha. Maiúsculas/minúsculas tanto faz e espaços nas pontas são ignorados — mas sinônimos não valem. Se a coluna se chamar EAN em vez de Código de barras, o campo é ignorado sem aviso.

Dica prática

Use a planilha-modelo exportada pelo próprio sistema em vez de montar uma do zero. Qualquer renomeação — mesmo trivial, como Cod. Barras no lugar de Código de barras — faz o campo sumir silenciosamente.

Colunas obrigatórias

Sem estas duas, o arquivo é rejeitado e nenhum produto é importado.

Coluna na planilha	O que representa
Código do produto	Vira o SKU do produto
Nome do produto	Nome do produto (chave para deduplicar)

Demais colunas reconhecidas

Identificação

Coluna na planilha	O que representa
Código de barras	EAN (ver regras do código de barras)
Referência interna do produto	Código de referência livre

Classificação

Coluna na planilha	O que representa
Categoria do produto	Grupo — criado automaticamente se não existir
Subcategoria nível 1	Subgrupo — criado automaticamente
Unidade de medida	Usa UN quando vazio

Estoque e preço

Coluna na planilha	O que representa
Estoque	Quantidade em estoque
Estoque mínimo	Quantidade mínima
Preço de custo	Preço de compra
Preço de venda	Preço de venda
Preço mínimo de venda	Limite inferior de venda

Fiscal

Coluna na planilha	O que representa
NCM	Precisa ter 8 dígitos para ser aceito
CEST	Código CEST
Origem do produto	Origem da mercadoria (numérico)
Situação tributária IPI	CST IPI
Alíquota IPI (%)	Alíquota IPI
Situação tributária COFINS	CST COFINS
Alíquota COFINS (%)	Alíquota COFINS
Situação tributária PIS	CST PIS
Alíquota PIS (%)	Alíquota PIS
Situação tributária ICMS	CST ICMS (Regime Normal)
CSOSN	CSOSN (Simples Nacional)
Alíquota ICMS (%)	Alíquota ICMS
Redução na base de cálculo de ICMS	Percentual de redução

Regras do código de barras

• O sistema extrai apenas os dígitos — máscaras, espaços e pontos são limpos automaticamente.
• Aceita o formato que o Excel costuma gerar (7891234567890 ou 7891234567890.0 — ambos funcionam).
• Tamanho válido: 8 a 14 dígitos (padrão GS1 — EAN-8, EAN-13 ou GTIN-14).
• Menos de 8 dígitos: o código de barras é descartado silenciosamente, mas o produto é importado mesmo assim (sem código).
• Mais de 14 dígitos: a linha inteira falha e vai para o relatório de erros (provável erro de digitação ou concatenação).

Comportamentos importantes

• Atualiza em vez de duplicar: se o Nome ou o Código do produto já existe na base, o sistema atualiza o produto existente (atualiza apenas NCM, CEST, Origem, Preço de custo e Preço mínimo) em vez de criar outro.
• Categoria/Subcategoria novas são criadas automaticamente quando aparecem com um nome ainda não cadastrado.
• Código do produto vazio: o sistema gera um sequencial automaticamente.
• Linhas com Nome vazio são puladas silenciosamente (não viram erro).
• Encoding numérico do Excel é tratado: valores como 10300.0 em campos de código viram 10300.

Antes de subir um arquivo grande

Faça um teste com 2–3 linhas e confirme:

1. O cabeçalho está com o nome exato de cada coluna.
2. O código de barras tem o tamanho esperado (8 a 14 dígitos).
3. Categoria/Subcategoria batem com o que já existe no cadastro — ou são nomes novos intencionais.

Linhas que falham aparecem no relatório do job de importação com a mensagem específica do erro.