Monitorización de lineales en un mapa vivo de la tienda: stock y cadena de frío

Los equipos de tienda ya recogen los datos: recuentos cíclicos con terminal, sondas de nevera, lecturas de pórticos RFID, la ronda matinal del jefe de sección. Lo que rara vez tienen es un lugar donde todo eso se sitúe sobre la propia tienda. Esta guía recorre nuestra demo Retail Mart Store —tres plantas, escaleras mecánicas y ascensores, cuatro capas en vivo— y explica cómo montar lo mismo en tus tiendas.

Una rotura de stock es un problema de ubicación antes que de inventario. El ERP sabe que el artículo está a cero; el reponedor necesita saber qué estantería, qué pasillo, qué planta. Las listas se ordenan por artículo o por valor; la tienda se ordena por geografía. Cuando cada estantería muestra su nivel de llenado y cada sección está teñida según su estado, el responsable de turno lee toda la planta de un vistazo y va directo al rojo.

Esa es la idea de monitorizar lineales sobre un mapa: tus recuentos y sensores se quedan donde están, y tienen dónde aterrizar. Spatial Map no sustituye a tu WMS, ERP ni a tu lógica de reposición. Vincula sus cifras a formas y posiciones del plano, actualiza los mapas abiertos cuando cambia una tabla y permite que cualquiera con un enlace compartido vea la misma imagen en el navegador. La solución retail muestra cómo la usan tiendas, supermercados y centros comerciales.

Retail Mart Store en el visor con todas las capas activas

Todo empieza por la geometría. Coloca el plano de la tienda en el editor —un PDF se escala a partir del tamaño de la hoja, un dibujo DWG o DXF se muestra como imagen de plano y también sirve un PNG o JPG— y dibuja encima. En la demo cada nivel (Ground, Level 1, Level 2) tiene su plano, conectado por escaleras mecánicas y ascensores que se ven en 3D, y el selector de planta del visor permite pasar de uno a otro.

• Estanterías y góndolas: se dibujan con la herramienta Rack; en la demo, los marcadores de stock se sitúan en la posición de cada estantería.
• Secciones: se dibujan como áreas (Bakery, Dairy, Frozen Food, Fresh Produce, Electronics & Appliances…) para que su estado tiña el suelo.
• Neveras y congeladores: las sondas que los miden se colocan donde están de verdad.
• Lectores RFID: un marcador o un área por lector o pórtico, para que su estado pulse donde está.
• Escaleras mecánicas, ascensores y escaleras: conectan las plantas en 3D. Las rutas de orientación se quedan en una planta y muestran dónde cambiar de nivel.

Retail Mart Store en el editor

La demo combina cuatro enlaces de datos. Quien consulta el mapa los activa o desactiva en el panel Layers, de modo que el técnico de frío puede ocultar el stock y el responsable de reposición, las temperaturas.

El estado de las secciones es donde brilla Color a shape: una sección es un área grande y teñirla da una lectura de tienda que un marcador de estantería no ofrece. Los colores vienen de las reglas de estilo. Escribes una regla una vez en el panel Style rules del editor —condición status = Critical, relleno rojo— y la marcas en cada enlace que deba usarla. Las reglas se evalúan de arriba abajo y gana la primera que coincide. La demo usa tres para las secciones (Critical en rojo, Low en ámbar, Healthy en verde) y tres para los lectores (Offline en rojo, Idle en gris, Active en violeta).

La cadena de frío en tienda tiene otro ritmo que en un centro de distribución: murales abiertos repartidos por la sala, puertas que los clientes abren todo el día y un congelador de trastienda que importa tanto como los de delante. La demo tiene siete sondas: dos en los murales de Dairy (consigna 3 °C) y cinco en los congeladores de Frozen Food (consigna −18 °C). Cada registro incluye la lectura, la consigna, la humedad, el nivel de batería, las aperturas de puerta del día y la hora de la última lectura.

Los umbrales son reglas de estilo sobre la lectura. Las reglas pueden combinar condiciones (All match (AND)), así que una regla puede decir «congelador por encima de −15 °C» y otra «mural por encima de 5 °C». Ordena primero las más urgentes:

