Validador Fiscal

Análise de conformidade SEFAZ v4.00 (NF-e, NFC-e, CT-e, CT-e OS, DCe, NFS-e Nacional)

Esquema de Validação (PL)

Forçar Modelo (Opcional)

Cole o conteúdo XML ou JSON aqui
Ou arraste um arquivo

Campos mínimos para cálculo

Use este resumo antes de acionar os botões de cálculo. Se faltar algum campo, a validação continua, mas a etapa complementar pode não ser concluída.

RTC em NF-e/NFC-e: item com CST, cClassTrib, valor do item/base, NCM ou NBS, município do fato gerador e data/hora do fato gerador.
RTC em CT-e/CT-e OS: XML com IBSCBS no imp, CST, cClassTrib, vTPrest, cMunFim, UFFim e dhEmi.
DCe: XML com infDCe, ide, emit, dest, itens, totais, transporte e QR-Code suplementar.
NFS-e Nacional: XML de NFSe ou DPS, valor do serviço, prestador identificado, competência, identificação do serviço e tributos/retenções quando existirem.

📊 Resultados da Validação

Insira o Documento

Cole o conteúdo do seu documento fiscal no editor ou clique em "Arquivo" para enviar um arquivo. O sistema aceita XML e JSON; quando o documento vier em XML, a validação é feita diretamente sobre a estrutura original.

Configure a Validação

Escolha o pacote de schema correto para o documento que vai validar. Para NF-e e NFC-e, use o PL vigente; para CT-e, CT-e OS e DCe, selecione o pacote correspondente; para NFS-e Nacional, o sistema detecta o documento automaticamente pelo XML de <NFSe> ou <DPS>.

Valide e Analise

Clique em Validar Documento. O sistema lê o arquivo, aplica a estrutura XSD, executa as regras de negócio e mostra o resultado em blocos separados: rejeições, alertas e validações concluídas.

Adequação RTC e NFS-e

Para NF-e, NFC-e, CT-e, CT-e OS e NFS-e Nacional, use Gerar RTC para pedir à Calculadora SEFAZ os grupos IBS, CBS e Imposto Seletivo (ou base de cálculo para NFS-e). Para DCe, use o impresso auxiliar DACE; para NFS-e Nacional, use DANFSe.

Revise o Resultado

Se a aplicação alterar o XML, valide novamente antes de baixar ou transmitir. O botão Baixar XML salva o arquivo ajustado para uso posterior.

Validação de Eventos e DCe

Para validar eventos, cole o XML completo do evento no editor e use Validar Documento. O frontend roteia automaticamente eventos de NF-e/NFC-e para /app/validar, documentos DCe para /app/validar-dce e eventos de NFS-e Nacional para /app/validar-nfse.

Para NF-e/NFC-e, o validador aceita as raízes <evento>, <envEvento> e <procEventoNFe>. Para DCe, aceita <DCe> e <dceProc> como documento principal ou processado. Para NFS-e Nacional, aceita <evento> e <pedRegEvento>.

Passo a passo rápido

1. Cole o XML do evento completo, sem remover namespace, assinatura ou protocolo.
2. Para evento de NF-e/NFC-e, mantenha o schema em PL_010c. Para DCe, valide o documento principal ou o dceProc; para NFS-e, o roteamento depende do próprio XML.
3. Clique em Validar Documento.
4. Revise rejeições de chave, autor, sequência, estrutura e XSD.
5. Se o XML for protocolado, prefira enviar o <procEventoNFe> completo.

Eventos NF-e/NFC-e suportados neste frontend: 790700, 110750, 110751, 110192, 110193, 110001, 112110, 112120, 112130, 112140, 112150, 211110, 211120, 211124, 211128, 211130, 211140, 211150, 212110, 212120, 412120 e 412130.

Limitação atual: o fluxo visual deste frontend ainda não valida eventos de CT-e/CT-e OS; aqui os exemplos cobrem NF-e, NFC-e, DCe e NFS-e Nacional.

Exemplo 4: documento DCe

Para DCe, cole o documento principal <DCe> ou o processado <dceProc>. O fluxo de DCe não usa os exemplos de evento acima.

