Skip to main content

Manual de Preenchimento da Planilha de Importação de Produtos

Este manual orienta o preenchimento correto da planilha utilizada no Conversor de Dados do NovoAvanço, garantindo padronização e compatibilidade com o processo de importação do sistema.

Cada aba (“guia”) da planilha possui um propósito específico e regras próprias para preenchimento, conforme descrito a seguir.

PARA BAIXAR A PLANILHA EXEMPLO DE PREENCHIMENTO, CLIQUE AQUI.

📄 Guia: “dados”

Responsável por armazenar as informações principais (capa) do cadastro de produtos.

Colunas e Regras de Preenchimento

codigoProduto

  • Indica o código interno do produto.

  • Deve conter apenas números inteiros, sem letras ou caracteres especiais.

  • É o campo base de referência para todas as outras guias.

  • Cada código deve aparecer uma única vez na planilha.

  • Não pode haver repetições.

  • Máximo: 6 dígitos.

  • Importante: Este campo é o identificador principal do produto. Qualquer divergência de código entre guias causará erro na importação.

  • Campo obrigatório

eanTributavel

  • Código de barras utilizado para movimentação fiscal (emissão de notas).

  • Campo obrigatório.

  • Deve ser numérico inteiro, com no máximo 14 dígitos.

  • Sem caracteres especiais, espaços ou letras.

  • Representa o codigo do produto para fins fiscais.

  • Não é o código EAN que será considerado para enviar para os caixas. O Código EAN ( principal e agrupados ), devem estar na guia agrupamento EAN.

codigoAlternativo

  • Código alternativo ao EAN, podendo ser alfanumérico com até 14 caracteres.

  • Utilizado quando o cliente possui códigos próprios ou internos, além do EAN.

  • Proibido o uso de caracteres especiais.

  • Permitido: letras e números apenas.

  • Não deve ser inseridos códigos EAN nessa coluna.

descricao

  • Descrição completa do produto.

  • Deve estar em CAIXA ALTA, com no máximo 140 caracteres.

  • Permitidos apenas os seguintes caracteres:
    . / - ( ) * + _ & % $ @

  • Proibido: acentuação, aspas, vírgulas, ponto e vírgula ou qualquer outro caractere especial.

  • Campo alfanumérico.

  • Campo obrigatório

descricaoResumida

  • Descrição abreviada, utilizada para etiquetas, ECF e PDV.

  • Deve seguir os mesmos critérios da descrição principal, porém limitada a 40 caracteres.

  • Usar sempre caixa alta.

  • Campo obrigatório

descricaoExpandida

  • Deve repetir exatamente o conteúdo do campo descricao.

  • Campo obrigatório

bloqueadoVenda

  • Define se o produto será enviado para o PDV.

  • Quando true, o produto não é enviado (exemplo: produtos de uso interno ou consumo).

  • Aceita: true, false, S, N.

  • Valor padrão: false.

  • Campo obrigatório

unidadeVenda

  • Unidade de venda da mercadoria.

  • Permitido apenas 2 caracteres, em caixa alta (ex.: UN, KG, CX).

  • Sem caracteres especiais.

  • Representa a unidade comercial padrão para venda.

  • Campo obrigatório

marca

  • Marca do produto.

  • Caso não exista informação, deixar em branco ou preencher com "Local".

tipoPesoVariavel

  • Indica se o produto é de peso variável (ex.: produtos de balança).

  • Define também se o PDV permitirá leitura via código de balança.

  • Aceita: true, false, S, N.

  • Campo obrigatório

vendaFracionada

  • Define se o produto pode ser vendido de forma fracionada (ex.: FLV).

  • Deve ser ativado se o preço do produto for definido por peso.

  • Aceita: true, false, S, N.

  • Campo obrigatório

camposto

  • Indica se o produto faz parte de um kit ou composição (ex.: cesta básica, bolo, combo).

  • Aceita: true, false, S, N.

quantidadeMaxima

  • Quantidade máxima que pode ser vendida em uma única operação.

  • Campo numérico com até 4 dígitos.

  • Valor padrão: 9999.

  • Campo obrigatório

quantidadeMinima

  • Quantidade mínima obrigatória por venda.

  • Campo numérico com até 4 dígitos.

  • Valor padrão: 0.

  • Campo obrigatório

idConcentrador

  • Código utilizado para vinculação de composições e outros cadastros.

  • Por padrão, utilizar o mesmo valor de codigoProduto.

etiquetaGondola

  • Define se o produto pode ser impresso em etiqueta de gôndola.

  • Padrão: true.

  • Aceita: true, false, S, N.

