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

curl --location 'https://evo-integracao-api.w12app.com.br/api/v1/carts' \ --header 'Content-Type: application/json-patch+json' \ --data '{ "idBranchToken": "string", "idBranch": 0, "idMember": 0, "idProspect": 0, "voucher": "string", "cartCheckoutLink": "string", "items": [ { "idMembership": 0, "idService": 0 } ] }'

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

Solicitud

Respuestas

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#

Solicitud

Respuestas

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