Gestionar problemas de entrega
Delivery Failed informa que no se pudo completar un pedido asignado durante la fase del cliente. Es un cambio importante del estado del pedido, no una nota de soporte ni una vista previa. Que aparezca el control, se abra un modal, se muestre una imagen previa, se lea el GPS, cambie una tarjeta o se reciba un pedido actualizado no demuestra que se haya registrado el fallo ni que terminaran todos los efectos posteriores.
:::warning Delivery Failed puede cambiar el comportamiento del pedido y la asignación
La acción final Delivery Failed puede actualizar el pedido e iniciar trabajo de historial, motivo/comentario y rastro de ubicación, además de efectos de logística, cola, notificaciones, sockets, complementos y trabajos. No la selecciones para probar visibilidad, permisos, GPS, captura de imagen o documentación.
:::
Disponibilidad
El código actual de Driver App puede mostrar Delivery Failed en estados de la fase del cliente que aparezcan como pedido recogido, casi llegado al cliente, en camino o llegado al cliente. La visibilidad también depende de la presentación específica del proyecto, configuración del control de rechazo, estado de carga del pedido, conectividad y comprobación local de permisos.
Que aparezca el control no demuestra elegibilidad. La aplicación no aplica el control Driver may reject orders que se usa para la acción normal de rechazo de una solicitud. La titularidad de API, bloqueo del pedido, estado objetivo y otras validaciones siguen siendo independientes.
Abrir el formulario de fallo requiere la comprobación local de permisos de la aplicación y monta un hook GPS. El estado de Delivery Failed no está en la lista local de requisitos de ubicación del formulario, así que el modal no añade la ubicación candidata. Una ruta posterior del backend aún puede leer la ubicación Driver almacenada para un rastro de estado opcional.
Antes de comenzar
- Confirma que el pedido sea la entrega activa autorizada prevista y que un problema real impida completarla.
- Si tienes dudas, revisa con el despachador el estado de la fase del cliente y la asignación actual.
- Prepara un motivo veraz y comentario significativo. No uses espacios en blanco para satisfacer la comprobación débil del comentario.
- Si se requiere una imagen, captura solo la evidencia solicitada para este pedido.
- Espera a que termine cualquier estado de carga del pedido o proveedor.
Completar la tarea
- En los detalles de la entrega activa, selecciona Delivery Failed una sola vez.
- Si se abre Request permissions, detente y revisa el permiso antes de volver al pedido. Volver no demuestra que el permiso se haya concedido ni que el GPS sea válido.
- En Delivery Failed, selecciona una opción de Reject reasons cuando describa el problema con exactitud. En la aplicación actual, el motivo desplegable es opcional.
- Introduce una explicación clara y significativa en Please type your comments in here. Si el comentario está vacío, el control final permanece deshabilitado.
- Si aparece Upload status image, captura la evidencia solicitada, revisa la vista previa y usa Remove image si no es correcta.
- Selecciona Delivery Failed como acción final una sola vez. Espera mientras se carga el pedido; si el modal o estado no está claro, no repitas la acción.
Al abrir el formulario se puede leer el GPS aunque la solicitud de fallo no adjunte esa ubicación candidata. La carga de imagen, actualización del estado, rastro de ubicación almacenada, notificaciones y otros efectos son etapas independientes.
Verificar el resultado
| Resultado observable | Interpretación segura |
|---|---|
| No aparece Delivery Failed | El estado, proyecto o configuración actual no mostró el control. |
| Pantalla Request permissions | La comprobación local de permisos no permitió abrir el modal. |
| Modal Delivery Failed | Está abierto el formulario local de motivo/comentario y pudo iniciarse trabajo de GPS. |
| Botón final deshabilitado | Siguen pendientes el comentario, imagen configurada o carga del pedido. |
| Vista previa de imagen | Hay un contenido multimedia candidato local; no se aceptaron la carga ni el estado. |
| El pedido está cargando | La solicitud de estado C05 no se ha resuelto. |
| Estado de error | Una capa de solicitud informó un fallo; aún hay que conciliar la carga, pedido, rastro y proveedor. |
| El modal permanece visible | El formulario en línea no tiene un comprobante uniforme de cierre satisfactorio. |
| Cambia el pedido, tarjeta o estado | Cambió el estado del cliente/devuelto; no se demuestra el fallo duradero ni todos sus efectos. |
Si no está claro el resultado, no vuelvas a enviarlo ni selecciones Complete delivery. Pide al despachador que verifique el pedido actual, asignación, motivo del fallo, contenido multimedia y estado logístico.
Estados y variaciones
Visibilidad y rama del proyecto
En el código fuente, el control para la fase del cliente está disponible para cuatro estados devueltos. Una condición específica del proyecto puede limitar aún más su presentación, y la configuración de controles de rechazo puede ocultar Delivery Failed. Que sea visible es una decisión local de presentación, no elegibilidad en el servicio actual.
Motivo y comentario
El formulario ofrece motivos de fallo predefinidos, incluida una opción Other. El menú desplegable es opcional; el comentario se exige mediante una comprobación de veracidad. En el cliente revisado, un comentario compuesto solo por espacios pasa la comprobación, así que la guía pública exige un comentario significativo.
Imagen configurada
Cuando la regla de imagen de estado incluye un fallo de entrega, el formulario requiere una foto de cámara y envía datos multipart. Si no existe esa regla, envía una solicitud JSON de estado/motivo. Ninguna de las ramas demuestra carga, persistencia o reversión.
Límite de ubicación
El hook GPS del modal lee una ubicación candidata al abrirse, pero el fallo de entrega no tiene validación local de ubicación ni adjunta esa ubicación. El código actual de la API puede escribir un rastro de ubicación del pedido con la ubicación Driver almacenada después del cambio de estado, si está habilitado por una función. El GPS candidato, ubicación almacenada y rastro son elementos separados; ninguno demuestra vigencia o confiabilidad.
Solución de problemas
No aparece Delivery Failed
El estado devuelto, presentación del proyecto, configuración de controles de rechazo, carga o conectividad pueden ocultarlo. Si hace falta para la operación, actualiza una vez el pedido y contacta al despachador; no cambies otro estado para mostrarlo.
La lista de motivos no describe el problema
Elige Other solo si es cierto y explica la situación en el comentario obligatorio. No selecciones un motivo falso solo para habilitar el envío.
El GPS se activa al abrir el formulario
El formulario monta un hook de ubicación, pero la ubicación candidata no forma parte de la solicitud de fallo de entrega. No actualices el GPS ni abras Settings para probar. Para los límites de permisos, sigue Entender los permisos de Driver.
No se puede capturar una imagen requerida
No envíes el fallo y reporta el problema de captura. No reutilices contenido multimedia ajeno ni divulgues evidencia de cliente/pedido fuera del flujo aprobado.
El modal permanece abierto después del envío
No vuelvas a pulsar Delivery Failed. Pide al despachador que concilie el pedido y los posibles efectos parciales de carga, rastro, notificación, logística o cola.
Guías relacionadas: Entender una entrega activa · Completar una entrega · Completar la recogida · Entender los permisos de Driver