Oten Tecnologia
Oten Fiscal
Documentación
GET/nfcom/{idOrChaveOrProtocolo}/evento

Consultar una solicitud de evento

Devuelve el estado de una solicitud de evento de NFCom. Observe el campo status: CONCLUIDO en éxito y REJEITADO en fallo.

Producción: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parámetros

codigo
query
Informe el código `110300` para devolver el evento de vinculación de pago (`vinculacaoPagamento`).
status
query
Informe uno de los siguientes estados: * `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 el protocolo devuelto al enviar el evento. Cuando se informa, tem prioridade sobre `codigo`.

Solicitud

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

Respuestas

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