¡Nuevo formato de ID!

Actualmente, nuestros endpoints devuelven los IDs como enteros, por ejemplo, id: 1. A partir del 6 de enero de 2025, se actualizará el formato del campo ID en las respuestas de la API, todos los IDs serán devueltos como cadenas de texto VARCHAR(36), es decir, id: "1".

Este cambio es un primer paso para futuras mejoras, donde comenzaremos a utilizar identificadores UUID para incrementar la robustez y seguridad de nuestros servicios.

¿A quienes va dirigido este cambio?

A usuarios que integren directamente sus aplicaciones a las respuestas de nuestra API. Si utilizas una de nuestras integraciones automaticas no debes preocuparte ya que los cambios serán transparentes para tí, estas integraciones son: Handy, Dnubo, Astroselling, Clientify, Payana, Cloudbeds by sHUB, Moship, SaludVitale, PTS PrestaShop, TRELI, Velocity go, Dentalink y Alegra sync woocommerce.

¿Cómo se realizará la transición a UUID?

En esta primera etapa la migración a UUID se hará sobre el mismo atributo id . Durante la transición:

• IDs actuales: Los IDs numéricos actuales se conservarán, pero serán representados como cadenas de texto en lugar de números.
• Nuevos registros: A partir del 6 de enero de 2025, los nuevos registros comenzarán a generarse con UUID, de manera gradual y por recurso.

Ejemplo:

• Producto 1 -> id: “1”.
• Producto 2 -> id: “2".
• Producto 3 -> id: “3”.
• [Posterior al 6 de enero de 2025, con UUID activado en el recurso]
• Producto 4 -> id: “75c1a5ad-4bd5-4675-b51b-8d6c70f1f2f9".

Tener en cuenta que la activación de UUID se realizará progresivamente por tipo de recurso (por ejemplo, facturas, contactos, o productos) y las fechas específicas de activación para cada recurso serán comunicadas tras el 6 de enero de 2025.

¿Qué necesitas hacer?
Realiza las siguientes acciones antes del 6 de enero 2025 para evitar cualquier interrupción en tu servicio:

• Revisa tu integración con nuestra API: asegúrate de que cualquier lógica en tu aplicación que dependa del campo ID sea flexible para manejar ambos formatos, es decir, IDs actuales como string númericos y nuevos registros como UUID.
• Realiza pruebas: te sugerimos realizar pruebas en un entorno seguro para confirmar que el cambio no afectará el funcionamiento de tus aplicaciones.

Esta migración no debería requerir cambios significativos en tu sistema si manejas los IDs como string desde ahora. Prepararte para esta transición garantizará que tu aplicación funcione correctamente, sin importar el formato del id recibido en cada recurso.

¿Por qué hacemos este cambio?
Estamos comprometidos en mejorar la eficiencia de nuestros servicios. La transición a UUIDs permitirá una mayor flexibilidad y robustez en la identificación de recursos dentro de la plataforma, lo que te beneficiará a ti y a todos nuestros usuarios a largo plazo.

Agradecemos tu comprensión y cooperación con este cambio. Sabemos que cualquier ajuste puede generar imprevistos, pero creemos que estos cambios son esenciales para ofrecerte un mejor servicio.

Si tienes alguna pregunta o necesitas asistencia para realizar estos ajustes, no dudes en contactarnos.