• Un marcador por sonda, situado en el mueble que mide, no en la pasarela.
• Reglas distintas para refrigerado y congelado, porque un solo umbral no sirve para ambos. Usa tus propios límites de seguridad alimentaria; los valores de arriba son ejemplos.
• Un informe Cold-Chain Sensors con cada sonda y su última lectura, junto al mapa.
• Historial por fila, para que «¿cuándo empezó a calentarse la isla de congelado 1?» tenga una respuesta con fecha y hora.

La forma más sencilla de llevar recuentos y lecturas al mapa es una tabla. Defines el esquema —texto, números, booleanos, fechas y más— y Spatial Map genera una API REST para ella. Las apps de recuento, una pasarela IoT o un script nocturno escriben filas con una clave de API. Si tus datos ya están detrás de un endpoint HTTP, la tabla puede consultar esa URL de forma programada.

1. 1
   Crea la tabla

   Tables → Create new table. Elige el tipo (Marker / POI o Sensor para sondas, Polygon / area para secciones) y añade campos como rack_name, department, units_on_hand, capacity_units y status. Cada fila se identifica con una clave estable; el código de estantería funciona bien.

2. 2
   Crea una clave de API

   Abre la pestaña API & access de la tabla y crea una clave por sistema. Cada clave solo puede escribir en esa tabla y se puede revocar sin afectar a las demás.

3. 3
   Añade un enlace de datos

   En el editor, Data → Manage data links → New link: elige la tabla, un modo de visualización (Live location marker para estanterías y sondas, Color a shape para secciones) e indica cómo encontrar el lugar de cada registro: coordenadas o un campo comparado con los nombres de las formas.

4. 4
   Añade las reglas

   Escribe una vez las reglas correcto / bajo / crítico en el panel Style rules y márcalas en el enlace. Pon primero la más urgente para que gane.

curl -X POST https://app.spatialmap.io/api/v1/public/tables/rows \
  -H "Authorization: Bearer sgv_tbl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "entityKey": "G-A10-85",
    "payload": {
      "rack_name": "A10",
      "department": "Grocery Section",
      "floor": "Ground",
      "units_on_hand": 1314,
      "capacity_units": 1728,
      "fill_label": "76%",
      "status": "OK",
      "lat": 33.78801,
      "lng": -117.97911
    }
  }'

El endpoint es un upsert: enviar de nuevo el mismo entityKey actualiza la fila en lugar de duplicarla, y cada escritura queda en el historial de la fila. Para un recuento completo de la tienda, POST /rows/bulk admite hasta 1.000 filas por petición. Cada clave está limitada a 60 peticiones por minuto, así que agrupa las escrituras en lugar de enviar una llamada por lectura.

El mapa responde «dónde»; los informes, «cuánto y desde cuándo». La tienda de demostración tiene un informe por tabla —Shelf Stock (daily count), Department Stock (daily count), RFID Reader Reads y Cold-Chain Sensors— y además RFID Live Map, un informe de mapa completo con la lista de lectores a la izquierda, la tienda en vivo en el centro y KPI y gráficos alrededor.

• Informes de recuento diario: KPI, tablas y gráficos, filtrados por sección o planta.
• Informe de cadena de frío: cada sonda con su última lectura, consigna y estado.
• Exportaciones: PDF y Excel para auditorías, además de CSV y JSON, y un PNG por gráfico.
• Historial: abre cualquier estantería o sonda en el visor y su historial por fila muestra cada cambio y qué cambió.

Informe RFID Live Map

Puedes reconstruirlo en una tarde: coloca un plano, dibuja secciones y estanterías, crea una tabla y envía unas filas. Empieza una prueba gratuita de 7 días —sin tarjeta, hasta 5 instalaciones— y usa la plantilla Retail de Solutions para agrupar la tienda con sus informes y datos. Pro cuesta 60 $/mes o 600 $/año para hasta 4 instalaciones (precios); la página de la solución retail muestra la visión completa.