Manual de uso · Configuración

Paso a paso

Administrar empresas y convenios marco de la plataforma

Dos de las cinco pestañas con candado rojo de Configuración —Empresas y Convenios Marco— son la consola con la que el equipo de Marko da de alta clientes, les asigna plan, cobra créditos y mantiene el catálogo global de convenios marco que después cada empresa elige como «adjudicados» en Mi Empresa. No es una pantalla para un proveedor del Estado: es infraestructura interna de Marko sobre la plataforma entera. Este manual recorre las dos pestañas sin dejar nada creado ni modificado en QA, y cierra con dónde vive —fuera de esta pantalla— el otro acceso transversal, el rol Staff.

Los pasos

Parte 1 · Entrar a la consola

1. Abre Configuración en el menú lateral y pulsa la pestaña Empresas, marcada en rojo con un candado, a continuación de Perfiles de Usuario.

   

   Qué deberías verLa cabecera Configuración De Empresa con las 20 pestañas en una sola fila. Al entrar a Empresas, un cuadro de búsqueda, un filtro Todos los estados de pago, el botón azul + Crear empresa y una tabla con las columnas Nombre, RUT, Plan, Precio y Estado Pago.

Parte 2 · El catálogo de empresas

2. Escribe en Buscar empresa para filtrar por nombre, RUT o código, o elige un estado de pago del desplegable.

   

   Qué deberías verLa tabla se acota a las filas que calzan. Cada fila trae el nombre comercial y, debajo en gris, el código interno de la empresa (el mismo id del documento en la base de datos); el filtro de estado ofrece Gratis, Trial, Activo, Suspendido, Vencido y Sin estado — esta última para empresas antiguas que nunca llegaron a tener el campo.
   El RUT de esta captura es de ejemploEl RUT real de la fila se sustituyó antes de fotografiarla. Ver el pie del manual.

Parte 3 · Dar de alta una empresa

3. Pulsa + Crear empresa. Se abre la ventana Nueva empresa, con el Paso 1: Validar empresa — el método por defecto es OC Ganada.

   

   Qué deberías verUn desplegable Método de validación con dos opciones (OC Ganada / RUT de la empresa), el campo ID de OC Ganada, el botón Validar empresa y, al pie, Cancelar / Crear. El resto del formulario —logo, razón social, RUT, giro, dirección, comuna y datos de contacto— está oculto hasta que la validación completa el id de la empresa.

4. Cambia el Método de validación a RUT de la empresa.

   

   Qué deberías verEl campo cambia a RUT de la empresa, con el placeholder de ejemplo Ej: 76123456-7.

5. Escribe un RUT y pulsa Validar empresa.

   

   Qué deberías ver hoy en QACon RUT de la empresa, el aviso rojo dice literalmente «internal»: la función validateCompanyFromRUT responde 403 en el ambiente de QA y la pantalla pinta el código crudo del error de Firebase en vez de un mensaje legible. Con OC Ganada y un código inventado, el aviso es más claro: «No se encontraron datos válidos para la OC … en la API OCDS.» — ambos verificados en vivo, sin completar nunca la validación con datos reales.
   Por qué este manual no llegó a crear una empresaAl validar por una OC Ganada real, esta pantalla reclama esa OC para una empresa nueva — el mismo mecanismo que permite que un código de OC ajeno «robe» el alta de un cliente. Y el callable que cierra la creación, finalizeCompanyCreation, no exige sesión autenticada del lado del servidor. Por ambas razones el formulario se abrió, se probó con datos inventados y se cerró sin pulsar Crear: no quedó ninguna empresa nueva en QA.

Parte 4 · Las acciones sobre una empresa ya creada

6. En cualquier fila, pulsa el botón ⋮ del extremo derecho.

   

   Qué deberías verUn menú de siete acciones: Editar, Configurar compras ágiles, Configurar Plan, Acuerdo de Servicio, Cargar créditos, Migrar datos a BigQuery y Habilitar indicadores operativos (dice Configurar indicadores operativos si ya estaban habilitados). Los pasos siguientes abren cada una — menos Migrar datos a BigQuery, que dispara de verdad una migración a BigQuery y no se ejecutó para este manual.

7. Pulsa Editar para revisar los datos de la empresa: razón social, nombre comercial, RUT, giro, dirección, comuna y, más abajo, los datos de contacto.

   

   

   Qué deberías verEl título dice «Editar empresa «código»» — el identificador interno, no el nombre. El Paso 1: Validar empresa queda bloqueado (no se puede cambiar el método de validación al editar) y bajo él el formulario completo, precargado. Al confirmar con Actualizar sale «Empresa actualizada exitosamente» y escribe directo en el documento de la empresa.
   Todos los campos de estas dos capturas están sustituidosRazón social, RUT, dirección, nombre de contacto, correo y teléfono son valores de ejemplo escritos en el navegador antes de fotografiar; ninguno es el dato real de la empresa que se usó para capturar. Se cerró con Cancelar: no se guardó nada.

