Consulta de Processamento

Método: POST

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

Descrição Geral

Essa rota tem como objetivo consultar o resultado do processamento de uma NF-e (Nota Fiscal Eletrônica) enviada à SEFAZ em modo assíncrono.

Quando a NF-e é transmitida, a SEFAZ pode processá-la de duas formas:

• Síncrona: a resposta de autorização ou rejeição é retornada imediatamente.
• Assíncrona: a SEFAZ retorna apenas um número de recibo (nRec), indicando que o lote foi recebido, mas ainda está em processamento.

Essa rota é usada para consultar o resultado desse processamento, verificando se a NF-e foi autorizada, rejeitada ou se ainda está em análise.

Função da Rota

• Consultar o status do lote de NF-e enviado à SEFAZ em modo assíncrono.
• Obter o protocolo de autorização da nota (em caso de sucesso) ou o motivo da rejeição (em caso de erro).
• Identificar se o processamento ainda está em andamento e definir se o sistema deve aguardar ou tentar novamente.
• Integrar com o fluxo de emissão para armazenar, imprimir DANFE ou seguir com cancelamento após a autorização.

Situações de Uso

A rota de consulta de processamento deve ser utilizada nas seguintes situações:

1. Emissão assíncrona de NF-e: Quando o envio da NF-e retorna apenas o recibo de processamento (nRec).
2. Processamento pendente: Quando a resposta da SEFAZ indica que o lote foi recebido, mas ainda não processado.
3. Falhas de comunicação: Quando o sistema não recebeu a resposta final do envio e precisa confirmar o status do documento.
4. Reenvio ou auditoria: Para verificar novamente o status de uma NF-e e garantir a consistência entre o sistema emissor e a SEFAZ.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
consulta.tpAmb	string	✅	Tipo de ambiente da SEFAZ: • 1 – Produção • 2 – Homologação
consulta.nRec	string	✅	Número do recibo retornado pela SEFAZ no envio assíncrono. Identifica o lote em processamento.
consulta.uf	string	✅	Sigla da UF (estado) responsável pela autorização da NF-e. Ex: SP, RJ, MG.
consulta.cnpj	string	✅	CNPJ do emitente da NF-e que enviou o lote.
certificate	string	✅	Certificado digital A1 do emissor, em formato Base64. Utilizado para assinar e autenticar a comunicação com a SEFAZ.
pass_certificate	string	✅	Senha do certificado digital A1 do emissor. Necessária para descriptografar e validar o certificado.

Autenticação

Essa rota requer duas camadas de autenticação:

1. Bearer Token (Authorization Header)
   • Fornecido pela API para acesso autenticado.
   • Esse token tem um tempo de expiração de 1 hora.
   • Deve ser enviado no campo Authorization como: Authorization: Bearer <seu_token_de_acesso>
2. API Key (Header adicional)
   • Chave exclusiva de acesso à API.
   • Deve ser enviada no header: api-key: <sua_api_key>

Exemplo de Payload

{
  "consulta": {
    "tpAmb": "1",
    "nRec": "312000123456789",
    "uf": "SP",
    "cnpj": "12345678000190"
  },
  "certificate": "SEUCERTIFICADODIGITAL123...",
  "pass_certificate": "senha123"
}

Exemplo de Requisição Completa

curl -X POST https://api.emitix.com.br/nfe/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>351000205876488</nRec></consReciNFe>",
    "response": {
      "tpAmb": "2",
      "verAplic": "SP_NFE_PL009_V4",
      "cStat": "104",
      "xMotivo": "Lote processado",
      "cUF": "35",
      "dhRecbto": " 2025-10-28T08:10:22-03:00",
      "protNFe": [
        {
          "infProt": {
            "tpAmb": "2",
            "verAplic": "SP_NFE_PL009_V4",
            "chNFe": "35241012345678000190550010000000101000000101",
            "dhRecbto": " 2025-10-28T08:10:22-03:00",
            "nProt": " 135230000000001",
            "digVal": "Hy1pHjGbmNAZtuvGg/bQI3QdiOg=",
            "cStat": "100",
            "xMotivo": "Autorizado o uso da NF-e"
          },
          "@_versao": "4.00"
        }
      ]
    }
  }
}