Status de Serviço

Método: POST

Endpoint: https://api.emitix.com.br/nfe/statusservico

Descrição Geral

A rota /nfe/statusservico permite consultar a situação operacional atual dos serviços de autorização e processamento de NF-e da SEFAZ (Secretaria da Fazenda) de um determinado estado.

É uma rota essencial para verificar a disponibilidade do ambiente antes de tentar o envio de documentos fiscais.

Função da Rota

• Verificar se o serviço de autorização de NF-e da SEFAZ está ativo.
• Obter a mensagem de status e o código de retorno oficial da SEFAZ.
• Auxiliar na tomada de decisão sobre o modo de emissão (normal ou contingência).

Situações de Uso

• Antes de iniciar um lote de emissão de NF-e.
• Em caso de falha na comunicação com a SEFAZ.
• Para monitoramento contínuo da disponibilidade do serviço.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
statusservico	objeto	✅	Dados para consulta de status.
certificate	string	✅	Certificado digital A1 do solicitante.
pass_certificate	string	✅	Senha do certificado digital A1.
statusservico.tpAmb	string	✅	Tipo de ambiente: "1" = produção, "2" = homologação.
statusservico.UF	string	✅	Sigla da UF (estado) a ser consultada. Ex: SP, RJ, MG.

Autenticação

• Bearer Token
  • Authorization: Bearer <seu_token_de_acesso>
• API Key
  • api-key: <sua_api_key>

Exemplo de Payload

{
  "statusservico": {
    "tpAmb": "1",
    "UF": "SP"
  },
  "certificate": "SEUCERTIFICADODIGITALAQUI..",
  "pass_certificate": "senha123"
}

Exemplo de Requisição Completa

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

Exemplo de Resposta (Serviço Ativo)

{
  "success": true,
  "message": "Consulta de status de serviço realizada com sucesso",
  "statusCode": 200,
  "data": {
    "response": {
      "tpAmb": "1",
      "verAplic": "SP_NFE_PL009_V4",
      "cStat": "107",
      "xMotivo": "Serviço em Operação",
      "cUF": "35",
      "dhRetorno": "2025-10-31T10:30:00-03:00"
    },
    "xml": "<retConsStatServ xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\">..."
  }
}