Lanzamiento con Un Clic, en Detalle

Descripción General

El Lanzamiento con Un Clic es la segunda de las cuatro opciones de integración para socios, y con la que empieza la mayoría de los socios. Las secciones siguientes describen lo que experimentan tus usuarios finales, lo que obtienes como negocio y cómo el lanzamiento elimina la fricción. La sección Detalle Técnico, más abajo, contiene la especificación de ingeniería.

Lo Que Experimentan Tus Usuarios

Con el Lanzamiento con Un Clic, Launch Pad actúa como una app companion de tu producto. Se abre en una ventana nueva del navegador, o en un iframe dentro de tu interfaz, con toda la configuración resuelta en segundo plano, para que el usuario empiece 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.

Dónde Encaja el Lanzamiento con Un Clic

Verge ofrece cuatro formas de añadir Launch Pad a tu producto, en orden creciente de esfuerzo. El Lanzamiento con Un Clic es la segunda, y con la que empieza la mayoría de los socios. Compara las cuatro opciones.

1. Opción 1
   Marca Blanca

   Sin código. Tu logo, subdominio y facturación sobre Launch Pad tal como es.

2. Estás Aquí

   Opción 2

   Lanzamiento con Un Clic

   Unas pocas llamadas a la API. El editor de rutas de Launch Pad hace la planificación y el plan vuelve a ti.

3. Opción 3
   Integración vía API

   Tu interfaz, nuestro motor. Tú renderizas y despachas el plan.

4. Opción 4
   Enterprise

   Un proyecto conjunto. Launch Pad embebido de forma nativa en tu FMIS.

Cómo el Lanzamiento con Un Clic Elimina la Fricción

Por Qué Existe el Lanzamiento con Un Clic

Modelo de Cuenta

Un acuerdo de Lanzamiento con Un Clic se organiza así:

Lo Que los Usuarios Ven en Launch Pad

Cuando un usuario abre Launch Pad a través de un lanzamiento de socio, algunas opciones de Launch Pad no aplican y se ocultan:

• 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 Líneas, 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 Proyecto de Líneas

Una vez que un usuario termina un Proyecto de Líneas en Launch Pad, el resultado necesita volver a tu producto. Hay cuatro opciones disponibles, y funcionan con cualquier opción de integración. Las opciones de envío (push) son muy preferibles al sondeo (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 Proyecto de Líneas"

    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

Otras Opciones de Integración

Esta página es la referencia completa del Lanzamiento con Un Clic. Si tu producto necesita menos, o más: