Configurar la rotación de conteo (gerente)

El conteo cíclico funciona con un generador automático que cada mañana crea las tareas del día: decide quién cuenta, en qué almacén y qué artículos. Tú no armas las tareas a mano (aunque puedes, ver §5); las gobiernas configurando dos cosas:

El Plan de conteo (Mercado Cycle Count Plan): un único registro global con toda la cadencia y las políticas.
Los Contadores (Mercado Cycle Count Worker): una ficha por empleado que dice a qué almacenes y grupos de artículos lo asignas.

Importante: la autoría de la rotación (crear/editar Plan y Contadores) se hace en Desk, no en la app de mercado. La app solo muestra un resumen de solo lectura ("Programación automática") y permite asignar/reasignar tareas puntuales. Esto es a propósito: la configuración recurrente es delicada y vive donde hay control de cambios.

Para editar, necesitas rol Sales Manager o System Manager.

1. El Plan de conteo (configuración global)

Abre en Desk: Mercado Cycle Count Plan (o desde la app, en la tarjeta Programación automática, el botón Editar en Desk ↗). Es un registro único (singleton): lo que configures aquí aplica a toda la operación.

Está dividido en secciones. Reviso cada campo con su valor por omisión y por qué existe.

General

Sistema activo (enabled, por omisión apagado): interruptor maestro. Apagado, el generador diario no corre para nadie. Enciéndelo cuando ya tengas al menos un contador configurado.
Saltar fines de semana (weekend_skip, por omisión encendido): sábado y domingo no se generan tareas.
Conteo ciego (todos los ítems) (blind_count, apagado): el contador no ve la cantidad del sistema mientras la tarea sigue abierta — tiene que contar de verdad. El servidor decide si cuadra o difiere. Los gerentes siempre ven todo.
Umbral alto valor (ciego por ítem) (hv_blind_threshold, 0 = apagado): los artículos cuyo costo (del snapshot) sea mayor o igual a este monto se cuentan a ciegas aunque el conteo ciego global esté apagado. Sirve para forzar rigor solo en lo caro (celulares, por ejemplo). Además marca esos ítems como "alto valor" para la política de evidencia.
Evidencia fotográfica obligatoria (proof_policy, por omisión off):
- off: la foto siempre es opcional.
- hv_only: los ítems de alto valor (≥ umbral) no se pueden enviar sin foto.
- hv_and_recheck: alto valor y las filas de re-conteo cruzado requieren foto.

Cuotas

Items por usuario por día (target_daily_count_per_user, 30): cuánto cuenta cada persona al día, repartido entre todos sus almacenes.
Items por almacén por día (target_daily_count_per_warehouse, 30): tope por tarea (una tarea = un usuario + un almacén).
Intervalo del conteo completo (días) (full_count_interval_days, 120): garantía de cobertura. Un artículo que no se haya auditado en este plazo regresa al pool con prioridad alta. Es lo que asegura que todo el inventario pase por conteo al menos cada N días, no solo lo que sale seguido.

Nota — cómo se reparte la cuota: si un contador tiene 30 ítems/día y 3 almacenes asignados, el generador divide esos 30 entre los 3. Un almacén con Cuota diaria (opcional) propia usa ese número en vez del reparto. Así balanceas a alguien que cubre varias bodegas sin saturarlo.

Priorización

Modo de priorización (prioritization_mode, por omisión flagged_first): con qué criterio se llena el lote diario.
- cycle_only (Rotación): solo el ciclo regular, por antigüedad de última auditoría.
- flagged_first (Alertados primero): primero lo vencido y lo alertado, luego la rotación normal.
- high_turnover (Alta rotación): prioriza lo que más se ha vendido en 90 días.
- high_value (Alto valor): prioriza por valor en stock (cantidad × costo).
Cuota máxima para alertados (%) (flagged_quota_cap_percent, 50): tope al porcentaje de una tarea que pueden ocupar ítems alertados. Evita que una avalancha de alertas ahogue la rotación normal (starvation).

Snapshot y ventana de observación

