Status do Serviço

Descrição Geral

A rota de Status do Serviço verifica a disponibilidade atual dos webservices da SEFAZ para a autorização e processamento do Manifesto Eletrônico de Documentos Fiscais (MDF-e).

Função da Rota

Retorna se o serviço da MDF-e na Secretaria da Fazenda (ou Ambiente Nacional) está em operação normal, inativo ou em estado de contingência.

Situações de Uso

• Validar proativamente se o sistema de emissão está operando sem interrupções.
• Prevenir tentativas de emissão falhas devido à indisponibilidade do sistema da SEFAZ.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
consStatServMDFe	object	✅	Objeto contendo os dados para consulta do status.
consStatServMDFe.tpAmb	string	✅	Identificação do Ambiente: 1 - Produção / 2 - Homologação.
consStatServMDFe.xServ	string	✅	Serviço Solicitado. Deve ser STATUS.
consStatServMDFe.CNPJ	string	⚙️ Opcional*	CNPJ do emitente do MDF-e.
consStatServMDFe.CPF	string	⚙️ Opcional*	CPF do emitente do MDF-e.
certificate	string	⚙️ Opcional	Certificado digital A1 em base64. Opcional caso já possua na base.
pass_certificate	string	⚙️ Opcional	Senha do certificado digital. Opcional caso já possua na base.

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

{
  "consStatServMDFe": {
    "tpAmb": "1",
    "xServ": "STATUS",
    "CNPJ": "12345678000123"
  }
}

Exemplo de Requisição Completa

curl --request POST \
  --url https://api.emitix.com.br/mdf/status-servico \
  --header 'api-key: SUA_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'token: SEU_TOKEN' \
  --data '{
    "consStatServMDFe": {
      "tpAmb": "1",
      "xServ": "STATUS",
      "CNPJ": "12345678000123"
    }
  }'

Exemplo de Resposta

{
	"success": true,
	"statusCode": 200,
	"message": "Status do MDFe consultado com sucesso",
	"data": {
		"tpAmb": "2",
		"verAplic": "RS20240709143558",
		"cStat": "107",
		"xMotivo": "Servico em Operacao",
		"cUF": "43",
		"dhRecbto": "2026-03-20T13:29:52-03:00",
		"tMed": "1",
		"@_xmlns": "http://www.portalfiscal.inf.br/mdfe",
		"@_versao": "3.00"
	}
}