Límites de navegación y push de Business App

Considera la navegación como un contrato que pertenece a la aplicación. Las integraciones pueden proporcionar una intención de negocio compatible y datos validados, pero no deben depender de nombres internos de pantallas, anidamiento de navegadores ni símbolos de componentes. Esos detalles pueden cambiar sin convertirse en una promesa pública de compatibilidad.

Antes de empezar

• Usa una compilación cuya relación entre Business App, Ordering Components y el entorno sea conocida.
• Usa datos sintéticos de pedidos y cuentas. Una prueba de push puede registrar un token de dispositivo o contactar a un proveedor externo; no es una acción de solo lectura.
• Antes de probar una transferencia de navegación, confirma mediante la API que la persona autenticada puede acceder al negocio y al pedido indicados.
• Define el fallback previsto cuando la sesión no esté iniciada, la aplicación siga cargando o no pueda resolver el destino.

Alcance y versión

Autoridad	Límite público compatible	Limitación de versión o referencia
Business App	Controla la navegación registrada de raíz, autenticada y por pestañas; decide cuándo se puede abrir una intención compatible.	La navegación puede cambiar entre versiones de la app; no uses nombres de rutas internas como contrato de integración.
Ordering Components	Proporciona estado de sesión, pedido, configuración y tiempo real que utiliza la navegación.	La aplicación consume una revisión exacta de Components; otras revisiones requieren una nueva revisión de compatibilidad.
Ordering API	Autoriza el recurso indicado y acepta registros aptos de tokens de notificación.	La autorización y el registro de tokens dependen del entorno de API que usa la app.
Proveedor push y sistema operativo	Entregan notificaciones e informan el estado de suscripción del dispositivo.	La entrega, los avisos de permisos, el comportamiento en segundo plano y la gestión de toques varían según proveedor, plataforma, compilación y estado del dispositivo.

Entradas y configuración

Entrada o configuración	Responsable	Validación y disponibilidad	Límite del fallo
Intención de navegación	Business App	Debe corresponder a un resultado admitido actualmente, una vez que la aplicación esté lista.	Un identificador de destino interno es un detalle de implementación y no debe enviarse como contrato de integración.
Referencia del recurso	Productor de integración y Ordering API	Debe identificar un recurso autorizado en el proyecto seleccionado sin exponer datos sensibles en registros o enlaces.	Una referencia bien formada no demuestra que la persona con sesión iniciada pueda leerla.
Estado autenticado y cargado	Business App y Ordering Components	La aplicación espera la sesión, la configuración y el estado del pedido requerido antes de intentar transferir la navegación.	Una intención recibida demasiado pronto puede aplazarse, ignorarse o requerir que el operador abra el elemento manualmente.
Aplicación push y suscripción del dispositivo	Responsable del despliegue, proveedor push y sistema operativo	Deben coincidir la configuración del proveedor, permisos, estado de suscripción, identidad de usuario y proyecto.	La creación del token, el registro de API, la entrega del proveedor y la gestión del toque pueden fallar por separado.
URL entrante	Productor de integración	Business App no ofrece una ruta general para enlaces de aplicación entrantes o universal links.	No supongas que una URL web o un esquema personalizado abrirá un destino interno de Business App.

Ciclo de vida y resultados

Para la navegación normal dentro de la aplicación, Business App elige un espacio de trabajo raíz según los estados de carga y autenticación; luego presenta el espacio autenticado y sus destinos secundarios registrados. Las pestañas y páginas secundarias siguen siendo detalles internos de composición.

Para una transferencia push:

1. El proveedor informa a la aplicación de una interacción con la notificación.
2. La aplicación extrae de la carga solo la intención de recurso compatible.
3. Espera la autenticación y el estado requerido de la aplicación.
4. Intenta abrir el resultado autenticado correspondiente.
5. La API sigue siendo responsable de autorizar y devolver el recurso indicado. La entrega del proveedor nunca elude la autorización de API.

Las notificaciones push pueden incluir una intención de abrir un pedido, pero la entrega y la acción al tocarla dependen del proveedor, los permisos del dispositivo y el estado de la app. Si el pedido no se abre, búscalo dentro de Business App.

Límites de plataforma y proveedor

• El permiso push, la creación del token, la entrega de notificaciones, el comportamiento en primer plano o segundo plano y los toques en notificaciones son etapas distintas.
• Registrar un token de notificación es una escritura en el servidor. Pruébalo solo en un entorno autorizado y elimina después los registros de prueba.
• El grafo de navegación interno de la aplicación puede estar anidado. Una integración debe expresar el resultado que necesita, no intentar recorrer ese grafo directamente.
• Los manifiestos móviles revisados no establecen enlaces entrantes generales. Los enlaces salientes a otra aplicación o sitio web son una responsabilidad distinta y no implican un contrato de navegación entrante.
• Los eventos en tiempo real y las notificaciones push son transportes distintos. Recibir uno no demuestra que el otro esté configurado o actualizado.

Diagnóstico y escalación

Comportamiento observable	Límite responsable	Siguiente paso
No se muestra una notificación.	Sistema operativo o proveedor push	Comprueba permiso, suscripción, entorno del proveedor y entrega de la carga antes de investigar la navegación.
Se muestra una notificación, pero la aplicación no abre el pedido previsto.	Transferencia de Business App	Confirma que la aplicación estuviera autenticada y terminara de cargar; luego usa la búsqueda interna de pedidos como alternativa segura. Escala con detalles de la compilación y el escenario sintético.
Se abre la aplicación, pero el recurso no está disponible.	Autorización de Ordering API o estado de datos	Confirma el proyecto seleccionado, el ámbito de la persona con sesión iniciada y el estado actual del recurso. No vuelvas a intentar con el identificador de otra persona.
Una URL abre el navegador en lugar de la aplicación.	Límite de enlaces entrantes	Esta versión del código fuente no establece un contrato general de enlaces entrantes. Indica al operador que abra Business App y busque el elemento dentro de la aplicación.
El comportamiento cambia tras actualizar Components o la aplicación.	Responsable de publicación	Vuelve a validar el grafo registrado y la transferencia push con las revisiones emparejadas exactas antes de considerarlos compatibles.

Artículos relacionados

• Arquitectura y configuración de Business App
• Descripción general de Business App