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 roles01-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
Abre Comercial en el menú lateral y entra en Mis Clientes.
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.
Espera a que cargue y lee el encabezado de la tabla.
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.
Escribe en el buscador para quedarte con un cliente o un grupo.
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
Haz click en una fila —o en Ver perfil del menú de tres puntos— para abrir su ficha.
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.
En Apodo / Nombre personalizado, escribe un nombre que reconozcas.
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.
Abre el desplegable Asignado a para repartir el cliente entre tu equipo.
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íogetAssignableAccounts (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.
Escribe una etiqueta y presiona Enter, y agrega una nota en el cuadro de texto.
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.
Pulsa Guardar cambios.
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
Entra en la pestaña Contactos —o en Gestión Contactos desde el menú de tres puntos del listado.
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).
Pulsa Nuevo contacto y completa el formulario.
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.
Pulsa Crear contacto y comprueba que aparece en la tabla.
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
Entra en la pestaña Estadísticas.
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».
Baja hasta la tabla A quién compra (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».
Haz click en un proveedor de la tabla para ver su desglose.
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.
Cierra el modal y abre el desplegable Filtrar por ID Licitación.
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.
Elige una licitación y revisa cómo cambian los datos.
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
Entra en la pestaña Mis ventas.
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.
Baja y revisa la tabla de órdenes: código, estado, fecha y monto.
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:
No avisa de nada nuevo. No hay notificación cuando aparece un cliente nuevo, sube
de monto o deja de comprar. Hay que entrar y comparar a ojo.
No asigna ejecutivos de verdad. El selector Asignado a sale vacío
(paso 6): en la práctica no hay forma de repartir la cartera desde esta pantalla.
No mira más allá de 12 meses. Todos los montos, OC y tendencias son de los
últimos 12 meses, fijo, sin selector de rango. Un cliente que compró hace 13 meses no aparece.
No agenda ni recuerda tareas. Las notas son texto libre sin fecha de
seguimiento, sin recordatorio y sin historial de quién escribió qué ni cuándo.
No cruza con Cotizaciones o Post Venta. Los contadores Cotizaciones y
OCs Portal del encabezado sólo dicen si la unidad tiene actividad, no la lista: para verla
hay que ir a esas otras pantallas por separado.
No exporta nada. Ni el listado completo ni la ficha de un cliente tienen botón de
exportar o descargar.
No hay página de contactos únicos. Los contactos se administran por unidad
compradora, uno por uno: no existe una libreta general de todos los contactos de todos tus clientes.
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
Dato
Fuente
Quién lo edita
Listado, montos, OC, estadísticas, Mis ventas
BigQuery, vía la Cloud Function executeBigQuery
Nadie: es lo que hay en Mercado Público, últimos 12 meses
Nombre, RUT, organismo, sector, dirección, comuna, región
Colección units (maestro público de ChileCompra en Firestore)
Nadie desde esta pantalla
Apodo, etiquetas, notas, asignado a
companies/<id>/myUnits/<codigoUnidad>
Tu empresa, desde Mi información
Contactos
Subcolección propia por unidad
Tu empresa, desde la pestaña Contactos
Las cuatro pestañas del detalle
Pestaña
Para qué sirve
Información
Datos públicos de sólo lectura a la izquierda, tu metadata editable a la derecha.
Contactos
Tu agenda de personas de contacto en esa unidad, con alta, edición y baja.
Estadísticas
Cuánto y qué le compra el mercado a esa unidad, con desglose por proveedor y filtro por licitación.
Mis ventas
Só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 ves
Qué 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í.