Marketplace
El marketplace es una vitrina pública para una comunidad (un residencial, un condominio, un barrio). Los negocios publican sus productos desde la app Búho Lite, tú apruebas cada tienda, y los vecinos encuentran los productos y les escriben por WhatsApp.
No es una tienda en línea: no hay pagos, stock ni comisiones, y el marketplace nunca registra una venta. El precio final y la entrega se acuerdan en el chat entre el vecino y la tienda.
Antes de empezar
- El marketplace debe estar habilitado en el servidor: en el archivo
.envvaENABLE_MARKETPLACE=true. Si no ves Marketplace en el menú lateral, falta este paso. - Si eres un administrador creado por un reseller, necesitas que te den acceso al módulo Marketplace en Administradores.
- Las tiendas se publican desde la app móvil Búho Lite (opción Activar marketplace). Desde este panel no se crean tiendas.
Para entrar, haz clic en Marketplace en el menú lateral.
- Estado: Publicado si el público puede verlo; Apagado si no. Haz clic en él para ir a Ajustes.
- Ver el marketplace: Abre la página pública en otra pestaña, tal como la ven los vecinos.
- Pestañas: Tiendas, Denuncias, Categorías y Ajustes. El número junto a Tiendas son las tiendas que esperan aprobación; el de Denuncias, las denuncias abiertas.
1. Configura y publica el marketplace
Empieza por la pestaña Ajustes.
- Interruptor del marketplace: Actívalo para publicarlo. Si lo apagas, los vecinos ven una página de "no disponible" y las apps reciben un aviso. No se pierde ningún dato: al encenderlo vuelve todo como estaba.
- Nombre de la comunidad: Por ejemplo, Residencial Los Álamos. Se muestra en la cabecera, el titular y el pie del marketplace.
- Titular de la portada y Remate destacado: La frase grande de la portada. El remate se pinta en rosa y cursiva; debajo ves cómo queda. Si dejas los dos vacíos, la portada no muestra titular.
- Saludo de WhatsApp: El texto con el que empieza el mensaje que recibe la tienda, uno para un producto y otro para un pedido de varios productos.
- Bloqueo automático por denuncias: Cuando un producto llega a este número de denuncias, se retira solo. Con 0 se desactiva.
- Umbral del ranking: Cuántos vecinos distintos deben recomendar una tienda para que muestre su número de recomendaciones y suba en el orden Más recomendados. Con 0 se desactiva.
- Motivos de denuncia: La lista que eligen los vecinos al denunciar. Con Añadir agregas uno; con la x, lo quitas.
- Guardar ajustes: Guarda los cambios.
En la misma pestaña también ajustas el Título y la Descripción para Google (SEO), los Productos por página, el Máximo de productos por tienda y el Símbolo de moneda de los precios.
Nota
Si tienes términos y condiciones activos en Configuración → Términos, el marketplace y la app muestran el enlace. Si no, el aviso amarillo te lo recuerda y el enlace no aparece.
2. Aprueba las tiendas
Cuando un negocio activa el marketplace en su app, llega a la pestaña Tiendas como Pendiente. Sus productos no se ven hasta que lo apruebes.
- Flecha: Despliega el catálogo de la tienda para revisarlo antes de aprobarla.
- Estado: Pendiente, Aprobada, Rechazada o Deshabilitada. Si la tienda se ocultó desde su app, verás además Oculta por la tienda.
- Denuncias: Cuántas denuncias acumula la tienda.
- Recomendaciones: Cuántos vecinos distintos recomendaron algo de la tienda. Aquí ves el número exacto.
- Menú de acciones (⋮): Aprobar, rechazar, deshabilitar y las demás acciones de la tienda.
Para revisar el catálogo, haz clic en la flecha:
- Bloquear: Retira ese producto del marketplace sin afectar al resto de la tienda.
- Ver todo el catálogo: Abre el catálogo completo, con búsqueda y filtros de productos activos, bloqueados e inactivos.
Si todo está bien, abre el menú de acciones (⋮) y elige Aprobar. Desde ese momento sus productos aparecen en el marketplace.
Si algo no cuadra, elige Rechazar y escribe el motivo (por ejemplo, "Sube fotos reales de tus productos"). La tienda lee el motivo en su app.
Consejo
La aprobación es solo para la primera vez. Después, los cambios que la tienda haga en su catálogo se publican al instante. Si una tienda aprobada deja de cumplir las reglas, elige Deshabilitar en su menú; también te pide un motivo.
En el menú de acciones de cada tienda también tienes:
- Contactos (N) — CSV: Descarga la lista de vecinos que pidieron el contacto de la tienda (nombre, WhatsApp, fecha e IP). Te sirve como evidencia ante una denuncia.
- Restablecer credencial: Para cuando la tienda cambió o perdió su celular. En su próxima sincronización, la app recibe una credencial nueva.
- Ver página pública: Abre la página de la tienda en el marketplace.
- Revisado: …: Aparece cuando hay una alerta de seguridad (por ejemplo, Cambió su WhatsApp). La alerta se muestra como una etiqueta amarilla en la columna Estado; después de revisarla, márcala como revisada.
3. Atiende las denuncias
Los vecinos pueden denunciar un producto o una tienda desde el marketplace. Las denuncias llegan a la pestaña Denuncias.
- Denunciado: El producto (con su código y su tienda) o la tienda denunciada.
- Motivo: El que eligió el vecino de la lista de Ajustes.
- Acumuladas: Cuántas denuncias suma ese producto o esa tienda.
- Menú de acciones (⋮):
- Bloquear producto: Te pide el motivo y retira el producto.
- Desbloquear producto: Lo vuelve a publicar.
- Deshabilitar tienda: Retira la tienda completa; te pide el motivo.
- Descartar: Cierra la denuncia sin hacer nada. La encuentras luego en Descartadas.
Advertencia
El bloqueo de un producto es permanente: aunque la tienda vuelva a sincronizar su catálogo, el producto bloqueado no regresa. Solo tú puedes desbloquearlo.
Consejo
Antes de bloquear, mira las recomendaciones de la tienda en la pestaña Tiendas. Un producto con muchas denuncias y también muchas recomendaciones suele ser una denuncia malintencionada, no un problema real.
4. Ordena las categorías
Las categorías salen de los productos que sincronizan las tiendas. En la pestaña Categorías ves cuántos productos tiene cada una y puedes:
- Renombrar: Corrige el nombre (por ejemplo, "abarrotes" → Abarrotes). Los enlaces que ya circulan siguen funcionando.
- Visible: Apaga el switch para ocultar la categoría de los filtros del marketplace.
Qué ven los vecinos
Con Ver el marketplace abres la portada pública.
- Buscador: Busca productos y tiendas mientras escribes, sin importar tildes ni mayúsculas. También busca por código.
- Productos y Tiendas: Cambia entre la lista de productos y la de tiendas. Más recomendados las ordena por recomendaciones.
- Categorías: Filtran los productos.
- Tarjeta del producto: Foto, nombre, precio (solo si la tienda decidió mostrarlo) y tienda. Los botones son recomendar (corazón), agregar al pedido (+) y WhatsApp.
Cada tienda tiene además su propia página, con un enlace para compartir por WhatsApp.
El contacto por WhatsApp
El número de WhatsApp de la tienda nunca se publica en la página. Cuando un vecino hace clic en WhatsApp, primero completa esta ventana:
- Tu nombre del vecino.
- Tu WhatsApp del vecino.
- No soy un robot: Una verificación que se resuelve en el navegador, sin servicios externos.
- Generar enlace de WhatsApp: Registra el contacto y abre el chat con la tienda, con el mensaje ya escrito.
Ese registro es el que descargas con Contactos (N) — CSV en la pestaña Tiendas.
Preguntas frecuentes
No veo Marketplace en el menú lateral.
Falta ENABLE_MARKETPLACE=true en el .env del servidor, o tu usuario no tiene acceso al módulo. Revisa Administradores.
Apagué el marketplace. ¿Se borraron las tiendas?
No. Apagarlo solo lo oculta a los vecinos y avisa a las apps. Al encenderlo, todo vuelve como estaba.
Una tienda cambió su nombre o sus productos. ¿Tengo que volver a aprobarla?
No. La aprobación es solo para la primera vez. Si una tienda aprobada cambia su número de WhatsApp, verás la alerta Cambió su WhatsApp en su fila.
¿El marketplace cobra comisión o registra las ventas?
No. Es solo una vitrina: la venta se acuerda por WhatsApp entre el vecino y la tienda.
¿Las tiendas pueden ocultar sus precios o su dirección?
Sí. Cada tienda decide en su app si muestra sus precios y su dirección exacta. Si no muestra la dirección, los vecinos ven solo una zona de referencia, como "Bloque 7, junto a la portería".