> ## Documentation Index
> Fetch the complete documentation index at: https://docs.folyo.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Historial de cambios de la API de Folyo por versión.

## v1.4.0 — 22 de abril de 2026

<Warning>
  **Breaking change:** El header `X-Sync` fue eliminado. La emisión de DTE es ahora siempre asíncrona. Si usabas `X-Sync: true`, migra a webhook o polling de `GET /v1/dte/emision/:jobId`.
</Warning>

| Tipo      | Descripción                                                                                                    | Endpoints               |
| --------- | -------------------------------------------------------------------------------------------------------------- | ----------------------- |
| Eliminado | Header `X-Sync` eliminado. POST responde `202` con `job_id`.                                                   | `POST /v1/dte/emitir`   |
| Agregado  | Campo `job_id` en el payload del evento `dte.emitido` (SSE y webhook).                                         | —                       |
| Agregado  | Endpoint SSE `GET /v1/events/stream` para notificaciones en tiempo real desde el dashboard.                    | `GET /v1/events/stream` |
| Cambiado  | POST responde `503 QUEUE_UNAVAILABLE` si Redis no está disponible. Antes caía silenciosamente a modo síncrono. | `POST /v1/dte/emitir`   |

## v1.3.0 — 9 de abril de 2026

| Tipo      | Descripción                                                      | Endpoints                                                      |
| --------- | ---------------------------------------------------------------- | -------------------------------------------------------------- |
| Agregado  | Descuentos por línea y globales en emisión DTE (`DscRcgGlobal`). | `POST /v1/dte/emitir`                                          |
| Agregado  | Descarga de XML firmado y PDF de documentos emitidos.            | `GET /v1/dte/xml/:tipo/:folio`, `GET /v1/dte/pdf/:tipo/:folio` |
| Agregado  | CI/CD con GitHub Actions y rotación automática de claves.        | —                                                              |
| Corregido | Vinculación NC usa `FolioRef` del XML cuando está disponible.    | `POST /v1/rcv/:periodo/sync`                                   |
| Cambiado  | Cifrado AES-256-GCM para XMLs y datos bancarios en PostgreSQL.   | —                                                              |

## v1.2.0 — 15 de marzo de 2026

| Tipo     | Descripción                                                               | Endpoints                                                                                              |
| -------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Agregado | Vinculaciones NC↔Factura en RCV con match automático.                     | `GET /v1/rcv/:periodo/vinculaciones`, `GET /v1/rcv/:periodo/nc-pendientes`, `POST /v1/rcv/vinculacion` |
| Agregado | Búsqueda y paginación en listado de documentos.                           | `GET /v1/documentos`                                                                                   |
| Cambiado | Mejora en el manejo de encoding XML (ISO-8859-1) para documentos del SII. | —                                                                                                      |

## v1.1.0 — 20 de febrero de 2026

| Tipo     | Descripción                                             | Endpoints                                                                |
| -------- | ------------------------------------------------------- | ------------------------------------------------------------------------ |
| Agregado | Sistema de invitaciones para usuarios del tenant.       | `POST /auth/invite/accept`, `POST /v1/usuarios/invitar`                  |
| Agregado | Webhooks para notificaciones de eventos en tiempo real. | `GET /v1/webhooks`, `POST /v1/webhooks`, `DELETE /v1/webhooks/:id`       |
| Agregado | Solicitud de folios directamente al SII desde la API.   | `POST /v1/dte/folios/solicitar`                                          |
| Agregado | Versionado de plantillas PDF con activación selectiva.  | `GET /v1/plantilla/versiones`, `PUT /v1/plantilla/versiones/:id/activar` |
| Agregado | Autocompletar datos de empresa desde el SII.            | `POST /v1/empresa/autocompletar`                                         |

## v1.0.0 — 15 de enero de 2026

Lanzamiento inicial de la API Folyo.

| Tipo     | Descripción                                                               | Endpoints                                                    |
| -------- | ------------------------------------------------------------------------- | ------------------------------------------------------------ |
| Agregado | Autenticación con JWT y API Keys.                                         | `POST /auth/login`, `POST /auth/register`, `GET /v1/apikeys` |
| Agregado | Emisión de DTEs (facturas, boletas, notas de crédito, guías de despacho). | `POST /v1/dte/emitir`                                        |
| Agregado | Registro de Compras y Ventas (RCV) con sincronización SII.                | `GET /v1/rcv/:periodo`, `POST /v1/rcv/:periodo/sync`         |
| Agregado | Gestión de empresas, folios, plantillas PDF y billing.                    | —                                                            |