Hora de generación de tareas (task_generation_time, 05:00:00): hora local a la que el generador crea las tareas del día.
Ventana de observación (minutos) (snapshot_observation_window_minutes, 240 = 4 h): si el conteo se registra más de N minutos después del snapshot, la app muestra una alerta de "desfase" (drift) y lo marca en el registro. Un desfase grande significa que el conteo se comparó contra un stock ya viejo.

Doble verificación

Requerir 2 observadores en alertados (double_check_flagged_items, encendido): un ítem alertado o con discrepancia necesita que dos personas distintas coincidan antes de poder generar un ajuste automático. (Como gerente estás exento: tu verificación cuenta como el segundo control.)
Re-muestreo de coincidentes (%) (recheck_sample_percent, 15): parte de la cuota diaria se llena con ítems que otro empleado ya marcó como "cuadra" en los últimos días. Es un control de calidad: detecta a quien cuenta distinto que sus compañeros. 0 lo apaga.
Ventana de re-muestreo (días) (recheck_lookback_days, 30): qué tan atrás mira para armar ese lote de re-muestreo.

Re-conteo de pendientes

Re-conteo de discrepancias (días) (discrepancy_followup_days, 15): cuando cierras una tarea con discrepancias sin verificar, esos artículos vuelven al pool en N días.
Re-conteo de alertados (días) (flagged_followup_days, 7): igual, pero para alertas; plazo más corto porque suelen ser problemas activos.

Generación de Stock Entry (ajuste)

Stock Entry automático en discrepancias verificadas (auto_create_stock_entry_on_verified_discrepancy, apagado): si lo apagas, las discrepancias verificadas esperan tu aprobación manual. Si lo enciendes, verificar una discrepancia ajusta el stock al instante.
Fecha contable del Stock Entry (stock_entry_date_basis, por omisión today): today (día en que reconcilias, más seguro) u observation_date (día en que se contó, que puede caer en un periodo contable cerrado).
Bloquear Stock Entry si dejaría negativo (negative_stock_block_auto_entry, encendido): si el ajuste dejaría el Bin en negativo, no se crea automático y pasa a tu revisión.

Retención

Retención del audit log (meses) (audit_log_retention_months, 18): filas del registro de auditoría más viejas que esto se purgan por un trabajo diario. 0 = no purgar nunca.

Reglas por grupo de ítems

Tabla Group Rules (group_rules) para tratar grupos completos distinto:

Tratamiento = Excluir: el grupo sale de la rotación (típico: cajas de liquidación que la cámara ya cubre). Aun así puedes dejar un Spot-check (ítems por tarea) (por omisión 2): "siempre revisar un par", trae N artículos aleatorios del grupo aunque esté excluido.
Tratamiento = Prioritario: el grupo rota ~3× más seguido (lo que el cliente toca todo el día).

Advertencia: el Plan valida sus números al guardar. No aceptará cuotas negativas, un Intervalo del conteo completo de 0 o menos, ni un Cuota máxima para alertados fuera de 0–100. Si te marca error al guardar, revisa esos campos.

2. Los Contadores (a quién asignas)

Abre en Desk: Mercado Cycle Count Worker. Crea una ficha por empleado que vaya a contar. El generador recorre estas fichas cada mañana.

Campos de la ficha

Usuario (user, obligatorio, único): el empleado. Una ficha por usuario.
Tienda (shop): tienda principal del contador. Define su ámbito de permisos y todos sus almacenes deben pertenecer a esta tienda.
Activo (enabled, encendido): apágalo para que el generador ignore a este contador sin borrar su configuración. Útil para bajas temporales sin perder el setup.
Cuota diaria personalizada (daily_quota_override): si la pones, manda sobre la cuota global del plan. Ideal para medio tiempo.
Pausado hasta (disabled_until): vacaciones o incapacidad. Mientras la fecha de hoy sea anterior a esta fecha, el generador salta a este contador. Se limpia sola una vez pasada.

Almacenes asignados (obligatorio)

Tabla Almacenes (warehouses): al menos uno. El generador crea una tarea por cada almacén de la lista. Cada renglón admite una Cuota diaria (opcional) propia que anula el reparto por omisión para ese almacén.

Advertencia: la ficha valida que cada almacén pertenezca a la tienda del contador. Si intentas asignar un almacén de otra tienda, marcará: "Almacén X pertenece a otra tienda (Y), no a Z." También rechaza almacenes duplicados en la lista. Esto evita conteos cruzados entre tiendas.

