Skip to main content

Status de Serviço

Método: POST
Endpoint: https://api.emitix.com.br/nfce/statusservico

Descrição geral​

Esta rota realiza a consulta do status de disponibilidade do serviço de autorização da NFC-e (Nota Fiscal de Consumidor Eletrônica) na SEFAZ.
O objetivo é verificar se o ambiente (Produção ou Homologação) está disponível, instável ou fora do ar no momento da requisição.

Função da rota​

A função principal desta rota é consultar a disponibilidade dos servidores da SEFAZ responsáveis pelo recebimento das NFC-e.
Ela é fundamental para evitar tentativas de envio de notas fiscais em momentos de indisponibilidade técnica do ambiente.

Situações de uso​

  • Antes de emitir uma NFC-e, verificar se a SEFAZ está operacional.
  • Durante rotinas automáticas de emissão, para pausar transmissões em caso de indisponibilidade.
  • Em sistemas de monitoramento fiscal, para auditar a saúde dos serviços SEFAZ.
  • Para ambientes de teste (Homologação), checar se o serviço está ativo.

Campos​

CampoTipoObrigatórioDescrição
tpAmbstring✅Tipo de ambiente da requisição: 1 = Produção, 2 = Homologação. Define o ambiente a consultar.
cUFstring✅Código numérico da Unidade Federativa do emitente (ex: 35 = SP).
CNPJstring✅CNPJ do contribuinte emitente (14 dígitos numéricos). Usado para autenticação fiscal.
certificatestring✅Certificado digital A1 do emitente, em Base64, para autenticação junto à SEFAZ.
pass_certificatestring✅Senha do certificado digital A1 para decodificação e uso do certificado.

Exemplo de payload​

{
  "tpAmb": "1",
  "cUF": "35",
  "CNPJ": "12345678000195",
  "certificate": "MIIDqjCCAyKgAwIBAgIIE... (base64)",
  "pass_certificate": "123456"
}

Exemplo de requisição completa​

curl -X POST https://api.emitix.com.br/nfce/statusservico \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "api-key: SUA_API_KEY_AQUI..." \
  -d '{Payload}'

Exemplo de resposta​

{
  "success": true,
  "message": "Consulta status realizada com sucesso",
  "statusCode": 200,
  "data": {
    "xml": "<consStatServ xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\"><tpAmb>2</tpAmb><cUF>35</cUF><xServ>STATUS</xServ></consStatServ>",
    "response": {
      "tpAmb": "2",
      "verAplic": "SP_NFCE_PL_009_V400",
      "cStat": "107",
      "xMotivo": "Serviço em Operação",
      "cUF": "35",
      "dhRecbto": "2025-10-20T10:23:50-03:00",
      "tMed": "60"
    }
  }
}