Carts And Wishlists

The Shop API differentiates between carts and wishlists for all customers.

The Cart contains:

  • Positions
  • Billing address
  • Shipping address
  • Selected payment method
  • Selected shipping method
  • Other properties

For B2C purposes there is only one cart per user. If there is no cart, then one will be created on demand. The most important mutation operation is cart_update. It allows to modify positions, set addresses, payment methods, etc.

The Wishlist contains:

  • Positions

Customers can have multiple wishlists that they can organize themselves.

Cart To Wishlist

With the cart_addAllToWishlist mutation it is possible to move all positions from a cart to the wishlist of a customer. The cart is empty afterwards. If the wishlist already contains positions with the same item id, they will be merged into one position.

Wishlist To Cart

With the wishlist_addAllToCartmutation all positions from the wishlist are moved to the cart of the customer. Positions that have no quantity on the wishlist will be moved with quantity set to 1. If the cart already contains positions with the same item id, they will be merged into one position.