Consulta de Situação

Descrição Geral

A rota de Consulta de Situação retorna todas as informações referentes a uma MDF-e já emitida e gerada, a partir da respectiva chave de acesso.

Função da Rota

Obter o status atual e o documento completo da MDF-e que foi autorizada ou processada pela SEFAZ.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
consulta	object	✅	Objeto contendo os dados para consulta.
consulta.tpAmb	string	✅	Identificação do Ambiente: 1 - Produção / 2 - Homologação.
consulta.xServ	string	✅	Serviço Solicitado. Deve ser CONSULTAR.
consulta.chMDFe	string	✅	Chave de acesso da MDF-e (44 posições).
consulta.CNPJ	string	⚙️ Opcional*	CNPJ do emitente da MDF-e.
consulta.CPF	string	⚙️ Opcional*	CPF do emitente da MDF-e.
certificate	string	⚙️ Opcional	Certificado digital A1 em base64.
pass_certificate	string	⚙️ Opcional	Senha do certificado.

Atenção: É obrigatório informar o CNPJ ou o CPF.

Autenticação

Todos os endpoints da API necessitam de credenciais de autenticação baseadas no Token e na API Key da Software House.

• api-key: Chave da API da Software House enviada pelo header.
• token: Token de autorização enviado pelo header.

Exemplo de Payload

{
  "consulta": {
    "tpAmb": "1",
    "xServ": "CONSULTAR",
    "chMDFe": "35190812345678000123550010000000011000000011",
    "CNPJ": "12345678000123"
  }
}

Exemplo de Requisição Completa

curl --request POST \
  --url https://api.emitix.com.br/mdf/consulta-situacao \
  --header 'api-key: SUA_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'token: SEU_TOKEN' \
  --data '{
    "consulta": {
      "tpAmb": "1",
      "xServ": "CONSULTAR",
      "chMDFe": "35190812345678000123550010000000011000000011",
      "CNPJ": "12345678000123"
    }
  }'

Exemplo de Resposta

{
	"success": true,
	"message": "Consulta de situação do MDFe realizada com sucesso",
	"data": {
		"tpAmb": "2",
		"verAplic": "RS20251030084838",
		"chMDFe": "35260374363615000119...",
		"dhRecbto": "2026-03-10T09:10:52-03:00",
		"nProt": "93526...",
		"digVal": "lGfsm0ZTCsV+h/bm3PBvnbngh5w=",
		"cStat": "100",
		"xMotivo": "Autorizado o uso do MDF-e",
		"@_Id": "MDFe93526..."
	}
}