Agrega Planificación de Rutas a Tu Plataforma

Descripción General

Cada nivel funciona de forma independiente. La mayoría de los socios comienzan en el Nivel 1 (Lanzamiento con Un Clic) y agregan niveles superiores más adelante según cambien sus necesidades. Las secciones siguientes describen lo que experimentan tus usuarios finales, lo que obtienes como empresa, el desglose completo de los cuatro niveles y un análisis detallado del Nivel 1. La sección de Detalle Técnico más adelante contiene la especificación de ingeniería.

Lo Que Experimentan Tus Usuarios

En el Nivel 1, Launch Pad actúa como una aplicación complementaria a tu producto. Se abre en una nueva ventana del navegador con toda la configuración realizada en segundo plano, para que el usuario pueda comenzar a trabajar de inmediato.

Lo Que Obtienes Como Socio

Diseñado para empresas y equipos de ingeniería que quieren incorporar enrutamiento de precisión sin montar la infraestructura necesaria para respaldarlo.

Cuatro Niveles de Integración

Cada nivel funciona de forma independiente. La mayoría de los socios comienzan en el Nivel 1 y agregan niveles superiores más adelante según cambien sus necesidades.

Cómo el Nivel 1 Elimina la Fricción

Por Qué Existe el Nivel 1

Modelo de Cuenta

Un compromiso de Nivel 1 se organiza de la siguiente manera:

Lo Que los Usuarios Ven en Launch Pad

Cuando un usuario abre Launch Pad a través del Nivel 1, algunas opciones de Launch Pad no aplican y están ocultas:

• Sin cambio de contraseña, sin gestión de correo electrónico ni cuenta, sin registro. El usuario no tiene contraseña de Launch Pad; el inicio de sesión proviene de tu producto. La pantalla de cambio de contraseña muestra un mensaje "Contraseña gestionada por [Socio]", de la misma forma en que Launch Pad ya gestiona a los usuarios que inician sesión a través de John Deere, Trimble o CNH.
• Sin selector de empresa. La sesión está bloqueada a una única organización de cliente para esa visita.
• El cierre de sesión es reemplazado por "Volver a [Socio]", que cierra la pestaña o envía al usuario de vuelta a una URL que tú proporcionas, en lugar de dejarlo en la página de inicio de sesión de Launch Pad.

El menú principal de trabajo (Planes, Planificación de Rutas, Equipos, Comparar) sigue disponible porque los usuarios lo necesitan para realizar la tarea. Solo se ocultan las opciones de identidad, facturación, administración y gestión de cuentas.

Devolución del Plan de Rutas

Una vez que un usuario termina un plan de rutas en Launch Pad, el resultado necesita volver a tu producto. Hay cuatro opciones disponibles que funcionan sobre cualquier nivel. Las opciones de push son fuertemente preferidas sobre el polling.

Flujo de Extremo a Extremo

Lo que ocurre, paso a paso, cuando un usuario del socio abre Launch Pad:

sequenceDiagram
    autonumber
    participant YU as UI del Socio
    participant YB as Backend del Socio
    participant LA as Launch Pad API
    participant LU as Launch Pad UI

    YU->>YB: usuario hace clic en "Abrir Plan de Rutas"

    note over YB,LA: Paso 1: crear usuario de LP si no existe
    YB->>LA: POST /api/users (idempotente en externalUserId)
    YB->>LA: POST /api/company-accesses (idempotente en usuario + org)

    note over YB,LA: Paso 2 (opcional): enviar un lote
    YB->>LA: POST /api/vBoundary/upsert

    note over YB,LA: Paso 3: solicitar un código de lanzamiento
    YB->>LA: POST /api/partner/launch ({ userId, companyId, returnUrl })
    LA-->>YB: { code, expiresInSec: 600 }

    YB-->>YU: 302 redirige a https://your-app.vergeag.com/launch?code=...
    YU->>LU: el navegador navega a /launch?code=...
    LU->>LA: POST /api/partner/launch/{code}/exchange
    LA-->>LU: JWT + refresh token
    note over LU: almacena JWT en localStorage,
elimina código de la URL,
navega a returnUrl
          

Propiedades Clave

• Te autenticas de servidor a servidor con una credencial de larga duración (la clave de API de tu usuario administrador). El navegador nunca ve la clave de API.
• El navegador solo ve un código opaco, de un solo uso y de corta duración en la URL (tiempo de vida de 10 minutos, consumido al intercambiarse).
• El endpoint de intercambio no requiere inicio de sesión; el código en sí es la credencial. La UI de Launch Pad lo llama en cuanto el usuario llega.
• Launch Pad emite una sesión de usuario normal (JWT + refresh token), la almacena en localStorage y enruta al usuario a la URL que especificaste.

Alineación con Estándares

Cómo Es la URL de Redirección

Lo que recibe el navegador del usuario (una línea, como encabezado Location:):

https://your-app.vergeag.com/launch?code=lc_R3w9q-Kx7VtNm2bH8sLpYj4eQ6gZc1aXfU0dT5nMoP&returnUrl=%2Fpath-planning%2Fboundary%2Fb3f47e1c-8a02-4d59-9c6e-2f7a8b1d6e09

Decodificada para mayor legibilidad:

Lo Que Hace la UI de Launch Pad al Llegar

Tú no implementas esto; se incluye como referencia para que puedas razonar sobre lo que ven tus usuarios entre el clic y el lote renderizado:

1. Lee code y returnUrl de la cadena de consulta.
2. Intercambia el código con Launch Pad por una sesión de usuario.
3. Inicia sesión del usuario en la organización de cliente correcta.
4. Elimina el código de la barra de direcciones para que no quede en el historial del navegador.
5. Envía al usuario al returnUrl que especificaste.

Si code falta, está vencido o ya fue usado, el usuario llega a una página de error que le pide volver a tu producto e intentarlo de nuevo.

Opciones de Devolución en Detalle

Niveles Superiores

Esta página es la referencia completa para el Nivel 1. Para los niveles superiores: