# Versiones

> Las versiones de la API de Trevol (2026-10-21 y 2026-10-22), cómo se elige la de una llave y qué cambia entre ellas.

Fuente: https://platform.trevol.si/docs/versiones

La versión de la API se elige con la cabecera `Trevol-Version`. Si no viene, vale la de la llave: las llaves anteriores quedaron en `2026-10-21` y las nuevas nacen en `2026-10-22`. **El encabezado manda sobre la versión de la llave.** Cada respuesta dice la versión usada en `Trevol-Version`, y `GET /v1/company` dice la de la llave (`key.api_version`).

## 2026-10-22

La versión de las llaves nuevas. Con la DIAN sin contestar responde el `202 processing`: Trevol termina el documento y te avisa por webhook.

## 2026-10-21

La versión de las llaves anteriores. Con la DIAN sin contestar responde el `503 dian_unavailable` de siempre. Para probar la nueva con una llave vieja, manda `Trevol-Version: 2026-10-22`.

## Qué no depende de la versión

El documento soporte, el documento equivalente, la nómina y los eventos RADIAN no traen versión nueva: valen las dos, con el mismo significado que en las facturas. Webhooks, eventos, el registro de peticiones y `delivery.status` valen para las dos versiones. Los cambios que no rompen nada (campos nuevos, `operationId`, ejemplos) no estrenan versión: están en el [registro de cambios](/docs/cambios).

> **Los SDK fijan la versión:** Cada SDK manda `Trevol-Version` en todas sus peticiones (la versión de su especificación, hoy `2026-10-22`). Una llave que estaba fijada en `2026-10-21` y empieza a usar un SDK pasa a `2026-10-22`: recibe un `202 processing` donde antes recibía un `503`. Si todavía no quieres cambiar, crea el cliente con `apiVersion: '2026-10-21'` (en cada lenguaje, la opción equivalente).