Documentos Electrónicos (Sesión)

Endpoints de sesión para listar, consultar, descargar XML/KuDE y revisar el historial de lotes de cada documento.

Esta API utiliza autenticación Keycloak. Ver Autenticación para obtener un token JWT.

Estos endpoints son sólo lectura. Para emitir documentos electrónicos usá el endpoint con API key.

Endpoints

Método	Path	Descripción
`GET`	`/api/v1/contribuyentes/:id/documentos-electronicos`	Lista paginada con filtros
`GET`	`/api/v1/contribuyentes/:id/documentos-electronicos/:deId`	Detalle de un DE
`GET`	`/api/v1/contribuyentes/:id/documentos-electronicos/:deId/xml`	Descarga del XML firmado
`GET`	`/api/v1/contribuyentes/:id/documentos-electronicos/:deId/kude`	Descarga del KuDE en PDF
`GET`	`/api/v1/contribuyentes/:id/documentos-electronicos/:deId/lotes`	Historial de lotes del DE

Filtros del listado

Query	Tipo	Descripción
`page`	`int`	Página (default `0`)
`size`	`int`	Tamaño de página (default `10`)
`iTiDe`	`short`	`1`=FE, `5`=NCE, `6`=NDE
`estado`	`string`	`PENDIENTE`, `APROBADO`, `RECHAZADO`, `CANCELADO`
`fechaDesde`	`date` (`YYYY-MM-DD`)	Fecha de creación desde
`fechaHasta`	`date` (`YYYY-MM-DD`)	Fecha de creación hasta

Ejemplo con filtros

curl "https://api.sifende.com.py/api/v1/contribuyentes/12/documentos-electronicos?iTiDe=1&estado=APROBADO&fechaDesde=2026-04-01&fechaHasta=2026-04-30&page=0&size=20" \
  -H "Authorization: Bearer $KEYCLOAK_JWT"

DocumentoElectronicoDTO (listado)

Campo	Tipo	Descripción
`documentoElectronicoId`	`long`	ID interno
`cdc`	`string` (44)	Código de Control
`iTiDe`	`short`	Tipo de DE
`tipoDocumentoLabel`	`string`	Label legible
`estado`	`string`	Ver ciclo de vida
`estadoLabel`	`string`	Label para UI
`numeroDocumento`	`string`	Formato `001-001-0000123`
`fechaCreacion`	`datetime`	Alta en Sifende

Ejemplo de respuesta

{
  "status": "success",
  "payload": {
    "content": [
      {
        "documentoElectronicoId": 9871,
        "cdc": "01800123451001001000000122026042710000000006",
        "iTiDe": 1,
        "tipoDocumentoLabel": "FACTURA_ELECTRONICA",
        "estado": "APROBADO",
        "estadoLabel": "Aprobado",
        "numeroDocumento": "001-001-0000123",
        "fechaCreacion": "2026-04-15T10:30:00"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 432,
    "totalPages": 22
  }
}

DocumentoElectronicoDetalleDTO

Incluye todos los campos del listado, más:

Campo	Tipo	Descripción
`numeroEstablecimiento`	`int`	Establecimiento del DE
`numeroTimbrado`	`int`	Timbrado vigente al emitir
`loteId`	`long?`	Lote asociado (si ya fue agrupado)
`estadoLote`	`string?`	Estado del lote
`qrUrl`	`string?`	URL del QR de SIFEN para el KuDE
`tieneXml`	`boolean`	Si el XML firmado está disponible
`tieneCdc`	`boolean`	Si el CDC ya fue generado
`mensajeRechazo`	`string?`	Mensaje devuelto por SIFEN si fue rechazado
`codigoRechazo`	`string?`	Código SIFEN del rechazo
`fechaEdicion`	`datetime`	Última actualización

Ejemplo de detalle

curl https://api.sifende.com.py/api/v1/contribuyentes/12/documentos-electronicos/9871 \
  -H "Authorization: Bearer $KEYCLOAK_JWT"

{
  "status": "success",
  "payload": {
    "documentoElectronicoId": 9871,
    "cdc": "01800123451001001000000122026042710000000006",
    "iTiDe": 1,
    "tipoDocumentoLabel": "FACTURA_ELECTRONICA",
    "estado": "APROBADO",
    "estadoLabel": "Aprobado",
    "numeroDocumento": "001-001-0000123",
    "numeroEstablecimiento": 1,
    "numeroTimbrado": 12345678,
    "loteId": 4521,
    "estadoLote": "PROCESADO",
    "qrUrl": "https://ekuatia.set.gov.py/consultas/qr?...",
    "tieneXml": true,
    "tieneCdc": true,
    "mensajeRechazo": null,
    "codigoRechazo": null,
    "fechaCreacion": "2026-04-15T10:30:00",
    "fechaEdicion": "2026-04-15T10:31:45"
  }
}

Descargas binarias

# XML firmado
curl -OJ https://api.sifende.com.py/api/v1/contribuyentes/12/documentos-electronicos/9871/xml \
  -H "Authorization: Bearer $KEYCLOAK_JWT"

# KuDE en PDF
curl -OJ https://api.sifende.com.py/api/v1/contribuyentes/12/documentos-electronicos/9871/kude \
  -H "Authorization: Bearer $KEYCLOAK_JWT"

Ambos retornan el archivo binario directamente (application/xml o application/pdf) sin envelope payload.

Historial de lotes del DE

Un mismo DE puede haber estado en varios lotes (por reintentos). Este endpoint devuelve la lista completa.

curl https://api.sifende.com.py/api/v1/contribuyentes/12/documentos-electronicos/9871/lotes \
  -H "Authorization: Bearer $KEYCLOAK_JWT"

Documentos Electrónicos (Sesión)

On this page