Consulta de chave do MDF-e: como fazer online em poucos passos

A consulta de chave do MDF-e é feita no Portal Nacional do MDF-e, mantido pela SEFAZ Virtual do RS, com a chave de 44 dígitos impressa no DAMDFE e login gov.br. A consulta resumida mostra emitente, placa, condutores e eventos; a completa exige certificado ICP-Brasil do emitente ou de ator autorizado no XML.

O caminhão está parado no posto fiscal e o agente quer confirmar o manifesto. Ou o sistema tenta emitir outro e recebe a “Rejeição 611: Existe MDF-e não encerrado para esta placa…”. Nos dois casos, o primeiro passo é a consulta de chave do MDF-e.

Este guia cobre a consulta pública do MDF-e no portal oficial, os manifestos não encerrados e a consulta por webservice. Para revisar o documento em si, veja o que é o MDF-e e quem emite.

O que é a chave de acesso do MDF-e?

A chave de acesso do MDF-e é o código de 44 posições que identifica, de forma única, cada Manifesto Eletrônico de Documentos Fiscais (MDF-e, modelo 58) autorizado pelo fisco. O documento foi instituído pelo Ajuste SINIEF nº 21/2010, e o leiaute vigente está no Manual de Orientação do Contribuinte (MOC) versão 3.00b.

O portal é operado pela SEFAZ Virtual do RS (SVRS), em projeto coordenado pelo Encontro Nacional de Coordenadores e Administradores Tributários Estaduais (ENCAT), e não pela Receita Federal.

Como são formados os 44 dígitos da chave

O MOC 3.00b define nove campos concatenados (exemplo do próprio manual):

Campo Tag no XML Posições Tamanho Exemplo
Código da UF do emitente cUF 1–2 2 43 (RS)
Ano e mês de emissão (AAMM) – 3–6 4 1812
CNPJ ou CPF do emitente CNPJ/CPF 7–20 14 07312871000190
Modelo mod 21–22 2 58
Série serie 23–25 3 001
Número do MDF-e nMDF 26–34 9 000033404
Forma de emissão tpEmis 35 1 1
Código numérico cMDF 36–43 8 42131077
Dígito verificador cDV 44 1 6

 

  • Forma de emissão: 1 é normal, 2 é contingência off-line e 3 é o Regime Especial da Nota Fiscal Fácil (NFF).
  • CNPJ alfanumérico: a Nota Técnica Conjunta de CNPJ alfanumérico mantém as 44 posições, aceita letras nas 12 primeiras do CNPJ e muda o cálculo do dígito verificador:

Regex da chave:  ^[0-9]{6}[A-Z0-9]{12}[0-9]{26}$

DV (módulo 11):

  valor(c) = ASCII(c) – 48          # ‘0’..’9′ -> 0..9; ‘A’ -> 17

  pesos 2..9, da direita para a esquerda, sobre as 43 primeiras posições

  resto = soma % 11

  DV = 0 se resto < 2; senão DV = 11 – resto

Onde encontrar a chave: DAMDFE e XML

No Documento Auxiliar do MDF-e (DAMDFE), a chave aparece impressa, com código de barras e QR Code. Veja onde fica a chave no DAMDFE.

No XML, a chave está no atributo Id da tag infMDFe, precedida do literal “MDFe”. Se o Id divergir dos campos, o autorizador devolve a Rejeição 227. Após a autorização, a chave também consta em protMDFe/infProt/chMDFe.

Como consultar MDF-e pela chave no portal oficial?

O MOC prevê dois níveis de consulta pública do MDF-e: resumida, só com a chave, e completa, com certificado digital:

  1. Acesse o Portal Nacional do MDF-e (dfe-portal.svrs.rs.gov.br/Mdfe) e abra a consulta por chave (endereço padronizado /MDFe/consulta).
  2. Entre com a conta gov.br. Em 10/10/2026, o endereço de consulta redirecionava para a identificação gov.br.
  3. Informe a chave de 44 dígitos, sem espaços nem pontos.
  4. Confira a consulta resumida, com a situação e os dados gerais do manifesto.
  5. Abra a consulta completa, se necessário, com certificado digital ICP-Brasil.

