Entender las alertas de entregas nuevas

Mientras Orders esté montado, Driver App puede mostrar una superposición dentro de la aplicación para un evento de pedido nuevo o actualizado. Puede incluir título, referencia de pedido enmascarada, ilustración, vibración, sonido e icono para cerrarla.

Ver o cerrar esta superposición no acepta, rechaza, confirma como recibida, marca como leída ni cambia una asignación o pedido. Tampoco demuestra que haya llegado una notificación push o evento en tiempo real, que la solicitud actual sea elegible, que se haya publicado la ubicación ni que el proveedor de notificaciones haya tenido éxito.

Disponibilidad

La superposición escucha notificaciones de eventos internos mientras está montada el área de pedidos. El mismo sistema puede mostrar texto distinto para eventos de mensaje nuevo, pedido nuevo, actualización del pedido, registro de asignación o actualización de asignación.

Que aparezca una alerta puede depender del estado de la sesión autenticada, estructura del evento, ciclo de vida actual de la aplicación, configuración de notificaciones/tiempo real, configuración del proveedor, comportamiento nativo de la plataforma y, si el contenido de cualquier evento suscrito incluye datos Driver, un intento de obtener la ubicación actual. La superposición Driver no usa generalmente la rama de filtro de estados de Business App para suprimir alertas.

Matriz de estados y resultados

Estado visible o del código fuente	Qué significa	Respuesta segura	Qué sigue sin confirmarse
No aparece una superposición	Este componente no está presentando un evento actual.	Continúa según el estado actual del pedido.	Que no exista evento, push o asignación.
Superposición de pedido nuevo	Un controlador de evento local eligió mostrar un pedido nuevo con referencia.	Lee la referencia enmascarada; ciérrala si hace falta.	Origen de recepción, elegibilidad, asignación o vigencia.
Superposición de pedido actualizado	Un controlador de evento local eligió mostrar una actualización.	Revisa por separado la lista/detalles del pedido.	Qué campo cambió o si la actualización es final.
Superposición de mensaje nuevo	Un controlador de evento local eligió mostrar un mensaje.	Sigue la guía de conversaciones.	Autorización para enviar, entrega, visibilidad o confirmación de lectura.
Contenido del evento con datos Driver	El controlador puede intentar obtener y publicar la ubicación actual antes de filtrar después el tipo de evento o elegir la superposición.	No uses la alerta como comprobante de ubicación, mensaje, pedido o asignación.	Vigencia/almacenamiento/difusión de la ubicación y estado del evento/asignación.
Aplicación activa con superposición	El componente puede vibrar y reproducir repetidamente sonido de alarma remoto o nativo.	Si necesitas detener la superposición local, usa el icono para cerrarla una vez.	Éxito multimedia/proveedor o restauración del volumen del dispositivo.
Se cerró la superposición	Se borró el estado local de superposición y se solicitó limpiar el componente.	Confirma únicamente que ya no aparece la superposición.	Confirmación, rechazo, estado de lectura, push o cambio de asignación.
Se abrió un push	Root puede interpretar formatos de contenido compatibles y solicitar navegar a los detalles.	Verifica la pantalla que aparece.	Garantía de entrega push, compatibilidad con enlaces profundos o éxito de datos de detalles.

Efectos y límites