8. Vuelve al menú ⋮ y pulsa Configurar Plan.

   

   Qué deberías verUna ventana con cuatro campos: Plan (el catálogo de planes: Compra Ágil, Convenio Marco, Multiempresa, Prueba Gratis, Especial, Prueba Compra Ágil), Estado del Pago (Gratis / Trial / Activo / Suspendido / Vencido), Precio Licencia (UF) y dos fechas de trial. Al guardar sale Guardar Cambios, que escribe directo en el documento de la empresa.

9. Pulsa Configurar compras ágiles y baja hasta Días mínimos antes del cierre para notificar.

   

   Qué deberías verEs el mismo modal que usa cualquier Manager desde su propia empresa (regiones, monto mínimo, palabras clave con los operadores & y $, contexto del negocio), más un campo que sólo aparece aquí: «Días mínimos antes del cierre para notificar», con la nota «Solo para admin: define con cuantos dias de anticipacion minima se envia una notificacion.»

10. Pulsa Cargar créditos.

    

    Qué deberías verEl nombre de la empresa, el saldo actual de créditos y un campo numérico «Créditos a agregar» que sólo acepta enteros positivos. Al confirmar suma al saldo — nunca lo reemplaza— y avisa cuánto quedó.

11. Pulsa Habilitar indicadores operativos.

    

    Qué deberías verUna explicación de lo que hace un clic en Activar indicadores: crea un dataset aislado en BigQuery para la empresa, con vistas filtradas por company_id, y avisa que el prerrequisito es haber corrido antes «Migrar datos a BigQuery» para esa empresa. Ninguno de los dos se ejecutó para este manual.

12. Pulsa Acuerdo de Servicio.

    

    Qué deberías verEl estado del acuerdo de esa empresa —en el ejemplo, un Enlace vencido— con acciones para generarlo, renovarlo o anularlo. Esta misma ventana es también el punto de entrada del equipo comercial: el rol Staff la abre desde el CRM con las mismas acciones. El detalle a fondo de generar, firmar y cerrar un Acuerdo de Servicio queda para el manual de esa pantalla.
    El nombre de la empresa en esta captura está sustituidoEl título original mostraba la razón social real de la empresa demo; se reemplazó en el navegador antes de fotografiar.

Parte 5 · Pestaña Convenios Marco

13. Vuelve a Configuración y pulsa la pestaña Convenios Marco, también marcada en rojo con candado.

    

    Qué deberías verLa cabecera Administración De Convenios Marco con la leyenda «Gestiona el catálogo global usado en la configuración de empresas», un buscador Buscar por nombre, id o URL y el botón + Agregar convenio.
    Es un catálogo global, no de tu empresaVive en un único documento de configuración compartido (configuration/convenios_marco), no dentro de ninguna empresa. Lo que edites aquí queda disponible para que cualquier empresa de la plataforma lo marque como «adjudicado» en Mi Empresa.

14. Baja para ver la tabla del catálogo.

    

    Qué deberías verUna tabla con cuatro columnas: ID (el identificador del convenio, en un badge negro), Nombre, URL Productos (enlace directo al catálogo del convenio en Mercado Público) y Acciones, con Editar y Eliminar en cada fila. La lista sale ordenada alfabéticamente por nombre y nada de lo que muestra es información privada — son catálogos públicos de Mercado Público.

