Marko Manual de uso · Comercial

Paso a paso

Revisar y anotar tu cartera de clientes

Mis Clientes arma sola tu cartera de organismos públicos a partir de las OC que tu empresa ganó en Mercado Público, ordenada por lo que te compraron. Sobre esa base pública le agregas lo tuyo: un apodo, el ejecutivo a cargo, etiquetas y notas. Este manual recorre ese circuito completo: encontrar un cliente, anotar tu información, gestionar sus contactos y revisar cuánto —y a quién más— le compra.

Qué vas a conseguir

Tu cartera de clientes revisada y anotada: apodo, ejecutivo asignado, etiquetas y notas guardadas en la ficha de cada organismo, y una lectura clara de cuánto te compra y a qué otros proveedores.

Para quién

La pantalla la ven Administrador, Manager, Ejecutivo y Ejecutivo avanzado. Facturación, Finanzas y Bodega no la tienen en el menú.

Qué necesitas antes

Que la empresa tenga RUT configurado en Mi Empresa. Sin eso la pantalla no trae nada: no hay con qué consultar Mercado Público.

Cuánto toma

Un par de minutos por cliente. Revisar la cartera entera, lo que tome recorrer la lista.

Todos ven la misma cartera A diferencia de Cotizaciones o de otras listas comerciales de Marko, aquí no hay filtro por dueño: la consulta a BigQuery se hace por el RUT de la empresa, no por quién cargó qué. Un Ejecutivo ve exactamente los mismos 88 clientes que un Manager. Si la lista te sale vacía siendo Ejecutivo, no es un permiso de menos: revisa primero que la empresa tenga RUT configurado.
La documentación interna se queda corta con los roles 01-ventas/13-mis-clientes.md dice «Admin, Manager, Executive»; el menú real (nav.service.ts) agrega Ejecutivo avanzado, y ninguna de las dos rutas (/customers, /customers/:id) lleva guard de rol en app-routing.module.ts — el control es sólo el menú.

Los pasos

Parte 1 · Ver tu cartera de clientes

  1. Abre Comercial en el menú lateral y entra en Mis Clientes.

    Comercial desplegado con Mis Clientes activo
    Qué deberías verEl submenú de Comercial desplegado con Mis Clientes resaltado como pantalla activa, encabezado Mis Clientes arriba del listado y el selector de Empresa mostrando sobre cuál estás trabajando.
  2. Espera a que cargue y lee el encabezado de la tabla.

    Listado de clientes con el contador y las columnas
    Qué deberías verUn instante de Consultando BigQuery... y después la tabla, con el texto «N clientes · últimos 12 meses · ordenado por monto adjudicado». Las columnas son Cliente (organismo + unidad), RUT, OCs, Monto y Últ. compra; la fila de más arriba es tu mejor cliente por monto.
    Si el RUT de la empresa no está configurado en Mi Empresa, en vez de la tabla sale el aviso «Esta empresa no tiene RUT configurado. Configúralo en Mi empresa.» y no hay nada más que hacer en esta pantalla hasta corregirlo.
  3. Escribe en el buscador para quedarte con un cliente o un grupo.

    Buscador filtrando por municipalidad
    Qué deberías verLa lista filtrándose al tipear, sin recargar nada: busca en el nombre del organismo, el apodo, el código de unidad y el RUT —con y sin puntos ni guión—. El contador de arriba cambia junto con la tabla.

