Changelog

2026-10-10

Nuevo

• GET /api/v1/contribuyente devuelve los datos del contribuyente asociado a la API key: RUC, razón social, dirección, actividades económicas, timbrado del ambiente de la clave, establecimientos y logo, con un estadoConfiguracion que indica si la emisión va a pasar los controles de configuración.
• GET /api/v1/contribuyente/plan-consumo es la nueva ruta de la consulta de plan y consumo, con la misma respuesta.

Deprecado

• GET /api/v1/documento-electronico/plan-consumo sigue respondiendo igual hasta el 2027-01-15, cuando se remueve. Sus respuestas incluyen los headers Deprecation, Sunset y Link con la ruta nueva. Cambiá la URL a /api/v1/contribuyente/plan-consumo; la autenticación y la respuesta no cambian.

---

2026-10-05

Comportamiento

• Una Idempotency-Key ya registrada devuelve la operación original aunque cambien el body o el CDC. Antes respondía 422 idempotency-key-reused; ahora ese error sólo aparece si usás la clave para otro tipo de operación. Si reutilizás una clave por error, recibís la operación anterior en lugar de un error.
• El replay y la recuperación de eventos pendientes funcionan aunque el documento esté archivado.
• La clave sigue reservada después de los 7 días de replay, hasta que termina la conservación del documento.

---

2026-10-03

Nuevo

• Autofactura Electrónica disponible para compras a personas locales no contribuyentes, en guaraníes y al contado, con consulta de estado y KuDE.
• GET /api/v1/geografia/departamentos/{departamentoId}/ciudades lista las ciudades del departamento sin elegir un distrito. En AFE, el distrito es opcional en el domicilio del vendedor y en el lugar de la operación.
• GET /api/v1/public/enums incluye tipoConstancia.

---

2026-10-02

Nuevo

• Cada API key pertenece a un ambiente fijo. Las claves nuevas usan sk_sandbox_ para Sandbox de Sifende, sk_test_ para pruebas con SIFEN y sk_live_ para producción, con la misma URL base. Las claves anteriores conservan su ambiente aunque su prefijo no coincida; verificalo en el panel.
• Timbrado y CSC configurables para DEV y PROD desde el panel. SANDBOX proporciona sus valores de prueba; el certificado activo sirve para los tres ambientes.
• Sandbox de Sifende permite probar emisión y notificaciones sin enviar documentos a SIFEN; su KuDE indica que no tiene validez fiscal.
• Filtro de ambiente en los documentos del panel: Desarrollo, Producción y Sandbox.
• Webhooks por ambiente, con hasta cinco endpoints activos por contribuyente y ambiente. Las notificaciones nuevas incluyen ambiente en la raíz y mantienen version: "1".
• Las respuestas de emisión y consulta de estado incluyen ambiente: DEV, PROD o SANDBOX. Este valor permanece asociado al documento.
• sandbox-operation-not-supported: respuesta 422 al intentar cancelar, inutilizar o nominar en SANDBOX.
• Nota de Remisión Electrónica disponible, con consulta de estado y KuDE.

Documentación

• Se documentan las facturas a crédito en PYG por PLAZO o CUOTA.
• Se documenta la personalización del correo, con logo, nombre comercial, colores, datos de contacto y correo de prueba.

Si ya usás webhooks

Los endpoints existentes quedan asignados al ambiente que tenía el contribuyente al aplicar este cambio. Revisá el ambiente que muestra cada endpoint en Webhooks. Para recibir eventos de otro ambiente, creá otro endpoint y guardá su secreto. Las entregas anteriores conservan su payload y destinatario originales: pueden no incluir ambiente y corresponder a otro ambiente, incluso en un reintento. La firma y los reintentos se mantienen.

2026-09-08

Nuevo

• 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

---

2026-08-18

Nuevo

• 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

Comportamiento

• 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; el protocolo puede ser null
• En inutilización, SIFEN 4066 deja el evento INDETERMINADA y devuelve el terminal 409 idempotency-outcome-unknown

---

2026-08-13

Nuevo

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

---

2026-08-10

Nuevo

• 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

---

2026-04-15

Nuevo

• Notas de Débito Electrónicas (NDE) mediante POST /api/v1/documento-electronico con tipoDocumento: "NOTA_DE_DEBITO_ELECTRONICA"
• Soporte para receptor B2B en Facturas Electrónicas

Corrección

• Corrección del cálculo de IVA incluido en el precio de los ítems gravados

---

2026-03-01

Nuevo

• Soporte para Notas de Crédito Electrónicas (NCE)

---