setCart

Reemplaza el carrito del usuario actual o del invitado. 🔐 Este método requiere autorización (o un contexto de invitado).

Descripción

Este método reemplaza todo el carrito del contexto actual - un usuario autorizado o un invitado (resuelto a través del encabezado x-guest-id, ver Modo invitado) - con los artículos proporcionados. Devuelve una Promesa que se resuelve en el objeto ICartResponse actualizado.

Usuarios.setCart(

body*

);

Esquema de parámetros

Esquema

body(requerido): ICartSet
Nuevos contenidos del carrito
ejemplo:

{ items: [{ productId: 1, qty: 2 }] }

body.items(requerido): ICartItem[]
Nuevos artículos del carrito.
ejemplo:

[{ productId: 1, qty: 2 }]

items.productId(requerido): número
Identificador del producto.
ejemplo: 1

items.qty(requerido): número
Cantidad del producto en el carrito.
ejemplo: 2

items.addedAt: cadena
Fecha ISO cuando se agregó el artículo.
ejemplo: "2026-05-30T10:00:00.000Z"

Ejemplos

Ejemplo mínimo

const response = await Users.setCart({
  items: [{ productId: 1, qty: 2 }],
});

Ejemplo de respuesta

{
  "items": [
    {
      "productId": 2957,
      "qty": 2,
      "addedAt": "2026-06-07T14:43:29.338Z"
    }
  ],
  "total": 1
}

Esquema de respuesta

Esquema: ICartResponse

items: ICartItem[]
Artículos del carrito.

items.productId: número
Identificador del producto.
ejemplo: 1

items.qty: número
Cantidad del producto en el carrito.
ejemplo: 2

items.addedAt: cadena
Fecha ISO cuando se agregó el artículo.
ejemplo: "2026-05-30T10:00:00.000Z"

total: número
Número total de artículos en el carrito.
ejemplo: 3

---