Amauta ML Sync

📊 ¿Cuántos productos publicar por día?

ML observa cómo se comporta tu cuenta antes de mostrarla con fuerza. Subir todo el catálogo el día 1 puede traer pausas, validaciones manuales o pérdida de visibilidad.

Antigüedad / estado	Cantidad por día	Por qué
Cuenta nueva (día 1–3)	10–30	Warm-up. ML observa cómo respondés a preguntas y entregás.
1–2 semanas	30–80 / día	Si no tuviste reclamos, ML te empieza a rankear mejor.
1–3 meses sin problemas	100–300 / día	Cuenta "establecida": podés cargar lotes grandes.
Vendedor con reputación verde	Sin límite práctico	Subí lo que quieras. Igualmente respeta el rate limit ML (~10 calls/seg).

🥇 Reglas de oro

Calidad > cantidad. 20 publicaciones bien armadas con fotos buenas, atributos completos y descripción clara > 200 publicaciones flojas. ML rankea por calidad y conversión.
Empezá por los productos con más stock. Si pegás venta y te quedás sin stock al toque, perdés reputación.
Mantené un buffer de stock ≥ 2. Te da margen para que la sincronización entre TN y ML no sobrevenda.
Ofrecé Mercado Envíos Flex o Full apenas puedas. ML rankea muchísimo mejor a los que ofrecen envío gratis.
Atributos completos. Marca, Modelo, Material son claves para que aparezcas en búsquedas filtradas.
Respondé preguntas en menos de 1h en horario comercial. Es uno de los KPIs ocultos más fuertes.
No publiques productos sin stock real. Si TN dice 0, no fuerces 1 en ML "para que aparezca". ML penaliza la cancelación de ventas.

🔄 Cómo funciona la sincronización de stock

Vendés en Tiendanube

TN dispara webhook order/paid a la app
App descuenta stock local
App calcula nuevo stock con buffer
App hace PUT /items/{id} en ML

≈ 5–30 segundos de latencia

Vendés en MercadoLibre

ML dispara webhook topic orders_v2
App busca el SKU vendido
App llama a la API de TN para bajar stock
App actualiza stock local

≈ 5–30 segundos de latencia

Importante: el stock ML siempre va a estar buffer unidades por debajo del stock real de TN. Es a propósito, es tu colchón anti-sobreventa. Si querés que coincidan exactamente, poné buffer=0 en Configuración (riesgoso).

💸 Precio normal vs precio promocional

Tiendanube guarda dos precios por producto: el "precio" (lista) y el "precio promocional" (oferta). En la grilla de productos ahora se ven los dos cuando aplica.

• Default global: configurable en .env con USE_PROMOTIONAL_PRICE_DEFAULT=true|false.
• Per producto: seleccionás productos en la grilla y elegís "Usar promo" o "Sin promo".
• Caso Amauta: el precio promocional es el precio mayorista real → conviene USE_PROMOTIONAL_PRICE_DEFAULT=true.
• Caso retail típico: querés publicar al precio de lista, no al de oferta → USE_PROMOTIONAL_PRICE_DEFAULT=false (default).

🎯 Si vendés otro rubro (ropa, perfumes, calzado…)

La app funciona con cualquier rubro. Cuando elegís categoría ML, la app pide los atributos REALES de esa categoría a la API de ML y los muestra en el wizard. Lo que no tenés todavía es el autocompletado smart: hoy las heurísticas son de joyería (plata 925, oro, etc.).

Para otros rubros tenés que llenar los atributos a mano la primera vez. En fase 2 vamos a sumar diccionarios de keywords para ropa, calzado y perfumes.

🛠️ Problemas comunes

Mi publicación quedó "Inactiva — verificando foto": Normal. ML procesa fotos en 5 min – 2h. Se activa sola.
Mi publicación quedó "Inactiva — sin stock": Tu stock real ≤ buffer (default 2). Bajá buffer o cargá más stock.
"User has not mode me1": Tu cuenta ML no tiene Mercado Envíos Flex activo. Activalo en envios.mercadolibre.com.ar.
"Marca / Modelo es obligatorio": La app ya inyecta BRAND="Amauta" y MODEL=<sku> automático. Si igual aparece, agregalo en el wizard.
"ML API 401: invalid access token": Token de ML venció. La app lo renueva sola; si igual pasa, andá a /oauth/mercadolibre/install.