# Versionado (/docs/referencia/versionado)



## Versión actual [#versión-actual]

**v1** — todos los endpoints usan el prefijo `/api/v1/`.

## Política de breaking changes [#política-de-breaking-changes]

Un cambio **no** es breaking si:

* Se agregan nuevos campos opcionales a la solicitud o respuesta
* Se agregan nuevos endpoints
* Se agregan nuevos valores a enumeraciones existentes

Un cambio **es** breaking si:

* Se eliminan o renombran campos existentes
* Se cambia el tipo de un campo
* Se cambia el comportamiento observable de un endpoint
* Se remueve un endpoint

Los breaking changes se anuncian con al menos **30 días de anticipación** vía email y en el [Changelog](/docs/referencia/changelog).

## Deprecación [#deprecación]

Cuando un endpoint se depreca:

* Se documenta con una nota de deprecación en esta documentación
* Se retorna el header `Sunset` con la fecha de remoción planeada
* Se retorna el header `Deprecation` con la fecha en que fue deprecado

## Deprecaciones vigentes [#deprecaciones-vigentes]

| Ruta deprecada                                   | Reemplazo                                                                               | Deprecada  | Remoción   |
| ------------------------------------------------ | --------------------------------------------------------------------------------------- | ---------- | ---------- |
| `GET /api/v1/documento-electronico/plan-consumo` | [`GET /api/v1/contribuyente/plan-consumo`](/docs/referencia/contribuyente/plan-consumo) | 2026-10-10 | 2027-01-15 |

## Versiones futuras [#versiones-futuras]

Cuando se lance v2, los endpoints v1 seguirán funcionando durante el período de migración. La documentación de v1 permanecerá disponible con un banner de deprecación.
