GET/nfcom/{idOrChaveOrProtocolo}/evento

Consultar a solicitação do evento

Consulte o status da solicitação do evento de NFCom. Para facilitar a sua integração, é recomendado observar o campo status, que deve ser `CONCLUIDO` para casos de sucesso, `REJEITADO` em caso de rejeição e `CANCELADO` em caso de cancelamento. Atualmente, o único evento disponível para NFCom é o `110300` (`vinculacaoPagamento`). Não informe parâmetros quando quiser retornar todos os eventos vinculados à nota.

Produção: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parâmetros

codigo query	Informe o código `110300` para retornar o evento de vinculação de pagamento (`vinculacaoPagamento`).
status query	Informe um dos status a seguir: * `CONCLUIDO`: para retornar o último evento autorizado pela SEFAZ. * `REJEITADO`: para retornar o último evento rejeitado pela SEFAZ. * `CANCELADO`: para retornar o último evento cancelado pela SEFAZ. O parâmetro `codigo` deve ser informado.
protocolo query	Utilize o protocolo retornado na requisição de envio do evento. Quando informado, tem prioridade sobre `codigo`.

Requisição

cURL

curl -X GET 'https://api.otentecnologia.com.br/nfcom/{idOrChaveOrProtocolo}/evento' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Respostas

200OK

JSON

{
  "message": "Encontrado eventos vinculados a nota.",
  "data": {
    "vinculacaoPagamento": [
      {
        "date": "2026-04-01T13:20:10.123Z",
        "status": "CONCLUIDO",
        "respostaSefaz": "Evento registrado e vinculado à NFCom",
        "cStat": 135,
        "numeroSequencia": "1",
        "protocoloSefaz": "135260000123456",
        "protocolo": "9cfff11a-34dc-47f8-b44d-6069ce5ab324",
        "xml": "https://api.otentecnologia.com.br/nfcom/{idOrChaveOrProtocolo}/eventosnfcom/xml?codigo=110300&protocolo={protocolEvento}&status=autorizacao"
      }
    ]
  }
}

400Bad Request

JSON

{
  "error": {
    "message": "Campo `codigo` obrigatório quando enviado `status`."
  }
}

401Unauthorized

JSON

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://www.otentecnologia.com.br/, e gere o seu TOKEN de acesso"
  }
}

404Not Found

JSON

{
  "error": {
    "message": "Não localizamos qualquer evento com os parâmetros informados"
  }
}