Manual de Micaela

Soporte

Cómo pedir ayuda

Micaela la construye un equipo pequeño, así que escribes directamente a quien conoce el producto por dentro. No hay formularios ni niveles de escalamiento.

Qué incluir en tu mensaje

Con estos cuatro datos casi siempre se resuelve en la primera respuesta:

• La pantalla donde pasa, y la tienda o el producto concreto si aplica.
• Qué esperabas que ocurriera y qué ocurrió en su lugar.
• El mensaje de error completo, si apareció alguno.
• La fecha y hora aproximada: con eso ubicamos el evento en la auditoría.

Empezar

Qué es Micaela

Micaela calcula, tienda por tienda y producto por producto, cuánto hay que pedir hoy para no quedarse sin mercancía ni acumular inventario muerto. El motor es DDMRP (Demand Driven MRP): en vez de un mínimo/máximo fijo, cada ítem tiene un amortiguador de tres zonas que se recalcula con la demanda real.

La plataforma se organiza en siete grupos de pantallas, que son los mismos del menú lateral:

Empezar

Conceptos DDMRP

Todo lo que hace la plataforma se apoya en cinco ideas. Vale la pena leerlas una vez: los nombres se repiten en cada pantalla.

El amortiguador y sus zonas

Cada combinación de producto + tienda (o producto + CEDI, en compras) tiene un amortiguador con tres zonas apiladas. La suma de las tres es el nivel objetivo (Top of Green), que es a donde el sugerido busca llevar el inventario.

Posición de inventario

Es lo que la plataforma compara contra las zonas. No es el stock físico: incluye lo que ya viene en camino.

Posición = existencia en tienda + en tránsito

En el sugerido verás dos semáforos por línea: el buffer actual (con la posición de hoy) y el buffer posterior al pedido (sumando lo que estás pidiendo). El segundo cambia en vivo mientras editas la cantidad, y es la forma de ver si tu ajuste manual deja el ítem donde debería.

Estados que muestra la interfaz

ADU y variabilidad

El ADU (Average Daily Usage) es la demanda diaria promedio que el motor aprende del historial de ventas. El CV (coeficiente de variación) mide qué tan errática es esa demanda. Entre los dos determinan el tamaño de las zonas: más demanda o más variabilidad, amortiguador más grande.

Cascada de parámetros

Los factores del cálculo se resuelven en cascada: global → categoría → producto. Lo más específico gana. Además, la Parametrización de buffers permite fijar valores por nivel geográfico (empresa, zona, región, minirregión o tienda).

Empezar

Unidades de pedido

Un mismo producto se pide de formas distintas según cómo se mueva físicamente. La plataforma calcula siempre en unidades de inventario y después convierte a la unidad operativa que elijas por línea.

Qué unidad se propone por defecto

• En pedidos: estiba si el producto paletiza y además es de alta rotación (clase AA o A) o su bloque está marcado como «bloque de estiba» en Parámetros globales. En cualquier otro caso, UE.
• En compras: estiba si el producto paletiza; si no, peso cuando maneja peso; si no, UE. La estiba de compra siempre es completa.

Redondeo por umbral

Al pasar de UI a estibas la cantidad casi nunca da exacta. El sistema aplica un umbral (por defecto configurado a nivel de empresa, con posibilidad de anularlo por producto): si el sobrante supera el umbral, se sube a la siguiente estiba; si no, se recorta. Cuando el ítem está en zona roja crítica y el redondeo lo dejaría en cero, se fuerza la unidad mínima. Pasa el cursor sobre la celda Estiba / media para ver el desglose del redondeo de esa línea.

Empezar

Ingreso y sesión

Hay tres formas de entrar:

• Correo y contraseña. La contraseña tiene mínimo 8 caracteres. El ojo del campo permite verla mientras la escribes.
• Google o Microsoft (SSO). Los botones solo se habilitan si el administrador configuró las credenciales del proveedor en el backend. Si no, aparecen deshabilitados con la explicación.
• Enlace desde la app principal. Si llegas embebido desde otra aplicación corporativa, la sesión se canjea automáticamente y entras sin volver a autenticarte.

Tras entrar, la plataforma carga tus permisos y arma el menú. El avatar del encabezado muestra tus iniciales y desde ahí se cierra la sesión.

Empezar

Términos y condiciones

Cuando el proveedor publica una versión nueva de los términos, la plataforma bloquea todas las escrituras hasta que la firmes. Puedes seguir consultando información, pero no registrar cambios. Al intentar guardar algo, el sistema te lleva a esta pantalla.

1. Lee el documento. El botón de aceptar permanece deshabilitado hasta que te desplaces al final del texto.
2. Pulsa Acepto la versión X. Queda registrada la firma con fecha.
3. Vuelves automáticamente a la pantalla donde estabas.

