Skip to main content

cartStart

Create a new shopping cart session.

Initializes a new cart with optional configuration including customer association, shop settings, and initial parameters. The cart will be created with a unique identifier and can be used for adding products and managing the shopping experience.

Possible errors:

  • CART_CREATE_ERROR: Failed to create the cart
  • CHANNEL_NOT_FOUND_ERROR: Specified channel does not exist
  • CONTACT_NOT_FOUND_ERROR: Specified contact does not exist
  • CUSTOMER_NOT_FOUND_ERROR: Specified customer does not exist
  • COMPANY_NOT_FOUND_ERROR: Specified company does not exist
  • FORBIDDEN: Insufficient permissions to create carts

AUTH: Role=[order.OWNER,order.EDITOR,order.VIEWER] OR (('user is authenticated') AND ('userId if present in input matches JWT' AND 'contactId if present in input matches JWT' AND 'customerId if present in input matches JWT' AND 'companyId(s) if present in input matches JWT'))

cartStart(
  input: CartStartInput
): Cart!

Arguments​

cartStart.input ● CartStartInput input​

Cart initialization parameters.

Optional configuration for the new cart including customer association, shop settings, language preferences, and initial cart state. If not provided, creates a basic cart with default settings.

Type​

Cart object​

Shopping cart entity for managing customer purchases.

Represents a shopping session containing products, customer information, addresses, payment preferences, and all data needed for order processing. Carts can be associated with different customer types and support various business models.