Errores Comunes
Los errores más frecuentes al integrar con la API de Sifende — causa y solución para cada uno.
Error 401 — Invalid or expired API key
Causa: El API key es incorrecto, fue revocado, o el header está mal formateado.
Solución:
- Verificá que el header sea exactamente:
Authorization: Bearer {tu-api-key} - No uses
X-API-Keyni otros formatos - Si el key fue rotado, actualizá al nuevo valor
Error 400 — validation-error en montos PYG
Causa: Enviaste montos con decimales para PYG.
Solución: Los montos en guaraníes son enteros. Cambiá 10000.00 → 10000.
Error 422 — documento-electronico-generation-error
Causa: El documento no cumple con las validaciones de SIFEN.
Solución: Revisá el campo detail del error Problem Details para el mensaje específico. Corregí los datos que no cumplen el modelo; si el problema persiste, contactá a soporte con el traceId.
Error 422 — configuracion-incompleta
Causa: Falta el timbrado del ambiente u otro dato de configuración del contribuyente.
Solución: Revisá campo y completá el dato en Contribuyente. Para el timbrado, elegí el ambiente de la API key en Contribuyente → Timbrado.
Error 404 — certificate-not-found
Causa: No se encontró un certificado activo junto con el CSC del ambiente.
Solución: Revisá el certificado y el CSC desde Contribuyente → Certificado digital.
Documento queda en PENDIENTE por más de 5 minutos
Causa: SIFEN puede demorar en procesar.
Solución: Consultá el estado nuevamente y mirá si SIFEN está respondiendo en Estado de SIFEN. Si persiste por más de 15 minutos, contactá soporte.
Rechazos comunes de SIFEN
Los rechazos que casi todos ven durante la habilitación y las pruebas — síntoma, causa y solución. Casi siempre es un dato que no coincide con lo que SET tiene registrado para tu RUC, no un error de Sifende.
Certificado Digital
Problemas comunes con el certificado digital — vencimiento, contraseña incorrecta y formato inválido.