Documentación · Conceptos · API v1 · versión 2026-10-22
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.
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).
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.
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).