Consulta resumida: o que aparece

Segundo o MOC 3.00b, a consulta resumida exibe:

  • dados gerais: chave, série, número, data de emissão, modal, UF de início, UF de fim e tipo de emissão;
  • emitente: CNPJ ou CPF, Inscrição Estadual (IE) e razão social;
  • relação de condutores e placa do veículo (apenas no modal rodoviário);
  • eventos de cancelamento, encerramento e inclusão de condutor.

Quando liberou a consulta, a SEFAZ-MG informou que a versão resumida é exibida “com mascaramento das informações”, no mesmo padrão da NF-e e do CT-e.

Consulta completa do MDF-e com certificado digital

A consulta completa traz todo o XML, em abas, e exige certificado ICP-Brasil com CNPJ ou CPF de um ator do manifesto: emitente, contratante ou autorizado no grupo autXML.

Para quem desenvolve: se o embarcador ou o contador precisar da consulta completa, inclua o CNPJ ou CPF dele em autXML na emissão.

Consulta pelo portal da SEFAZ do estado

Algumas secretarias mantêm páginas próprias. A SEFAZ de Mato Grosso do Sul, por exemplo, oferece a Consulta Pública do MDF-e, que também pede a chave de 44 dígitos.

Como consultar MDF-e não encerrado?

Em sistemas, a consulta de não encerrados usa o webservice MDFeConsNaoEnc: recebe o CNPJ ou CPF do emitente e devolve chaves e protocolos dos manifestos ainda abertos.

Um manifesto aberto bloqueia novas emissões. Segundo o FAQ do portal, não se autoriza outro MDF-e para o mesmo veículo e o mesmo par de UF de carregamento e descarregamento enquanto o anterior não for encerrado. O MOC detalha o bloqueio:

cStat Situação que bloqueia a emissão
611 MDF-e não encerrado para a mesma placa, tipo de emitente e UF de descarregamento
662 MDF-e não encerrado para a mesma placa no sentido oposto da viagem
462 MDF-e não encerrado há mais de 5 dias para a placa, com até 2 UF de percurso
686 Qualquer MDF-e não encerrado há mais de 30 dias para o emitente

A correção é registrar o evento de encerramento (110112) e então reenviar o novo MDF-e.

Quais situações a consulta de MDF-e pode retornar?

Pelo MOC 3.00b, a consulta de situação devolve um destes códigos de status (cStat):

  • 100 – Autorizado o uso do MDF-e: manifesto válido; sem evento de encerramento, segue aberto;
  • 101 – Cancelamento de MDF-e homologado: o documento perdeu a validade;
  • 132 – Encerramento de MDF-e homologado: trajeto concluído e informado ao fisco.

Sem manifesto localizado, a resposta é uma rejeição, como 217 (não consta na base) ou 236 (chave inválida).

No webservice, o MOC limita a consulta a 180 dias da emissão e rejeita com o código 460 as chaves cujo ano e mês estejam mais de seis meses atrasados. O manual não fixa prazo para a consulta pública no portal.

Como consultar a situação do MDF-e por webservice?

Em ERPs e sistemas de transporte, consultar MDF-e é uma chamada síncrona ao MDFeConsulta, listado na relação oficial de webservices. O MOC exige SOAP 1.2, TLS com autenticação mútua e certificado ICP-Brasil. O retorno (retConsSitMDFe) traz cStat, xMotivo, o protocolo (protMDFe) e os eventos (procEventoMDFe):

<!– POST https://mdfe.svrs.rs.gov.br/ws/MDFeConsulta/MDFeConsulta.asmx –>

