Gestionar Catálogo CM
Panel para que proveedores adjudicados en convenios marco monitoreen su catálogo de productos, su cobertura frente al total del convenio y su posición competitiva.
Descripción
"Gestionar Catálogo CM" permite a las empresas adjudicadas en convenios marco ver, por cada convenio, qué tan completo está su catálogo respecto del total del convenio, qué productos les faltan, cómo se comparan sus precios con la competencia y cuál es su ranking de mercado.
🔒 Visibilidad condicionada: el módulo aparece en el menú solo si la empresa tiene convenios marco adjudicados (propiedad
convenios_marcocon elementos encompanies/{companyId}). Si el arreglo está vacío o no existe, el módulo se oculta automáticamente.
Si se accede sin convenios configurados, se muestra el aviso: "Tu empresa no tiene convenios marco adjudicados. Configúralos en Configuración de Empresa" (con enlace a Mi empresa).
Características Principales
🗂️ Tarjetas por convenio marco
La pantalla principal muestra una tarjeta por cada convenio marco adjudicado. Cada tarjeta tiene el nombre del convenio, su ID y un set de KPIs que cargan de forma asíncrona (con spinner):
| KPI | Descripción |
|---|---|
| Familias | Familias de productos nuestras / total del convenio, con % de cobertura. |
| SKUs | SKUs nuestros / total del convenio, con % de cobertura. |
| Marcas | Número de marcas que ofrecemos en el convenio. |
Cada tarjeta termina con el enlace "Ver dashboard →" que abre el detalle del convenio. Si un convenio aún no tiene datos disponibles, la tarjeta muestra "Aún no hay datos de catálogo disponibles".
🔄 Refrescar
Un botón "Refrescar" (icono de actualización) en la cabecera invalida la caché en memoria y vuelve a pedir los KPIs de todos los convenios a BigQuery.
📈 Detalle del convenio (dashboard)
Al hacer click en una tarjeta se abre /cm-catalogs/:convenioId, con su propio botón "Refrescar" y un bloque superior de KPIs ampliados:
- Familias de productos (nuestras / total) + % cobertura.
- SKUs específicos (nuestros / total) + % cobertura.
- Marcas.
- Regiones.
Si la empresa tiene OCs en ese convenio, se muestra además la tarjeta "Tu posición en el mercado" (últimos 12 meses): ranking #X de Y proveedores, número de clientes y líder del mercado (nombre + monto). Si aún no hay OCs, se indica con un aviso informativo.
El dashboard se organiza en tres pestañas:
- Mis productos — catálogo propio en el convenio. Filtros por Región, Familia y búsqueda libre ("Nombre, SKU, marca…"). Tabla con SKU (enlace al detalle del producto), Nombre, Marca, Modelo, Familia, Precio CM, Precio Costo (editable en línea, se guarda por empresa), Margen $ y Margen % (con color según signo). Paginada de a 50 registros.
- Productos faltantes — SKUs del convenio que no están en nuestro catálogo, con filtro de búsqueda y columnas SKU, Nombre, Familia, OCs mercado y Proveedores (ambas ordenables). Si no faltan productos: "¡Tienes todos los productos del convenio en tu catálogo!".
- Alertas — alertas de precio (sobreprecio / líder). Filtros por Región, Tipo de alerta (Todas las alertas / Solo sobreprecio / Solo líderes de precio) y búsqueda. Columnas con mi precio vs. promedio vs. mínimo del mercado, competidores, diferencia y un badge "Caro" o "Líder".
🛒 Detalle de producto
Desde el SKU (en "Mis productos") o desde una alerta se llega a /cm-catalogs/:convenioId/products/:productId, que lista los proveedores que venden ese producto en el convenio (proveedor + RUT, precio, regiones, OCs y monto), resaltando a la propia empresa. Permite buscar por proveedor, RUT o marca y abrir cada proveedor en Mercado Público.
Casos de Uso
- Gerente de producto: detecta familias y SKUs del convenio que no están en su catálogo para ampliar oferta.
- Ejecutivo de pricing: usa las alertas para corregir precios fuera de rango y carga el precio de costo para conocer su margen real por SKU.
- Dirección comercial: revisa el ranking de mercado del convenio para medir su competitividad.
Integraciones
- BigQuery (vía Cloud Functions, con caché en memoria) — resumen del catálogo, ranking de proveedores, productos faltantes, alertas de precio, "mis productos" y detalle de producto. Ventana de 12 meses para el ranking.
- Firebase Firestore — convenios marco adjudicados (
companies/{companyId}.convenios_marco), listado maestro de convenios (general-config) y costos propios por SKU (companies/{companyId}/cm-product-costs/{productId}).