Sifende
Referencia API

Versionado

Política de versionado de la API de Sifende — versiones, breaking changes y deprecaciones.

Actualizado el

Versión actual

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

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.

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

Ruta deprecadaReemplazoDeprecadaRemoción
GET /api/v1/documento-electronico/plan-consumoGET /api/v1/contribuyente/plan-consumo2026-10-102027-01-15

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.

En esta página

Usamos cookies necesarias para que el sitio funcione. Con tu permiso, también usamos herramientas de analítica para entender cómo se usa el sitio y para medir nuestras campañas publicitarias. Política de privacidad