<consSitMDFe xmlns=”http://www.portalfiscal.inf.br/mdfe” versao=”3.00″>

  <tpAmb>1</tpAmb>

  <xServ>CONSULTAR</xServ>

  <chMDFe>43181207312871000190580010000334041421310776</chMDFe>

</consSitMDFe>

emitir(MDF-e)

  └─ timeout ou resposta perdida?

       └─ consultar(chMDFe)                  # MDFeConsulta

            ├─ cStat 100 → gravar protMDFe; não reenviar

            ├─ cStat 101/132 → atualizar status (cancelado/encerrado)

            └─ 217 (não consta) → reenviar o mesmo XML, com a mesma chave

Consultar após um timeout evita reenviar um manifesto já autorizado (duplicidade: Rejeição 204 ou 539). O MOC, porém, prevê a Rejeição 678 (consumo indevido) quando a mesma chave é consultada mais de 10 vezes em uma hora, critério que cada autorizador pode ajustar.

Não confunda com o MDFeDistribuicaoDFe, que entrega XMLs aos atores interessados por número sequencial (NSU).

Automatize consultas e documentos fiscais com a NFE.io

A NFE.io é infraestrutura fiscal para escalar o faturamento sem débito técnico, com emissão de NF-e, NFC-e e NFS-e e consultas de CNPJ, CPF, CT-e e NF-e:

  1. Endpoints RESTful com contratos JSON, sem SOAP: nada de montar envelopes XML.
  2. Validação prévia pelo motor fiscal: o payload é conferido antes do envio, o que reduz as rejeições na SEFAZ (NF-e e NFC-e) e nas prefeituras (NFS-e).
  3. Webhooks em tempo real: autorizações, cancelamentos e rejeições chegam ao sistema sem consultas periódicas (polling).
  4. Guarda legal dos XMLs: conservar os documentos até a prescrição é dever do contribuinte (art. 195, parágrafo único, c/c art. 174 do Código Tributário Nacional), e a API dá acesso e download de XML e PDF.
  5. Ambiente de sandbox: testes de emissão, consulta e erros antes da produção.

Acesse a documentação da API da NFE.io, conheça a API de consulta de dados fiscais e teste no ambiente de sandbox.

==========================

Perguntas frequentes:

É possível consultar o MDF-e só com a chave de acesso?

Sim. Pelo MOC 3.00b, a consulta resumida pede só a chave de 44 dígitos; no portal, o acesso exige também login gov.br.

Precisa de certificado digital para consultar o MDF-e?

Não, para a consulta resumida. A consulta completa exige certificado ICP-Brasil de um ator do manifesto (MOC 3.00b).

Por que a consulta do MDF-e pede login gov.br?

Porque o endereço de consulta do Portal Nacional do MDF-e redireciona para a identificação gov.br.

É possível saber pela consulta se o MDF-e está encerrado?

Sim. O status 132 indica encerramento homologado (MOC 3.00b); status 100 sem evento de encerramento indica manifesto aberto.

Até quando um MDF-e pode ser consultado?

No webservice, até 180 dias da emissão (MOC 3.00b). O manual não fixa prazo para a consulta pública no portal.

A chave do MDF-e é igual à da NF-e?

Não. A estrutura de 44 posições é a mesma, mas o modelo (posições 21 e 22) é 58 no MDF-e e 55 na NF-e.

Entre em contato

Automatize suas notas fiscais com quem já processou bilhões de transações

A NFE.io é referência nacional em emissão e consulta fiscal. Mais de 4 mil empresas já descomplicaram a burocracia com segurança, estabilidade e suporte técnico.

  • +70 mi notas fiscais emitidas
  • +R$ 4,87 bi processados via API
  • +50% do PIB nacional coberto

Conheça nossas soluções


Está cansado de emitir as notas fiscais da sua empresa uma por uma?

Sabemos que é um processo muito chato e repetitivo. Você não precisa mais gastar tempo com isso, sabia ?

QUERO GANHAR TEMPO
x