Emitir e consultar MDF-e

Conferir MDF-e na SEFAZ

GET https://apifiscal.weesy.com.br/v1/mdfe/{id}/situacao-sefaz

Pergunta à SEFAZ, pela chave de acesso, qual é a situação do MDF-e lá, e atualiza o nosso registro com a resposta. Use quando desconfiar que o status aqui está diferente do da SEFAZ — por exemplo, depois de uma queda de conexão.

Parâmetros

Nome	Onde	Tipo	Descrição
id obrigatório	caminho	string	Id do MDF-e, devolvido no campo `id` quando você emitiu.

Exemplo de chamada

cURLcurl --request GET \
  --url "https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/situacao-sefaz" \
  --header "Authorization: Bearer $WEESY_TOKEN"

Node.jsconst resposta = await fetch("https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/situacao-sefaz", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
  },
});
console.log(resposta.status, await resposta.text());

Pythonimport os

import requests

resposta = requests.get(
    "https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/situacao-sefaz",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP<?php

$contexto = stream_context_create(["http" => [
    "method" => "GET",
    "header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN")]),
    "ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/situacao-sefaz", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;

C#using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("WEESY_TOKEN"));

using var resposta = await http.GetAsync("https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/situacao-sefaz");
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Respostas

200: O MDF-e, já atualizado com a resposta da SEFAZ (em sefaz).
401: Token ausente, errado ou revogado (credencialinvalida). Confira o cabeçalho Authorization. (formato de erro)
404: mdfenaoencontrado — não existe, ou é de outra empresa. (formato de erro)
409: mdfestatusinvalido — o MDF-e ainda não foi enviado à SEFAZ (não tem chave de acesso). (formato de erro)
503: A prefeitura, o sistema nacional ou a SEFAZ estão fora do ar (autorizadorindisponivel). Tente de novo em alguns minutos. (formato de erro)

Campos da resposta 200

Campo Tipo Descrição

id
obrigatório

string

O id que a Weesy dá ao documento. Guarde como texto e não tente interpretar.

idIntegracao
obrigatório

string

O código seu que veio na emissão.

status
obrigatório

string

Situação do MDF-e. A lista pode crescer: trate valor desconhecido sem quebrar.

Valor	Significado
`recebido`	Recebemos o MDF-e; ele ainda vai para a SEFAZ
`em_processamento`	Enviado à SEFAZ; aguardando a resposta
`autorizado`	A SEFAZ autorizou — a viagem pode começar. Lembre de encerrar no fim
`rejeitado`	A SEFAZ recusou por algum dado — veja `sefaz.mensagem`, corrija e mande de novo com o mesmo `idIntegracao`
`erro`	Falha técnica (SEFAZ fora do ar, tempo esgotado) — reenvie em `POST /mdfe/{id}/reprocessamento`
`cancelado`	A SEFAZ confirmou o cancelamento
`encerrado`	A viagem terminou e a SEFAZ registrou o encerramento

ambiente
obrigatório

string

Onde o documento é emitido.

Valor	Significado
`producao`	Documento de verdade, com valor fiscal
`homologacao`	Teste na SEFAZ, sem valor fiscal. Exige certificado

O ambiente simulacao (sem certificado, sem sair da Weesy), que a NFS-e tem, ainda não existe para CT-e e MDF-e.

empresa
obrigatório object

empresa.cnpj
obrigatório

string

CNPJ sem pontos, barra ou traço (14 posições). Já aceita o CNPJ com letras, que começa a valer em 2026.

empresa.razaoSocial
obrigatório string

empresa.uf

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

serie
obrigatório string

numero

string ou null

Número do MDF-e. Vazio até a Weesy montar o XML.

chaveAcesso string ou null

protocolo

string ou null

Protocolo de autorização da SEFAZ.

autorizadoEm string (date-time) ou null

ufInicio

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

ufFim

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

percurso array de string

carregamento array de object

carregamento[].codigoIbge
obrigatório

string

Código IBGE do município.

carregamento[].nome

string

Nome do município.

carregamento[].uf

string

Sigla da unidade federativa.

descarregamento array de object

descarregamento[].codigoIbge
obrigatório

string

Código IBGE do município.

descarregamento[].nome

string

Nome do município.

descarregamento[].uf

string

Sigla da unidade federativa.

descarregamento[].chavesCte array de string

veiculo object

veiculo.placa

string

Placa do veículo, sem traço, em maiúsculas (formato antigo ou Mercosul).

veiculo.uf

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

carga object

carga.valor

number

Valor em reais, como número com 2 casas decimais (ex. 100.00). Não mande como texto.

carga.quantidadeCte

integer

Quantos CT-e o MDF-e leva (contado das chaves em descarregamento).

sefaz

object

Última resposta da SEFAZ, como ela mandou. Útil para entender uma rejeição.

sefaz.cStat

integer ou null

Código de resposta da SEFAZ (ex. 100 = autorizado; 135 = evento registrado).

sefaz.mensagem

string ou null

Texto da SEFAZ que explica o código.

sefaz.protocolo

string ou null

Número do protocolo da SEFAZ, quando houver.

encerramento

null ou object

Preenchido quando o MDF-e é encerrado.

encerramento.municipio

object

Identificação do município por código IBGE, nome e UF.

encerramento.municipio.codigoIbge
obrigatório

string

Código IBGE do município.

encerramento.municipio.nome

string

Nome do município.

encerramento.municipio.uf

string

Sigla da unidade federativa.

encerramento.encerradoEm

string (date-time)

Data e hora no horário de Brasília (ex. 2026-10-26T09:27:34-03:00).

encerramento.protocolo string ou null

cancelamento

null ou object

Preenchido quando o MDF-e é cancelado.

cancelamento.justificativa string

cancelamento.canceladoEm

string (date-time)

Data e hora no horário de Brasília (ex. 2026-10-26T09:27:34-03:00).

cancelamento.protocolo string ou null

historico

array de object

Por onde o MDF-e passou, em ordem.

historico[].status
obrigatório

string

Situação do MDF-e. A lista pode crescer: trate valor desconhecido sem quebrar.

Valor	Significado
`recebido`	Recebemos o MDF-e; ele ainda vai para a SEFAZ
`em_processamento`	Enviado à SEFAZ; aguardando a resposta
`autorizado`	A SEFAZ autorizou — a viagem pode começar. Lembre de encerrar no fim
`rejeitado`	A SEFAZ recusou por algum dado — veja `sefaz.mensagem`, corrija e mande de novo com o mesmo `idIntegracao`
`erro`	Falha técnica (SEFAZ fora do ar, tempo esgotado) — reenvie em `POST /mdfe/{id}/reprocessamento`
`cancelado`	A SEFAZ confirmou o cancelamento
`encerrado`	A viagem terminou e a SEFAZ registrou o encerramento

historico[].em
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

historico[].mensagem string ou null

links
obrigatório object

links.self
obrigatório string

links.xml

string ou null

Vazio até autorizar.

links.damdfe

string ou null

Vazio até autorizar.

criadoEm
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

atualizadoEm
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

← Voltar ao início