# Changelog (/docs/referencia/changelog)



## 2026-11-13 [#2026-11-13]

### Nuevo [#nuevo]

* [API integradora](/docs/referencia/integradores): los socios integradores dan de alta y configuran a sus clientes desde su propio sistema con una key `ik_…` creada en el portal de socios. Cubre alta con o sin titular, plan y pagador, certificado, establecimientos, personalización, webhooks y API keys de cada cliente. Ver la [guía de alta por API](/docs/guias/alta-cliente-integrador). Los endpoints están en el [spec OpenAPI](/docs/referencia/openapi) y en el [explorador de la API](/docs/referencia/api), con el esquema de seguridad `integradorKey`.

***

## 2026-11-09 [#2026-11-09]

### Nuevo [#nuevo-1]

* [`DELETE /api/v1/contribuyente/api-key`](/docs/referencia/autenticacion#revocar-la-clave-desde-tu-integración) revoca la API key con la que se hace el pedido, para que una integración se dé de baja sin entrar al panel. Responde `204`; después la clave responde `401`.

### Cambios [#cambios]

* Revocar la propia clave y [eliminar un webhook](/docs/referencia/webhooks/administrar-por-api#eliminar) ya no responden `403 plan-operation-not-allowed` cuando el plan dejó de incluir la API de integración.

***

## 2026-10-27 [#2026-10-27]

### Nuevo [#nuevo-2]

* El contribuyente elige [cuándo se envía el documento por correo al receptor](/docs/guias/descargar-kude#cuándo-envía-sifende-el-correo-al-receptor) desde **Editar contribuyente → Configuración**: al emitir (por defecto), cuando la SIFEN lo aprueba, o nunca, para enviarlo desde tu propio sistema con el KuDE y el XML descargados por API. El `email` del receptor sigue siempre en el XML.

***

## 2026-10-24 [#2026-10-24]

### Cambios [#cambios-1]

* [SANDBOX](/docs/conceptos/ambientes#sandbox-de-sifende) ya no exige un certificado activo: si el contribuyente todavía no cargó el suyo, Sifende firma con uno de prueba. En SANDBOX, [`GET /api/v1/contribuyente`](/docs/referencia/contribuyente) devuelve `listoParaEmitir: true` sin certificado, con `certificadoConfigurado: false`. Los correos de documentos SANDBOX salen marcados como prueba.

***

## 2026-10-20 [#2026-10-20]

### Nuevo [#nuevo-3]

* [`POST /api/v1/documento-electronico`](/docs/referencia/documentos-electronicos/emitir) acepta `numeroDocumento`, `codigoSeguridad` y `numeroTimbrado` para sistemas que numeran por su cuenta, como un ERP. Un número repetido devuelve `409 document-number-in-use` con el `cdc` del documento existente; uno inutilizado, `409 document-number-voided`; un timbrado distinto, `422 timbrado-mismatch`. Un número cuyo documento fue rechazado devuelve `422 document-number-requires-voiding`: se inutiliza y se emite con otro número. Ver [Numeración desde tu sistema](/docs/conceptos/timbrado-numeracion#numeración-desde-tu-sistema).
* [`GET /api/v1/documento-electronico/{cdc}/xml`](/docs/referencia/documentos-electronicos/descargar-xml) descarga el XML firmado del documento, con el QR, usando la API key. Responde `404` si el documento no es del contribuyente y ambiente de la clave, y `409` si todavía no tiene XML.
* [Administrar webhooks por API](/docs/referencia/webhooks/administrar-por-api): `/api/v1/contribuyente/webhooks` permite listar, crear, consultar, actualizar y eliminar webhooks, rotar su secreto y consultar sus entregas con la API key, sin entrar al panel. El ambiente sale de la clave: una clave sólo ve los webhooks de su ambiente. El secreto `whsec_…` se devuelve únicamente al crear y al rotar. Crear y rotar rechazan `Idempotency-Key` con `400 idempotency-not-supported`.

***

## 2026-10-10 [#2026-10-10]

### Nuevo [#nuevo-4]

* [`GET /api/v1/contribuyente`](/docs/referencia/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`](/docs/referencia/contribuyente/plan-consumo) es la nueva ruta de la consulta de plan y consumo, con la misma respuesta.

### Deprecado [#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 [#2026-10-05]

### Comportamiento [#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](/docs/plataforma/planes).

***

## 2026-10-03 [#2026-10-03]

### Nuevo [#nuevo-5]

* [Autofactura Electrónica](/docs/referencia/modelos/autofactura) 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 [#2026-10-02]

### Nuevo [#nuevo-6]

* 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](/docs/conceptos/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](/docs/panel/documentos): Desarrollo, Producción y Sandbox.
* [Webhooks por ambiente](/docs/panel/webhooks), 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`](/docs/solucion-problemas/sandbox-operation-not-supported): respuesta 422 al intentar cancelar, inutilizar o nominar en SANDBOX.
* [Nota de Remisión Electrónica](/docs/referencia/modelos/nota-remision) disponible, con consulta de estado y KuDE.

### Documentación [#documentación]

* Se documentan las facturas a crédito en PYG por `PLAZO` o `CUOTA`.
* Se documenta la [personalización del correo](/docs/panel/personalizacion), con logo, nombre comercial, colores, datos de contacto y correo de prueba.

### Si ya usás webhooks [#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 [#2026-09-08]

### Nuevo [#nuevo-7]

* [`GET /api/v1/padron/{documento}`](/docs/referencia/padron) 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 [#2026-08-18]

### Nuevo [#nuevo-8]

* [`GET /api/v1/documento-electronico/plan-consumo`](/docs/referencia/contribuyente/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 [#comportamiento-1]

* 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 [#2026-08-13]

### Nuevo [#nuevo-9]

* 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 [#2026-08-10]

### Nuevo [#nuevo-10]

* `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 [#2026-04-15]

### Nuevo [#nuevo-11]

* 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]

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

***

## 2026-03-01 [#2026-03-01]

### Nuevo [#nuevo-12]

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

***
