Integrar landing page

Objetivo

Permitir que sistemas externos (sitios web, apps, tótems o CRMs) utilicen la EVO API para:

Mostrar planes disponibles (memberships) para compra

Mostrar ítems disponibles para venta (productos/servicios)

Crear y gestionar un carrito de compras (carts)

Dirigir al usuario al checkout

Este flujo permite construir recorridos completos de compra para prospects o alumnos, utilizando EVO como backend comercial.

Endpoints Utilizados

Consultar planes disponibles (memberships)

GET /api/v2/membership

Consultar ítems disponibles para venta (sitio web/tótem)

GET /api/v1/sales/sales-items

Crear carrito

POST /api/v1/carts

Consultar carrito

GET /api/v1/carts

Flujo Técnico

1. Mostrar Planes Disponibles para Compra

El primer paso es consultar los planes disponibles (memberships), que representan los productos principales como planes mensuales, anuales, etc.

Solicitud:

GET /api/v2/membership?active=true&externalSaleAvailable=true

Parámetros recomendados:

Parámetro	Descripción
`active=true`	Devuelve solo planes activos
`externalSaleAvailable=true`	Devuelve planes disponibles para venta externa
`idBranch`	Filtra planes por unidad
`showActivitiesGroups`	Devuelve actividades vinculadas
`showOnlineSalesObservation`	Devuelve observaciones de venta

Estos datos permiten mostrar:

Nombre del plan

Valor

Duración

Beneficios (diferenciales)

Reglas comerciales

URL de venta (cuando aplique)

2. Mostrar Ítems Disponibles para Venta

Además de los planes, es posible consultar directamente los ítems disponibles para venta configurados en EVO (ej.: planes + servicios adicionales).

Solicitud:

GET /api/v1/sales/sales-items?idBranch=1

Este endpoint devuelve:

Ítems mostrados en la página de ventas

Información de precio y cuotas

Reglas de pago (tarjeta, boleto, etc.)

Enlaces de checkout

Configuraciones de fidelidad

Servicios adicionales (anualidad, tasas, etc.)

Importante:

Solo se devuelven ítems con Autoservicio habilitado.

3. Selección de Ítems por el Usuario

Con base en la información devuelta:

El usuario elige un plan (idMembership) o servicio (idService)

Puede visualizar:

precio

cuotas

beneficios

vigencia

Esta etapa ocurre en el frontend (sitio web/app/tótem).

4. Crear Carrito de Compra (Sales Intent)

Después de la selección de los ítems, el sistema debe crear un carrito para el usuario.

Solicitud:

POST /api/v1/carts

Ejemplo:

{
  "idBranch": 1,
  "idProspect": 123,
  "voucher": "PROMO10",
  "items": [
    {
      "idMembership": 2001
    }
  ]
}

Reglas importantes:

Informar idMember (alumno) o idProspect (lead)

Cada ítem debe contener:

idMembership o

idService

Respuesta:

{
  "idCartToken": "abc123",
  "cartCheckoutLink": "https://checkout.evo.com/xyz"
}

5. Redirigir al Checkout

Con el cartCheckoutLink devuelto:

El usuario puede ser redirigido para finalizar la compra

El checkout puede ocurrir:

en el entorno EVO

o mediante integración personalizada

6. Consultar Carrito (Opcional)

Si es necesario recuperar o validar el carrito:

GET /api/v1/carts?idProspect=123

GET /api/v1/carts?idMember=1010

Permite:

recuperar ítems seleccionados

validar el estado del carrito

mostrar el resumen antes del pago

Escenario Adicional: Actualización de Planes

Para mantener el catálogo actualizado:

GET /api/v2/membership?updateDate=2024-06-01

Este filtro permite:

sincronizar solo planes actualizados

reducir el volumen de datos

mantener la consistencia con el frontend

Preguntas Frecuentes

1. ¿Puedo vender planes fuera de EVO?

Sí, siempre que el plan tenga externalSaleAvailable = true.

2. ¿Cuál es la diferencia entre membership y sales-items?

membership: representa el plan base (producto)

sales-items: representa el ítem configurado para venta (con reglas comerciales, cuotas, etc.)

3. ¿Necesito usar carrito obligatoriamente?

Sí, el carrito es el mecanismo oficial para iniciar el proceso de compra y generar el checkout.

4. ¿Puedo crear carrito para prospect?

Sí. Utilice idProspect para leads aún no convertidos.

5. ¿El checkout puede ser personalizado?

Sí, pero el flujo estándar utiliza el cartCheckoutLink proporcionado por EVO.

Resultado Esperado

Después de implementar este flujo:

Los planes y productos estarán disponibles para venta externa

El usuario podrá navegar, seleccionar y comprar directamente mediante la integración

El proceso de compra estará estructurado (catálogo → carrito → checkout)

EVO se utilizará como backend central de ventas, garantizando consistencia comercial

Integrar landing page

Objetivo#

Endpoints Utilizados#

Consultar planes disponibles (memberships)#

Consultar ítems disponibles para venta (sitio web/tótem)#

Crear carrito#

Consultar carrito#

Flujo Técnico#

1. Mostrar Planes Disponibles para Compra#

2. Mostrar Ítems Disponibles para Venta#

3. Selección de Ítems por el Usuario#

4. Crear Carrito de Compra (Sales Intent)#

5. Redirigir al Checkout#

6. Consultar Carrito (Opcional)#

Escenario Adicional: Actualización de Planes#

Preguntas Frecuentes#

1. ¿Puedo vender planes fuera de EVO?#

2. ¿Cuál es la diferencia entre membership y sales-items?#

3. ¿Necesito usar carrito obligatoriamente?#

4. ¿Puedo crear carrito para prospect?#

5. ¿El checkout puede ser personalizado?#

Resultado Esperado#

Objetivo

Endpoints Utilizados

Consultar planes disponibles (memberships)

Consultar ítems disponibles para venta (sitio web/tótem)

Crear carrito

Consultar carrito

Flujo Técnico

1. Mostrar Planes Disponibles para Compra

2. Mostrar Ítems Disponibles para Venta

3. Selección de Ítems por el Usuario

4. Crear Carrito de Compra (Sales Intent)

5. Redirigir al Checkout

6. Consultar Carrito (Opcional)

Escenario Adicional: Actualización de Planes

Preguntas Frecuentes

1. ¿Puedo vender planes fuera de EVO?

2. ¿Cuál es la diferencia entre membership y sales-items?

3. ¿Necesito usar carrito obligatoriamente?

4. ¿Puedo crear carrito para prospect?

5. ¿El checkout puede ser personalizado?

Resultado Esperado