Gestión de cambios en la API y productos

Cobre evoluciona continuamente sus APIs y productos. Cuando algo cambia, Cobre notifica con anticipación a los clientes afectados para que los equipos de integración puedan planificar actualizaciones sin sorpresas. Esta guía explica cómo funciona ese proceso: cómo se clasifican los cambios, cuánto aviso recibe cada tipo, qué contiene cada notificación, dónde se entrega y qué debe hacer su equipo cuando llega una.

Esta guía trata sobre cómo se comunican los cambios y cómo responder a ellos — no introduce un endpoint u objeto nuevo. Úsela para planificar el lado operativo de mantener una integración con Cobre a lo largo del tiempo.

Cómo se clasifican los cambios

No todos los cambios afectan una integración por igual, por lo que el aviso anticipado depende del alcance del cambio.

Tipo de cambio	Qué es	Aviso anticipado
Cambio menor	Nuevos campos o información adicional en una respuesta o webhook que no afecta las integraciones existentes. No se requiere acción para seguir operando con normalidad.	1 a 2 semanas
Cambio simple	Ajustes menores que pueden requerir una actualización de código menor, sin rediseñar la integración.	30 días
Cambio medio	Modificaciones que requieren trabajo moderado de integración, como cambios en la lógica de proceso o en cómo se consume un endpoint.	90 días
Cambio mayor	Migraciones, deprecaciones o cambios incompatibles que requieren rediseñar parte de la integración antes de una fecha de cierre.	180 días

El aviso anticipado se cuenta desde la primera notificación hasta la fecha en que el cambio entra en vigor — o, en migraciones, hasta la fecha de cierre de la versión anterior.

El periodo de aviso se mide desde la primera comunicación, no desde recordatorios posteriores. Planifique su trabajo con la fecha original para evitar actuar cerca de una fecha de cierre.

Términos clave

Aviso anticipado: El tiempo entre la primera notificación y la fecha en que un cambio entra en vigor (o la fecha de cierre en migraciones).

Fecha de cierre: En migraciones y deprecaciones, la fecha después de la cual deja de funcionar la versión o el comportamiento anterior.

Cambio incompatible: Un cambio que requiere rediseñar parte de una integración para seguir operando. Siempre se comunica como cambio mayor.

Contacto operativo / Contacto técnico: Los contactos registrados del cliente que reciben avisos de cambios para que ambos equipos coordinen la implementación.

KAM (Key Account Manager): Su contacto asignado en Cobre, disponible para apoyar la implementación y responder preguntas.

Qué contiene cada notificación

Independientemente del tipo de cambio, cada aviso que envía Cobre deja explícito lo siguiente:

Qué está cambiando, con precisión técnica — el campo, endpoint, código o formato afectado exacto.

Cuándo aplica el cambio — la fecha de vigencia y la fecha de cierre cuando hay una migración.

Si el cambio aplica para usted y qué hacer, o una declaración clara de que no se requiere acción.

La documentación actualizada que explica el ajuste, para implementarlo sin ambigüedad.

Un contacto para cualquier pregunta.

Quién recibe una notificación

Los avisos se envían a todos los contactos operativos y técnicos registrados de los clientes afectados por el cambio. Enviar a ambos roles permite que los dos equipos coordinen la implementación directamente, sin depender de que la información se reenvíe internamente entre áreas.

Mantenga actualizados sus contactos operativos y técnicos registrados. Los avisos de cambios solo se entregan a los contactos registrados de su organización.

Canales de comunicación

Cada aviso se entrega por correo electrónico a los contactos técnicos y operativos registrados. Cuando el cambio lo requiere, la documentación técnica correspondiente en docs.cobre.com también se actualiza para reflejar el ajuste.

Cómo responder a una notificación

Cuando llega un aviso, siga estas acciones para confirmar el impacto e implementar los cambios requeridos de forma segura antes del plazo.

Confirmar si aplica

Descripción: Revise las condiciones del aviso — el endpoint, producto o flujo afectado — frente a lo que su integración utiliza realmente.

Qué esperar después de la acción: Una determinación clara de si el cambio le afecta y, de ser así, qué partes de su integración están en alcance.

Revisar la documentación actualizada

Descripción: Si el aviso enlaza a una sección en docs.cobre.com, revísela para obtener el detalle técnico necesario para implementar el ajuste.

Qué esperar después de la acción: Una comprensión precisa del nuevo campo, endpoint, código o formato y cómo adaptar su código.

Probar primero en QA

Descripción: Para cambios que puedan afectar su integración, valide el ajuste en el entorno de pruebas antes de desplegar a producción.

Qué esperar después de la acción: Confianza de que su integración actualizada se comporta correctamente frente al cambio antes de que llegue tráfico de producción.

Implementar antes del plazo

Descripción: Complete los ajustes requeridos antes de la fecha de vigencia o de cierre. El aviso anticipado está dimensionado para dar tiempo suficiente, pero actúe con margen.

Qué esperar después de la acción: Una integración migrada o actualizada que sigue operando sin interrupción después de que el cambio entre en vigor.

Contactar a su KAM

Descripción: Comuníquese con su Key Account Manager (KAM) ante cualquier duda. También está disponible el canal estándar de soporte de Cobre.

Qué esperar después de la acción: Apoyo de Cobre durante toda la implementación.

Qué puede esperar de Cobre

Visibilidad anticipada de cada cambio - Recibe aviso de cambios menores, simples, medios y mayores con un plazo proporcional a su impacto — de 1–2 semanas hasta 180 días.

Avisos precisos y accionables - Cada aviso indica exactamente qué cambia, cuándo aplica, si le afecta, qué hacer y dónde está la documentación actualizada.

Implementación coordinada - Al notificar tanto a contactos operativos como técnicos, sus equipos pueden coordinar la actualización directamente.

Migraciones acompañadas - Para cambios incompatibles y deprecaciones, dispone de una fecha de cierre definida y apoyo del KAM para migrar antes de que deje de funcionar la versión anterior.

Gestión de cambios en la API y productos

Cómo se clasifican los cambios#

Términos clave#

Qué contiene cada notificación#

Quién recibe una notificación#

Canales de comunicación#

Cómo responder a una notificación#

Qué puede esperar de Cobre#

Cómo se clasifican los cambios

Términos clave

Qué contiene cada notificación

Quién recibe una notificación

Canales de comunicación

Cómo responder a una notificación

Qué puede esperar de Cobre