Detalhes da planilha de importação/atualização de produtos

Produtos
1

Este artigo explica como preencher corretamente a planilha de importação e atualização de produtos, destacando os campos que exigem mais atenção para evitar erros durante o processo.

No vídeo um tutorial completo, passando por cada coluna da planilha:

:warning: Atenção à estrutura da planilha

Antes de qualquer preenchimento:

  • Não altere a estrutura da planilha

  • Não remova, renomeie ou mude a ordem das três primeiras colunas:

    • id_produto

    • nome

    • id_variacao

  • As colunas de grade (iniciadas por grade:) também não devem ser alteradas

Essas regras garantem que o sistema consiga identificar corretamente os produtos e suas variações.

id_produto:

  • Utilize este campo apenas para atualizar produtos já existentes
  • O ID deve ser informado exatamente como está no sistema
  • Para produtos novos, deixe o campo em branco

:magnifying_glass_tilted_right: Qualquer diferença no ID, inclusive letras maiúsculas ou minúsculas, pode gerar erro.

nome:

  • Campo obrigatório na criação de novos produtos

  • Para produtos sem grade, preencha normalmente

  • Para produtos com grade:

    • Preencha o nome apenas na primeira linha

    • Nas variações, informe apenas o id_produto do produto pai

:warning: Produtos com o mesmo nome são tratados como produtos com grade.

id_variacao:

  • Utilize este campo apenas para atualizar variações já existentes

  • Para novas variações, deixe o campo em branco

  • O ID precisa estar exatamente igual ao cadastrado no sistema

grades:

  • As colunas iniciadas por grade: representam as variações do produto

  • Para criar uma nova grade, adicione uma coluna como:

    • grade:Cor

  • Para utilizar uma grade já existente, informe o nome ou o ID exatamente como está no sistema

:pushpin: Importante:

  • Produtos com o mesmo nome ou mesmo id_produto devem ter as mesmas grades

  • Grades duplicadas ou divergentes geram erro de validação

categorias:

  • As categorias funcionam em níveis hierárquicos

  • Para usar categoria_nivel_2, o nível 1 deve estar preenchido

  • Para usar categoria_nivel_3, os níveis 1 e 2 devem estar preenchidos

  • Categorias inexistentes são criadas automaticamente, respeitando a hierarquia

códigos:

codigo_sku

  • Campo opcional

  • Se não preenchido, o sistema gera automaticamente

codigo_barras

  • Campo opcional

  • Aceita apenas números

  • Recomendado seguir o padrão EAN-13

  • Se não preenchido, o sistema pode gerar automaticamente

custo e composição do custo:

Campos relacionados:

  • custo

  • valor_compra

  • ipi

  • icms_st

  • seguro

  • difal

  • outras_despesas

Regras importantes:

  • Aceitam apenas valores numéricos

  • Podem usar ponto ou vírgula para centavos

  • Se os campos de composição forem preenchidos, a soma deve ser igual ao campo custo

markup e preço:

  • Se custo e markup estiverem preenchidos e o preco estiver vazio, o sistema calcula o preço automaticamente

  • Se custo, markup e preco estiverem preenchidos, os valores precisam estar coerentes

  • Inconsistências nesses campos podem gerar erro na importação

estoque:

Na exportação de produtos/importação:

  • Substitui o estoque atual do produto no sistema

Adição de estoque (apresentada apenas na mov. de estoque)

  • Soma a quantidade informada ao estoque atual

:warning: Importante:

  • Nunca utilize estoque e adição de estoque ao mesmo tempo para o mesmo produto.

fornecedores:

Você pode vincular até três fornecedores por produto:

  • Usando o ID do fornecedor (id_fornecedor_1, 2 ou 3)

  • Ou cadastrando um novo fornecedor informando:

    • cnpj/cpf_fornecedor

    • nome_fornecedor

:pushpin: Se o ID do fornecedor for informado, os demais dados serão ignorados.

dados fiscais:

Campos como:

  • ncm

  • cest

  • ICMS-ST

  • Base de cálculo FCP

  • cnpj_fabricante

  • beneficio_fiscal

Regras:

  • Campos opcionais

  • Quando preenchidos, devem conter apenas valores válidos e no formato correto

peso e dimensões:

Campos:

  • peso_liquido(kg)

  • peso_bruto(kg)

  • altura(m)

  • largura(m)

  • profundidade(m)

Regras:

  • Preencher apenas com números

  • Não incluir unidades como “kg” ou “m” no valor

integração com ecommerce:

Descricao_ecommerce:

  • descrição detalhada do produto para ser exibida no canal de e-commerce.

Sincronizar_ecommerce:

  • aceita apenas ‘sim’ ou ‘não’

Origem:

  • aceita apenas ‘nacional’ ou ‘internacional’

Em caso de dúvida

Se surgir qualquer dúvida durante o preenchimento ou se a importação apresentar erros, entre em contato com o suporte especializado para orientação.