Guia Completo Como Importar XML de NFe na Jettax
(Erros comuns, explicações, passo a passo e conceitos importantes)
🟦 1. Entendendo o XML Completo da Nota Fiscal (nfeProc)
Possíveis buscas relacionadas: “erro ao importar XML”, “nfeProc faltando”, “XML incompleto”.
O que é o nfeProc
O nfeProc é o pacote completo do XML da sua Nota Fiscal Eletrônica. Ele contém dois elementos essenciais:
NFe (os dados da nota)
protNFe (o protocolo de autorização da SEFAZ)
Quando o XML vem com o nfeProc completo, significa que a nota está autorizada e válida.
Passo a passo – Como garantir que o XML está completo
Passo 1: Abra o arquivo XML em um editor de texto.
Passo 2: Procure pelo termo nfeProc no início da estrutura.
Passo 3: Verifique se o documento contém os blocos NFe e protNFe logo abaixo.
Passo 4: Caso o arquivo esteja apenas com a NFe, solicite ao fornecedor o XML completo com o protocolo.
Observações importantes
Sempre importe na Jettax o XML completo, contendo nfeProc.
Isso evita rejeições e garante a leitura correta dos dados.
🟦 2. Entendendo o Protocolo de Autorização (protNFe)
Variações comuns: “XML sem protocolo”, “erro de autorização”, “protNFe ausente”.
O que é o protNFe
O protNFe é o trecho do XML que confirma que a SEFAZ autorizou a nota. Ele contém:
Número do protocolo
Data e hora da autorização
Resultado da autorização
A chave da nota fiscal
Sem o protNFe, a NF-e não é considerada autorizada oficialmente.
Passo a passo – Como identificar o protNFe
Passo 1: Abra o XML.
Passo 2: Localize o elemento protNFe dentro do bloco nfeProc.
Passo 3: Verifique se há informações como protocolo, data e status.
Observações importantes
A Jettax pode recusar a importação caso o XML não tenha o protocolo.
🟦 3. O que é a Assinatura Digital (Signature)
Busca relacionada: “erro Signature”, “XML sem assinatura”.
Para que serve a Signature
O bloco Signature é a assinatura digital da NF-e, realizada pelo certificado da empresa (A1 ou A3).
Ela garante que:
O documento não foi alterado.
O emissor realmente é quem declarou a nota.
O XML é autêntico e íntegro.
Passo a passo – Como verificar a assinatura
Passo 1: Abra o XML.
Passo 2: Procure pelo trecho chamado Signature dentro da tag principal da nota.
Passo 3: Confirme que o arquivo não foi editado ou modificado antes de importar.
Observações importantes
A Jettax valida a assinatura para garantir a autenticidade do documento.
🟦 4. A Importância do ID com o CNPJ do Emitente
Erros comuns: “ID inválido”, “CNPJ não corresponde”, “estrutura da NFe incorreta”.
O que é o ID da NFe
O atributo ID (dentro de infNFe) é a chave de acesso da nota, e sempre contém o CNPJ do emissor.
Por que isso importa
A Jettax utiliza o ID para confirmar que o XML realmente pertence à empresa emissora.
Passo a passo – Como validar o ID
Passo 1: Abra o XML.
Passo 2: Localize o elemento infNFe.
Passo 3: Confira se o atributo ID inicia com “NFe”.
Passo 4: Verifique se a sequência numérica da chave inclui o CNPJ correto do emissor.
Observações importantes
Se o CNPJ no ID estiver incorreto, a Jettax pode classificar o arquivo como inconsistente.
🟦 5. O que é o NSU e por que afeta o tempo de busca
Buscas frequentes: “nota não aparece”, “demora na busca”, “problema NSU”.
O que é o NSU
O NSU (Número Sequencial Único) é uma numeração gerada pela SEFAZ para cada documento fiscal recebido pelo CNPJ.
Ele funciona como uma fila sequencial, onde cada nota entra em uma ordem cronológica.
Por que notas retroativas demoram mais para aparecer
A SEFAZ só libera os documentos na ordem do NSU.
Isso significa que o sistema:
Não pode pular números anteriores.
Precisa “percorrer” todos os NSUs da fila até encontrar as notas antigas.
Passo a passo – Entendendo o comportamento da busca
Passo 1: Solicite a busca retroativa na Jettax.
Passo 2: Aguarde a leitura sequencial dos NSUs.
Passo 3: Assim que o NSU correspondente for liberado, a nota aparecerá na base.
Observações importantes
Esse comportamento é da SEFAZ, não da Jettax.
🟦 Encerramento
Agora você entende:
Como funciona o XML completo da NF-e
Para que servem nfeProc, protNFe e Signature
Por que o ID precisa conter o CNPJ
Como o NSU impacta a busca de notas retroativas
Qualquer dúvida, estamos aqui para ajudar. Vamos resolver isso juntos!