La pantalla también se puede abrir a mano para releer el documento vigente. En ese caso muestra qué versión firmaste y cuándo. Si estás al día, el único botón es Volver a trabajar.

Empezar

Avisos de licencia

Bajo el encabezado puede aparecer una franja permanente con el estado del licenciamiento. Es informativa, pero cambia lo que puedes hacer.

Además, la licencia decide qué funcionalidades están habilitadas (Pedidos, Compras, Pronóstico, Copiloto, Datos maestros, Parámetros DDMRP). Una funcionalidad no licenciada no aparece en el menú aunque tu rol tenga el permiso. Consulta el detalle en Mi licencia.

General

Inicio

La pantalla de aterrizaje. Resume el estado del abastecimiento y ofrece los accesos que más se usan a diario.

Qué muestra

• Accesos rápidos al sugerido de pedidos, al carrito (con líneas y valor actuales) y a los parámetros DDMRP.
• Estado de buffers. Una barra con el reparto de los amortiguadores entre quiebre, reponer, óptimo y exceso, calculado con los buffers reales de la compañía.
• Tu compañía. Conteos de productos, tiendas, pedidos (con los pendientes), órdenes de compra y usuarios.
• Productos recientes. Las últimas seis referencias del maestro, con categoría y precio.
• Insights con IA y accesos rápidos a cargar datos, parámetros, reportes y copiloto.

Pedidos

Analítica de pedidos

El tablero de control del proceso de reposición. Va primero en el menú del módulo a propósito: se mira antes de entrar a operar el sugerido.

Bloques del tablero

La granularidad de las series (diaria, semanal o mensual) la define la consulta que alimenta el tablero; la carga inicial es diaria.

Pedidos

Sugerido de pedidos

La pantalla central de la operación diaria. Responde una sola pregunta — qué le pido hoy a esta tienda — y deja ver el porqué de cada cifra. Toda la matemática DDMRP se calcula en el servidor; aquí se revisa, se ajusta y se envía.

El flujo, paso a paso

1. Elige la región y la tienda en los selectores del encabezado. Al cambiar de tienda se recarga el sugerido y se limpia la selección.
2. Filtra para acotar el trabajo: por bloque, categoría, clase de rotación, días de inventario o «solo con pedido».
3. Revisa cada línea. Compara el buffer actual con el posterior al pedido; expande las que no cuadren para ver de dónde sale la cifra.
4. Ajusta las cantidades donde el criterio comercial lo pida, y excluye lo que no va.
5. Envía al carrito. Si hay líneas seleccionadas se envían solo esas; si no hay ninguna seleccionada, se envía todo el sugerido con cantidad mayor que cero.

El encabezado: contexto y cifras del pedido

Arriba a la izquierda, el código y el nombre de la tienda con su ruta geográfica (zona · región — minirregión); a la derecha, los dos selectores y el botón Enviar al carrito. Debajo, cinco tarjetas que resumen el pedido y que responden al filtro activo, no al catálogo completo:

Filtros

Se combinan entre sí y afectan tanto a la tabla como a las cinco tarjetas:

• Bloque y Categoría — para trabajar por sección de la góndola.
• Pareto — clase de rotación. Útil para atender primero AA y A.
• Días de inventario — bajo (menos de 3 días), medio (entre 3 y 7) o alto (más de 7).
• Solo con pedido — esconde todo lo que el sistema no propone pedir.
• Buscar PLU o ítem — texto libre sobre código y descripción.

El botón Excluir, a la derecha, se activa cuando hay líneas seleccionadas con las casillas.

Columnas de la tabla

La tabla tiene dos grupos: Información ítem (el estado de hoy) y Pedido hoy (lo que se va a pedir, sobre fondo destacado).

Al final de cada fila hay dos botones: el globo de diálogo, que abre la explicación del sugerido, y la flecha, que despliega el detalle del ítem.

Editar cantidades y cambiar de unidad

Cada línea tiene un control de más/menos y un campo numérico. Al modificar una cantidad respecto al sugerido original aparece la marca editado, y el tooltip muestra cuál era el valor propuesto. Los días de cobertura y el semáforo posterior se recalculan al instante.

El desplegable de la columna Estiba / media ofrece solo las unidades que el producto admite. Al cambiarla, el sistema vuelve a proponer la cantidad en esa unidad aplicando el redondeo por umbral; al volver a UE se restaura el sugerido original de la línea. Bajo el control se lee siempre el equivalente en UI, que es lo que viaja al ERP.

El detalle del ítem

Es la parte que explica el número. Se abre con la flecha del final de la fila y muestra, para ese producto y esa tienda, de dónde sale el sugerido. La cabecera indica el ítem y la ventana de análisis usada para los promedios (8 días en el ejemplo).

