Marko Manual de uso · Comercial

Paso a paso

Revisar tu catálogo y ranking en un convenio marco

Si tu empresa ya se adjudicó uno o más convenios marco, Gestionar Catálogo CM te muestra cuánto de ese convenio cubres, cómo se comparan tus precios con los de la competencia y en qué puesto quedas del ranking de proveedores. Es la pantalla para saber qué te falta cargar y dónde estás caro frente al mercado.

Qué vas a conseguir

Saber qué tan completo está tu catálogo frente al convenio, cuáles de tus precios están fuera de rango y en qué posición del ranking de proveedores quedas.

Para quién

Roles Administrador, Manager, Ejecutivo y Ejecutivo avanzado (nav.service.ts:157). Facturación, Finanzas y Bodega no tienen esta entrada en el menú.

Qué necesitas antes

Que tu empresa tenga al menos un convenio marco adjudicado (company.convenios_marco). Sin eso, la entrada de menú ni siquiera aparece.

Cuánto toma

Un par de minutos para revisar cobertura y ranking; más si vas a cargar precios de costo SKU por SKU.

Esta pantalla se esconde solaEl ítem Gestionar Catálogo CM del menú Comercial sólo aparece si company.convenios_marco tiene al menos un convenio (nav.service.ts:158, sidebar.component.ts:344-345). ALIMENTOS SPA, la empresa de estas capturas, tiene cuatro convenios adjudicados — por eso se ve. Si en tu empresa no aparece, no es un permiso que falte: es que todavía no tienen ningún convenio marco cargado.