etiquetaSeguranca

  • Campo inativo, mas obrigatório.

  • Preencher sempre com false.

fatorConversao

  • Fator de conversão de venda.

  • Define a multiplicação entre unidade de venda e quantidade vendida.

  • Campo numérico, até 2 dígitos.

  • Padrão: 1.

  • Campo obrigatório

fatorConversaoEntrada

  • Fator de multiplicação utilizado na entrada de mercadorias.

  • Exemplo: fator 12 indica que uma caixa contém 12 unidades.

  • Campo numérico, até 2 dígitos.

  • Campo obrigatório

consultaRapida

  • Indica se o produto pode ser pesquisado no PDV pela tecla F7.

  • Padrão: true.

  • Campo obrigatório

unidadeMedidaTributavel

  • Unidade de medida usada para tributação.

  • Geralmente igual à unidade de venda.

  • Somente letras (sem números), máximo de 2 caracteres, em caixa alta.

  • Campo obrigatório

codigoAnp

  • Código de 9 dígitos definido pela Agência Nacional do Petróleo, Gás Natural e Biocombustíveis (ANP).

  • Obrigatório apenas para combustíveis, lubrificantes e derivados.

  • Caso não aplicável, deixar em branco.

  • Numérico, sem pontos, traços ou espaços.

pesoKg

  • Peso total do produto.

  • Aceita valores fracionários (ex.: 10,5).

  • Utilizado para cálculos de balança e tributação.

origemNacionalidade

  • Define a origem do produto:

    • 0 = Nacional

    • 1 = Internacional

  • Campo numérico com apenas 1 dígito.

  • Padrão: 0 (Nacional).

  • Campo obrigatório

cest

  • Código CEST de 7 dígitos numéricos inteiros e positivos.

  • Importante: manter a célula em formato texto para preservar zeros à esquerda.

  • Não incluir pontos, traços, vírgulas ou espaços.

  • Obrigatório se o produto estiver cadastrado com CST ICMS = 60.

  • Campo obrigatório

ncm

  • Código NCM de 8 dígitos numéricos inteiros e positivos.

  • Importante: manter a célula em formato texto no Excel para preservar zeros à esquerda.

  • Não incluir pontos, traços, vírgulas ou espaços.

  • Somente números.

  • Campo obrigatório

incidePisCofins

  • Indica se o produto possui incidência de PIS/COFINS.

  • Aceita: true, false, S, N.

  • Obrigatório se houver CST PisCofins igual a 1.

  • Não incluir pontos, traços, vírgulas ou espaços.

pisCSTSaida

  • Código CST do PIS.

  • Campo numérico, 1 dígito.

  • Não incluir pontos, traços, vírgulas ou espaços.
  • Campo obrigatório

pisAliquota

  • Alíquota do PIS.

  • Preencher apenas se o CST for 1.

  • Caso contrário, deixar zerado.

  • Não incluir pontos, traços, ou espaços.
  • Permitido vírgula para aliquotas como ( 1,65, por exemplo )
  • Campo obrigatório

cofinsCSTSaida

    • Código CST do PIS.

    • Campo numérico, 1 dígito.

    • Não incluir pontos, traços, vírgulas ou espaços.
    • Campo obrigatório

cofinsAliquota

    • Alíquota do Cofins.

    • Preencher apenas se o CST for 1.

    • Caso contrário, deixar zerado.

    • Não incluir pontos, traços, ou espaços.
    • Permitido vírgula para aliquotas como ( 7,60, por exemplo )
    • Campo obrigatório

cofinsAliquotaReais

  • Campo opcional.

  • Caso não aplicável, manter em branco.

  • Permitido vírgula para aliquotas como ( 7,60, por exemplo )

📄Guia: “agrupamentoEAN”

Guia destinada à vinculação de códigos de barras adicionais a um mesmo código interno de produto.

Colunas

codigoProduto

  • Deve conter exatamente os mesmos códigos internos da guia “dados”.

  • Pode se repetir somente quando houver múltiplos EANs vinculados ao mesmo produto.

  • Numérico, inteiro, positivo.

ean

  • Todos os códigos de barras vinculados ao produto.

  • Nessa coluna deve ser 

  • Numérico, inteiro, positivo, com até 14 dígitos.

  • Sem repetições.

  • Deve incluir também o código interno como um dos EANs, garantindo a vinculação completa (importante para relatórios e produtos de balança).

  • Evite a formatação automática do Excel que resume códigos longos. Configure a célula como texto.

principal

  • Define o EAN principal entre os agrupados.

  • Obrigatório ter pelo menos um EAN principal por código interno.

  • Aceita: true, false, S, N.

