Pular para o conteúdo principal

Bloco infNFeSupl

O bloco infNFeSupl é exclusivo para o modelo de nota fiscal eletrônica NFC-e (modelo 65) e carrega informações suplementares que não fazem parte da estrutura tradicional da NF-e (modelo 55).

Ele é opcional, mas amplamente utilizado e necessário para exibição de dados importantes como o QR Code, e, em alguns estados, o bloco infRespTec (responsável técnico) também deve ser incluído dentro deste bloco.

📌 Estrutura do infNFeSupl​

O infNFeSupl deve ser declarado após o fechamento do bloco infNFe, no mesmo nível da tag infNFe. Ele não é filho direto de nenhum outro bloco, e deve aparecer exatamente após o fechamento do infNFe para que a SEFAZ aceite o XML.

⚠️ A ordem correta dos blocos é obrigatória para validação. A SEFAZ não aceita infNFeSupl dentro de infNFe, e tampouco fora do envelope da nota.

🧩 Campos do infNFeSupl​

TagDescriçãoTipoTamanhoObrigatórioObservações
qrCodeLink para consulta da NFC-e com os parâmetros criptografadosTexto-SimDeve ser uma URL completa com todos os parâmetros exigidos pelo estado
urlChaveURL simplificada para consulta da NFC-e via chave de acessoTexto-SimUsada principalmente por aplicativos e validação manual via SEFAZ
infRespTecBloco com dados do responsável técnicoBloco-CondicionalObrigatório em alguns estados, como PR.

🔒 Campo qrCode – detalhes importantes​

O QR Code é um dos elementos mais importantes da NFC-e. Ele é construído com base em parâmetros definidos pela nota técnica e deve conter:

  • Chave de acesso da NFC-e
  • CSC ID e token
  • Hash criptografado com SHA-1
  • Versão do QR Code
  • Ambiente (homologação ou produção)
  • Formato de retorno (HTML)

O qrCode não é apenas o link da SEFAZ — ele deve conter os parâmetros codificados e com o hash no final.

✅ Exemplo XML completo do infNFeSupl​

<infNFeSupl>
  <qrCode><![CDATA[
    https://nfce.sefaz.pr.gov.br/nfce/qrcode?p=41240412345678000123550010000000011000000010|2|1|1|NTTRU9MWJDT9BITHAIZMVQ6KCTG9FRKEPWMT|5AEBF9D481C7A993984A8DBD5DC6C7D1D6E1AC60
  ]]></qrCode>
  <urlChave>https://nfce.sefaz.pr.gov.br/nfce/consulta</urlChave>
  <infRespTec>
    <CNPJ>12345678000123</CNPJ>
    <xContato>Equipe Técnica</xContato>
    <email>suporte@softwarehouse.com.br</email>
    <fone>4130294000</fone>
  </infRespTec>
</infNFeSupl>

📌 Observações importantes​

  • O conteúdo de <qrCode> deve ser envolto por <![CDATA[ ... ]]> para que os símbolos da URL não quebrem o XML
  • A URL do qrCode varia de estado para estado — consulte a SEFAZ do seu estado
  • O campo urlChave é usado para consultas simplificadas via chave de acesso em navegadores e aplicativos
  • O bloco infRespTec, se exigido pela UF, deve estar dentro de infNFeSupl, e não no final do XML

Para mais detalhes sobre a geração do QR Code e a estrutura de validação, consulte a documentação de assinatura e QR Code da NFC-e.