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. 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.