Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-10-04

Notas de versión y cambios

Cómo ingestia.io versiona releases, comunica cambios que rompen compatibilidad, migra formatos versionados y descontinúa recursos — y el estado actual de esta práctica.

En esta página (10)

Cómo ingestia.io identifica versiones, comunica cambios y preserva la compatibilidad — para que puedas planificar integraciones con seguridad.

Qué cambió para quien usa

Los cambios de pantalla y de comportamiento, en portugués de quien usa, están en Novidades.

Formato de la versión#

Cada build carga una versión determinística por commit, en el formato v1.<día-del-año>.<commits-del-día>, con el hash del commit y la hora del build. Ejemplo (sintético): v1.251.2 · commit 4a4ec2f · 2026-09-08T11:29:31Z.

  • La versión es auto-generada en el build (no se edita a mano).
  • Sirve para rastrear qué build está en producción y correlacionar con el soporte.
  • No es un número de release comercial: identifica el build, no un paquete a la venta.

Fuente de la verdad del estado#

El estado de cada recurso (disponible, acceso limitado, planificado) cambia junto con el código: cambio de estado = cambio de doc en el mismo release — la doc nunca "adelanta" un estado que el código no sostiene.

Sigue el estado consolidado en Estado y disponibilidad.

Compatibilidad y formatos versionados (N−1)#

Formatos que viajan entre versiones — widgets, filtros, tema, estado de URL y token de embed — usan envoltorios con versión y un decoder N−1 obligatorio:

  • Un lector más nuevo siempre puede leer el formato de la versión anterior.
  • Un campo desconocido nunca se descarta silenciosamente en la lectura.
  • Al subir una versión de formato, el decoder anterior se mantiene.

Esto significa que links compartidos, dashboards guardados y tokens de embed siguen válidos a través de actualizaciones.

Cambios que rompen compatibilidad (breaking changes)#

Cuando un cambio pueda afectar integraciones, la política es:

  • Preferir aditivo: nuevos campos/opciones en lugar de eliminar/renombrar.
  • Señalar el estado: la página del recurso cambia junto (ej.: pasa a decir "planificado" si algo se aplaza).
  • Comunicar antes: los cambios que afectan integraciones (API/OData, embed, SSO/SCIM) se avisan en Novedades y por soporte.
  • Esquema de base es aditivo: los cambios de esquema son aditivos y versionados (migrations), sin romper lecturas existentes.

Migraciones#

  • Formatos de contenido (widget/filtro/tema/URL/embed): migración automática en la lectura vía decoder N−1 — no necesitas reescribir nada.
  • Esquema de metadatos (base de control): migrations versionadas aplicadas por la plataforma; nada de acción manual del cliente.
  • Datos de negocio (datalake): gobernado por el cliente (controlador) — ver Governança e LGPD.

Descontinuación (deprecación)#

  • Recursos descontinuados reciben el badge Descontinuado en la doc; evita depender de ellos.
  • Recursos aún no construidos quedan como Roadmap (ej.: CDC verdadero, webhooks públicos, API de escritura, clave de API por miembro) — ver Estado y disponibilidad.

Cambios de estado ya publicados#

Cambio de estado es cambio de documentación en el mismo release. Lo que cambió hasta aquí:

QuéAntesAhoraPor qué
Amazon S3 y Google Cloud Storage como fuenteRoadmapAcesso limitadopasaron a tener lectura real (listado y descarga del bucket del cliente); la liberación general depende de validación con un bucket real
Bling, Conta Azul y HubSpotregistro rechazadoAcesso limitadola renovación automática del acceso pasó a ser gestionada por la plataforma; la denegación dejó de existir
Azure Blob Storageregistro rechazadoAcesso limitadola lectura del container entró en el mismo flujo de fuentes que las demás
Catálogo de conectores21110, en 14 categoríasERPs, tiendas, medios de pago, CRMs, marketing, productividad, datos públicos, warehouses, carpetas remotas, APIs genéricas y bases compatibles

Todo conector nuevo entró en Acesso limitado, nunca como disponible: la especificación de cada uno fue escrita a partir de la documentación pública de la API, sin credencial real. La promoción a disponible es decisión humana, un conector a la vez, después de validación con cuenta real y 30 días de ejecución acompañada. La lista completa, con el estado de cada uno, está en Conectores.

TOTVS Protheus, Senior y PagBank entraron como Planejado: su API no es pública/estable o no lista registros, así que no hay conector — y decir eso vale más que ofrecer uno que fallaría en la primera llamada.

Cómo saber "qué cambió para mí"#

  1. Revisa en Novidades lo que cambió en el producto.
  2. Consulta Estado y disponibilidad para el panorama general.
  3. Para integraciones, monitorea el comportamiento de las rutas /api/v1 (el formato de error y los límites están en Erros e limites).

Límites de esta página#

  • El historial publicado es el de Novedades: cambios que el cliente percibe, no cada build.

Relacionados#


Última revisión: 2026-09-08. Versión determinística por commit; compatibilidad N−1 de los formatos versionados.

Enlaces relacionados