Parte 2 · Anotar tu información sobre un cliente

  1. Haz click en una fila —o en Ver perfil del menú de tres puntos— para abrir su ficha.

    Ficha del cliente recién abierta, pestaña Información
    Qué deberías verLa ficha del cliente: un encabezado con el organismo, la unidad, su RUT, código de unidad, comuna/región y actividad, más dos contadores (Cotizaciones y OCs Portal) que indican de dónde salió esta unidad. Debajo, cuatro pestañas: Información, Contactos, Estadísticas y Mis ventas. La pestaña Información trae a la izquierda los Datos públicos (ChileCompra) —de sólo lectura— y a la derecha Mi información, la que edita tu empresa.
    No todas las unidades tienen ficha pública completa Si la unidad no está en el maestro público de ChileCompra, en vez de la lista Nombre/RUT/Organismo/ Sector/Actividad/Dirección/Comuna/Región verás «Esta unidad no está en el master público.». La sección Mi información igual funciona: puedes anotar apodo, etiquetas y notas aunque falte el dato público.
  2. En Apodo / Nombre personalizado, escribe un nombre que reconozcas.

    Campo Apodo con un nombre personalizado escrito
    Qué deberías verEl campo lleno y, debajo, la ayuda «Útil cuando varias unidades del mismo organismo se distinguen por dirección o sucursal.» Nada se guarda todavía: el apodo sólo queda en pantalla hasta que pulses Guardar cambios al final del bloque.
  3. Abre el desplegable Asignado a para repartir el cliente entre tu equipo.

    Selector Asignado a abierto mostrando No items found
    Qué deberías verDebería listar a los ejecutivos de tu empresa. En la práctica, comprobado en vivo con la cuenta de Ejecutivo, el desplegable abre con «No items found» aunque la empresa sí tiene cuentas con rol Ejecutivo y Ejecutivo avanzado.
    El selector de ejecutivos sale vacío getAssignableAccounts (my-units.service.ts:95-105) consulta la colección global accounts y filtra por roles[companyId] con EXECUTIVE o EXECUTIVE_ADVANCED. En ALIMENTOS SPA la consulta no devuelve ningún candidato pese a existir cuentas con esos roles — posible efecto de la regla de Firestore que exige compartir empresa para poder listar la colección accounts. El resto del formulario funciona igual: puedes dejar el cliente sin asignar y seguir con el apodo, las etiquetas y las notas.
  4. Escribe una etiqueta y presiona Enter, y agrega una nota en el cuadro de texto.

    Etiqueta creada y notas escritas
    Qué deberías verLa etiqueta convertida en una pastilla con una × para quitarla —puedes crear las que quieras, no hay una lista fija— y el texto de la nota tal cual lo escribiste, sin límite de caracteres visible.
  5. Pulsa Guardar cambios.

    Ficha ya guardada con el apodo y la etiqueta aplicados
    Qué deberías verEl botón cambia a Guardando... un instante y después aparece el aviso «Información actualizada». El encabezado de la ficha se refresca solo: el apodo pasa a título principal, la etiqueta aparece como pastilla junto al organismo, y el nombre público queda como línea secundaria debajo. Si algo falla, sale un cuadro de error con el texto «No se pudo guardar la información» y nada se pierde de lo escrito.
    Esta metadata es tuya, no de ChileCompra Apodo, etiquetas, ejecutivo asignado y notas viven en companies/<id>/myUnits/<codigoUnidad>: son propias de tu empresa y no cambian nada de lo público. Si nunca nadie las tocó, ese documento ni siquiera existe todavía —se crea recién al primer Guardar cambios.

Parte 3 · Gestionar los contactos

  1. Entra en la pestaña Contactos —o en Gestión Contactos desde el menú de tres puntos del listado.

    Pestaña Contactos sin contactos registrados
    Qué deberías verEl bloque Mis contactos (N) con una tabla: Nombre, Email, Teléfono, Cargo, Observaciones y Acciones. Si todavía no hay ninguno, la tabla muestra «Sin contactos registrados» y el contador queda en (0).
  2. Pulsa Nuevo contacto y completa el formulario.

    Formulario de nuevo contacto completado
    Qué deberías verUn formulario con Nombre y Email marcados con asterisco, Teléfono móvil (con el ejemplo +56 9 ...), Cargo y Observaciones. Abajo, Cancelar descarta sin preguntar y Crear contacto guarda.
  3. Pulsa Crear contacto y comprueba que aparece en la tabla.

    Contacto nuevo ya en la tabla de Mis contactos
    Qué deberías verEl aviso «Contacto creado» y la fila nueva en la tabla, con el contador subiendo a (1). El menú de acciones de cada fila trae Editar y Eliminar; eliminar pide confirmación con «¿Eliminar contacto? Esta acción no se puede deshacer.» antes de borrar de verdad.

Parte 4 · Analizar las compras del cliente

  1. Entra en la pestaña Estadísticas.

    Pestaña Estadísticas con los dos KPI principales
    Qué deberías verDos KPI arriba —Monto total transado y Órdenes de compra, ambos de los últimos 12 meses— y, debajo, un desplegable Filtrar por ID Licitación que arranca en «Todas las licitaciones».
  2. Baja hasta la tabla A quién compra (top proveedores).

    Tabla A quién compra con los top proveedores
    Qué deberías verHasta diez proveedores —de cualquier empresa, no sólo la tuya— con sus OC y el monto transado, junto a la tabla Qué compra (top categorías) a la izquierda. Cada fila de proveedores es clickeable: el cursor cambia y el título dice «Ver análisis por proveedor».
  3. Haz click en un proveedor de la tabla para ver su desglose.

    Modal de desglose por proveedor
    Qué deberías verUn modal con el nombre y RUT del proveedor en el título, dos KPI (Monto total transado y Órdenes de compra), la tabla Qué le compra por categoría y la Tendencia mensual, más un listado de Últimas órdenes de compra con enlace a Mercado Público. Cerrar lo descarta sin guardar nada —el modal es sólo de consulta.
  4. Cierra el modal y abre el desplegable Filtrar por ID Licitación.

    Desplegable de licitaciones abierto
    Qué deberías verLa lista de convenios marco por los que ese cliente ha comprado, cada uno con su código y cuántas OC trae —por ejemplo «Alimentos · 2239-9-LR24 · 65 OCs»—, ordenados de mayor a menor número de OC.
  5. Elige una licitación y revisa cómo cambian los datos.

    Estadísticas filtradas por una licitación
    Qué deberías verLos dos KPI se recalculan sobre ese convenio, la tabla Qué compra (top categorías) desaparece —no trae categoría por convenio— y quedan sólo A quién compra y Tendencia mensual, ahora una al lado de la otra. La «×» del desplegable limpia el filtro y vuelve a «Todas las licitaciones».

