Crear Carrito (Sales Intent)

Descripción

Este endpoint se utiliza para crear un nuevo carrito de compras. Está orientado a situaciones en las que un miembro o prospecto selecciona productos (como matrículas o servicios) para posteriormente finalizar la compra.

OBS. Disponible para uso con clave de acceso de sucursal y también con clave de acceso de ADM General.

📨 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.
`idProspect`	int32	Situacional	ID del prospecto vinculado al carrito. Utilizado para visitantes o leads.
`voucher`	string	No	Código de descuento que será aplicado 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 ser una matrícula `idMembership` o un servicio `idService`.

🧩 Estructura del Objeto `items`

Debe informarse al menos uno de los campos idMember o idProspect. Además, cada ítem debe contener un idMembership o un idService.

Campo	Tipo	Obligatorio	Descripción
`idMembership`	int32	Situacional	ID de la matrícula que se incluirá.
`idService`	int32	Situacional	ID del servicio que se incluirá.

📝 Ejemplo de Solicitud (Request Body)

{
  "idBranch": "123",
  "idMember": 1010,
  "idProspect": 0,
  "voucher": "PROMOACADEMIA",
  "items": [
    {
      "idMembership": 2001,
      "idService": 0
    }
  ]
}

📤 Estructura de la Respuesta

Al crear el carrito, la API devuelve el token identificador del carrito y el enlace para finalizar la compra.

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).

Requisição

Authorization

Basic Auth

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

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

Parâmetros Bodyapplication/json-patch+json

Exemplo

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

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Add new cart

Crear Carrito (Sales Intent)

Descripción

📨 Cuerpo de la Solicitud (Request Body)

🧩 Estructura del Objeto `items`

📝 Ejemplo de Solicitud (Request Body)

📤 Estructura de la Respuesta

Requisição

Exemplos de Requisição

Respostas

Add new cart

Crear Carrito (Sales Intent)#

Descripción#

📨 Cuerpo de la Solicitud (Request Body)#

🧩 Estructura del Objeto items#

📝 Ejemplo de Solicitud (Request Body)#

📤 Estructura de la Respuesta#

Requisição

Exemplos de Requisição

Respostas

Crear Carrito (Sales Intent)

Descripción

📨 Cuerpo de la Solicitud (Request Body)

🧩 Estructura del Objeto `items`

📝 Ejemplo de Solicitud (Request Body)

📤 Estructura de la Respuesta