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 .