Abastecimiento en estibas

Solo aparece si el producto paletiza. Muestra primero los factores del maestro y luego la conversión completa, que se lee de izquierda a derecha:

Cuando corresponde, la línea añade una marca: mínimo forzado (zona roja) si el redondeo habría dejado en cero un ítem crítico, u omitido si el sugerido no alcanza la unidad mínima. Si el producto se maneja por peso, en lugar de este bloque —o además de él— aparece Compra por peso, con los kilos por UI y el costo por kilo.

Indicadores del ítem

Evolución del amortiguador

El enlace ver evolución, sobre la barra de zonas, despliega una gráfica de los últimos 45 días: cómo se movió la posición de inventario respecto a las zonas. Es la forma de distinguir un quiebre puntual de un amortiguador mal dimensionado — si la línea vive pegada al rojo, el problema no es el pedido de hoy sino la parametrización.

Movimientos de inventario recientes

Cierra el detalle con el movimiento día a día: fecha, tipo (venta, insumo, merma, baja…), cantidad — negativa en rojo cuando sale, positiva en verde cuando entra — y la referencia del documento que lo originó. Es el último nivel de detalle antes de ir al ERP: si una cifra no cuadra, aquí se ve exactamente qué la movió.

Explicación del sugerido

El botón ¿Por qué este sugerido? de cada línea abre un chat que explica el cálculo con los datos DDMRP reales de esa fila: stock, zonas, posición del buffer y cantidad propuesta. Trae preguntas sugeridas: por qué este sugerido, cómo se calcula la cantidad, qué pasa si no se pide y cuándo llega.

Excluir y enviar

Las casillas de la izquierda seleccionan líneas; la del encabezado marca toda la página. Con una selección activa, Excluir saca esos ítems de la vista y los deja en cero, y Enviar al carrito manda solo los seleccionados. Sin selección, el envío arrastra todo el sugerido con cantidad mayor que cero.

Paginación

La tabla pagina de 20 en 20, ajustable a 50 o 100. El cambio de página no pierde las cantidades que hayas editado ni la selección.

Pedidos

Carrito de pedidos

Reúne lo que enviaste desde el sugerido, agrupado por tienda, para una última revisión antes de confirmar.

Qué puedes hacer

• Ajustar cantidades con el control de más/menos o escribiendo el valor. Poner cero elimina la línea.
• Quitar líneas una por una, o vaciar el carrito completo.
• Confirmar y enviar a Siesa. El botón solo aparece si tu rol tiene el permiso carrito.enviar_siesa; si no, verás el aviso de que no lo tienes.

Paneles laterales

• Resumen: tiendas, líneas, unidades de empaque y valor total.
• Indicadores por bloque: líneas, unidades y valor de cada bloque, con barra proporcional para ver de un vistazo dónde se concentra el pedido.

Compras

Analítica de compras

El tablero del área de compras, organizado en seis pestañas. Los datos se cargan con granularidad mensual.

Compras

Sugerido de compras

El mismo oficio que el sugerido de pedidos, pero un eslabón antes: qué comprarle al proveedor para reponer el CEDI, consolidando la demanda que vienen generando las tiendas. La mecánica de la tabla es idéntica; cambian el contexto, los datos y el resultado.

Diferencias con el sugerido de pedidos

El encabezado: contexto y cifras de la compra

A la izquierda, la insignia del CEDI y el subtítulo que recuerda de qué va la pantalla. A la derecha, Ver órdenes —que lleva al listado de órdenes ya generadas— y Generar órdenes de compra, que cambia a Generar órdenes (N) cuando hay líneas seleccionadas, para que sea evidente que solo se van a emitir esas.

Debajo, seis tarjetas que responden al filtro activo:

Filtros

• Proveedor — la lista se arma con los proveedores que aparecen en el sugerido. Filtrar por uno es la forma natural de preparar su orden.
• Categoría — para revisar por familia de producto.
• Solo con compra — esconde lo que no hay que comprar.
• Buscar PLU o ítem — texto libre sobre código y descripción.

Cuando hay algún filtro activo aparece Limpiar. Excluir se habilita al seleccionar líneas e indica cuántas afectará.

Columnas de la tabla

Tres grupos: Información ítem, Estado CEDI (la situación de hoy en el centro de distribución) y Compra sugerida.

Igual que en pedidos, cada fila termina con el globo de diálogo, que explica el sugerido, y la flecha, que abre el detalle.

Editar cantidades y cambiar de unidad

Control de más/menos y campo numérico por línea, con la marca editado cuando te apartas del sugerido. El desplegable ofrece solo las unidades que el producto admite; al cambiarla, la cantidad se vuelve a proponer en esa unidad con el redondeo por umbral, y al volver a UE se restaura el sugerido original.

