Inducción de repartidores v1.6 y guía de bolsillo v1.2 (guía de redacción)
Adapta los dos documentos publicados de «Inducción de repartidores» a la guía de redacción de manuales (v1.3) y corrige lo que no coincidía con CORE master (0a5442f4).
- Manual de capacitación v1.5 → v1.6. Control automático: 122 E → 0 E (64 R).
- Guía de bolsillo v1.1 → v1.2. Control automático: 9 E → 0 E (5 R).
- Se sacan los
.mdde v1.5 y v1.1. Quedan sus PDF.fuente/se regeneró conpublicar_lote.py, y la fila de cada documento se actualizó enREADME.mdy enfuente/README.md.
Qué cambió
Formato
- Una sección por tarea, con «Dónde:», «Quién:» (los permisos que exige el código, con su nombre literal) y «Cómo queda:».
- Avisos «Tené en cuenta» y «Desde acá no se puede».
- Remisiones por título, nunca por número de capítulo.
- «oficina» → «administración» y «teléfono» (el aparato) → «celular».
- La portada lleva «VALE DESDE: Cualquier versión» y «VERIFICADO: 12/11/2026», y «R105 · app 1.12.1».
- «Qué hago si…» pasa a ser «Si algo no sale», con tablas «Lo que pasa | Qué hacer», justo antes del historial.
Lo que ya explica otro manual se resume y remite
- «Solicitudes desde la app de reparto»
- «Incidentes en la app de reparto»
- «Comprobantes y facturas por WhatsApp»
- «Control de playa sobre rutas futuras»
- «Hojas de ruta»
- «App del repartidor»
- «Integración SIRO»
- «Domicilio completo en la tarjeta del cliente»
- «Envases»
- «Dispensers y servicio técnico»
En el capítulo de incidentes ya no se repiten adjuntar, editar ni cerrar.
Correcciones de contenido (lo que la v1.5 afirmaba y no es así en master)
Control de playa
- Si te equivocaste, la v1.5 decía que quien lo aprobó «lo corrija en la web». Corregirlo lo deja «Pendiente» hasta que se apruebe de nuevo, y tampoco se cambia la hoja, el reparto, la fecha ni el tipo. Hacen falta «Buscar controles», «Modificar control» y «Nuevo control».
- La aprobación desde la app puede fallar y dejar el control «Pendiente» sin aviso.
- Si se cerró la ruta sin cargar la entrada, se puede cargar con «Control de playa — ruta futura» (fecha de hoy, «Entrada»).
Desbloqueo
- El botón «Desbloquear» con código sigue funcionando: sirve sin señal. La v1.5 decía que ya no se usaba.
- Generar el código pide «Hojas de Rutas», «Hoja de ruta» y «Desactivar bloqueo de alerta».
Solicitudes
- Un pedido o un servicio técnico repetido para el mismo día puede quedar rechazado. Solo se suman a uno abierto los atajos de cobranza, recupero y revisión de cuenta.
Cierre de ruta en la app
- Son tres controles: suma «Facturas sin registrar».
- Las solicitudes rechazadas no se reintentan solas.
- La diferencia de cheques, retenciones y tarjetas no queda registrada: no viaja a la administración.
Envases, cobros y devoluciones
- El bloqueo también impide cargar envases.
- El QR de Mercado Pago depende del centro de facturación.
- Los talonarios son los del reparto, no los del móvil.
- Una devolución sin cambio directo genera nota de crédito o ajuste, por lo que se puede vincular a una venta, y en los retornables baja los envases del cliente.
Servicio técnico
- Las validaciones de dispensers rigen solo con el motivo «Exitoso».
- Con «Ausente» y un servicio técnico pendiente, el cliente queda marcado ausente aunque se conteste «No».
Permisos
- «Stock en Ruta» pide «Hojas de Rutas» y, antes de «Consolidando», «Todas las liquidaciones». La v1.5 nombraba solo el segundo.
- Corregir una visita desde «Consolidando» pide «Editar venta». Para cambiar la cobranza pide además «Home», «Ver recibos», «Crear recibos» y «Nuevo cheque».
- Finalizar sin permiso da «Operación no permitida por seguridad. Consulte con el administrador», no «error desconocido».
- Los gastos desde la web piden también «Home».
Cierre del reparto y liquidación
- Después de un error de cierre, la hoja queda en «Reparto finalizado». La v1.5 decía «Consolidando».
- Por defecto el cierre es en dos pasos, con «Cerrar reparto» y el permiso «Imputar ventas».
- En el PDF, la diferencia de efectivo sale con el signo invertido respecto de la pantalla; la v1.5 decía «sin signo». La caja del PDF muestra solo las tarjetas de débito.
- Los avisos de «Transacciones» llevan sus textos literales. La etiqueta «Tiene recibos de cobros sin visitas» marca en realidad cobros de ausentes; los recibos sin visita están en el cuadro «Recibos sin visitas».
- Columna «Usado en ST» en artículos.
- Los estados «Descargada» y «En reparto».
Otros
- El contador «Pendientes» no coincide con el filtro.
- Un pedido de un cliente que ya estaba en la hoja conserva su orden.
- Definiciones más precisas de «Proximo bloqueo», «Bloqueado» y «Facturas Vencidas».
Guía de bolsillo v1.2
- Portada corta.
- Columna «Quién» en los pasos del día.
- Paso 7, «Cerrar reparto», para las empresas que cierran en dos pasos.
- «Si algo no sale» con las 6 consultas más frecuentes del manual, historial y aviso de soporte.
Decisiones donde la guía no prevé este tipo de documento
- Orden por jornada: se mantiene el orden del día de trabajo (antes de salir, en cada cliente, al volver, en la PC). La guía lo pide para los manuales básicos y es lo natural en uno de capacitación.
- Glosario y «Otras funciones y definiciones»: quedan como secciones de referencia.
- Cuestionario de evaluación (29 preguntas): se mantiene. Pasa a dos tablas («Preguntas…» y «Respuestas…»), porque con pasos numerados el control lo toma como tarea. Las respuestas se corrigieron con los mismos hechos que el cuerpo.
- Guía de bolsillo: la guía no prevé guías cortas. Lleva lo mínimo que pide (portada con los campos obligatorios, «Si algo no sale», historial y aviso) y el «Quién» como columna, para no perder el formato de una página. La portada no fuerza un salto de página.
- «tu empresa»: quedan 21 avisos R por «tu empresa». En un manual que le habla al repartidor se mantuvo, en lugar de «cada empresa».
Vigencia
«VALE DESDE: Cualquier versión». Cada sección con algo posterior a cabfebcd lo marca en su primer párrafo. Todos los commits son merges a master y ancestros de 0a67f948 (actualización de octubre 2026), comprobado con git merge-base --is-ancestor. Entre 0a67f948 y master no hay cambios en lo que describe el manual, así que nada va como «Sin actualización publicada».
| Commit | Qué describe |
|---|---|
01d4c37d |
Control de playa: «Tu usuario no tiene permiso…», «No pudimos confirmar si el control se guardó» |
abc3adc6 |
Firma siempre en el control de ruta futura |
4727ae1c |
La contraseña se tipea siempre |
1b9a3c48 |
«Solicitar», megáfono, solicitudes en «No Sync» y al cerrar la ruta |
feaf7a94 |
«Para qué día» y aviso de pedido o servicio técnico ya abierto |
86fc2c18 |
«Localidad» en el cambio de domicilio |
6e1984c0 |
Comprobantes por WhatsApp, constancia del QR de SIRO, «Cuenta Cte», «Factura sin enviar», comprobante de servicio técnico, «Facturas sin registrar» |
ee0efefa |
Adjuntos en el chat de incidentes |
da38e570 |
Ventana «Incidentes», «Ver Incidentes (N sin leer)», globo de la tarjeta |
d023271b |
Domicilio completo en la tarjeta |
66cbac2b |
Estados «Descargada» y «En reparto» |
b8366a7b |
Un pago con QR de SIRO no es un cobro duplicado |
34694c85 |
Columna «Usado en ST» de la liquidación |
9ee0165b, que es el «VALE DESDE» de «Comprobantes y facturas por WhatsApp», no toca la app; para lo de la app se usa 6e1984c0. Este manual no está en actualizaciones.json: queda como «Cualquier versión».
Cómo se verificó
-
Contra el código de
master0a5442f4: cinco revisiones de solo lectura, una por grupo de capítulos, que contrastaron cada afirmación, mensaje y permiso conarchivo:línea. Los nombres visibles de los permisos salen deOpcionesMenu. -
Revisión externa (Codex, gpt-6.1-sol, high), dos vueltas:
- Primera vuelta: 20 hallazgos. Se verificaron en el código y se corrigieron 19. El 20 (los mensajes en las tablas) también, entre «».
- Segunda vuelta, sobre lo corregido: 10 hallazgos de gravedad media o baja, todos corregidos («Nuevo cheque», alcance de los repartos en ruta futura, solicitudes de otro usuario, «Usado en ST» en artículos, crédito de la devolución, atribución y ubicación de las marcas, columna «Quién» y paso «Cerrar reparto» en la guía, mensaje completo).
- Sin hallazgos de gravedad alta en la segunda vuelta, así que no hubo tercera.
-
Controles:
-
lint-manual.py: 0 E en los dos documentos. -
verificar-fuente.py: 34 generadores, 38 documentos, 0 problemas. - Las 122 rutas de
<img>existen. - Cada remisión “…” existe en este manual o en el que nombra.
-
git merge-treecontramain: sin conflictos.
-
- Capturas: se revisaron las 121 en hojas de contacto, y los epígrafes se reescribieron mirándolas. Todas son del entorno de demostración, con datos ficticios.
Qué NO se verificó
- Nada se recorrió en pantalla: todo se contrastó leyendo el código.
-
Capturas viejas, sin recapturar: son de la app 1.10.0 a 1.12.1, y el texto describe la 1.12.1. En particular:
-
02-config-clavemuestra «Version 1.10.0». - Las de los capítulos 2 a 14 y 16 a 18 son de la 1.11.0 a 1.11.8.
- No hay captura del aviso «Facturas sin registrar», del control de playa corregido ni de «Cerrar reparto».
-
- Formulario de «Alta Temprana de Cliente»: no se pudo verificar. La app lo abre en otra aplicación que no está en el repositorio de CORE. El manual lo describe en general y remite a «App del repartidor».
-
Buscador del asistente: no se probó la lectura por sección con la v1.6. El clon
C:\SWS\claude\manualesque usa el buscador está atrasado (indexa la v1.4 de este manual): hay que actualizarlo para esa prueba.
Contradicciones con otros manuales publicados (no se editaron)
-
«Hojas de ruta» v1.4
- Junta «Hay recibos sin visitas» con la etiqueta «Tiene recibos de cobros sin visitas», que en realidad marca cobros de clientes ausentes.
- Su tabla de permisos no incluye «Gastos de repartos» ni «Nuevo gasto de reparto», ni lo que piden los dos PDF y «Remitos».
-
«App del repartidor» v1.1
- §6 da «Hoja de ruta no descargada» para un celular sin hoja; el código da «No Database selected».
- §4 dice «Stock en Ruta» = «Hojas de Rutas», sin «Todas las liquidaciones».
- «Desbloquear un cliente en la app» no nombra «Hoja de ruta».
-
«Control de coordenadas de clientes» v1.1, §7: describe la pantalla «Tomar coordenadas» de una app 1.13.0 que no está en
master(1.12.1). - La propia v1.5 de este manual decía que el desbloqueo con código ya no se usaba, en contra de «App del repartidor». Queda resuelto a favor de «App del repartidor».
FAQ de clientes (guía §13)
controlar-manuales.py --rama origin/docs/induccion-v1.6:
- Contra el FAQ de
main, 11 artículos salían ROTA por los títulos renombrados. - Con support!26: 0 ROTA, 9 CAMBIÓ.
Los 18 artículos que declaran este manual se contrastaron con la v1.6: sin contradicciones de fondo. Además se buscaron otros artículos del tema con git grep y con el buscador del asistente: tres ubicaban «Finalizar reparto» «en la liquidación» (está en «Transacciones») y otros tres pedían una precisión (permisos del desbloqueo, «Todas las liquidaciones», el signo en el PDF). Todo eso se corrige en support!26. Los artículos se sellan después del merge de este MR.
Origen de las filas de «Si algo no sale»
- Las de la v1.5 («Qué hago si…»), que salieron de tickets y del relevamiento original.
- Dudas anticipadas a partir de las correcciones de esta versión: control de playa enviado con error, solicitud rechazada por repetida, «Stock en Ruta» sin permiso, facturas sin registrar al cerrar. Se revisan cuando haya consultas reales.