Listar Eventos

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

GET /eventos

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

Autenticación y ruta

GET /api/v1/documento-electronico/eventos

Authorization: Bearer {api-key}. La clave determina el contribuyente y el ambiente.

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`	`string`	—	Filtra por tipo: `CANCELACION`, `INUTILIZACION` o `NOMINACION`

Respuesta exitosa

Status: 200 OK

La respuesta contiene directamente content, page, size, totalElements y totalPages.

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

Campos del evento

Campo	Tipo	Descripción
`eventoSifenId`	`integer`	Identificador del evento
`documentoElectronicoId`	`integer\|null`	DE asociado (null en inutilizaciones)
`contribuyenteId`	`integer`	Contribuyente emisor del evento
`ambiente`	`string`	Ambiente de la operación: `DEV` o `PROD`
`tipoEvento`	`enum`	`CANCELACION`, `INUTILIZACION` o `NOMINACION`
`estadoEvento`	`enum`	`PENDIENTE`, `ENVIADO`, `APROBADO`, `RECHAZADO`, `ERROR`, `INDETERMINADA`
`cdc`	`string\|null`	CDC del documento (cancelación o nominació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`	`integer`	Timbrado del rango inutilizado
`establecimiento`	`string`	Establecimiento (3 dígitos)
`puntoExpedicion`	`string`	Punto de expedición (3 dígitos)
`numeroInicio`	`string`	Primer número del rango
`numeroFin`	`string`	Último número del rango
`tipoDocumento`	`integer`	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 inválida

Ejemplo

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

Listar Eventos

On this page