El detalle de la línea

Se abre con la flecha del final de la fila y tiene dos bloques.

Detalle del amortiguador

Compra en estibas

Aparece si el producto paletiza, con los factores del maestro en la cabecera. Los seis campos cuentan la conversión completa; con el ejemplo de la figura:

Bajo los campos puede aparecer una lista de avisos: mínimo forzado por zona roja crítica cuando el redondeo habría dejado en cero un ítem urgente, o que el sugerido quedó por debajo de la unidad mínima y se omite — en ese caso DDMRP lo volverá a proponer cuando la necesidad crezca lo suficiente.

Si la referencia se compra por peso, en su lugar aparece Compra por peso, con los kilos por unidad de inventario, el costo por kilo, el peso resultante y el equivalente en UI.

Explicación del sugerido

El globo de diálogo abre el mismo tipo de chat que en pedidos, con los datos DDMRP de esa línea del CEDI: existencia, tránsito, demanda diaria, amortiguador y cantidad propuesta.

Generar las órdenes

1. Ajusta cantidades y excluye lo que no va.
2. Si vas a emitir solo la orden de un proveedor, fíltralo o selecciona sus líneas.
3. Pulsa Generar órdenes de compra. Con líneas seleccionadas se generan solo con esas; sin selección, con todo lo que tenga cantidad mayor que cero.
4. Se crea una orden por proveedor y quedan listadas en Órdenes de compra.

Compras

Órdenes de compra

Las órdenes consolidadas por proveedor, listas para confirmar, exportar y enviar al ERP.

Ciclo de vida de una orden

Cualquier orden puede eliminarse desde el pie de su tarjeta.

Exportación

Cada orden se descarga en dos formatos:

• .txt (Siesa) — archivo plano delimitado por barras, con la cabecera de la orden y una línea por ítem: orden, PLU, cantidad, unidad de empaque, costo, unidad operativa, cantidad en esa unidad y equivalente en UI.
• CSV — con las mismas columnas más descripción y subtotal, para análisis en hoja de cálculo.

En el encabezado hay cuatro indicadores: número de órdenes, proveedores distintos, unidades totales y costo total. Cada tarjeta muestra proveedor, fecha y hora de entrega, fecha de recibo en CEDI y el detalle de ítems con subtotales.

Compras

Forecast de venta y compra

Proyección por producto de la venta esperada y de la compra necesaria para sostenerla, con la posibilidad de intervenir a mano cada período.

Cómo se usa

1. Selecciona el producto en el desplegable. Se cargan sus dos series: venta y compra.
2. Revisa la gráfica: histórico real, venta proyectada y compra proyectada sobre los mismos períodos.
3. Ajusta los períodos futuros que lo necesiten escribiendo un valor. Dejar el campo vacío devuelve el valor base calculado.
4. Si el ajuste debe afectar el abastecimiento, usa Realimentar buffer: actualiza el ADU del amortiguador y queda registrado en auditoría.

Controles

• Unidades / Valor. Alterna la vista entre cantidades y pesos, multiplicando por el precio de venta del producto.
• Recalcular. Recalcula el forecast del producto seleccionado o de toda la compañía.
• Plan de compra. Consolidado de los próximos seis períodos.
• Exportar CSV. Descarga período, tipo, venta base, ajuste, venta final, uplift, venta real y compra final.

El campo uplift refleja el multiplicador aplicado por las fechas especiales que caen en ese período.

Inteligencia

Copiloto (IA)

Un asistente conversacional que consulta la API real de tu compañía. No inventa cifras: llama a herramientas del sistema y responde con lo que devuelven.

Qué puede hacer

El copiloto tiene acceso a cuatro herramientas, y cada respuesta muestra cuáles usó:

La pantalla ofrece preguntas de arranque y el botón Nueva conversación para empezar de cero. En el título se indica el proveedor activo: Claude vía Vertex AI o la API de Claude.

Inteligencia

Pronóstico (IA)

Aquí es donde el amortiguador se pone al día. El motor aprende la demanda del historial de ventas y vuelve a dimensionar las zonas de cada buffer.

Recalcular

1. Pulsa Recalcular buffers (IA).
2. El motor estima el ADU y la variabilidad de cada ítem y redimensiona zona roja, amarilla y verde y el nivel objetivo.
3. La tabla se actualiza con los valores nuevos, el método usado y la marca de tiempo del último cálculo.

Métodos de pronóstico

Historial demo

El botón Generar historial demo crea 90 días de ventas sintéticas para poder probar el recálculo sin datos reales. Es una herramienta de demostración y pruebas: en un ambiente productivo el historial debe venir del ERP o de un cargue real.