Los pasos

  1. Abre Comercial en el menú lateral y entra en Gestionar Catálogo CM.

    Menú lateral con Comercial desplegado y la entrada Gestionar Catálogo CM resaltada
    Qué deberías verEl submenú de Comercial desplegado, con Gestionar Catálogo CM entre Análisis Mercado y Contactos De Adquisiciones.
  2. Revisa la lista Tus convenios adjudicados.

    Tarjetas de los convenios marco adjudicados por la empresa, con sus KPIs de cobertura
    Qué deberías verUna tarjeta por cada convenio marco de tu empresa, con tres números que cargan con un segundo de retraso (van a BigQuery): Familias de producto (las tuyas sobre el total del convenio), SKUs (ídem) y Marcas, más el % de cobertura de SKU al pie. Cada tarjeta termina en Ver dashboard.
    Si una tarjeta dice «Sin datos disponibles aún»La consulta a BigQuery para ese convenio falló (o no hay filas). No es que tu catálogo esté vacío: pulsa Refrescar arriba a la derecha — invalida la caché de 5 minutos y vuelve a pedir los KPIs de los cuatro convenios.
  3. Pulsa sobre la tarjeta del convenio que quieras revisar (toda la tarjeta es clicable, no sólo el enlace Ver dashboard).

    Dashboard del convenio con los KPIs ampliados y el bloque Tu posición en el mercado
    Qué deberías verArriba, los mismos KPIs ampliados a Familias de productos, SKUs específicos, Marcas y Regiones. Debajo, si tu empresa ya tiene OC de ese convenio, el bloque Tu posición en el mercado: tu ranking («#X de Y proveedores»), tus Clientes de los últimos 12 meses y el Líder del mercado. Si todavía no tienes OC del convenio, ese bloque se reemplaza por un aviso azul explicándolo.
    Los números de esta captura están alteradosEl ranking, el nombre del líder de mercado y — en todos los pasos siguientes — tus precios propios y los de terceros identificables están sustituidos por valores ficticios. Es tu posición competitiva real: no se puede mostrar tal cual en un manual público. El pie de página detalla exactamente qué se cambió.
  4. En la pestaña Mis productos (la que abre por defecto), revisa tu catálogo dentro del convenio.

    Tabla Mis productos con SKU, nombre, marca, familia, Precio CM, Precio Costo, Margen $ y Margen %
    Qué deberías verUna fila por SKU tuyo en el convenio, paginada de a 50: SKU (enlaza al detalle), Nombre, Marca, Modelo, Familia, Precio CM (el precio al que está tu producto en el convenio), Precio Costo (un campo editable) y Margen $ / Margen % calculados al vuelo. Mientras no cargues un precio de costo, las dos columnas de margen muestran un guion — no $0.
  5. Haz clic en el campo Precio Costo de una fila y escribe tu costo real.

    Campo Precio Costo editado en línea, con Margen $ y Margen % recalculados
    Qué deberías verMargen $ y Margen % se recalculan solos apenas escribes. El guardado es automático 800 ms después de tu última tecla — no hay botón Guardar — y confirma con un toast verde: «Precio costo actualizado». Es un dato privado de tu empresa (companies/{id}/cmProductCosts): nadie más lo ve.
    No hay forma de borrarlo, sólo de sobrescribirloSi dejas el campo vacío, la app no guarda nada (el código descarta explícitamente un valor que no sea un número válido, cm-catalog-detail.component.ts:673-676): el último costo que sí guardaste queda ahí. Para «borrar» un precio de costo hay que reemplazarlo por otro número, no se puede vaciar desde esta pantalla.
  6. Filtra por Región o por Familia arriba de la tabla, o escribe en Buscar (nombre, SKU o marca).

    Filtro de región aplicado sobre la tabla Mis productos, con el conteo de SKUs actualizado
    Qué deberías verLa tabla se recarga contra BigQuery y el contador de la esquina («N SKUs») cambia. El desplegable Familia sólo se llena con las familias que ya viste en pantalla — no trae de entrada el catálogo completo de familias del convenio.
  7. Cambia a la pestaña Productos faltantes.

    Tabla de productos faltantes: SKU, nombre, familia, OCs del mercado y proveedores
    Qué deberías verLos SKU que el convenio ofrece y tu catálogo no tiene, ordenados por OCs mercado (demanda real de ese SKU en los últimos 12 meses) — con cuántos Proveedores ya lo venden. Si filtras por región, aparece una aclaración: esos SKU faltan en esa región, pero las OCs contadas son del convenio completo. Si no te falta nada, el mensaje es «¡Tienes todos los productos del convenio en tu catálogo!».
  8. Cambia a la pestaña Alertas (el número en el badge es cuántas tienes).

    Tabla de alertas de precio: mi precio, promedio, mínimo, competidores, diferencia y badge Caro o Líder
    Qué deberías verUn SKU por fila con Mi precio contra el Promedio y el Mínimo del mercado, cuántos Competidores lo venden y la Diferencia porcentual. El badge dice Caro (rojo) si estás por sobre el promedio o Líder (verde) si eres tú quien tiene el precio más bajo. Filtra por Tipo de alerta para ver sólo sobreprecios o sólo tus liderazgos. Si no hay ninguna, el mensaje es «No hay alertas de precio en este convenio. ¡Tus precios están bien calibrados!».
  9. Haz clic en el nombre de un producto (desde Mis productos o desde una alerta) para ver quién más lo vende.

    Detalle de un producto con la lista de proveedores que lo venden, precio, RUT y monto histórico, con la fila propia resaltada
    Qué deberías verLa lista completa de proveedores que venden este SKU en el convenio, ordenada por OCs históricas, con Proveedor, RUT, Marca, Precio, Regiones, OCs históricas y Monto histórico. Tu propia fila sale resaltada en azul con una estrella y el badge Tu empresa. Puedes filtrar por razón social, RUT o marca. Si haces clic en el número de OCs históricas de una fila con al menos una OC, se abre un modal con los organismos públicos que le compraron ese producto a ese proveedor.

Lo que todavía no hace

Para consultar después

DatoRegla
Quién ve esta pantallaAdministrador, Manager, Ejecutivo y Ejecutivo avanzado — y sólo si la empresa tiene convenios marco adjudicados. Facturación, Finanzas y Bodega no la tienen en el menú.
Qué la hace aparecercompany.convenios_marco con al menos un elemento. Vacío o inexistente: la entrada del menú se oculta sola.
De dónde salen los datosBigQuery (catálogo público de Mercado Público) vía la función executeBigQuery, con caché en memoria de 5 minutos por consulta. Refrescar invalida esa caché. Tu costo por SKU vive aparte, en Firestore (companies/{id}/cmProductCosts).
Ventana del ranking y las alertasSiempre los últimos 12 meses corridos, sin selector de período.
Cómo se calcula el margenMargen $ = Precio CM − Precio Costo. Margen % = Margen $ / Precio CM. Sin costo cargado, ambos muestran un guion.
Badge «Caro» vs «Líder» en AlertasCaro: tu precio está por sobre el promedio del mercado para ese SKU. Líder: tu precio es el más bajo.
Quién guarda el precio de costoCualquiera de los cuatro roles que ven la pantalla; se guarda con tu uid y queda por empresa, no por convenio.