YOM Docs

• Guías de integración
  • Formas de integración
    • Integración por API
    • Integración por archivos
  • Entidades
    • Categorías
    • Centro de Distribución
    • Comercios
    • Comodatos
    • Costo de despacho
    • Crédito
    • Documentos Tributarios
    • Límite de descuento
    • Pagos
    • Productos
    • Promociones
    • Segmentos
    • Sobrescrituras
    • Stock
    • Supervisores
    • Transacciones
    • Vendedores
  • Webhooks
    • Requisitos técnicos
    • Clientes a YOM Webhooks
      • Modificación de órdenes
      • Carga masiva de stock
      • Modificación masiva de órdenes
    • YOM a clientes Webhooks
      • Ordenes
      • Pagos
      • Pedido mínimo
      • Precio de despacho
      • Devoluciones
      • Comodatos
      • Creación de comercios
  • Changelog
  • API de Extracción de Recomendaciones
    • Autenticación
    • Recomendaciones
    • Buenas prácticas
• Configuraciones

Buenas prácticas

A continuación se listan las buenas prácticas recomendadas para el consumo eficiente y seguro de la API de Recomendaciones de YOM.

🔄 Consumo

• Reutilice el token durante su ventana de validez; no solicite uno nuevo por cada request.
• Paginación: recorra las páginas usando page hasta que hasNext sea false. En el endpoint por comercio puede subir limit hasta 100; el endpoint de dominio devuelve 500 por página.
• Cargas incrementales: ordene por -updatedAt y filtre en su lado por fecha para traer solo lo nuevo.
• Reintentos: ante 429 y 5xx, reintente con espera exponencial.

🔒 Seguridad

• Guarde el client_secret en un gestor de secretos.
• No almacene el client_secret en repositorios, logs, tickets ni scripts compartidos.
• Mantenga credenciales separadas por ambiente (Staging y Producción).
• Rote las credenciales ante cualquier sospecha de exposición, contactando a YOM.

🆘 Soporte

Ante cualquier duda de integración, problemas de acceso o coordinación del pase a Producción, contacte a su equipo de contraparte en YOM.

📝 Control de cambios

Pasos anteriores

<aside> <img src="/icons/arrow-left_gray.svg" alt="/icons/arrow-left_gray.svg" width="40px" />

Recomendaciones

</aside>

Siguientes pasos

<aside> <img src="/icons/arrow-right_gray.svg" alt="/icons/arrow-right_gray.svg" width="40px" />

Configuraciones

</aside>