Datos

Datos maestros

La conexión viva con el ERP. Aquí se define una consulta SQL por cada conjunto de datos que la plataforma debe traer, y con qué frecuencia refrescarlo.

Configurar la conexión

1. Abre el editor de conexión e ingresa host, puerto, base de datos, usuario y contraseña del SQL Server.
2. Pulsa Probar. El resultado dice si conectó y con qué motor, o el error exacto.
3. Guarda. La contraseña se almacena cifrada y no se vuelve a mostrar: el campo queda vacío y solo se envía si escribes una nueva.

El botón Cargar presets siembra un juego de datasets predefinidos para no empezar de cero; después solo hace falta configurar la contraseña de la conexión.

Anatomía de un dataset

Ejemplos de mapeo, según el destino:

• Productos: { "sku": "item", "name": "desc_item" }
• Ventas: { "productSku": "item", "storeCode": "CO", "date": "fecha", "quantity": "cantidad" }

Acciones sobre cada dataset

• Previsualizar. Ejecuta la consulta y muestra hasta 25 filas sin escribir nada. Es el paso para validar el SQL y el mapeo.
• Sincronizar. Trae los datos y los almacena; si tiene destino de feed, además alimenta DDMRP. El aviso informa cuántos registros se almacenaron y cuántos pasaron al modelo.
• Ver registros. Navega el contenido almacenado con búsqueda y paginación.
• Editar y eliminar (esto último borra también sus registros; pide confirmación).

Datos

Cargar datos

La vía manual: subir archivos o configurar conexiones puntuales por entidad, sin pasar por el catálogo de datasets.

Entidades

Cargar un archivo

1. Elige la entidad. La pantalla muestra las columnas obligatorias y opcionales que espera.
2. Descarga la plantilla CSV. Trae los encabezados correctos y se abre bien en Excel con tildes.
3. Llena el archivo y súbelo.
4. Usa Validar primero: informa cuántos registros son válidos y cuántos tienen error, sin escribir nada.
5. Cuando esté limpio, carga. El mensaje distingue con precisión entre «cargados N de M registros» y una validación que no escribió nada.

El caso especial de las ventas

Las ventas viajan por un importador propio de historial, porque la fecha de cada venta es el dato esencial y no debe descontar inventario. Su plantilla tiene columnas propias:

productSku, storeCode, date, quantity, unitCost

• La fecha admite AAAA-MM-DD o DD/MM/AAAA (día primero).
• El importador agrupa por producto, tienda y día, y netea las devoluciones.
• Reemplaza el rango de fechas que traiga el archivo, así que volver a cargar el mismo archivo no duplica la demanda.
• El resultado informa días cargados, unidades, productos, tiendas y el rango de fechas.

Conexiones a base de datos o API REST

Además del archivo, cada entidad admite dos orígenes conectados:

• Base de datos: host, puerto, base, usuario, contraseña y la consulta SQL.
• API REST: URL, método, jsonPath para ubicar el arreglo dentro de la respuesta y la autenticación por cabecera.

En ambos casos el flujo es el mismo: Probar conexión → Previsualizar (hasta 20 filas, con sus columnas) → Guardar conexión. Las conexiones guardadas quedan listadas por entidad y se pueden importar con un clic o eliminar.

Configuración

Parámetros globales DDMRP

Los factores que gobiernan el tamaño del amortiguador y la forma del sugerido, con resolución en cascada: global → categoría → producto.

Bloques que se piden por estiba

La primera tarjeta lista los bloques del maestro de productos. Los que marques quedan configurados para que sus productos se sugieran por estiba por defecto (junto con los de alta rotación por clase AA o A). Pulsa Guardar bloques de estiba para persistir el cambio.

Las medias estibas no tienen regla automática: las decide el analista línea por línea según la demanda.

Cálculo del amortiguador

Parámetros por categoría

La tabla inferior permite sobrescribir, por categoría, los días de inventario objetivo, el factor de variabilidad y el factor de zona verde, y activar o desactivar cada sobrescritura con su interruptor.

Configuración

Fechas especiales

Los eventos que alteran la demanda — quincenas, fin de año, día de la madre, ferias locales — y el multiplicador que se aplica a la proyección durante esos días.

Campos de una fecha especial

Cada fecha se puede crear, editar y eliminar (con confirmación). El listado resume el alcance en lenguaje llano: «Toda la compañía» / «Todas las tiendas» cuando no hay restricción. El efecto se ve en la columna uplift del forecast.

Configuración

Cargue de parametrización

Carga masiva de parámetros DDMRP por archivo, con tres plantillas descargables y un histórico de cargues.

Plantillas

