Entender los avisos de cambio forzado de estado
El código fuente de Driver App contiene formularios para forzar la recogida y entrega, pensados para pedir un motivo después de que un intento normal de cambiar el estado encuentre un error de zona de ubicación. Son avisos de recuperación condicionales, no acciones de entrega habituales.
Disponibilidad
El formulario de cambio forzado solo puede abrirse si el cliente reconoce un resultado de error específico de un intento anterior de cambiar el estado de recogida o entrega. El código revisado contiene las ramas correspondientes, pero el código aceptado de la API no demuestra que el backend en ejecución emita esos fragmentos exactos en el formato necesario.
No esperes que aparezca un aviso forzado ni consideres que su presencia demuestre que se admite, autoriza o permite con seguridad forzar el estado.
Matriz de estados y resultados
| Estado | Comportamiento del cliente | Interpretación segura |
|---|---|---|
| No ha fallado una solicitud normal de estado | No aparece ningún aviso forzado | Usa únicamente el procedimiento normal correspondiente. |
| Error general o con otro formato | Estado de error estándar | No cumple el control para una acción forzada. |
| Fragmento reconocido de zona de recogida | El cliente puede abrir el formulario de recogida forzada | Solo es una rama condicional del cliente. |
| Fragmento reconocido de zona de entrega | El cliente puede abrir el formulario de entrega forzada | Solo es una rama condicional del cliente. |
| Formulario abierto | Menú de motivo, comentario obligatorio, comprobaciones de ubicación y posibles campos de foto/código | Formulario previo a la acción; no se ha aceptado en el backend. |
| Comentario vacío | La acción final está deshabilitada | No se envió ninguna solicitud. |
| Problema de ubicación | Puede aparecer Requirements Not Met o un error | No lo eludas; no se ha comprobado que la ubicación sea correcta. |
| Se requiere imagen | Área de foto y acción final deshabilitada | Límite de medios/proveedor; no se demuestra nada más. |
| Aparece Security code | Campo de código de entrega del lado del cliente | No es prueba segura ni validada por el servidor. |
| Error del envío o el pedido no cambia | No se confirmó el cambio de estado | Cierra, actualiza y pide al despachador que lo verifique. |
Datos que recogen los formularios
Ambos formularios forzados pueden mostrar:
- un menú de motivos;
- un campo de comentario obligatorio;
- comprobaciones de ubicación configuradas para recogida o entrega;
- una imagen de estado obligatoria, si está configurada; y
- para algunas configuraciones de entrega forzada, un campo Security code.
En el código revisado, el comentario solo se comprueba como valor de cliente no vacío y la selección de motivo es opcional en el contenido enviado. Ninguno de esos campos demuestra que el servidor haya validado la solicitud.
La ruta forzada revisada no establece que los datos de ubicación sean completos, correctos ni confiables. Tampoco hay evidencia independiente de su vigencia ni política sobre ubicación simulada. Por tanto, un aviso visible, comprobación de ubicación, comentario, imagen o código no confirma que la ubicación sea correcta ni que exista autorización segura.
Comportamiento de plataforma, permisos y ciclo de vida
Abrir el formulario pasa por el control agregado de permisos de Driver App y monta un formulario con capacidad para consultar GPS. Los avisos de permisos, Settings, GPS, cámara, teclado y foco del código pueden variar entre iOS y Android.
Los detalles del pedido subyacente quizá ya estén leyendo y siguiendo la ubicación. Ningún estado de plataforma o ciclo de vida convierte el aviso forzado en una acción aprobada por el servidor.
Efectos y límites
Si se enviara una solicitud de cambio forzado, los objetivos de recogida y entrega serían estados diferentes y podrían afectar el historial del pedido, mensajes, informes, estado Driver/ubicación, logística, eventos en tiempo real, notificaciones, correo, webhooks, trabajos, imágenes y proveedores. Algunos efectos pueden completarse por separado o fallar sin reversión.
Esta referencia no contiene un procedimiento para forzar el estado. Si aparece el aviso, detente y consulta al despachador o el proceso de soporte de tu organización antes de enviar cualquier solicitud.
Solución de problemas
- Si no aparece un aviso forzado, no repitas el cambio normal de estado solo para intentar provocarlo. Revisa el error original y contacta al despachador.
- Si aparece un aviso inesperado, ciérralo y actualiza el pedido antes de continuar.
- Si falta la ubicación, está desactualizada o se rechazó, no introduzcas ni compartas coordenadas manualmente ni consideres una imagen como sustituto de la ubicación.
- Si el formulario pide un código, no lo adivines, reconstruyas ni compartas en el chat o notas de soporte.
- Si no está claro el estado final, vuelve a abrir el pedido y pide al despachador que confirme el estado actual. No envíes repetidamente la acción forzada.
Guías relacionadas: Completar la recogida · Completar una entrega · Problemas de recogida · Problemas de entrega · Permisos de ubicación