Ajustes de Mercado

Esta página es para el encargado que administra la app de catálogo Mercado. Aquí defines el almacén y la lista de precios por defecto, qué módulos se ven, cómo se muestra la marca en el encabezado, la visibilidad de costos, y activas o apagas herramientas como el Showroom y el buscador de protectores compatibles.

Todo esto se hace dentro de la app de Mercado, en el menú Configuración (ruta /settings). No hace falta entrar al Escritorio.

Importante — quién puede editar: sólo los managers (Sales Manager) pueden cambiar estos ajustes. Un Sales User entra a la pantalla pero la ve en solo lectura, con un aviso ámbar: "Solo lectura — pide a un Sales Manager que cambie estos valores." Los campos aparecen en gris y el botón Guardar está deshabilitado.

Nota: cada sección tiene su propio botón Guardar, para que un guardado parcial no pise cambios de otra sección. Guarda sección por sección.

1. Visibilidad y precios

Controla qué listas de precios y qué almacén usa la app por defecto.

Abre Configuración y despliega Visibilidad y precios.
Ajusta:
- Lista de precios principal (default_price_list): la Price List que se muestra primero en cada ítem. Elige "— sin definir —" para no fijar ninguna.
- Almacén principal (default_warehouse): el almacén que usa la app. Elige "— usar Stock Settings —" para caer al almacén por defecto de Stock Settings.
- Listas secundarias: marca las listas de precios adicionales que quieres mostrar además de la principal (la principal se excluye sola). Si no marcas ninguna, se muestran todas las listas de venta (Selling) habilitadas.
- Umbral stock bajo (low_stock_threshold): los ítems con existencia entre 1 y este valor se marcan como "stock bajo" en el tablero. Por defecto 3.
- TTL caché (s) (cache_ttl_seconds): tiempo de vida de la caché de búsquedas. Por defecto 300. Es informativo/de ajuste fino; súbelo si el catálogo es muy grande y quieres menos recargas, bájalo si necesitas ver cambios más rápido.
Haz clic en Guardar. Verás "Guardado." al terminar.

[captura: sección "Visibilidad y precios" con los desplegables de lista principal y almacén]

Nota — precedencia de almacén y precios: este ajuste es el default del tenant (todo Mercado). Cada tienda (Mercado Shop) puede tener su propio Almacén por defecto y Lista de precios por defecto, que mandan para los usuarios de esa tienda. Si el almacén principal de aquí queda vacío, se usa el de Stock Settings. En resumen: tienda > tenant (esta pantalla) > Stock Settings.

2. Experiencia

Mostrar costo y margen solo a Sales Manager (show_cost_to_managers_only): activado (por defecto), sólo los managers ven costo y margen; los vendedores no. Desactívalo si quieres que todo el equipo vea esos números.

Ajústalo y haz clic en Guardar.

Nota: este toggle es de negocio, no de seguridad de datos sensibles del sistema. Aun así, ayuda a que los vendedores no divulguen márgenes al cliente.

3. Módulos (activar u ocultar secciones)

Aquí decides qué módulos aparecen en el menú de la app, por sitio.

Despliega Módulos.
Activa o desactiva cada módulo:
- Dashboard (Tablero) (enable_dashboard)
- Ventas en vivo (enable_ventas_en_vivo)
- Ventas a crédito (enable_financiamiento)
- Liquidaciones (enable_liquidaciones) — reconcilia ventas financiadas; normalmente se activa junto con Ventas a crédito.
- Conteo cíclico (enable_conteo)
- Inventarios (enable_inventarios)
- Caja chica (enable_caja_chica)
- Contabilidad (enable_contabilidad)
- Empleados (revisión) (enable_empleados)
- Etiquetas (enable_etiquetas)
- Showroom (enable_showroom)
- Protectores · por modelo (enable_protector_matcher) — apagado por defecto.
- Ubicaciones (cajones) (enable_ubicaciones) — apagado por defecto en Mercado.
Haz clic en Guardar.

[captura: sección "Módulos" con la rejilla de casillas]

Importante — qué hace apagar un módulo: apagado = el módulo se oculta del menú y se bloquea por URL (si alguien escribe la ruta a mano, lo redirige a Panorama). Panorama, Catálogo, Pagos pendientes y Configuración siempre están activos y no se pueden apagar.

Nota: el menú se actualiza sin recargar cuando guardas; la barra lateral y la navegación inferior reaccionan al instante al cambio de banderas.

Notas por módulo

Protectores · por modelo (enable_protector_matcher): apagado = no se muestra el menú 🛡 Protectores ni el botón en la ficha del ítem. Encendido = el buscador queda disponible (ver sección 6).
Ubicaciones (cajones) (enable_ubicaciones): apagado = Mercado no muestra el panel "Está en…" ni el sugeridor. En el taller esta función siempre está activa; en Mercado es opcional.

