Cargando datos...
Cargando datos...
Cargando...
Cargando...
Cargando...
Cargando...
ℹ️ La sugerencia automática se calcula con 45 días de cobertura objetivo. Los valores en la columna "Enviar" son editables — tu edición pisa el cálculo automático y se mantiene mientras no recargues la página.
Cargando...
COLS:
?
?
?
?
?
Cargando datos de performance...
🔐
Conecta tu cuenta de vendedor
Necesitas un Access Token de ML para ver tus ventas reales, stock, publicidad y reputación.
1
Crea app en ML Developers
2
Obtén tu Access Token
3
Pégalo aquí y listo
Credenciales
Access Token ML
User ID de ML
Refresh Token ML — permite renovación automática cada 6h
🔒 El token se guarda cifrado en el servidor. Nunca se expone al navegador directamente.
📌 La búsqueda pública de mercado funciona sin token. Para datos privados (ventas, stock, ads) necesitas el Access Token.
📌 La búsqueda pública de mercado funciona sin token. Para datos privados (ventas, stock, ads) necesitas el Access Token.
v3.0
Consolidación: cleanup de paneles y guía contextual
Mayo 2026 · versión actual
NUEVO
Panel Finanzas
Resultado financiero del período en formato waterfall: Ventas concretadas → menos comisión ML (sale_fee real por orden) → menos costo de envío real (solo Full, neto del descuento por reputación) → menos publicidad y otros cargos (input manual) → menos impuestos 1% → Recibiste (neto seller) → menos COGS (cruzado por SKU contra Fulfy) → Utilidad neta con margen %. Selector de fechas independiente desde/hasta (default últimos 30 días). 4 summary cards: Ventas / Cargos ML / Recibiste / Margen neto. Aviso amarillo cuando hay SKUs vendidos sin match en el catálogo Fulfy (COGS parcial).
NUEVO
Costo de envío real desde /shipments/{id}/costs
Nuevo endpoint /api/ml/shipping-costs en el server que cruza órdenes pagadas del rango con la API de shipments de ML. Por cada envío fetcha /shipments/{id} + /shipments/{id}/costs en paralelo (batches de 15), filtra por status_history.date_shipped dentro del rango y agrega por logistic_type: Full, Flex y Drop-off. La descripción de la fila "Costo de envío" del panel Finanzas suma solo Full (coincide con "Envío a mi cargo" del reporte ML) y muestra el descuento por reputación aplicado. Ventana de órdenes ampliada 14 días hacia atrás para capturar envíos que despacharon tarde.
MEJORA
Performance: tour guiado y tooltips contextuales
Botón "● Tour" en el topbar abre un overlay de 6 pasos que explica el panel completo: bienvenida, selección de período, búsqueda, KPIs superiores, columnas configurables y exportación. Cada toggle de columna (Stock, Histórico, Ventas, Precios) tiene un ícono ? que muestra al hover un tooltip con título, descripción detallada y un tip extra. Implementado con delegación de eventos sobre document — un solo listener para todos los íconos.
MEJORA
Rentabilidad: COGS desde Fulfy como única fuente
Se retiró el input editable de COGS manual y los indicadores F/M/? por fila. El costo ahora viene exclusivamente del catálogo Fulfy vía SKU. Cuando una publicación no tiene match en Fulfy, la celda muestra el mensaje "Sin costo Fulfy" en rojo en lugar de un input vacío. Las llamadas a /api/cogs se eliminaron de Dashboard, Rentabilidad, Performance y Finanzas — un solo punto de verdad para el costo de producto.
QUITADO
Panel Mis Productos retirado del sidebar
El nav-item de "Mis Productos" ahora está oculto. El panel y su lógica de CRUD se mantienen en el código pero ya no son alcanzables desde la UI. La razón: el flujo de COGS manual que justificaba el panel fue reemplazado por la integración Fulfy (ver entry de Rentabilidad arriba). El endpoint /api/cogs en el server.js sigue intacto.
QUITADO
Panel Métricas eliminado
Se quitó el panel "Métricas" que analizaba un producto individual en el tiempo (visitas/ventas con período comparado, gráfico Chart.js, KPIs con delta). El nav-item, el panel HTML, las funciones loadMetricas, initMetricasProducts, filterMetricasProducts, selectMetricasProduct, getMetricasFilter, onMetricasFilterChange, el wrapper window.nav específico y el loader ensureChartJS se removieron por completo. La funcionalidad estaba poco usada y duplicaba info disponible en Rentabilidad y Performance.
v2.0
Nuevos paneles + integración Fulfy
Abril 2026
NUEVO
Panel Métricas
Análisis de producto individual en el tiempo. Buscador por nombre o SKU, selector de período (7/15/30 días o fechas custom), gráfico de líneas con visitas y ventas diarias del período actual superpuesto con el período anterior en línea punteada. KPIs con delta ▲▼ comparando ambos períodos: revenue, unidades, margen, conversión, ACOS y ROAS. Tabla diaria con visitas, unidades, revenue y conversión.
NUEVO
Panel Performance (Catálogo de productos)
Vista completa del catálogo cruzando Mercado Libre con Fulfy. Columnas: Bogotá (stock Fulfy), Full ML real, Rotar (unidades con not_available en Full), Total, Total ventas históricas, Visitas, Ventas del período + delta vs período anterior, Revenue + delta, Conversión + delta, Precio mínimo calculado y Precio real de ML. Desglose expandible por publicación incluyendo items con una sola publicación. Ordenamiento por cualquier columna. Buscador por nombre, SKU o MCO. Comparación de períodos con valor anterior visible debajo del actual.
NUEVO
Integración Fulfy Stock API
Conexión completa con app.backend.fulfy.co para obtener stock bodega, costo de productos y nombre comercial por SKU. Paginación automática con guard de 50 iteraciones. Manejo de redirects 301 en el proxy del servidor. El stock bodega en Inventario se sincroniza desde Fulfy en lugar de ingreso manual.
MEJORA
COGS desde Fulfy en panel Rentabilidad
El costo de cada producto se obtiene automáticamente desde la API de Fulfy como fuente primaria. El input manual sigue activo como fallback editable. Indicador visual por fila: F (fuente Fulfy, borde cyan), M (manual, borde normal), ? (sin costo, borde rojo). Al editar el input se persiste en db.json y recalcula sin recargar.
MEJORA
Stock Full ML real via API de inventarios
Inventario consulta /inventories/{id}/stock/fulfillment por cada variación para obtener el stock físico real en depósitos Full ML. La versión original usaba available_quantity que mezcla Full y no-Full. Items Full sin variaciones se marcan con ~ en ámbar indicando stock estimado no verificable por API.
MEJORA
Inventario desglosado en 4 columnas
Stock Full ML / Stock Disponible ML / Stock Bodega / Total reemplaza la columna única anterior. Nuevo filtro KPI "Reabastecer Full ML" para items con stock Full menor a 15 días de cobertura. Ordenamiento por columna con click en encabezado. Fila completa clickeable para abrir la publicación en ML.
MEJORA
SKUs en todos los paneles
extractMLSku() busca el SKU en cascada: seller_sku → attributes[SELLER_SKU] → seller_custom_field → variaciones. SKU visible en Publicaciones, Inventario, Rentabilidad y Performance. PATCH masivo aplicado sobre 79 variaciones en ML para cargar seller_custom_field donde faltaba.
MEJORA
Paginación completa de publicaciones
Publicaciones e Inventario traen todos los items activos paginando de a 100. La versión original tenía límite fijo de 100 — con 154 publicaciones activas se perdían 54. Contador "X de Y productos" confirma que se cargaron todos.
MEJORA
Links de publicaciones con URL real
Órdenes, Publicaciones, Inventario y Rentabilidad usan el permalink completo de ML con slug del título. La versión original generaba URLs incompletas tipo /MCO2729149814 en lugar de /MCO-2729149814-morral-tula-impermeable-...
FIX
Panel Órdenes no cargaba con token válido
Variable itemId usada antes de ser declarada en el .map() de loadOrdenes(). El ReferenceError era capturado por el catch que ejecutaba showConnectPrompt(), aparentando un problema de token cuando era un bug de JS.
FIX
Panel Publicaciones pedía conectar ML con token activo
El subtítulo del panel no tenía id="pub-sub". La referencia nula disparaba showConnectPrompt() desde el catch de loadPublicaciones().
FIX
Catches ML diferenciados en todos los paneles
Dashboard, Órdenes, Publicaciones, Stock, Rentabilidad y Reputación distinguen errores de token vs errores de JavaScript. Los errores JS muestran el mensaje real con botón Reintentar en lugar del prompt de conexión genérico.
v1.0
Versión Original — fulfyecom_v16
Base de partida · Abril 2026
Dashboard de archivo único (index.html + server.js) con 10 paneles: Dashboard, Rentabilidad, Órdenes, Publicaciones, Inventario, Mis Productos, Costos Fijos, IA Asistente, Conectar ML y Usuarios. Conectado a Mercado Libre Colombia via API oficial con auto-refresh de token cada 5 horas. Stock mostraba available_quantity sin distinguir Full ML de stock propio. Sin conexión a Fulfy. COGS 100% manual en db.json. Límite de 100 publicaciones por panel. Links de items sin slug. Catch genérico en todos los paneles ML mostraba siempre el prompt de conexión ante cualquier error.
Dashboard
Rentabilidad
Órdenes
Publicaciones
Inventario
Mis Productos
Costos Fijos
IA Asistente
Conectar ML
Usuarios
Concentración de Ventas
Análisis 80/20 por producto · ML Colombia
Cargando análisis...