YOM Docs
2026 Noviembre 16 → 2.1.0
- Sobrescrituras: los campos
startDate y endDate pasan a ser opcionales. Sin fechas, la sobrescritura queda vigente sin vencimiento. Se retira pricing.steps del ejemplo: los descuentos por volumen se configuran como Promociones.
- Segmentos: se corrige la descripción y el ejemplo de
commerceIds, una lista de identificadores que coinciden con el commerceId de cada comercio.
2026 Octubre 05 → 2.0.0
Se reorganiza la documentación. Las páginas que se retiraron dejan de estar disponibles; su contenido se encuentra en las nuevas secciones.
Nueva estructura
- Se crea Formas de integración, que reúne las dos formas de enviar datos a YOM:
- Integración por API: unifica las antiguas páginas API Programada, Requisitos técnicos, Endpoints a disponibilizar e Implementación.
- Integración por archivos: unifica las antiguas páginas Archivos (Carga de datos), Inteligencia, Operacional, Archivos a disponibilizar e Implementación, e incluye la estructura de carpetas, el nombre de archivo de cada entidad y el formato CSV.
- Se crea Entidades, con el modelo de datos de cada entidad. El modelo es el mismo para la integración por API y por archivos.
- Se retiran las páginas de entidades por archivo (Comercios, Productos, Transacciones, Vendedores, Categorías, Stock, entre otras), cuyo contenido ya estaba documentado en cada entidad.
Entidades
- Cada entidad indica, junto a su endpoint, el nombre del archivo con el que se integra por archivos (
<fecha>_<hora>_<entidad>.csv).
- Se agrega el endpoint
GET /api/promotion a Promociones.
Webhooks
- Creación de comercios pasa a YOM a clientes Webhooks y se reescribe según el contrato vigente: cuerpo
commerceRequest con las respuestas del formulario, estados approved, rejected, observations y pending, objeto commerceData para crear el comercio, tiempo máximo de respuesta de 70 segundos y sin reintentos automáticos. Se elimina la consulta periódica de estado por GET.
Navegación
- El menú lateral se muestra desplegado en todas las páginas.
- Todas las páginas incluyen los accesos Pasos anteriores y Siguientes pasos, en el orden del menú.
- Se ajusta el ancho de las columnas para dar más espacio al contenido.
2024 Diciembre 19 → 1.4.1
Se actualiza entidad Categoría.
Se reemplazan los campos categoryKey y parentCategoryKey por categoryId y parentCategoryId para seguir con la convención de las otras entidades → Categorías
2024 Diciembre 18 → 1.4.0
Se actualiza inyección de datos via Webhooks. Se agrega inyección de Ordenes y Pagos. → Webhooks
2024 Diciembre 13 → 1.3.0
Se actualiza entidad Comercio.
- Se añade el campo
locations que permite listar las ubicaciones físicas del Comercio → Comercios. Este reemplaza al campo location.
- Vendedores,Supervisores
- Se depreca el uso de los campos
administrativeLevel y logisticalLevel.
Se actualiza entidad Producto.
- Se depreca el uso de
measurement y packaging. Se reemplaza por el uso de formats y constraints → Productos
Se actualiza entidad Sobreescritura.
- Se añade la capacidad de sobreescribir el campo
constraints de un Producto a través de una Sobreescritura.
2024 Diciembre 12 → 1.2.0
- Se actualiza entidad Promociones. Se añade explicación de sus tipos, objetivos y la lógica de las Reglas de Promociones → Promociones
2024 Diciembre 06 → 1.1.0
- Se actualiza entidad Pagos para soportar múltiples documentos, detalles y registro de transacciones externas → Pagos
2024 Diciembre 05 → 1.0.5
- Se añade filtro sobre el campo
date como requerido en integración vía API Programada de Transactions.
2024 Noviembre 27 → 1.0.4
- Se corrigen ejemplos para la entidad Product. ****Incluyen el cambio del uso de
sku por productId de la versión 1.0.2.
2024 Septiembre 24 → 1.0.3
2024 Julio 19 → 1.0.2
- Se define el campo
location de Comercio.
- Se definen los campos
dimensions, measurement, packaging y formats de Producto como opciones para el manejo de formatos de venta.
- Se reemplaza el uso de
sku por productId en Producto. Se sugiere el uso de SKU como identificador único del Producto pero es posible manejar un identificador distinto a este.
2024 Julio 03 → 1.0.1
- Se unifican las referencias a Comercios a lo largo de todas las entidades. ****Se reemplaza el uso de las palabras user y client en todas sus versiones por commerce. Esto considera los campos:
2024 Julio 01 → 1.0.0