Changelog

Historial de cambios de la API de Sifende — nuevas funcionalidades, correcciones y breaking changes.

2026-09-08

GET /api/v1/padron/{documento} consulta un RUC o cédula y devuelve razón social, estado, tipo de contribuyente y domicilio fiscal con los códigos geográficos de SIFEN
Los nombres de campo y las enumeraciones son los del receptor del documento electrónico (tipoContribuyente, tipoContribuyenteReceptor, tipoDocumento, numeroDocumento, digitoVerificador, nombreRazonSocial), y estadoRuc trae el código SET del estado
Acepta el documento con o sin puntos y con o sin dígito verificador; una cédula que no es RUC responde con tipoContribuyente: NO_CONTRIBUYENTE y tipoDocumento: CEDULA_PARAGUAYA
domicilio y email pueden venir en null cuando el padrón no los tiene
Límite de 60 consultas por minuto por API key y 120 por contribuyente, con 429 rate-limit-exceeded y Retry-After; la consulta es de sólo lectura y no consume el plan de consumo

GET /api/v1/documento-electronico/plan-consumo consulta el plan, el ciclo, el cupo, las reservas y el costo adicional estimado del contribuyente asociado a la API key
Idempotency-Key opcional en emisión, cancelación e inutilización, con namespace único por contribuyente y replay exacto durante 7 días
Retries dirigidos por el cliente con la misma clave ante conexión sin respuesta, 409 idempotency-in-progress o 503 idempotency-upstream-unknown

Una clave cuyo replay venció queda reservada permanentemente y devuelve 409 idempotency-key-expired; no puede reutilizarse
En cancelación, SIFEN 4003 se acepta como éxito equivalente y conserva la evidencia original sin inventar un protocolo
En inutilización, SIFEN 4066 deja el evento INDETERMINADA y devuelve el terminal 409 idempotency-outcome-unknown
Sifende no reintenta ni reconcilia estos eventos en segundo plano

Webhooks salientes por contribuyente para documento.aprobado, documento.rechazado, documento.cancelado y lote.procesado
Firma HMAC-SHA256, entrega durable con reintentos e historial de 90 días
Panel para administrar endpoints, rotar secretos y consultar intentos de entrega

GET /api/v1/public/enums expone la categoría tipoContribuyenteReceptor (PERSONA_FISICA / PERSONA_JURIDICA), obligatoria para receptores contribuyentes. El endpoint pasa de 18 a 19 categorías

El changelog incluye solo cambios en la API pública. Ver el repositorio para el historial completo de cambios internos.