<DCe xmlns="http://www.portalfiscal.inf.br/dce">
  <infDCe Id="DCe35260545147944000124550010001112971605045214" versao="1.00">
    <ide>
      <cUF>35</cUF>
      <cDC>123456</cDC>
      <mod>99</mod>
      <serie>1</serie>
      <nDC>111297</nDC>
      <dhEmi>2026-05-14T10:00:00-03:00</dhEmi>
      <tpEmis>1</tpEmis>
      <tpEmit>1</tpEmit>
      <nSiteAutoriz>1</nSiteAutoriz>
      <cDV>0</cDV>
      <tpAmb>2</tpAmb>
      <verProc>1.0</verProc>
    </ide>
  </infDCe>
</DCe>

Exemplo 5: evento unitário de NF-e/NFC-e

Use este formato para um único evento. Ajuste tpEvento, descEvento, chNFe e o conteúdo de detEvento conforme o tipo real.

<evento xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00">
  <infEvento Id="ID1121103524010039446000588755001000000001100000001401">
    <cOrgao>35</cOrgao>
    <tpAmb>2</tpAmb>
    <CNPJ>00394460005887</CNPJ>
    <chNFe>35240100394460005887550010000000011000000014</chNFe>
    <dhEvento>2026-05-14T10:00:00-03:00</dhEvento>
    <tpEvento>112110</tpEvento>
    <nSeqEvento>1</nSeqEvento>
    <verEvento>1.00</verEvento>
    <detEvento versao="1.00">
      <descEvento>Informação de efetivo pagamento integral para liberar crédito presumido do adquirente</descEvento>
      <cOrgaoAutor>35</cOrgaoAutor>
      <tpAutor>1</tpAutor>
      <verAplic>app-exemplo</verAplic>
      <indQuitacao>1</indQuitacao>
    </detEvento>
  </infEvento>
  <Signature>...</Signature>
</evento>

Exemplo 6: lote de eventos de NF-e/NFC-e

Use <envEvento> quando quiser validar o envelope de lote e cada ocorrência interna.

<envEvento xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00">
  <idLote>000000000000001</idLote>
  <evento versao="1.00">
    <infEvento Id="ID1101923524010039446000588755001000000001100000001401">
      <cOrgao>35</cOrgao>
      <tpAmb>2</tpAmb>
      <CNPJ>00394460005887</CNPJ>
      <chNFe>35240100394460005887550010000000011000000014</chNFe>
      <dhEvento>2026-05-14T11:10:00-03:00</dhEvento>
      <tpEvento>110192</tpEvento>
      <nSeqEvento>1</nSeqEvento>
      <verEvento>1.00</verEvento>
      <detEvento versao="1.00">
        <descEvento>Insucesso na Entrega da NF-e</descEvento>
        <cOrgaoAutor>35</cOrgaoAutor>
        <verAplic>app-exemplo</verAplic>
        <dhTentativaEntrega>2026-05-14T10:30:00-03:00</dhTentativaEntrega>
        <tpMotivo>1</tpMotivo>
        <hashTentativaEntrega>MDEyMzQ1Njc4OTAxMjM0NTY3ODk=</hashTentativaEntrega>
      </detEvento>
    </infEvento>
    <Signature>...</Signature>
  </evento>
</envEvento>

Exemplo 7: procEventoNFe protocolado

Quando você já tiver o retorno da SEFAZ, valide o XML protocolado completo para revisar evento e retEvento juntos.

<procEventoNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00">
  <evento versao="1.00">
    <infEvento Id="ID1107503524010039446000588765001000000001100000001701">
      <cOrgao>35</cOrgao>
      <tpAmb>2</tpAmb>
      <CNPJ>00394460005887</CNPJ>
      <chNFe>35240100394460005887650010000000011000000017</chNFe>
      <dhEvento>2026-05-14T12:00:00-03:00</dhEvento>
      <tpEvento>110750</tpEvento>
      <nSeqEvento>1</nSeqEvento>
      <verEvento>1.00</verEvento>
      <detEvento versao="1.00">
        <descEvento>ECONF</descEvento>
        <verAplic>app-exemplo</verAplic>
        <detPag>
          <indPag>0</indPag>
          <tPag>01</tPag>
          <vPag>100.00</vPag>
          <dPag>2026-05-14</dPag>
        </detPag>
      </detEvento>
    </infEvento>
    <Signature>...</Signature>
  </evento>
  <retEvento versao="1.00">
    <infEvento>
      <tpAmb>2</tpAmb>
      <verAplic>app-sefaz</verAplic>
      <cOrgao>35</cOrgao>
      <cStat>135</cStat>
      <xMotivo>Evento registrado e vinculado a NF-e</xMotivo>
      <chNFe>35240100394460005887650010000000011000000017</chNFe>
      <tpEvento>110750</tpEvento>
      <xEvento>ECONF</xEvento>
      <nSeqEvento>1</nSeqEvento>
      <dhRegEvento>2026-05-14T12:01:00-03:00</dhRegEvento>
      <nProt>135260000000001</nProt>
    </infEvento>
  </retEvento>
