Conversão da Dados Área reservada a documentos sobre conversão de dados para o NovoAvanço. 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 . Conversor de XML de Cancelamento NF-e Novo Avanço → procEventoNFe Download do programa aqui 📌 1. Contexto O sistema Novo Avanço gera XMLs de NF-e no formato nfeProc , contendo: Dados completos da nota fiscal Protocolo de autorização Status da nota (incluindo cancelamento) Quando uma nota é cancelada, o sistema não gera o XML do evento de cancelamento completo , apenas registra o cancelamento dentro do protocolo da NF-e. Por outro lado, algumas integrações, auditorias fiscais e ferramentas externas exigem o XML no formato: procEventoNFe Este produto resolve exatamente esse gap. 🎯 2. Objetivo do Produto Converter XMLs de NF-e canceladas (formato nfeProc ) em XMLs no formato completo de evento: procEventoNFe Garantindo: Compatibilidade com padrões SEFAZ Leitura por ferramentas fiscais Padronização de dados para integração ⚙️ 3. Funcionamento Geral O conversor executa o seguinte fluxo: 🔄 Fluxo de execução Usuário seleciona pasta de origem (XMLs do Novo Avanço) Usuário seleciona pasta de destino Sistema percorre todos os XMLs Para cada XML: Lê os dados necessários Monta a estrutura procEventoNFe Gera um novo XML Exibe progresso e logs em tempo real 🧠 4. Estrutura dos XMLs 📥 Entrada (Novo Avanço) Formato: nfeProc ├── NFe └── protNFe └── infProt Contém: Chave da nota Protocolo Status ( cStat ) Motivo ( xMotivo ) Data ( dhRecbto ) 📤 Saída (Gerado pelo Conversor) Formato: procEventoNFe ├── evento │ ├── infEvento │ └── Signature └── retEvento └── infEvento 🔗 5. Correspondência de Campos Campo destino Origem Regra cOrgao ide/cUF Direto tpAmb ide/tpAmb Direto CNPJ emit/CNPJ Direto chNFe protNFe/infProt/chNFe Direto dhEvento dhRecbto Padrão (ou manual) tpEvento — Fixo: 110111 nSeqEvento — Fixo: 1 verEvento — Fixo: 1.00 descEvento — Fixo: Cancelamento nProt (evento) protNFe/nProt Direto xJust xMotivo Padrão (ou manual) 📌 Retorno ( retEvento ) Campo Origem tpAmb tpAmb verAplic verAplic cOrgao cUF cStat cStat xMotivo xMotivo chNFe chNFe tpEvento Fixo xEvento "CANCELAMENTO" nSeqEvento Fixo dhRegEvento dhRecbto nProt nProt 🧩 6. Tratamento dos Campos 🔹 tpEvento Valor fixo: 110111 Representa evento de cancelamento 🔹 nSeqEvento Valor fixo: 1 Primeiro evento de cancelamento da nota 🔹 xJust Padrão: usa xMotivo do XML Pode ser sobrescrito manualmente 🔹 dhEvento Padrão: usa dhRecbto Pode ser definido manualmente pelo usuário 🔹 Signature Reaproveitada do XML original Não é recalculada Mantém compatibilidade estrutural 🖥️ 7. Interface do Sistema A interface web local permite: 📂 Seleção de pastas Pasta de entrada (XMLs do sistema) Pasta de saída (XMLs convertidos) 🧾 Campos configuráveis tpEvento nSeqEvento xJust dhEvento Todos já vêm com valores padrão. 📊 Execução Barra de progresso em tempo real Contadores: Total Processados Erros Logs detalhados 🛑 Controle Iniciar conversão Cancelar execução Limpar logs ▶️ 8. Como Usar Passo a passo Abrir o programa Selecionar pasta de origem Selecionar pasta de destino (Opcional) Ajustar campos Clicar em Iniciar conversão Durante a execução Acompanhar barra de progresso Ver logs em tempo real Cancelamento Clique em Cancelar O sistema interrompe o processamento atual Resultado XMLs gerados na pasta de destino Nome padrão: _procEventoNFe.xml ⚠️ 9. Limitações Não gera assinatura digital nova Não consulta SEFAZ Usa dados já existentes no XML Não substitui o XML oficial do evento 🔒 10. Considerações Técnicas Aplicação local (Flask) Execução via navegador Integração com Windows (bandeja) Processamento em background (thread) Manipulação XML via Python 🧪 11. Compatibilidade Compatível com leitores XML fiscais Estrutura alinhada ao padrão SEFAZ Evita conflitos de namespace 🏁 12. Conclusão O Conversor de XML de Cancelamento do Novo Avanço: Resolve a ausência do XML de evento completo Permite integração com ferramentas externas Automatiza conversão em lote Oferece interface simples e eficiente   ⚙️ Regras de Alteração dos Campos Esta seção define quais campos podem ser alterados pelo usuário , quais não devem ser alterados , e quais são sensíveis para integridade fiscal . 🔒 1. Campos NÃO editáveis (fixos / controlados pelo sistema) Esses campos são definidos automaticamente pelo conversor e não devem ser alterados , pois fazem parte da estrutura fiscal obrigatória. Campo Origem Motivo cOrgao XML original Define a UF (SEFAZ responsável) tpAmb XML original Ambiente (produção/homologação) CNPJ XML original Emitente da nota chNFe XML original Identificação única da NF-e nProt XML original Protocolo da nota cStat XML original Status fiscal xMotivo XML original Retorno da SEFAZ verEvento Fixo ( 1.00 ) Versão do layout descEvento Fixo ( Cancelamento ) Tipo do evento xEvento Fixo ( CANCELAMENTO ) Descrição padronizada verAplic XML original Versão da aplicação SEFAZ ⚠️ Importante Alterar qualquer um desses campos pode: Invalidar o XML Gerar inconsistência fiscal Quebrar integração com sistemas contábeis 🟡 2. Campos editáveis com restrição Esses campos podem ser alterados, mas com cuidado . 🔹 xJust (Justificativa do cancelamento) ✔ Padrão: xMotivo do XML ✔ Pode ser alterado? Sim ⚠️ Regras: Deve ter entre 15 e 255 caracteres (recomendado) Deve representar corretamente o motivo do cancelamento ❗ Riscos ao alterar: Divergência com registro original Problemas em auditorias 🔹 dhEvento (Data/hora do evento) ✔ Padrão: dhRecbto do XML ✔ Pode ser alterado? Sim ⚠️ Regras: Deve estar no formato: YYYY-MM-DDTHH:mm:ss-03:00 ❗ Riscos ao alterar: Inconsistência temporal com SEFAZ Divergência com logs fiscais 🟢 3. Campos editáveis seguros Esses campos são controlados, mas não afetam integridade fiscal diretamente . 🔹 tpEvento ✔ Padrão: 110111 ✔ Pode ser alterado? Não recomendado ⚠️ Motivo: 110111 = Cancelamento Alterar muda completamente o tipo do evento 🔹 nSeqEvento ✔ Padrão: 1 ✔ Pode ser alterado? Sim (com ressalvas) ⚠️ Regras: Deve ser inteiro Normalmente sempre 1 para cancelamento ❗ Riscos: Pode causar inconsistência em sistemas que validam sequência 🧠 4. Resumo Geral Campo Pode alterar? Nível de risco xJust ✔ Sim Médio dhEvento ✔ Sim Médio nSeqEvento ✔ Sim Baixo tpEvento ⚠ Não recomendado Alto Demais campos ❌ Não Crítico 🎯 5. Recomendação de Uso Para uso seguro: Não altere campos técnicos Utilize apenas: xJust (quando necessário) dhEvento (em casos específicos) 🏁 Conclusão O conversor já define automaticamente todos os campos necessários para gerar um XML válido. As alterações devem ser feitas apenas quando houver necessidade real, evitando inconsistências fiscais ou divergências com o registro original da NF-e.