Cada plantilla incluye una fila de ejemplo — bórrala antes de subir. Se pueden descargar una por una o todas de una vez. El archivo se sube arrastrándolo a la zona de carga o con el selector; formatos aceptados CSV y XLSX, hasta 10 MB.

El histórico de cargues registra identificador, fecha, archivo, registros procesados, errores y estado (Procesado, Con errores, En proceso).

Administración

Empresa

El resumen del estado de parametrización de tu compañía: cuántos países, zonas, regiones, minirregiones y tiendas ubicadas hay en la jerarquía, más el número de roles y usuarios. Debajo, accesos directos a Geografía, Tiendas, Usuarios, Roles, Parámetros DDMRP y Alta de compañía.

Es un buen punto de partida cuando llegas a una implantación nueva: si «Tiendas ubicadas» está en cero, la geografía todavía no está armada y el sugerido no podrá agruparse por región.

Administración

Geografía

La jerarquía territorial de la compañía. Tiene cuatro niveles fijos, y de ellos cuelgan las tiendas.

País → Zona → Región → MiniRegión → (tiendas)

La pantalla se divide en el árbol, a la izquierda, y el formulario de alta, a la derecha. Para crear un nodo: elige el nivel, selecciona el padre (excepto para país), escribe el código y el nombre, y agrega. El árbol muestra el conteo de tiendas de cada minirregión.

Administración

Tiendas

Un listado con buscador por código o nombre. Cada fila muestra el código, el nombre, la región (campo heredado) y un desplegable para asignar la minirregión a la que pertenece la tienda. El cambio se guarda al seleccionar; también se puede dejar «sin asignar».

Las opciones del desplegable se muestran con la ruta completa zona / región / minirregión, para no confundir nombres repetidos.

Administración

Maestro de productos

El catálogo de ítems de la compañía con su clasificación DDMRP y sus factores de estibado.

El listado

Buscador por SKU o nombre y filtro por categoría. Cada fila muestra SKU, nombre, categoría, proveedor preferente, bloque, clase de rotación, unidad de medida, costo, precio, lead time, pedido mínimo, múltiplo de empaque, los factores de estibado y el estado activo/inactivo. Desde la fila se edita o se elimina el producto.

La columna Estiba resume los factores: unidad de agrupación, factor de estiba y factor de media. Si el producto se compra por peso, aparece además el peso por unidad. Un producto sin factor de estiba se maneja «solo empaque».

Crear o editar un producto

El formulario recoge:

• Identificación: SKU (no editable una vez creado) y nombre.
• Clasificación: categoría, bloque, clase de rotación y proveedor preferente.
• Comercial: unidad de medida, costo, precio de venta.
• Abastecimiento: lead time en días, pedido mínimo, múltiplo de empaque.
• Estado: activo o inactivo.

Importar productos

El botón Importar abre un asistente de tres pasos con tres orígenes:

1. Elige el origen. Archivo plano CSV (pegado o subido), base de datos (PostgreSQL o SQL Server, con consulta SELECT) o API REST (URL, método, jsonPath y cabeceras).
2. Mapea las columnas. El asistente detecta las columnas y una muestra de filas, y propone la correspondencia. Si usas los nombres de las plantillas (sku, name, category, block, pareto, costPrice, sellPrice…) el mapeo es automático.
3. Revisa el resultado: productos creados, actualizados y filas con error sobre el total.

Administración

Parametrización de buffers

La herramienta de parametrización masiva de amortiguadores. Permite fijar valores a cualquier nivel geográfico o copiar la parametrización de una tienda a otras.

Pestaña «Aplicar por geografía»

1. Elige el ámbito: toda la empresa, una zona, una región, una minirregión o una tienda.
2. Elige los productos: todos, los de una categoría, o un producto concreto.
3. Escribe los valores. Los campos que dejes en blanco no se tocan: solo se aplica lo que llenes.
4. Previsualiza el impacto. El sistema responde cuántas tiendas por cuántos productos equivalen a cuántos buffers afectados. Revisa esa cifra antes de aplicar.
5. Aplica.

Valores parametrizables

Pestaña «Clonar parametrización»

• Copiar de una tienda a otras. Se elige una tienda plantilla y se copia toda su parametrización por producto a las tiendas destino, sea a todas las demás o a una selección concreta. Útil cuando abres tiendas nuevas con el mismo formato.
• Uniformar dentro de una tienda. Aplica los mismos valores base a todos los productos de una tienda.

Administración

Usuarios y asignaciones

Aquí se decide dos cosas por cada persona: qué puede hacer (el rol) y sobre qué información (el alcance geográfico). Son independientes.

Cómo asignar

