Solución de Problemas
KuDE temporalmente no disponible
Qué significa el Problem Detail kude-unavailable y cómo reintentar una descarga de KuDE sin guardar un 202 como PDF.
kude-unavailable identifica una indisponibilidad temporal al obtener o preparar el PDF del KuDE. La API no encontró una copia legible para entregar y clasificó la causa como temporal.
HTTP/1.1 503 Service Unavailable
Content-Type: application/problem+json{
"type": "https://sifende.com.py/docs/solucion-problemas/kude-unavailable",
"title": "KuDE temporalmente no disponible",
"status": 503,
"detail": "El KuDE no está disponible temporalmente.",
"traceId": "f2f0333f78bfb6a4184cb5a5374685a5"
}Qué hacer
- Si venías de un
202, seguí usando elLocationrecibido cuando vuelvas a consultar. No cambies la URL ni borressoloConsulta=true. - Reintentá después del intervalo que indique
Retry-Aftersi el header está presente. Si no está, aplicá backoff propio. - Si el error persiste, contactá soporte con el
traceId, el CDC y la hora aproximada.
Qué no significa
- No significa que el documento sea inválido ni que debas reemitirlo.
- No promete exactly-once ni recuperación automática de correo.
- No habilita guardar un
202 application/jsoncomo PDF. - No implica que consultar con
soloConsulta=truevaya a reencolar o reparar el PDF.
Diferencias con otros errores de KuDE
| Status | Tipo | Acción sugerida |
|---|---|---|
| 202 | Sin Problem Detail | Seguir Location con soloConsulta=true; no guardar como PDF |
| 500 | kude-generation-error | Error técnico interno sin causa temporal segura; reportar con traceId si persiste |
| 501 | kude-not-supported | El tipo de documento no tiene KuDE disponible |
| 503 | kude-unavailable | Reintentar más tarde o escalar con traceId |
El panel web espera hasta 60 segundos antes de mostrar una acción manual; ese límite sólo aplica a la experiencia del panel, no al contrato público ni al tiempo máximo del worker.
Ver también Descargar KuDE y Errores.