Referencia APIEventos SIFEN
Detalle de Evento
GET /eventos/:eventoId — obtené el detalle completo de un evento SIFEN.
GET /eventos/:eventoId
Devuelve el detalle completo de un evento SIFEN, incluyendo el protocolo de autorización si SIFEN lo confirmó.
Autenticación y ruta
GET /api/v1/documento-electronico/eventos/{eventoId}Authorization: Bearer {api-key}. La clave determina el contribuyente y el ambiente.
Path parameters
| Parámetro | Tipo | Descripción |
|---|---|---|
eventoId | integer | eventoSifenId del evento |
Respuesta exitosa
Status: 200 OK
Devuelve el objeto del evento (mismos campos que Listar Eventos).
Ejemplo — evento de CANCELACION confirmado
{
"eventoSifenId": 1024,
"documentoElectronicoId": 8821,
"contribuyenteId": 42,
"tipoEvento": "CANCELACION",
"estadoEvento": "APROBADO",
"cdc": "01800123451001001000000122026042710000000006",
"motivo": "Error en datos del cliente",
"protocoloAutorizacion": "20260427143218000",
"codigoRespuesta": "0600",
"mensajeRespuesta": "Evento de cancelación registrado exitosamente",
"fechaCreacion": "2026-04-27T14:32:18",
"fechaProcesamiento": "2026-04-27T14:32:45",
"ambiente": "DEV"
}Ejemplo — evento de INUTILIZACION pendiente
{
"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": "001",
"puntoExpedicion": "001",
"numeroInicio": "0000025",
"numeroFin": "0000030",
"tipoDocumento": 1,
"serieNumero": null,
"ambiente": "DEV"
}Cuándo aparece protocoloAutorizacion
El campo se completa solo cuando SIFEN confirma el evento con un protocolo. El código 0600 indica que el evento quedó registrado. Un resultado APROBADO también puede corresponder a una cancelación ya registrada (4003); en ese caso el protocolo puede ser null.
Si el evento todavía está PENDIENTE, protocoloAutorizacion, codigoRespuesta y mensajeRespuesta serán null.
Errores
| Status | Tipo | Descripción |
|---|---|---|
| 401 | — | API key inválida |
| 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"