Detalle de Evento

GET /eventos/:eventoId

Devuelve el detalle completo de un evento SIFEN, incluyendo el protocolo de autorización si SIFEN lo confirmó.

Variantes

GET /api/v1/documento-electronico/eventos/{eventoId}

Authorization: Bearer {api-key} — la clave determina el contribuyente.

GET /api/v1/contribuyentes/{contribuyenteId}/eventos/{eventoId}

Authorization: Bearer {jwt} — el usuario debe ser propietario del contribuyente.

Path parameters

Parámetro	Tipo	Descripción
`eventoId`	`integer`	`eventoSifenId` del evento

Respuesta exitosa

Status: 200 OK

Devuelve un EventoSifenDTO completo (mismos campos que Listar Eventos).

Ejemplo — evento de CANCELACION confirmado

{
  "status": "success",
  "payload": {
    "eventoSifenId": 1024,
    "documentoElectronicoId": 8821,
    "contribuyenteId": 42,
    "tipoEvento": "CANCELACION",
    "estadoEvento": "PROCESADO",
    "cdc": "01800123451001001000000122026042710000000006",
    "motivo": "Error en datos del cliente",
    "protocoloAutorizacion": "20260427143218000",
    "codigoRespuesta": "0391",
    "mensajeRespuesta": "Evento de cancelación registrado exitosamente",
    "fechaCreacion": "2026-04-27T14:32:18",
    "fechaProcesamiento": "2026-04-27T14:32:45"
  }
}

Ejemplo — evento de INUTILIZACION pendiente

{
  "status": "success",
  "payload": {
    "eventoSifenId": 1025,
    "documentoElectronicoId": null,
    "contribuyenteId": 42,
    "tipoEvento": "INUTILIZACION",
    "estadoEvento": "PENDIENTE",
    "cdc": null,
    "motivo": "Numeración no utilizada por error de sistema",
    "protocoloAutorizacion": null,
    "codigoRespuesta": null,
    "mensajeRespuesta": null,
    "fechaCreacion": "2026-04-27T15:01:09",
    "fechaProcesamiento": null,
    "numeroTimbrado": "12557896",
    "establecimiento": 1,
    "puntoExpedicion": 1,
    "numeroInicio": 50,
    "numeroFin": 55,
    "tipoDocumento": 1,
    "serieNumero": null
  }
}

Cuándo aparece `protocoloAutorizacion`

El campo se completa solo cuando SIFEN confirma el evento (estadoEvento = PROCESADO y codigoRespuesta exitoso, ej. 0391 para cancelaciones, 0392 para inutilizaciones).

Si el evento todavía está PENDIENTE, protocoloAutorizacion, codigoRespuesta y mensajeRespuesta serán null.

Errores

Status	Tipo	Descripción
401	—	API key o JWT inválido
403	`access-denied`	El usuario no es propietario del contribuyente
404	`evento-not-found`	El `eventoId` no existe o no pertenece al contribuyente

Ejemplo

curl https://api.sifende.com.py/api/v1/documento-electronico/eventos/1024 \
  -H "Authorization: Bearer $API_KEY"

On this page