4. Proveedores de crédito (se gestionan en Desk)

Las fórmulas de liquidación y bono, los adjuntos requeridos y el alta/baja de proveedores de crédito (Payjoy, Paguitos…) no se editan en esta pantalla. La sección Proveedores de crédito sólo te da un botón:

Abrir Credit Provider en Desk ↗ — te lleva al doctype Credit Provider en el Escritorio, que trae su propio probador de fórmulas.

Nota: esto es intencional: la autoría de fórmulas es delicada y se hace en el Escritorio, no en la app.

5. Marca (encabezado de la app)

Controla cómo se presenta el catálogo en pantalla (distinto del branding de tickets, que está en Doco Business Settings).

Despliega Marca.
Ajusta:
- Nombre comercial (tenant_name_display): el texto del encabezado de la app. Por defecto Mercado Doco. Si lo dejas vacío se usa "Mercado".
- URL del logotipo (tenant_logo): la ruta del logo, por ejemplo /files/logo.png.
Haz clic en Guardar.

Nota: aquí capturas la URL del logo (por ejemplo un archivo ya subido a /files/...). Es distinto del logo por tienda (campo Logo en Mercado Shop) y del membrete impreso.

6. Buscador de protectores compatibles (matcher)

El matcher de protectores busca, a partir del dispositivo, las micas/protectores con dimensiones similares. Se activa con el toggle Protectores · por modelo de la sección Módulos (sección 3). Por defecto está apagado.

Cómo funciona para el operador (menú 🛡 Protectores, ruta /protectores):

Busca Por código (item code del dispositivo) o Por modelo (texto libre como "iPhone 14").
Ajusta la Tolerancia (± mm, por defecto 0.5) con el deslizador; ábrela cuando la búsqueda estricta no arroje resultados.
Obtiene una lista ordenada por puntaje de protectores compatibles (incluye los que no hay en existencia, para poder cotizar).
Vota 👍 Sí queda / 👎 No queda para alimentar la confianza del matcher.

De dónde salen los datos del matcher

Para que el matcher funcione, cada ítem necesita sus dimensiones registradas. Eso vive en el doctype Mercado Display Spec (Escritorio), no en esta pantalla. Cada Display Spec lleva, entre otros:

Ítem (único), Es protector / mica (marca si el ítem es candidato o es el dispositivo a proteger), Universal.
Ancho (mm) y Alto (mm) (obligatorios; son las medidas críticas, tolerancia ±0.5 mm por defecto).
Radio de esquinas, Curvatura (Flat/2.5D/Edge/Waterfall), Tipo de notch (None/Centered/Off-center/Punch-hole/Dynamic Island) y medidas del notch.
Fuente de las medidas (ej. "GSMArena 2024-03", "medición física").

Los votos de los operadores se guardan en Mercado Protector Compatibility, que calcula la confianza como confirmados / (confirmados + rechazados) por protector.

Nota: si al operador le falta un dispositivo en la base, el propio buscador ofrece el enlace "Crear Display Spec en Desk →". Registrar buenas medidas (de fuente confiable o medición física) es lo que hace útil al matcher; con medidas malas, sugiere protectores que no quedan.

[captura: buscador de protectores con la lista de resultados y los botones de voto]

7. Política de conteo por tienda

Si eres manager y tienes varias tiendas, verás la sección plegable Política de conteo por tienda. Permite que una tienda anule la política global del Cycle Count Plan.

Por cada tienda:

Lee la línea de política efectiva actual (por ejemplo "ciego ≥ $500 · evidencia hv_only · override de tienda").
Marca Anular plan para que manden los valores de la tienda.
Ajusta:
- Conteo ciego (todos).
- Umbral alto valor ($).
- Evidencia fotográfica: Opcional, Obligatoria · alto valor, o Obligatoria · AV + re-conteo.
Haz clic en Guardar de esa tienda.

Nota: apagado = la tienda hereda del Cycle Count Plan global (que se edita en el Escritorio). Encendido = estos valores mandan para las tareas de esa tienda. Es el mismo override que aparece en el formulario de Mercado Shop.

8. Solución de problemas

"Solo lectura": tu usuario no es Sales Manager. Pide que te den el rol o que un manager haga el cambio.
Un módulo sigue apareciendo tras apagarlo: revisa que hayas hecho clic en Guardar de la sección Módulos. El menú se actualiza al guardar; si dudas, recarga con F5.
El almacén "no cambia" en una tienda: recuerda que la tienda (Mercado Shop) tiene su propio almacén por defecto que gana sobre este ajuste global.
No aparece el menú 🛡 Protectores: el toggle Protectores · por modelo está apagado, o el usuario no ve la sección; actívalo en Módulos.

Manual