1. Selecciona el usuario en la lista de la izquierda. A la derecha aparecen sus asignaciones actuales.
2. En Nueva asignación, elige el rol.
3. Elige el nivel de alcance. Si no es GLOBAL, selecciona el nodo concreto.
4. Pulsa Asignar. La asignación aparece en la tabla y se puede quitar en cualquier momento.

Niveles de alcance

Un mismo usuario puede tener varias asignaciones: por ejemplo, rol de Analista sobre una zona y rol de Consulta a nivel global.

Administración

Roles y permisos

La matriz de qué puede hacer cada rol. Los roles de sistema vienen predefinidos y no se editan; para necesidades propias se crean roles de la compañía.

Crear un rol

1. Pulsa + Nuevo rol.
2. Define la clave (por ejemplo GERENTE_REGION), el nombre visible, la descripción y el alcance por defecto.
3. Créalo. El rol nace sin permisos.
4. Marca los permisos en la matriz y pulsa Guardar permisos.

La matriz agrupa los permisos por módulo y muestra el código y la descripción de cada uno. Un rol de sistema aparece marcado como solo lectura: sus casillas están deshabilitadas. La lista lateral indica, por rol, cuántos permisos tiene y cuántas asignaciones existen — útil antes de eliminarlo.

Administración

Auditoría del sistema

El rastro de quién hizo qué, cuándo, desde dónde y con qué resultado. Registra mutaciones, autenticación y errores, siempre acotado a tu compañía.

Resumen de los últimos 7 días

Tres indicadores: eventos totales, eventos fallidos (resaltados si hay alguno) y el reparto por categoría.

Filtros y detalle

Se puede filtrar por categoría, resultado (éxito o fallo), entidad, texto libre (acción, ruta o correo) y rango de fechas. La tabla muestra fecha y hora, categoría, acción, usuario, entidad, código HTTP, estado, IP y duración en milisegundos; las filas fallidas se resaltan.

Al hacer clic en una fila se expande el detalle: ruta completa con el método, identificador de la petición, entidad e identificador afectados, user agent y la metadata en formato JSON. La paginación admite 25, 50 o 100 registros por página.

Administración

Alta de compañía

Crea una compañía nueva completa en un solo formulario de cuatro bloques. Es la vía asistida, la que usa el equipo de implantación.

Licencia inicial

• Tipo Demo → planes de 15, 30 o 60 días.
• Tipo Paga → planes mensual, semestral o anual.
• Asientos: número de usuarios, o la casilla de usuarios ilimitados.
• Funcionalidades: Pedidos, Compras, Pronóstico (IA), Copiloto (IA), Datos maestros y Parámetros DDMRP. Vienen todas activas y se desmarcan las que no apliquen.

Al crear, la pantalla confirma con el nombre y el NIT de la compañía y el correo del administrador, y ofrece crear otra.

Administración

Términos y condiciones (administración)

Gestión de las versiones del documento legal y del registro de firmas.

Ciclo de una versión

1. Nueva versión. Se crea como borrador, con su número de versión, título y contenido.
2. Editar. Mientras sea borrador, el texto se puede modificar o el borrador se puede eliminar.
3. Publicar. A partir de ese momento la versión es la vigente y todos los usuarios deben firmarla para poder escribir.

De las versiones ya publicadas solo se puede ver el texto. El botón de firmas abre el registro de aceptaciones: quién firmó, qué versión y cuándo.

Administración

Mi licencia

El estado del licenciamiento de tu propia compañía y, cuando está habilitado, el camino para ampliarlo o renovarlo sin pasar por ventas.

Lo que muestra

• Una franja con el estado (verde si está activa, roja si está en solo lectura).
• Cinco tarjetas: tipo (demo o paga), plan, fecha de vencimiento, días restantes y asientos.
• Las funcionalidades habilitadas por la licencia.

Prueba piloto de 3 meses

Si tu operación supera las 10 tiendas, puede aparecer la oferta de activar una prueba de tres meses sin costo, con hasta 10 tiendas y todas las funcionalidades. No pide tarjeta y se activa una sola vez.

Pagar o renovar

Cuando el módulo de pagos está habilitado para tu compañía:

1. Elige la duración del plan.
2. Elige la forma de pago entre los proveedores disponibles.
3. Compara los planes. Cada tarjeta muestra la cobertura y el precio.
4. Pulsa Pagar este plan. Te redirige al proveedor y, al volver, la pantalla informa si el pago se aplicó.

Si el módulo de pagos no está habilitado, la pantalla simplemente indica que para ampliar o renovar hay que contactar al proveedor.

Plataforma

Licencias

Pantalla del proveedor (HardSupply), no del cliente: emite, renueva y suspende las licencias de todas las empresas.

El listado muestra cada compañía con su NIT, estado, plan, fecha de vencimiento y asientos. Al gestionar una, el panel lateral permite:

