Ingresa tu código personal para ver tus clientes y comisiones.
Comparte este enlace con nuevos clientes. Al abrirlo, tu código queda adjunto a su primer pedido.
| Ventana | Pedidos | Cajas | Ingresos | Prom/Pedido |
|---|
Elige tu punto de partida. La ruta se reordenará para minimizar la distancia total.
STALE_DAYS en la parte superior del script.
REP-JUAN-042).
Úsalo en el enlace de referido ?ref=REP-.... El primer pedido de un
cliente nuevo que use el enlace queda permanentemente asignado a ese vendedor.
Guía completa del proceso, desde que el cliente hace un pedido hasta que el camión regresa al almacén. Cada sección del panel tiene su propia responsabilidad — usa esta página como referencia rápida.
El cliente entra a la tienda desde su celular, elige la cantidad de cajas, llena su nombre/teléfono/dirección, arrastra el pin 📍 a su ubicación exacta de entrega y toca Confirmar. El pedido aparece instantáneamente en Pedidos con estado Nuevo y un badge rojo pulsando en la barra lateral.
Los pedidos que tienen pin marcado muestran una etiqueta verde 📍 pin — el conductor los navega por coordenadas (mucho más confiable que direcciones escritas).
En Pedidos, cada tarjeta Nueva tiene un botón ✓ Confirmar. Al tocarlo, el pedido pasa a estado Confirmado (acknowledged) y queda listo para rutear.
En Pedidos, mientras el pedido esté en estado Nuevo o Confirmado, toca ✏️ Editar. Puedes cambiar cantidad (el precio se recalcula automáticamente según el nivel), teléfono (+507, se formatea XXXX-XXXX) y dirección.
Una vez que el pedido entra a Rutas, ya no se puede editar.
En Pedidos, toca el botón 🗑️ Cancelar en la tarjeta. Aparece un modal que pide la razón:
La razón se guarda en el perfil del cliente para futura referencia.
Ve a Rutas. Cada pedido confirmado se agrega automáticamente. Usa las flechas ▲ / ▼ en cada parada para subirla o bajarla en la secuencia, toca Abrir ruta en Google Maps para ver el recorrido, y toca Confirmar ruta cuando esté lista. Esto activa la sección Carga.
El cargador abre Carga en el celular. Ve los pedidos en orden de entrega, carga físicamente las cajas y toca 🚚 Cargar en camión en cada uno. Cuando todos están cargados, aparece "✓ Ruta completa cargada" y se activa Entregas.
El conductor abre Entregas. Cada parada muestra dirección (toca para abrir mapas), teléfono (toca para llamar) y un stepper −/+ para ajustar la cantidad entregada. Al llegar, toca Marcar entregada. El pedido pasa a Completados.
En Entregas, baja la cantidad con el botón − antes de marcar entregado. La diferencia se guarda como devolución (returnedQty). El pedido se marca como Completado por lo que sí se entregó, y las cajas que regresan se registran automáticamente en Pedidos → Devoluciones para que bodega sepa qué va a volver.
El pedido original en Completados muestra una etiqueta naranja Dev N indicando cuántas cajas se devolvieron.
Vive dentro de Pedidos, debajo de la lista de pendientes. Rastrea todas las cajas que van de regreso a bodega en tres fases:
Arriba verás 4 tiles-resumen: En camino · Quitadas · Pendientes · Total de cajas. Cada fila tiene un botón ✓ Recibido en bodega.
Al tocar Recibido, aparece un toast con Deshacer por si fue un error — la reversión es inmediata. Confirmaciones recientes (últimas 24h) quedan visibles en verde como comprobante.
En Entregas, el botón ↩️ Quitar del camión marca el pedido como Devuelto (cancelado en camino) — estado terminal. El pedido:
Ejemplo: cliente llama cuando el camión ya salió y cancela. Toca "Quitar del camión" → el pedido queda registrado como devuelto, las 10 cajas aparecen en Devoluciones. Cuando el camión vuelve, bodega toca "✓ Recibido en bodega" y queda cerrado.
Ve a Precios. Puedes editar el precio base (fallback para casos extremos) y los niveles por volumen (ej. 1–2 cajas $15, 3–6 cajas $14.50, 7+ cajas $14). Los cambios son en vivo — la tienda del cliente se actualiza al instante.
Los pedidos archivados siguen contando en todas las estadísticas (Dashboard, top clientes, historial), pero desaparecen de la lista default de Completados para reducir el ruido.
Archiva uno por uno con el botón 🗄️ Archivar en la tarjeta, o en masa desde Ajustes → botón para archivar completados anteriores a 90 días.
Para verlos, ve a Completados → filtro Archivados.
Ve a Clientes → subtab Reactivar. Muestra todas las tiendas que no han reordenado en 7+ días, con días de ausencia y botones directos de llamada/WhatsApp. Úsala como lista de seguimiento semanal.
Sí. Todo (pedidos, clientes, precios) se guarda en Firebase Firestore y se sincroniza en tiempo real entre todos los dispositivos abiertos. Un cambio en la tableta del almacén se ve al instante en el celular del conductor.
Ve a Ajustes → sección Contraseña de Administrador. Además hay una Contraseña de Borrado separada, requerida solo para borrar todos los pedidos (doble protección).
Ve a Ajustes → Datos. Hay tres opciones, todas pedidas por la contraseña de borrado (distinta de la de admin):
Ninguna acción toca precios, contraseñas ni ajustes. No se pueden deshacer.
Ve a 📦 Inventario en la barra lateral. La pantalla muestra tres tiles:
Para actualizar el total, usa los botones rápidos (+25/+50/+100/+200/+500) cuando llega un camión de reposición, o el formulario manual para registrar merma, daño, ajuste o recuento físico (fijar a un valor exacto).
Cuando el disponible cae debajo del umbral de inventario bajo, aparece una alerta amarilla y un signo ❗ en la barra lateral.
Todo cambio queda registrado en el Historial de Movimientos (últimos 20).
Por default NO. El panel está en modo informativo — te muestra el estado real pero permite que entren pedidos aunque no haya stock. Esto sirve para que empieces a poner cajas en el sistema sin que la tienda se rompa.
Cuando estés listo, ve a Inventario → Configuración y enciende el interruptor "Bloquear pedidos que excedan el inventario". A partir de ese momento, si un cliente intenta pedir más cajas de las disponibles, el pedido será rechazado con un mensaje amigable pidiéndole reducir la cantidad.
Puedes apagarlo de nuevo en cualquier momento.
Las cajas se descuentan automáticamente cuando el pedido sale en camión. En la práctica, esto pasa cuando el cargador toca 🚚 Cargar en camión en la sección Carga (o cuando se mueve a En Camión desde Pedidos). Las cajas físicas ya no están en bodega — están en el camión rumbo al cliente.
Si se hace una devolución (parcial en entrega, o cancelación con cajas que regresan), las cajas vuelven al inventario en el momento que bodega toca ✓ Recibido en bodega en la pantalla de Devoluciones. Si se toca Deshacer, también se revierte el ingreso.
El descuento es idempotente: aunque cambies de estado y vuelvas, una caja solo se descuenta o se devuelve una vez por pedido.
Al inicio de cada día (medianoche, hora Panamá), el sistema toma una foto de cuántas cajas tienes en bodega — eso es tu "inicio del día". Cuando consumes 80% de ese stock (vendido en camión − devuelto), aparece una banda roja en la pantalla de Inventario y un signo ❗ en la barra lateral. Es la señal de que toca hacer un pedido grande de reposición antes de que te quedes sin nada.
El umbral del 80% es ajustable en el código (state.inventory.safetyPct), por default es 0.80.
Es una proyección en vivo: cuántas cajas te van a quedar cuando se despachen todos los pedidos que ya tienes confirmados / ruteados / en camión. Tres estados:
Indican acciones pendientes: