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.

• Todos os itens devem ter um estado e vinculado.

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.