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-Key ni 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. Los problemas más comunes son: timbrado vencido, certificado expirado, campos faltantes para el tipo de documento.

Error 404 — timbrado-not-found

Causa: No hay un timbrado configurado para el contribuyente.

Solución: Configurá el timbrado electrónico en el panel de Sifende antes de emitir documentos.

Error 404 — certificate-not-found

Causa: No hay un certificado digital subido para el contribuyente.

Solución: Subí tu certificado PKCS12 desde el panel en Configuración → Certificado.

Documento queda en PENDIENTE por más de 5 minutos

Causa: El scheduler de Sifende podría tener un retraso o el lote está en reintento.

Solución: Consultá el estado nuevamente. Si persiste por más de 15 minutos, contactá soporte.