Listar Eventos

GET /eventos — paginá los eventos SIFEN (cancelaciones e inutilizaciones) de un contribuyente.

GET /eventos

Lista los eventos SIFEN —cancelaciones e inutilizaciones— enviados desde la API. Soporta paginación y filtrado por tipo.

Variantes

Hay dos rutas equivalentes según el modo de autenticación:

GET /api/v1/documento-electronico/eventos

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

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

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

Query parameters

Parámetro	Tipo	Default	Descripción
`page`	`integer`	`0`	Página solicitada (base 0)
`size`	`integer`	`10`	Cantidad de elementos por página
`tipoEvento`	`enum`	—	Filtra por tipo: `CANCELACION` o `INUTILIZACION`

Respuesta exitosa

Status: 200 OK

La versión sesión (JWT) envuelve la respuesta en { status, payload }. La versión API key devuelve directamente el PageDTO.

{
  "status": "success",
  "payload": {
    "content": [
      {
        "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"
      }
    ],
    "totalElements": 87,
    "totalPages": 9,
    "size": 10,
    "number": 0
  }
}

Campos del EventoSifenDTO

Campo	Tipo	Descripción
`eventoSifenId`	`integer`	ID interno del evento
`documentoElectronicoId`	`integer\|null`	DE asociado (null en inutilizaciones)
`contribuyenteId`	`integer`	Contribuyente emisor del evento
`tipoEvento`	`enum`	`CANCELACION` o `INUTILIZACION`
`estadoEvento`	`enum`	`PENDIENTE`, `PROCESADO`, `RECHAZADO`
`cdc`	`string\|null`	CDC del documento (solo cancelación)
`motivo`	`string`	Motivo declarado al enviar el evento
`protocoloAutorizacion`	`string\|null`	Número de protocolo SIFEN cuando se confirma
`codigoRespuesta`	`string\|null`	Código de respuesta SIFEN
`mensajeRespuesta`	`string\|null`	Mensaje SIFEN
`fechaCreacion`	`datetime`	Fecha de envío del evento
`fechaProcesamiento`	`datetime\|null`	Fecha de respuesta de SIFEN

Solo en `tipoEvento = INUTILIZACION`

Campo	Tipo	Descripción
`numeroTimbrado`	`string`	Timbrado del rango inutilizado
`establecimiento`	`integer`	Establecimiento (3 dígitos)
`puntoExpedicion`	`integer`	Punto de expedición (3 dígitos)
`numeroInicio`	`integer`	Primer número del rango
`numeroFin`	`integer`	Último número del rango
`tipoDocumento`	`short`	Código numérico del tipo de documento (ej. `1` = FE)
`serieNumero`	`string\|null`	Serie utilizada (si aplica)

Errores

Status	Tipo	Descripción
401	—	API key o JWT inválido
403	`access-denied`	El usuario no es propietario del contribuyente
422	`invalid-enum-value`	`tipoEvento` con valor no válido

Ejemplo

curl "https://api.sifende.com.py/api/v1/documento-electronico/eventos?page=0&size=20&tipoEvento=CANCELACION" \
  -H "Authorization: Bearer $API_KEY"

On this page