Parte 5 · Revisar lo que tú le vendiste

  1. Entra en la pestaña Mis ventas.

    Pestaña Mis ventas con Total facturado y OCs emitidas
    Qué deberías verEl título «OCs que mi empresa le emitió a esta unidad — últimos 12 meses» y dos KPI: Total facturado y OCs emitidas. Estos números son los mismos que ya viste en Monto y OCs de la pestaña Información: es la misma consulta, sólo que aquí se detalla en tabla.
    Sin RUT, esta pestaña ni siquiera consulta Si la empresa no tiene RUT configurado sale el aviso «Esta empresa no tiene RUT configurado. No es posible consultar ventas.» — la misma condición del paso 2, repetida aquí porque la consulta es independiente.
  2. Baja y revisa la tabla de órdenes: código, estado, fecha y monto.

    Tabla de OC emitidas a la unidad
    Qué deberías verUna fila por OC con el código del portal y la descripción del pedido debajo, un badge de estado (Aceptada, Recepcion Conforme…), la fecha y el monto. El ícono del final abre la OC en Mercado Público en una pestaña nueva. Si no hay ninguna en el período, el mensaje es «Sin OCs emitidas a esta unidad en los últimos 12 meses.»

Lo que todavía no hace

Mis Clientes es un cruce de lo que ya compraron en Mercado Público con lo que tú anotas encima. Estas son las cosas que la pantalla no resuelve, para que no las esperes:

Para consultar después

Qué es una unidad compradora

Cada fila de la cartera no es un organismo entero: es una unidad compradora (organismo + unidad específica). Un mismo organismo grande —un servicio de salud, el Ejército— puede aparecer varias veces en la lista, una fila por cada unidad distinta que te compró. El apodo existe justo para distinguirlas cuando el nombre público no alcanza.

De dónde sale cada dato

DatoFuenteQuién lo edita
Listado, montos, OC, estadísticas, Mis ventasBigQuery, vía la Cloud Function executeBigQueryNadie: es lo que hay en Mercado Público, últimos 12 meses
Nombre, RUT, organismo, sector, dirección, comuna, regiónColección units (maestro público de ChileCompra en Firestore)Nadie desde esta pantalla
Apodo, etiquetas, notas, asignado acompanies/<id>/myUnits/<codigoUnidad>Tu empresa, desde Mi información
ContactosSubcolección propia por unidadTu empresa, desde la pestaña Contactos

Las cuatro pestañas del detalle

PestañaPara qué sirve
InformaciónDatos públicos de sólo lectura a la izquierda, tu metadata editable a la derecha.
ContactosTu agenda de personas de contacto en esa unidad, con alta, edición y baja.
EstadísticasCuánto y qué le compra el mercado a esa unidad, con desglose por proveedor y filtro por licitación.
Mis ventasSólo las OC que tu empresa le emitió a esa unidad, con enlace a cada una en Mercado Público.

Cuando algo no sale

Lo que vesQué pasa
«Esta empresa no tiene RUT configurado. Configúralo en Mi empresa.»Falta el RUT en la ficha de la empresa. Sin él no hay con qué consultar BigQuery: ni el listado, ni las estadísticas, ni Mis ventas van a cargar.
«No encontramos OCs en mercado público para tu RUT.»El RUT sí está configurado, pero Mercado Público no tiene OC adjudicadas a tu empresa en los últimos 12 meses.
«Sin resultados para tu búsqueda.»El texto del buscador no calza con ningún nombre, apodo, código ni RUT de la lista ya cargada.
«Esta unidad no está en el master público.»La unidad no tiene ficha en el maestro de ChileCompra. La metadata propia (apodo, etiquetas, notas) igual funciona.
El desplegable «Asignado a» dice «No items found»Comprobado en vivo: no trae candidatos aunque existan ejecutivos en la empresa. Ver la nota del paso 6.
«No se pudo guardar la información»Falló el guardado de apodo/etiquetas/notas/asignado. Nada se pierde de lo escrito en el formulario; reintenta.
«Esta empresa no tiene RUT configurado. No es posible consultar ventas.»Mismo caso del listado, repetido en la pestaña Mis ventas porque consulta aparte.
«Sin OCs emitidas a esta unidad en los últimos 12 meses.»Tu empresa no le vendió nada a esa unidad en el período, aunque otros proveedores sí.