Crear Carrito (Sales Intent)

Descripción

Este endpoint se utiliza para crear un nuevo carrito de compras. Está destinado a situaciones en las que un miembro o prospecto selecciona productos, como contratos o servicios, para finalizar la compra posteriormente.

Para los ítems de tipo contrato (idMembership), es posible incluir uno o más contratos adicionales opcionales mediante el campo additionalMemberships. Los adicionales informados se vinculan al ítem principal, se conservan en el carrito y continúan hasta la etapa de checkout.

🚧 Observaciones
Disponible para su uso con clave de acceso de sucursal y también con clave de acceso de ADM General.
Se debe informar al menos uno de los campos idMember o idProspect.
Cada ítem debe contener un idMembership o un idService.
El campo additionalMemberships debe utilizarse únicamente para contratos adicionales opcionales. Los adicionales de tipo Fixed no deben ser enviados por la integración, ya que se incluyen automáticamente cuando se completa la venta del contrato principal en el checkout.
Los contratos adicionales están sujetos a las mismas validaciones de vínculo y elegibilidad aplicadas en el flujo de Sales. Si la combinación informada no es válida, la operación será rechazada y no se generará un carrito utilizable.

📨 Cuerpo de la Solicitud (Request Body)

Campo	Tipo	Obligatoriedad	Descripción
`idBranch`	int32	Situacional	ID de la sucursal donde se creará el carrito.
`idBranchToken`	string	Situacional	Token identificador de la sucursal donde se creará el carrito.
`idMember`	int32	Situacional	ID del miembro vinculado al carrito. Necesario si el usuario ya está registrado como miembro.
`idProspect`	int32	Situacional	ID del prospecto vinculado al carrito. Utilizado para visitantes o leads.
`voucher`	string	No	Código de descuento que se aplicará al valor final del carrito.
`cartCheckoutLink`	string	No	URL directa para el proceso de finalización del carrito (checkout).
`items`	array	Sí	Lista de ítems que se incluirán en el carrito. Cada ítem puede contener un contrato (`idMembership`) o un servicio (`idService`).

🧩 Estructura del Objeto `items`

Campo	Tipo	Obligatoriedad	Descripción
`idMembership`	int32	Situacional	ID del contrato que se incluirá en el carrito.
`idService`	int32	Situacional	ID del servicio que se incluirá en el carrito.
`additionalMemberships`	arrayobject	No	Lista de contratos adicionales opcionales vinculados al ítem de contrato. Permite informar uno o más adicionales. Ver más abajo.

🧩 Estructura del Objeto `additionalMemberships`

Campo	Tipo	Obligatoriedad	Descripción
`idMembership`	int32	Sí	ID del contrato adicional opcional que se incluirá en el carrito.
`membershipValue`	number (double)	No	Valor final del contrato adicional informado por la integración. Cuando se informa, sobrescribe el valor predeterminado definido por EVO (`defaultSaleValue`) y no se recalcula ni se multiplica por la vigencia. Cuando no se informa, EVO utiliza el valor predeterminado aplicable al contrato adicional.

OBS. Cada contrato informado en additionalMemberships debe tener un vínculo opcional válido con el contrato principal o cumplir con las reglas de elegibilidad para la venta de adicionales a un miembro que ya posea un contrato principal elegible.

📥 Ejemplo de Solicitud

Ejemplo de un contrato principal con múltiples contratos adicionales opcionales:

{
  "idMember": 123,
  "items": [
    {
      "idMembership": 100,
      "additionalMemberships": [
        {
          "idMembership": 200
        },
        {
          "idMembership": 201,
          "membershipValue": 45.00
        }
      ]
    }
  ]
}

En el ejemplo anterior, el adicional 200 utilizará el valor predeterminado definido por EVO, mientras que el adicional 201 utilizará 45.00 como valor final informado por la integración.

📤 Estructura de la Respuesta

Al crear el carrito, la API devuelve el token identificador del carrito, el enlace para finalizar la compra y los ítems agregados. Cuando se informan contratos adicionales, estos se conservan y se devuelven dentro del respectivo ítem de contrato.

Campo	Tipo	Descripción
`idCartToken`	string	Token único del carrito creado. Puede utilizarse posteriormente para recuperarlo.
`cartCheckoutLink`	string	URL directa para el proceso de finalización del carrito (checkout).
`items`	array	Lista de ítems incluidos en el carrito. Ver más abajo.

🧩 Estructura del Objeto `items`

Campo	Tipo	Descripción
`idMembership`	int32	ID del contrato incluido en el carrito, cuando corresponda.
`idService`	int32	ID del servicio incluido en el carrito, cuando corresponda.
`additionalMemberships`	arrayobject	Lista de contratos adicionales opcionales vinculados al ítem de contrato.

🧩 Estructura del Objeto `additionalMemberships`

Campo	Tipo	Descripción
`idMembership`	int32	ID del contrato adicional opcional.
`membershipValue`	number (double)	Valor informado para el contrato adicional, cuando corresponda.

OBS. Los contratos adicionales informados durante la creación se conservan con sus vínculos, se devuelven posteriormente mediante los endpoints de consulta de Carts y se mantienen durante el flujo hasta la finalización del checkout.

Solicitud

Autorización

Envía tus solicitudes HTTP con un encabezado

Authorization

que contenga la palabra Basic seguida de un espacio y una cadena codificada en base64 username:password

Ejemplo:

Authorization: Basic *****************

Parámetros del Body

application/json-patch+json

Ejemplo

{
    "idBranchToken": "string",
    "idBranch": 0,
    "idMember": 0,
    "idProspect": 0,
    "voucher": "string",
    "cartCheckoutLink": "string",
    "items": [
        {
            "idMembership": 0,
            "idService": 0,
            "additionalMemberships": [
                {
                    "idMembership": 0,
                    "membershipValue": 0
                }
            ]
        }
    ]
}

Ejemplos de solicitud

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respuestas

🟢200OK

application/json

Success

Body

Ejemplo

{
    "idCartToken": "string",
    "cartCheckoutLink": "string",
    "items": [
        {
            "idMembership": 0,
            "idService": 0,
            "additionalMemberships": [
                {
                    "idMembership": 0,
                    "membershipValue": 0
                }
            ]
        }
    ]
}

🟠400Bad Request

Add new cart

Crear Carrito (Sales Intent)#

Descripción#

📨 Cuerpo de la Solicitud (Request Body)#

🧩 Estructura del Objeto items#

🧩 Estructura del Objeto additionalMemberships#

📥 Ejemplo de Solicitud#

📤 Estructura de la Respuesta#

🧩 Estructura del Objeto items#

🧩 Estructura del Objeto additionalMemberships#

Solicitud

Ejemplos de solicitud

Respuestas

Crear Carrito (Sales Intent)

Descripción

📨 Cuerpo de la Solicitud (Request Body)

🧩 Estructura del Objeto `items`

🧩 Estructura del Objeto `additionalMemberships`

📥 Ejemplo de Solicitud

📤 Estructura de la Respuesta

🧩 Estructura del Objeto `items`

🧩 Estructura del Objeto `additionalMemberships`