El Localizador responde a dos preguntas sobre tus propias tiendas: dónde está un producto y en qué orden recoger los artículos de un pedido en línea. Lo tienen las cuentas de establecimiento con el plan Localizador o Tienda Pro, también durante su piloto; la cuenta gratuita no lo incluye. Los planes y sus precios están en la página para supermercados, y no se cobra nada hasta que abran los planes de pago. Mientras el Localizador está desactivado, su página no aparece y sus operaciones de la API responden 404.
Dónde está un producto
Abre «Localizador», en el grupo «Acción en tienda» del menú. En «¿Dónde está?», elige una de tus tiendas y escribe el EAN, tu código de artículo o el nombre del producto, mejor con su marca. El EAN y tu código se buscan en el catálogo de tu cuenta: un ean o un code que no hayas vinculado no encuentra nada, salvo que envíes también el nombre. La respuesta dice siempre cómo encontró el producto («por código» o «por nombre»). Un nombre puede coincidir con varios productos: primero van los que mejor coinciden, cada uno con sus ubicaciones, la mejor primero:
- el pasillo, tal como lo señaliza la tienda («Pasillo 4»), y el lado, izquierda o derecha según se camina de la entrada al fondo;
- el tramo del pasillo: el tercio delantero, el central o el del fondo;
- la sección o la zona, con su nombre;
- el nivel: abajo, a la altura de la mano, a la altura de los ojos o arriba;
- la semana ISO (de lunes a domingo, hora peninsular) en que se vio por última vez, cuántas semanas hace y su frescura: «reciente», «algo antigua» o «antigua: compruébalo en el lineal»;
- «sin confirmar», cuando nuestro equipo ha marcado la ubicación porque alguien avisó de que el producto ya no está ahí (§7 de la política para establecimientos), hasta que un recorrido posterior de un mapeador lo vuelva a ver en ella o nuestro equipo quite la marca (los recorridos de tu propio equipo no la quitan);
- quién lo vio: los recorridos de los mapeadores o los de tu propio equipo.
Las ubicaciones confirmadas van primero, después las vistas más recientemente y después las más seguras. Si conocemos el producto pero no tiene ninguna ubicación vista en las últimas 26 semanas, la respuesta lo dice (not_seen), con la última semana en que se vio, si la hay; si nada de la tienda coincide, también lo dice (not_found): nunca adivina.
Lo que una respuesta nunca incluye
Ningún precio: tu tienda tiene los suyos, y los nuestros son los observados en una semana. Tampoco fotogramas, días ni quién recorrió la tienda. Las lecturas de los mapeadores llegan por semana ISO y solo de semanas cerradas; las de los recorridos de tu propio equipo cuentan desde el mismo día.
Ruta de preparación de pedidos
En la misma página, en «Ruta de preparación de pedidos», pega las líneas del pedido, una por línea: el EAN, tu código o el nombre del producto, y, si quieres, un punto y coma con la cantidad (; 2). Después pulsa «Calcular la ruta». La ruta va desde la entrada hasta las cajas siguiendo el plano publicado de la tienda, o el mapa privado de tu equipo cuando la tienda solo tiene ese. Cada parada indica su pasillo, su lado y su nivel, y las líneas que se recogen en ella; «Imprimir» la saca en papel. En «Líneas aparte» quedan las que no se pueden situar, con el motivo:
| Motivo | Qué significa |
|---|---|
not_found |
No coincide con nada de esta tienda |
not_seen |
El producto no tiene ninguna ubicación actual en esta tienda |
ambiguous |
Coinciden dos productos: escribe también la marca |
off_map |
Su ubicación no está en el plano que sigue la ruta, o no se puede llegar a ella |
Si la entrada del plano se midió, la ruta da los metros aproximados a pie; si no, el orden sigue igualmente los pasillos. No guardamos nada del pedido, y la ruta no cronometra ni clasifica a nadie: las condiciones prohíben usar los datos para vigilar, evaluar o sancionar al personal (cláusula 5.2(d) de las condiciones del visor para establecimientos).
Tus tiendas de un vistazo
En «Tus tiendas», la página muestra cada tienda de la cuenta con los productos que tienen ubicación actual («Con ubicación»), cuántos se han visto hace poco («Vistos hace poco»), la última semana con lecturas y de quién son: de los mapeadores, de tu equipo o de ambos. Así ves en qué tiendas son más débiles las respuestas.
Ningún plan envía mapeadores a una tienda ni fija cada cuánto se recorre. Para refrescar las respuestas de una tienda, tu equipo puede recorrerla con la app (recorridos del propio equipo), y su mapa privado responde desde ese día.
La API
Los sistemas de tu cadena pueden hacer las mismas consultas con una clave de API. La página enlaza «Claves de API del localizador»: las crea un administrador de la cuenta en «Ajustes de la cuenta» › «API», con un segundo factor acreditado hace poco (segundo factor). En una cuenta de establecimiento, una clave lleva locator:read y, si se los das, los permisos del catálogo para cargarlo; ninguna clave de una marca ni ningún asistente de IA llega a estas operaciones:
| Operación | Petición |
|---|---|
list_locator_stores |
GET /api/portal/v1/locator/stores |
locate_product |
POST /api/portal/v1/locator/lookups |
plan_picking_route |
POST /api/portal/v1/locator/routes |
Una ruta se pide con un cuerpo como este, para que el pedido nunca viaje en una dirección web:
{ "storeId": "…", "lines": [{ "id": "L1", "name": "…", "quantity": 2 }] }
Cada clave tiene su propio límite por minuto, más alto que el de una marca, porque la app o la web de la tienda atiende a sus clientes. La cuenta comparte las filas diarias de la API (500.000 filas al día), y cada respuesta cuenta lo que da (sus tiendas, sus ubicaciones, o sus paradas y líneas aparte), como mínimo una fila. Una tienda que no es de la cuenta responde 404. La referencia de la API describe cada campo y sus límites, y claves de API, permisos y errores explica cada error.
Qué puedes mostrar a tus clientes
Mientras tu plan incluya el Localizador, la cláusula 3.7 de las condiciones del visor para establecimientos te permite mostrar a tus clientes, en tu app, tu web y las pantallas de tus tiendas, las ubicaciones que da el Localizador, como lo observado en la semana indicada y nunca como una garantía. Nunca fotogramas, precios, datos de otras tiendas ni nuestros datos en bloque. Ese permiso termina con el plan. Guarda las claves en secreto, en tus servidores y nunca en una página web; úsalas solo desde tus sistemas y revoca cualquiera que se filtre.
commercetools, Salesforce Commerce Cloud, VTEX
Una tienda en línea muestra dónde está un producto en la tienda elegida por su cliente llamando a locate_product desde sus servidores, con el EAN o tu código: en commercetools, desde una extensión de su API o el servidor de la tienda; en Salesforce Commerce Cloud, desde un servicio de su Service Framework; en VTEX, desde el servidor de una aplicación IO. Guarda cada respuesta una semana.