Límite	Comportamiento definido por el código fuente	Límite público
EventContext/tiempo real	Emite nombres de eventos locales que consume la superposición.	La intención del evento no demuestra recepción del transporte, orden ni vigencia.
Estado de la superposición	Mantiene un evento actual y lo borra al cerrar.	Descartarlo es solo presentación local.
Sonido/vibración/medios	La superposición activa puede vibrar, cargar sonido remoto, usar un módulo de alarma nativo y mostrar una ilustración integrada.	Consultarla no es pasivo ni hermético; no se demuestra que funcionara la reproducción.
Ruta de notificación Android	Puede subir al máximo el volumen de alarma ante una notificación remota y el código revisado no restaura el valor anterior.	No afirmes que se conserva el volumen previo del dispositivo.
Ubicación	El contenido de cualquier evento suscrito que incluya datos Driver puede solicitar coordenadas y publicarlas antes del filtro posterior o presentación de la alerta.	Recopilación, vigencia, tratamiento de simulación, almacenamiento, difusión y efectos sobre pedidos son independientes y quedan bloqueados.
Token push	La configuración autenticada del proveedor puede obtener/guardar/registrar un token de notificación.	Aviso, token, registro, entrega push, evento abierto y superposición son estados distintos.
Asignación/pedido	La alerta puede referirse a un pedido o solicitud de asignación.	No es acción Accept/Reject/estado ni decisión de elegibilidad.

Ver y cerrar la alerta con seguridad

1. Lee únicamente el tipo de alerta visible y la referencia enmascarada del pedido.
2. No selecciones un pedido, asignación, mensaje, mapa, contacto o estado basándote solo en la alerta.
3. Para cerrar la superposición local, selecciona el icono de cierre una sola vez.
4. Confirma únicamente que ya no aparezca.
5. Abre Orders o consulta la guía de la tarea correspondiente por separado si necesitas confirmar el estado actual.

No uses tráfico real de push, asignación, ubicación, sonido o proveedor de notificaciones para probar este comportamiento. Un simulador no aísla esos efectos.

Variaciones de plataforma y ciclo de vida

• El sonido y la vibración solo funcionan mientras el componente considera que la aplicación está activa.
• Android puede usar una ruta de alarma nativa; otros casos pueden usar el reproductor de sonido. Ambas dependen del dispositivo/proveedor.
• Las notificaciones remotas entrantes de Android pueden cambiar el volumen de alarma sin una ruta de restauración revisada.
• Los permisos de notificación y presentación de banners de iOS tienen límites independientes de inicio/Settings.
• Ir a segundo o primer plano puede cambiar si se ejecutan sonido/vibración, pero no demuestra que se haya confirmado el evento o limpiado el estado.

Solución de problemas

Lo que ves	Qué comprobar	Recuperación segura
No aparece una alerta esperada de entrega	Ciclo de vida de la aplicación, configuración de notificaciones/tiempo real, permisos, formato del evento, conexión y lista actual de pedidos	No envíes un pedido de prueba ni cambies la asignación. Comprueba la lista actual y escala solo con hora/plataforma depuradas.
La alerta aparece para un estado inesperado	La superposición Driver no aplica generalmente la rama de filtro de estados de Business App.	Ciérrala y verifica el pedido/solicitud actual en su pantalla responsable.
La alerta se cierra, pero no está claro el estado del pedido	Cerrar solo cambia el estado local de la superposición.	No repitas ni deduzcas ninguna acción; usa la guía de pedido/detalles.
Continúa el sonido o vibración	Es posible que no haya terminado la limpieza nativa/multimedia o ciclo de vida.	Ciérrala una vez, sal de la alerta y usa los controles seguros del dispositivo; informa la plataforma/versión sin identificadores.
Cambió el volumen de alarma de Android	La ruta nativa revisada de notificación puede subir el volumen sin restaurarlo.	Ajusta el volumen normalmente con los controles del dispositivo e informa el comportamiento; no generes otra alerta.
Aparece un error de ubicación antes de la alerta	El contenido del evento tenía datos Driver; el controlador intentó obtener ubicación actual antes de filtrar o presentar el evento.	No cambies ubicación, mensaje, pedido o asignación para repetir; sigue la guía de ubicación y escala el caso.
Al abrir un push lleva a un lugar inesperado	El formato del contenido y estado raíz actual controlan la navegación compatible.	Verifica la pantalla visible; no uses el push como enlace profundo o comprobante de éxito.

Guías relacionadas: Descripción general de Driver App · Navegar por Driver App · Entrega activa · Permisos de ubicación · Ver conversaciones de pedidos