Cart

mutation createEmptyCart

Create an empty (guest or customer) cart and return its ID.

Sem parâmetros. Para clientes autenticados, adicione Authorization: Bearer. Guest carts têm ID masked (string); customer carts usam o mesmo endpoint mas associam automaticamente.

mutation { createEmptyCart }

query cart

Retrieve cart data by ID (guest or customer).

{ cart(cart_id: "GPkHFxJ5...") { id items { id product { sku name } quantity prices { price { value } } } prices { grand_total { value currency } } } }

mutation addProductsToCart

Add simple/configurable/bundled products (recommended).

Substitui as mutations específicas addSimpleProductsToCart, addConfigurableProductsToCart etc. a partir do Magento 2.4.5.

mutation {
    addProductsToCart(
        cartId: "cart-id"
        cartItems: [
            { sku: "SKU-001", quantity: 2,
              selected_options: ["base64-encoded-uid"] }
        ]
    ) {
        cart { items { product { sku } quantity } }
        user_errors { code message }
    }
}

mutation updateCartItems

Update item quantity or remove by setting qty=0.

mutation {
    updateCartItems(input: {
        cart_id: "cart-id"
        cart_items: [{ cart_item_uid: "...", quantity: 3 }]
    }) { cart { items { uid quantity } } }
}

mutation removeItemFromCart

Explicitly remove an item.

mutation mergeCarts

Merge a guest cart into the authenticated customer cart.

Chame após o login para que itens adicionados como guest sejam preservados no cart do cliente.

mutation applyCouponToCart

Apply a coupon code to the cart.

mutation removeCouponFromCart

Remove the applied coupon.

mutation setShippingAddressesOnCart

Set shipping addresses on cart (supports multi-shipping).

mutation setBillingAddressOnCart

Set the billing address.

mutation setGuestEmailOnCart

Set the guest email (required to place order).

mutation setShippingMethodsOnCart

Choose shipping method(s).

mutation setPaymentMethodOnCart

Set payment method (checkmo, banktransfer, custom gateways...).

mutation placeOrder

Place the order — returns order number.