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 EANcodigo principal 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 80140 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,pontos, traços,traços, vírgulas ou espaços.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,pontos, traços, vírgulas ou vírgulas.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 COFINS.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.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

      • CódigosTodos 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.

      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.

      valorPMZ

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

      • Formato: 0000,00.

      estoque

      • Quantidade em estoque.

      • Formato: 0000,00.

      • Usar vírgula, não ponto.

      📄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".

      • 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.

      Back to top