addCartItem

Adiciona um item ao carrinho (ou atualiza a quantidade de um item existente). 🔐 Este método requer autorização (ou um contexto de convidado).

Descrição

Este método adiciona um único item ao carrinho do contexto atual - um usuário autorizado ou um convidado (resolvido via o cabeçalho x-guest-id, veja Modo convidado). Se o produto já estiver no carrinho, sua quantidade é atualizada. Ele retorna uma Promise que resolve para o objeto ICartResponse atualizado.

Users.addCartItem(

body*

);

Esquema de parâmetros

Esquema

body(obrigatório): ICartAddItem
Item a ser adicionado
exemplo:

{ productId: 1, qty: 2 }

body.productId(obrigatório): número
Identificador do produto.
exemplo: 1

body.qty(obrigatório): número
Quantidade a ser adicionada.
exemplo: 2

Exemplos

Exemplo mínimo

const response = await Users.addCartItem({ productId: 1, qty: 2 });

Exemplo de resposta

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

Esquema de resposta

Esquema: ICartResponse

items: ICartItem[]
Itens do carrinho.

items.productId: número
Identificador do produto.
exemplo: 1

items.qty: número
Quantidade do produto no carrinho.
exemplo: 2

items.addedAt: string
Data ISO quando o item foi adicionado.
exemplo: "2026-05-30T10:00:00.000Z"

total: número
Número total de itens no carrinho.
exemplo: 3

---