15. Pulsa + Agregar convenio.

    

    Qué deberías verUna ventana Nuevo convenio marco con tres campos: ID (placeholder ej: aseo-2025), Nombre (ej: Aseo (2025)) y URL de productos (https://…). Al confirmar con Crear convenio el ID sólo acepta minúsculas, números y guiones; el Nombre pide 3 caracteres como mínimo; la URL tiene que empezar por http:// o https://. Si el ID ya existe en el catálogo, el aviso dice «Ya existe un convenio con ese ID.» y no crea nada.

16. Cierra esa ventana y pulsa Editar sobre un convenio ya existente.

    

    Qué deberías verLa misma ventana, titulada Editar convenio marco y precargada con el ID, Nombre y URL de productos del convenio. Guardar con Guardar cambios reemplaza esa entrada del catálogo entero — no crea una fila nueva.

17. Pulsa Eliminar sobre una fila.

    

    Qué deberías verUna confirmación: «¿Eliminar convenio?», con el texto «Se eliminará "nombre" (id)."» usando el nombre y el ID reales del convenio, y los botones Sí, eliminar y Cancelar. A diferencia de Empresas, aquí sí es un borrado real y definitivo del catálogo — no hay soft delete: si una empresa ya tenía ese convenio marcado como adjudicado, el nombre deja de resolverse en su ficha.
    Se canceló a propósitoPara esta captura se pulsó Cancelar: el catálogo de convenios marco de QA quedó exactamente como estaba, sin ninguna fila creada, editada ni eliminada.

Rol Staff — cómo se asigna

El otro acceso transversal de Marko —además del flag admin que abre esta pestaña— es staff: el equipo comercial interno, que ve todas las empresas pero sólo sus datos comerciales, nunca los operativos. Vale la pena aclararlo aquí porque comparte pestaña con este manual: un usuario staff puro (sin admin y sin rol en ninguna empresa) entra a Configuración y ve únicamente la pestaña Empresas — company-settings.component.ts se la recorta a esa sola pestaña, con sólo dos de las siete acciones habilitadas: Configurar Plan y Acuerdo de Servicio. Nada de Crear, Editar, Configurar compras ágiles, Cargar créditos, Migrar a BigQuery ni Indicadores operativos, y ninguna otra pestaña del hub.

No hay ninguna casilla en la interfaz para asignarlo. A diferencia de los roles de empresa —que se marcan desde Cuentas → Administrar roles— el flag staff se escribe a mano, directo en el documento de la cuenta:

accounts/{uid}
  staff:  true          // habilita el acceso transversal comercial
  admin:  false          // NO es administrador de plataforma
  active: true           // una cuenta desactivada no opera, aunque sea staff
  roles:  {}              // sin roles: no pertenece a ninguna empresa cliente

Es a propósito: son cuentas del equipo interno de Marko, no de clientes, y por eso no viven en un flujo de alta pensado para invitar personas a una empresa. Si a una cuenta staff se le asigna además un rol en alguna empresa, deja de comportarse como «staff puro» y pasa a navegar como un usuario normal de esa empresa — pierde el acceso transversal.

Quién entra de verdad

Las dos pestañas de este manual dicen «Empresas» y «Convenios Marco», sin nada en el nombre que avise que son distintas del resto de Configuración. Por dentro sí lo son.

Lo que todavía no hace

• 🔴 «Eliminar empresa» no existe en la interfaz, aunque el documento funcional de esta pantalla lo describe. El método deleteCompany() sigue en el código (companies.component.ts) pero ningún botón lo llama — se ve en el HTML de la fila (companies.component.html) que ese botón fue retirado. Hoy no hay forma de borrar una empresa desde Configuración.
• Crear una empresa depende de una API que hoy no responde igual en QA que en producción. Validar por RUT de la empresa falla con el aviso crudo «internal» (403 de validateCompanyFromRUT); validar por OC Ganada exige un código de OC real y ganado, que este manual nunca usó por el riesgo de reclamar una empresa ajena.
• El callable que cierra la creación no exige sesión. finalizeCompanyCreation es un onCall que no comprueba context.auth; en teoría cualquiera que lo invoque con un companyDataInput válido puede crear una empresa, sin pasar por esta pantalla ni por ninguna cuenta de plataforma.
• Ningún campo de estos formularios valida en línea mientras escribes. El único aviso es un toast al confirmar — «Por favor, complete todos los campos requeridos.» — sin decir cuál falta, salvo el caso del logo, que sí tiene su propio mensaje y hace scroll hasta el campo.
• El campo «Nombre» de contacto puede traer el teléfono, no un nombre. Si la empresa se creó o editó alguna vez con ese defecto de Mi Empresa, el formulario de edición de plataforma lo muestra tal cual está guardado, sin corregirlo ni avisar.
• «Migrar datos a BigQuery» y «Activar indicadores» son botones de un solo clic sin confirmación que disparan trabajos reales contra BigQuery — no hay un «¿estás seguro?» de por medio, a diferencia de eliminar una empresa (que ni siquiera existe) o un convenio.
• El catálogo de Convenios Marco no valida que la URL exista ni que el convenio siga vigente en Mercado Público. Cualquier URL con el formato correcto pasa, aunque el convenio real haya vencido.
• Borrar un convenio del catálogo no avisa si alguna empresa ya lo tiene adjudicado. El borrado es inmediato y definitivo (no hay soft delete, a diferencia de casi todo lo demás en Marko); si una empresa lo tenía marcado, su ficha en Mi Empresa deja de poder resolver el nombre.

Para consultar después

Cuando algo no sale