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
Conversor de XML de Cancelamento NF-e

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:

<nome_original>_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:

✔ Pode ser alterado?

Não recomendado

⚠️ Motivo:

110111 = Cancelamento
Alterar muda completamente o tipo do evento

🔹 `nSeqEvento`

✔ Padrão:

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