Grupos de ítems (alcance, opcional)

Tabla Item Groups (item_groups) para limitar qué cuenta cada persona. Vacío = todos los grupos.

Modo = Incluir solo: el contador solo cuenta esos grupos. Ejemplo: un técnico que solo cuenta displays y baterías.
Modo = Excluir: nunca le tocan esos grupos. Ejemplo: el de mostrador nunca cuenta refacciones.

Si combinas filas Incluir solo con filas Excluir, las de Excluir se restan de la lista incluida. Incluye subgrupos automáticamente.

[captura: ficha de un Mercado Cycle Count Worker en Desk, mostrando Usuario, Tienda, la tabla de Almacenes con dos renglones y una regla de grupo]

3. Cómo arma el generador las tareas (para que confíes en él)

Vale la pena entender la lógica, porque explica por qué a veces "no salió tarea":

Corre una vez al día a la hora configurada. Si el Sistema activo está apagado, o es fin de semana con Saltar fines de semana encendido, no hace nada.
Recorre cada contador activo y no pausado.
Reparte su cuota diaria entre sus almacenes.
Por cada almacén, selecciona los artículos según el modo de priorización, respetando el tope de alertados, el re-muestreo y las reglas por grupo.
Fotografía (snapshot) la cantidad y el costo de cada artículo en ese momento — ese es el número contra el que se compara el conteo, y queda congelado.
Crea la tarea en estado asignada.

Protecciones que conviene conocer:

Una sola tarea por (usuario, almacén, día). Si ya existe una, no crea otra. Por eso una asignación manual de hoy hace que la generación automática excluya ese almacén para ese usuario.
Si un almacén falla (un Bin corrupto, por ejemplo), se revierte solo ese almacén y el resto de la generación continúa.
Si no hay artículos elegibles en un almacén con el modo elegido, simplemente no genera tarea ahí ese día.

Nota: el snapshot es la clave de todo. Una vez tomado, la cantidad esperada, el costo, el Bin y la hora no cambian — ni siquiera el sistema los puede reescribir a mitad de la tarea. Esto protege el registro: sabes exactamente contra qué número se contó, aunque el artículo se renombre o se venda después.

4. El resumen en la app (solo lectura)

En Conteo de inventario → Mi cola, como gerente ves la tarjeta Programación automática con un vistazo del plan vigente: si está activa o apagada, la hora de generación, ítems por persona, el modo, el intervalo de ciclo completo, el % de re-muestreo, y chips de las políticas activas (sin fines de semana, doble verificación, 🙈 conteo ciego, 🙈 alto valor ≥ $X, 📷 evidencia). Es un espejo de solo lectura; para cambiar algo, el botón Editar en Desk ↗.

5. Asignar o reasignar una tarea puntual (sin esperar al generador)

A veces necesitas un conteo hoy mismo, fuera de la rotación. Desde la app:

En Conteo de inventario, botón Asignar tarea (arriba a la derecha).
Elige Responsable (solo aparecen contadores habilitados de tus tiendas).
Elige Almacén (solo los que cubre ese contador).
Elige Método de selección: Alertados primero, Rotación, Alto valor o Alta rotación.
Ajusta la Cantidad de ítems con el deslizador (5 a 60).
Presiona Previsualizar lista para ver exactamente qué artículos caerían, con su nombre, código, cantidad en sistema y el motivo por el que entró cada uno. Nada se crea todavía.
Si te convence, Crear y asignar.

La selección la hace el mismo motor del generador diario, bajo el mismo candado por almacén — así una asignación manual no choca con la generación automática ni duplica trabajo. La tarea queda marcada como manual:<tu-usuario> para la auditoría.

Nota: si ya existe una tarea de ese contador en ese almacén ese día, la creación falla con "Ya existe la tarea … ese día." La previsualización te avisa antes con un aviso ámbar.

Para reasignar una tarea abierta a otro contador, usa el ícono de reasignar en la pestaña Historial (ver la página Revisar y cerrar tareas).

Documentos relacionados: Revisar y cerrar tareas · Salud de inventario.

Manual