Las acciones disponibles son emitir o guardar cambios, renovar por el término elegido, suspender (deja a la compañía en solo lectura), reactivar una suspendida o cancelada y cancelar de forma definitiva.

Plataforma

Alta autogestionada

El camino por el que una empresa se da de alta sola, sin intervención del equipo de implantación. Corre en un servicio aparte y termina entregando una compañía operativa.

Registro

1. La empresa se registra y acepta los términos de la plataforma, que se muestran antes de crear la cuenta.
2. Recibe un correo y verifica la cuenta. Si no llega, se puede reenviar.
3. Al activarse, se emite un token de sesión del asistente y empieza el recorrido guiado.

Pasos del asistente

En todo momento hay un progreso con la lista de verificación y el porcentaje completado, y una pantalla de licencia que confirma con qué plan queda la compañía. Los endpoints de cada paso están en el explorador OpenAPI, bajo el servicio Onboarding.

API y servicios

Arquitectura y Swagger

Micaela expone su funcionalidad como API REST documentada con OpenAPI 3. Son tres servicios desacoplados, cada uno con su propia especificación y su propia interfaz Swagger.

Los tres servicios

Los tres montan sus rutas bajo el prefijo global /api, con la excepción de /health, que responde sin prefijo para las sondas de disponibilidad.

API y servicios

Autenticación y multi-tenencia

El flujo de token

1. Obtén el token con POST /api/auth/login, enviando correo y contraseña.
2. Envíalo en cada petición como Authorization: Bearer <token>.
3. Renuévalo con POST /api/auth/refresh antes de que expire.

En Swagger UI se autoriza una sola vez con el botón Authorize, pegando el token del paso 1; la sesión queda persistida entre recargas de la página.

curl -s http://localhost:3000/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"...","password":"..."}'

curl -s http://localhost:3000/api/products \
  -H "Authorization: Bearer $TOKEN"

Aislamiento por compañía

Todos los endpoints filtran automáticamente por la compañía del token: no hace falta — ni se permite — pasar el identificador de compañía a mano. El alcance geográfico del usuario acota además qué tiendas ve dentro de esa compañía.

Dos particularidades

• Onboarding. Sus pasos no se autorizan con JWT sino con la cabecera X-Onboarding-Session, el token de sesión del asistente que se emite al activar la cuenta. Es deliberado: la compañía todavía no existe cuando empieza el recorrido.
• Webhooks de pagos. No llevan token de usuario: los firma el proveedor de pago y el servicio valida esa firma.

API y servicios

Explorador OpenAPI

El contrato completo de los tres servicios, generado directamente del código. Elige el servicio, filtra por texto y despliega cualquier operación para ver sus parámetros, cuerpo y respuestas.

API y servicios

Regenerar el contrato

La especificación no se escribe a mano: se deriva de los controladores y los DTO. Cuando cambie el código, se vuelve a generar.

El backend trae el generador listo, y produce openapi.json sin necesidad de base de datos ni de levantar el servidor:

cd backend
npm run swagger:json     # → backend/openapi.json

Funciona porque arranca Nest en modo preview: construye el grafo de módulos y lee los metadatos de rutas y DTO, pero no instancia los proveedores ni ejecuta los hooks de ciclo de vida, así que el cliente de base de datos nunca intenta conectarse.

Con los servicios en ejecución, el contrato también se descarga en vivo:

curl -s http://localhost:3000/api/docs-json  -o backend-openapi.json
curl -s http://localhost:3200/api/docs-json  -o onboarding-openapi.json
curl -s http://localhost:3100/api/docs-json  -o payments-openapi.json

El archivo resultante se puede cargar en cualquier herramienta compatible con OpenAPI 3: Postman, Insomnia, Bruno, o un generador de clientes como openapi-generator.

Referencia

Roles predefinidos

Seis roles vienen de fábrica. Tres son genéricos y tres están pensados para la estructura territorial del retail. Todos se pueden usar como plantilla para crear roles propios.

Referencia

Catálogo de permisos

Los permisos son de cuatro tipos. Entender la diferencia ayuda a diagnosticar por qué alguien no ve o no puede hacer algo.

Acciones más usadas

Licencia y permisos: dos filtros encadenados

Para que puedas hacer algo se tienen que cumplir las dos condiciones: que tu rol tenga el permiso y que la funcionalidad esté incluida en la licencia. Cada funcionalidad licenciable agrupa un conjunto de permisos:

Lo que no está en ninguna funcionalidad es núcleo y está siempre disponible: inicio, administración, lecturas de catálogo. Y en modo solo lectura se conservan las lecturas — ver pantallas y consultar datos — y caen todas las escrituras.

Referencia

Solución de problemas

Los síntomas más habituales y qué hacer con cada uno.