Sistema de gestión de entregas para mensajería

El problema

• El despacho funciona con llamadas, WhatsApp y una pizarra, así que nadie tiene una vista única de qué repartidor tiene capacidad: los trabajos se asignan por duplicado o se caen, y un pedido urgente no encuentra al repartidor disponible más cercano.
• La prueba de entrega vive en hojas de ruta de papel o en la galería personal del móvil de un repartidor, así que cuando un cliente disputa 'nunca lo recibimos' no hay firma, foto ni GPS que sacar y el cargo se da por perdido.
• Los primeros intentos fallidos —habitualmente entre el 8% y el 20% de las entregas de última milla, con los errores de dirección solos como causa de cerca del 45%— se convierten sin ruido en costos de reentrega (unos 17,78 dólares por paquete fallido) sin motivo de excepción registrado y sin reintento programado.
• Fugas de facturación: el tiempo de espera, las paradas extra, el horario nocturno y los recargos por kilometraje nunca pasan de la memoria del repartidor a la factura, y cada cliente tiene una tarifa distinta, así que el mismo recorrido se factura de forma inconsistente.

Un día con el sistema

1. Una cuenta de cliente reserva una recogida en el día desde tu portal (o el despacho registra un pedido telefónico): direcciones de recogida y entrega, ventanas horarias, número de piezas y nivel de servicio; el trabajo aterriza como 'sin asignar' en el tablero.
2. El despacho lo asigna al repartidor disponible más cercano cuya zona y vehículo encajen; el trabajo aparece en el móvil de ese repartidor en orden de parada, por delante de su trabajo posterior si es urgente.
3. El repartidor toca 'en ruta a la recogida', llega, confirma las piezas y marca 'recogido' con una marca de tiempo; el seguimiento del cliente pasa a recogido automáticamente.
4. En la entrega, el repartidor captura una firma, una foto del paquete en la puerta y el GPS; el trabajo pasa a 'entregado' y la prueba de entrega se guarda contra esa parada, sin poder editarse después.
5. En la siguiente entrega no hay nadie en casa: el repartidor registra la excepción recipient_not_home, hace una foto de la puerta cerrada y el trabajo pasa a 'fallido'; el sistema pone en cola un reintento y avisa al cliente en lugar de tragarse el costo en silencio.
6. A media tarde entra un pedido urgente; el despacho lo coloca al principio de la cola del repartidor disponible más cercano sin rebarajar todo a mano.
7. El tiempo de espera en un muelle de carga y una parada añadida se adjuntan al trabajo como recargos mientras el recorrido sigue fresco, así que de verdad llegan a la factura.
8. Al cierre del período, los trabajos entregados se agregan por cliente sobre su tarifa en una factura con cada prueba de entrega adjunta, lista para enviar según sus condiciones de pago.

Dónde falla la IA

• Tratar una entrega como una sola dirección: un trabajo de mensajería es una recogida Y una entrega (a veces una recogida y muchas entregas), cada una con su propia ventana horaria y su propia prueba. Aplánalo a una única 'dirección de entrega' y pierdes la marca de tiempo de recogida, las rutas de varias paradas y la prueba de entrega por parada.
• La prueba de entrega como un extra prescindible: la firma, la foto con marca de tiempo, el GPS y el nombre de quien recibe son la evidencia que gana los contracargos y las disputas por no entrega. La captura debe estar ligada a la parada y la hora reales y no debe poder editarse después, o no vale nada en el momento en que un cliente afirma que el paquete nunca llegó.
• Solo 'entregado' frente a 'no entregado': sin una taxonomía explícita de excepciones la app no puede distinguir destinatario ausente de dirección incorrecta de rechazado, no puede disparar el reintento correcto y no puede facturar ni condonar bien. Modela exception_code como un campo de primera clase, no como una nota de texto libre.
• La trampa de la clasificación laboral: si tus repartidores son contratistas independientes 1099, dictar sus rutas, horas y métodos exactos es uno de los factores que pueden reclasificarlos como empleados y exponerte a salarios atrasados, impuestos y multas. Guarda worker_type y mantén más suaves los controles de cara al contratista: esto es exposición regulatoria real, no una preferencia de interfaz. No es asesoría legal; consulta la prueba de tu jurisdicción.
• Un precio único por trabajo: el mismo recorrido se factura distinto según el contrato del cliente, y el tiempo de espera, las paradas extra, el horario nocturno y los recargos por kilometraje son donde está el margen. Un único quoted_price sin recargos y sin tarifa por cliente subfactura en silencio cada día ajetreado.

Preguntas frecuentes

¿En qué se diferencia un trabajo de mensajería de una sola dirección de entrega?

Un trabajo de mensajería es una recogida y una entrega —y a veces una recogida con muchas entregas—, cada una con su propio contacto, ventana horaria y prueba. La app modela la recogida y la entrega como paradas distintas del trabajo, así conservas la marca de tiempo de recogida, puedes construir rutas de varias paradas y adjuntar la prueba de entrega a la parada exacta donde ocurrió, en lugar de a una única 'dirección de entrega' plana.

¿Qué cuenta como prueba de entrega válida y se sostiene en una disputa?

Una prueba de entrega electrónica sólida combina la firma del destinatario, una foto con marca de tiempo del paquete en el punto de entrega, coordenadas GPS, el nombre de quien recibe y cualquier nota del repartidor, todo capturado en el dispositivo del repartidor en el momento de la entrega. Como la app liga cada uno de esos elementos a una parada y una hora concretas y no permite editarlos después, la evidencia existe antes que la disputa: que es justo lo que resuelve a tu favor un contracargo de 'nunca lo recibimos'.

¿Qué pasa cuando una entrega falla en el primer intento?

El repartidor registra una excepción explícita —destinatario ausente, dirección incorrecta, rechazado, acceso denegado— y hace una foto. El trabajo pasa a 'fallido', la app pone en cola un reintento y avisa al cliente automáticamente. Como los primeros intentos fallidos suelen rondar entre el 8% y el 20% de las entregas de última milla a unos 17,78 dólares cada uno, capturar el motivo es lo que te deja reentregar, refacturar o condonar de forma deliberada en lugar de absorber el costo a ciegas.

¿Puedo dar a los clientes su propio seguimiento y facturar a cada uno con su propia tarifa?

Sí. Cada cliente tiene una tarifa y condiciones de pago, los recargos se adjuntan a los trabajos individuales y los trabajos entregados se agregan en una factura por cliente con cada prueba de entrega adjunta. Puedes correr todo como un portal de cara al cliente más un back office de despacho en tu propio dominio, alojado en ybuild: los clientes siguen sus propios trabajos por el flujo de estados mientras tu equipo trabaja el tablero de despacho, todo en un solo sistema que de verdad es tuyo.

Mis repartidores son contratistas 1099, ¿esta app creará un problema de clasificación?

La app guarda worker_type en cada repartidor y está construida para que documentes las entregas sin controlar de más cómo trabajan los contratistas. La clasificación depende en gran parte de cuánto controlas la ruta, las horas y los métodos: dictar los tres empuja a un contratista hacia el estatus de empleado. Mantén los controles que aplicas a los repartidores 1099 más ligeros que los que aplicas a los empleados y trata esto como una cuestión de diseño operativo, no como un interruptor de configuración. Esto es orientación general, no asesoría legal: consulta la prueba de estatus laboral de tu jurisdicción.