</procEventoNFe>

Exemplo 8: evento de NFS-e Nacional

Para NFS-e Nacional, o evento pode vir com raiz <evento>. O frontend identifica esse XML pelo namespace da NFS-e ou pela presença de pedRegEvento.

<evento xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.01">
  <infEvento Id="EVT00000000000000000000000000000000000000000000000000202201001">
    <verAplic>app-exemplo</verAplic>
    <ambGer>2</ambGer>
    <nSeqEvento>001</nSeqEvento>
    <dhProc>2026-05-14T13:02:00-03:00</dhProc>
    <nDFSe>1</nDFSe>
    <pedRegEvento versao="1.01">
      <infPedReg Id="PRE00000000000000000000000000000000000000000000000000202201">
        <tpAmb>2</tpAmb>
        <verAplic>app-exemplo</verAplic>
        <dhEvento>2026-05-14T13:00:00-03:00</dhEvento>
        <CNPJAutor>12345678000195</CNPJAutor>
        <chNFSe>00000000000000000000000000000000000000000000000000</chNFSe>
        <e202201>
          <xDesc>Manifestação de NFS-e - Confirmação do Prestador</xDesc>
        </e202201>
      </infPedReg>
    </pedRegEvento>
  </infEvento>
  <Signature>...</Signature>
</evento>

Exemplo 9: pedido de registro de evento da NFS-e

Quando o XML vier diretamente como <pedRegEvento>, cole o conteúdo integral. O frontend encaminha esse caso para a validação própria da NFS-e.

<pedRegEvento xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.01">
  <infPedReg Id="PRE00000000000000000000000000000000000000000000000000202201">
    <tpAmb>2</tpAmb>
    <verAplic>app-exemplo</verAplic>
    <dhEvento>2026-05-14T13:05:00-03:00</dhEvento>
    <CNPJAutor>12345678000195</CNPJAutor>
    <chNFSe>00000000000000000000000000000000000000000000000000</chNFSe>
    <e202201>
      <xDesc>Manifestação de NFS-e - Confirmação do Prestador</xDesc>
    </e202201>
  </infPedReg>
</pedRegEvento>

⚠️ Como a aplicação funciona por tipo de documento:

NF-e e NFC-e: a aplicação valida o documento, calcula a RTC quando houver dados suficientes e devolve o XML pronto para revisão.
CT-e, CT-e OS e DCe: a aplicação valida o documento, calcula a RTC quando houver os campos mínimos do transporte ou do documento e devolve o XML pronto para revisão.
NFS-e Nacional: a aplicação valida <NFSe>, <DPS>, <evento> e <pedRegEvento>, calcula a base de cálculo da NFS-e e gera o DANFSe Nacional para XML de nota.
XML: deve conter a raiz correta e os campos na ordem esperada pelo schema.
JSON: deve seguir exatamente a estrutura do documento fiscal correspondente.

Campos mínimos para cálculo:

RTC em NF-e/NFC-e: item com CST, cClassTrib, valor do item/base, NCM ou NBS, município do fato gerador e data/hora do fato gerador.
RTC em CT-e/CT-e OS/DCe: XML com IBSCBS no imp, CST, cClassTrib, vTPrest, cMunFim, UFFim, dhEmi e, para DCe, a estrutura eletrônica correspondente com identificação, itens, totais e QR-Code suplementar.
NFS-e Nacional: documento NFSe ou DPS com valor do serviço, dados do prestador, competência, identificação do serviço e os campos de tributos/retenções quando existirem.
CBS Anual: documento XML ou JSON com data/competência/ano detectável para extrair o ano de referência.