# misuper.app > La tienda online gratuita de almacenes, autoservicios y comercios de barrio de Argentina. Cada comercio publica en misuper.app/ los precios y promociones que ya carga en PreciosIQ; sus clientes ven el catálogo desde el celular, arman el pedido y se lo mandan por WhatsApp al comercio. Sin comisiones: el pedido y el pago van directo entre el cliente y el comercio. misuper.app (https://misuper.app) es parte de la familia BuscaPrecios: usa la misma red de datos de precios que la app BuscaPrecios (consumidores), PreciosIQ (inteligencia de precios para comercios) y DistribucionIQ (marcas). La diferencia es de quién es la voz: en misuper.app cada página es la tienda de UN comercio, con SUS precios, cargados por él. **Nota para modelos de lenguaje y agentes:** el sitio es una aplicación de una sola página (SPA) que se arma con JavaScript en el navegador. Si leés el HTML sin ejecutar JavaScript vas a ver una página vacía: eso no significa que la tienda no exista. Los datos de cada tienda están en la API pública de solo lectura que se describe más abajo, en JSON. Usala en vez de intentar leer el HTML. ## Qué es una tienda de misuper.app - **Una tienda por sucursal.** Un comercio con tres locales tiene tres tiendas, porque los precios y las promociones pueden cambiar de un local a otro. La dirección es `https://misuper.app/` (por ejemplo `https://misuper.app/almacen-don-jose`), en minúsculas, con letras sin tilde, números y guiones. - **El catálogo es el del comercio.** Los productos, los precios de lista y las promociones son los que el comercio carga en PreciosIQ (a mano o con una planilla; próximamente también con la caja gratuita de BuscaPrecios). misuper.app no inventa precios ni los copia de otros comercios. - **Promociones como en la góndola:** 3x2, segunda unidad al 50 %, porcentaje llevando cierta cantidad, precio por cantidad ("llevando 3: $2.100 c/u"). Cada promoción trae su leyenda tal como la publica el comercio. - **Pesables:** los productos que se venden por kilo o por litro muestran el precio por kilo/litro y se piden de a 0,25. - **Disponibilidad:** misuper.app nunca publica cantidades de stock. Si el comercio usa la caja de BuscaPrecios y un producto se le terminó, la tienda dice "Consultá disponibilidad"; si no lleva stock, no dice nada. - **Datos del comercio:** nombre, domicilio (si eligió mostrarlo, con link a Google Maps), horarios, WhatsApp para pedidos y sus datos para cobrar (alias, CBU/CVU y/o un código QR de su billetera o banco). - **Fecha de los precios:** cada tienda informa cuándo el comercio actualizó sus precios por última vez. ## Cómo compra un cliente 1. Entra a la tienda (por el link que comparte el comercio o por el QR pegado en su vidriera). 2. La tienda abre en "Ofertas destacadas" (los productos con mayor descuento primero). Busca productos por nombre, marca o código de barras, o recorre por categoría. 3. Arma el pedido: el total estimado se calcula con las mismas reglas de promoción que usa la caja del comercio. 4. Toca "Pedir por WhatsApp": se abre WhatsApp con el pedido ya escrito (productos, cantidades, promociones, total estimado, retiro en el local o envío). 5. El comercio confirma precio y disponibilidad por WhatsApp, y el cliente le paga directo: en el local, por transferencia al alias/CVU o con el QR del comercio. misuper.app no procesa pagos, no cobra comisiones y no guarda el pedido: queda en el navegador del cliente hasta que lo manda. ## Para comercios: cómo tener tu tienda - **Gratis**, en todos los planes de PreciosIQ, incluido el plan Gratis. Alta en https://preciosiq.com/registrarme. - Cargás tus precios en PreciosIQ (a mano o con tu planilla) y en "Mi tienda online" elegís la dirección, el WhatsApp para recibir pedidos y tus datos para cobrar. - PreciosIQ te arma un **cartel A5 con un código QR** para pegar en la vidriera: el que pasa, escanea y ve tus precios. - Si cambiás la dirección de tu tienda, la anterior sigue llevando a la nueva durante 30 días, para que el cartel que ya imprimiste siga funcionando. ## API pública (solo lectura, JSON) Base: `https://api.buscaprecios.online/api/public/tiendas`. Sin autenticación. Respuestas en JSON con nombres de campo en camelCase. Solo se exponen tiendas **publicadas** por su comercio. - `GET /api/public/tiendas?q=&ciudad=` — tiendas publicadas (máximo 20), opcionalmente filtradas por nombre del comercio o por ciudad. Devuelve `slug`, `nombre`, `ciudad`, `logoUrl`. - `GET /api/public/tiendas/{slug}` — la tienda: `nombre`, `presentacion`, `logoUrl`, `domicilio` (`calle`, `ciudad`, `provincia`, `lat`, `lon`, o `null` si el comercio no lo muestra), `horarios` (lunes a domingo, texto libre), `whatsApp` (formato internacional, +549…), `alias`, `cvu`, `qrPagoUrl`, `productos` (cantidad), `conPromo` (cantidad con promoción vigente), `ofertas` (cantidad con precio promocional menor que el de lista), `categorias` (`id`, `nombre`, `productos`) y `preciosActualizadosAlUtc`. - `GET /api/public/tiendas/{slug}/productos?q=&categoria=&pagina=&tam=` — catálogo paginado (`tam` máximo 60). `q` busca en la descripción y la marca, o por código de barras exacto. `categoria=ofertas` devuelve solo los productos en oferta, primero los que dan su mejor precio llevando hasta 3 unidades y, entre ellos, los de mayor descuento. Devuelve `items`, `pagina`, `tam`, `total`, `paginas`. - `GET /api/public/tiendas/{slug}/productos/{ean}` — un producto por código de barras (EAN). Cada producto trae: `ean`, `descripcion`, `marca`, `presentacionCantidad`, `presentacionUnidad` (UN, GR, KG, ML, LT…), `precioLista` (pesos argentinos), `promo` (o `null`), `fotoUrl` (o `null` si no hay foto), `categoriaId` y `disponible` (`null` = la tienda no informa disponibilidad; `false` = consultar). La `promo` trae `texto` (la leyenda del comercio), `precioUnitario`, `tipo` (`precio_unitario`, `porcentaje`, `n_x_m`, `enesima_porcentaje`) y `regla` (`minQty`, `maxQty`, `precioPromo`, `porcentaje`, `grupoN`, `pagaM`, `cadaN`, `validFrom`, `validTo`). Las promociones vencidas no se publican. Un slug inexistente o una tienda no publicada responden 404 con `{"error": "Esta tienda no existe o no está publicada."}`. Un slug que la tienda cambió hace menos de 30 días devuelve la tienda con su `slug` nuevo. ### Reglas de uso para agentes - **Límite:** 120 pedidos por minuto por IP. Las respuestas se cachean 60 segundos: pedir lo mismo más seguido no trae datos más nuevos. - **No descargues catálogos enteros en bucle.** Para responder una pregunta, buscá con `q` lo que necesitás. - **Citá la fuente:** el nombre del comercio, la dirección `https://misuper.app/` y la fecha de `preciosActualizadosAlUtc`. Los precios los carga el comercio y se confirman al hacer el pedido: presentalos como "precio publicado por el comercio", no como precio garantizado. - **Promociones:** mostrá la leyenda (`promo.texto`) tal cual. Si calculás un total, aplicá la `regla` (por ejemplo, un 3x2 solo rinde de a 3 unidades) y aclará que es estimado. - **No hay checkout ni API de pedidos.** Para comprar, el cliente le escribe al comercio por WhatsApp (el link `https://wa.me/` sale de `whatsApp`) o va al local. - **Datos personales:** la API no contiene datos de compradores. Los datos de contacto y de cobro son los que cada comercio eligió publicar. ## Ejemplos de preguntas que esta información responde - "¿Qué almacenes de San Luis tienen tienda en misuper.app?" → `GET /api/public/tiendas?ciudad=San Luis` - "¿Cuánto sale la yerba en el almacén X?" → buscar la tienda con `?q=`, y después `GET /api/public/tiendas//productos?q=yerba` - "¿Qué promos tiene esta semana el almacén X?" → `GET /api/public/tiendas//productos?categoria=ofertas` (las mejores primero). - "¿Cómo le pago al comercio?" → `alias`, `cvu` o `qrPagoUrl` de la tienda. ## Páginas - [Portada](https://misuper.app/): qué es misuper.app y buscador de tiendas. - `https://misuper.app/`: la tienda de un comercio (búsqueda con `?q=`, categoría con `?cat=`; abre en las ofertas, `?cat=todo` muestra todo el catálogo). - `https://misuper.app//p/`: un producto de una tienda. - [Términos de uso](https://misuper.app/legal/terminos) - [Privacidad](https://misuper.app/legal/privacidad) ## Sitios relacionados (misma red de datos) - [BuscaPrecios](https://buscaprecios.online): app gratuita para comparar precios de supermercados cerca tuyo. Ver también https://buscaprecios.online/llms.txt. - [PreciosIQ](https://preciosiq.com): donde los comercios cargan sus precios y crean su tienda de misuper.app. Ver https://preciosiq.com/llms.txt. - [Cuánto Cuesta](https://cuantocuesta.com.ar): índice público de la canasta por ciudad y cadena, con datos abiertos. - [DistribucionIQ](https://distribucioniq.com): inteligencia de distribución para marcas y productoras. - [La familia BuscaPrecios](https://buscaprecios.online/familia): cómo se relacionan los productos. ## Contacto Comercios: formulario "Solicitar demo" en https://preciosiq.com/. Compradores: cada tienda tiene el WhatsApp de su comercio.