fator

  • Fator de venda do EAN.

  • Padrão: 1.

  • Pode variar em casos de caixas ou fardos.

  • Não pode conter casas decimais.
  • Não incluir pontos, traços, vírgulas ou espaços.

precoVenda

  • Preço específico para o EAN (quando aplicável).

  • Caso não exista preço diferenciado, deixar em branco.

📄Guia: “precos”

Destinada à informação de preços, custos, PMZ e estoque.

Colunas

numeroDaLoja

  • Número da loja responsável pelo registro.

  • Numérico, positivo, até 2 dígitos.

  • É permitido informar todas as lojas na mesma planilha.

codigoProduto

  • Deve corresponder exatamente aos códigos da guia “dados”.

  • Numérico, até 6 dígitos.

  • Divergências causarão inconsistência na importação.

valorVendaVarejo

  • Valor de venda do produto.

  • Formato: 0000,00

  • Usar vírgula como separador decimal (ponto não é aceito).

  • Campo numérico.

valorCusto

  • Valor de custo do produto.

  • Mesmo formato: 0000,00.

  • Não deve haver mais de duas casas decimais depois da vírgula.

valorPMZ

  • Preço de margem zero (ou preço de custo médio).

  • Formato: 0000,00.

  • Não deve haver mais de duas casas decimais depois da vírgula.

estoque

  • Quantidade em estoque.

  • Formato: 0000,00.

  • Usar vírgula, não ponto.

  • Não deve haver mais de duas casas decimais depois da vírgula.

📄Guia: “classificacaoMercadologica”

Responsável por vincular o produto à estrutura mercadológica.

Colunas

codigoProduto

  • Mesmo código informado na guia “dados”.

  • Numérico, até 6 dígitos.

departamento / categoria / subcategoria / segmento / subsegmento

  • Todos os campos devem ser preenchidos em caixa alta, com apenas letras.

  • Proibidos números e caracteres especiais.

  • Caso não haja classificação, preencher com "GERAL".

  • Não deve haver nenhuma célula em branco.

  • Mantenha padronização e consistência nos nomes para evitar duplicidade (ex.: “HIGIENE” ≠ “HIGIÊNE”).

📄Guia: “dadosFiscaisEstaduais”

Contém as informações fiscais do produto por estado e loja.

Colunas

loja

  • Número identificador da loja.

  • Numérico, positivo, até 2 dígitos.

  • É possível listar todas as lojas em um único arquivo.

codigoProduto

  • Mesmo código da guia “dados”.

  • Pode se repetir para diferentes estados (estadoId) ou lojas (loja).

  • Numérico, até 6 dígitos.

estadoId

  • Sigla do estado (ex.: MG, PR).

  • Apenas letras, sem caracteres especiais.

  • Máximo: 2 caracteres.

tributacao

  • Tipo de tributação (letra).

  • Preencher apenas quando informado pela origem dos dados.

  • Caso contrário, deixar em branco.

aliquotaOriginal / aliquotaEfetiva / reducao

  • Campos numéricos, aceitam vírgula para casas decimais (ex.: 18,5).

  • aliquotaEfetiva deve ser menor que aliquotaOriginal nos casos de CST 20 (redução).

  • reducao representa a diferença percentual entre ambas.

  • Quando não houver, deixar em branco.

aliquotaIBPTFederal / aliquotaIBPTEstadual

  • Informadas pela tabela padrão IBPT.

  • Preencher apenas em casos de exceção.

cstICMS

  • Código CST de ICMS (2 dígitos).

  • Obrigatório.

    • 00 e 20 → requerem alíquota.

    • 60, 40, 41 → alíquotas devem ser zeradas.

codigoBeneficioFiscal

  • Código alfanumérico (até 10 caracteres) utilizado na NF-e/NFC-e para identificar benefícios fiscais.

  • Preencher se aplicável, caso contrário, deixar em branco.

aliquotaFCPICMS

  • Percentual do Fundo de Combate à Pobreza (FCP).

  • Numérico, aceita vírgula decimal.

aliquotaADRem

  • Campo inativo.

  • Manter em branco.

codigoAnp

  • Mesmo critério descrito na guia “dados”.

pesoKg

  • Peso total do produto.

  • Pode conter valores decimais (ex.: 10,5).

codigoMotivoDesoneracao

  • Código do motivo da desoneração do ICMS (campo motDesICMS da NF-e).

  • Até 2 caracteres alfanuméricos.

  • Caso não haja, deixar em branco.

aliquotaDesoneracao

  • Percentual da desoneração.

  • Formato: 00,00.

No Comments
Back to top