Consulta Processamento

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

Descrição Geral

Esta rota realiza a consulta do processamento de uma NFC-e (Nota Fiscal de Consumidor Eletrônica) previamente enviada à SEFAZ.
Quando uma NFC-e é transmitida, a SEFAZ pode levar alguns segundos para processá-la. Com esta rota, o contribuinte pode consultar o status do processamento a partir do número de recibo (nRec) retornado no envio da nota.

Função da Rota

Consultar o resultado do processamento de uma NFC-e após o envio do lote, verificando se o documento foi:

Autorizado;
Rejeitado;
Em processamento;
Ou se houve algum erro de comunicação.

Esta rota também permite recuperar informações como o protocolo de autorização e o status final da nota.

Situações de Uso

Quando uma NFC-e foi enviada em lote e é necessário verificar se o processamento foi concluído.
Quando o sistema recebeu o número de recibo (nRec), mas ainda não possui a resposta definitiva da SEFAZ.
Em casos de falhas de rede, onde o retorno da SEFAZ não foi recebido no momento do envio.
Para confirmar a autorização antes de disponibilizar o DANFE NFC-e para o cliente.

Campos

Campo	Tipo	Obrigatório	Descrição
consulta	object	✅	Objeto contendo os dados da consulta.
consulta.tpAmb	string	✅	Tipo de ambiente: 1 (Produção) ou 2 (Homologação).
consulta.nRec	string	✅	Número do recibo da NFC-e (15 dígitos) retornado no envio.
consulta.cnpj	string	✅	CNPJ do emitente da NFC-e (14 dígitos).
consulta.uf	string	✅	Sigla da Unidade Federativa do emitente (ex: SP).
certificate	string	✅	Certificado digital A1 em Base64, para assinar a requisição.
pass_certificate	string	✅	Senha do certificado digital A1.

Exemplo de Payload

{
  "consulta": {
    "tpAmb": "1",
    "nRec": "123456789012345",
    "cnpj": "12345678000199",
    "uf": "SP"
  },
  "certificate": "MIIGgTCCBGmgAwIBAgIQ... (base64)",
  "pass_certificate": "senha_certificado"
}

Exemplo de Requisição Completa

curl -X POST https://api.emitix.com.br/nfce/consultaProcessamento \
  -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 processamento realizada com sucesso",
  "statusCode": 200,
  "data": {
    "xml": "<consReciNFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\"><tpAmb>2</tpAmb><nRec>124429912023</nRec></consReciNFe>",
    "response": {
      "tpAmb": "2",
      "verAplic": "SP_NFE_PL009_V4",
      "cStat": "104",
      "xMotivo": "Lote processado",
      "cUF": "35",
      "dhRecbto": "2025-10-22T14:32:04-03:00",
      "protNFe": [
        {
          "infProt": {
            "tpAmb": "2",
            "verAplic": "SP_NFE_PL009_V4",
            "chNFe": "3525107436361500...",
            "dhRecbto": "2025-10-22T14:21:41-03:00",
            "nProt": "1352500089102335",
            "digVal": "Hy1pHjGbmNAZtuvGg/bQI3QdiOg=",
            "cStat": "100",
            "xMotivo": "Autorizado o uso da NF-e"
          },
          "@_versao": "4.00"
        }
      ]
    }
  }
}

Descrição Geral​

Função da Rota​

Situações de Uso​

Campos​

Exemplo de Payload​

Exemplo de Requisição Completa​

Exemplo de Resposta​