GET/nfcom/{idOrChaveOrProtocolo}/evento

Check an event request

Returns the status of an NFCom event request. Watch the status field: CONCLUIDO on success, REJEITADO on failure.

Production: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parameters

codigo query	Send code `110300` to return the payment-link event (`vinculacaoPagamento`).
status query	Send one of the following statuses: * `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	Use the protocol returned when the event was submitted. When provided, tem prioridade sobre `codigo`.

Request

cURL

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

Responses

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"
  }
}