commercetools · Schema

CartDraft

Request body for creating a new cart.

CommerceComposable CommerceE-CommerceGraphQLRESTSDK

Properties

Name Type Description
currency string ISO 4217 currency code for the cart.
customerId string ID of the customer to associate with the cart.
customerEmail string Email address for anonymous or identified carts.
key string User-defined unique key for the cart.
lineItems array Initial line items to add to the cart.
billingAddress object
shippingAddress object
taxMode string Tax calculation mode.
inventoryMode string Inventory tracking mode.
store object
View JSON Schema on GitHub

JSON Schema

commercetools-cartdraft-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CartDraft",
  "title": "CartDraft",
  "type": "object",
  "description": "Request body for creating a new cart.",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "ISO 4217 currency code for the cart."
    },
    "customerId": {
      "type": "string",
      "description": "ID of the customer to associate with the cart."
    },
    "customerEmail": {
      "type": "string",
      "format": "email",
      "description": "Email address for anonymous or identified carts."
    },
    "key": {
      "type": "string",
      "description": "User-defined unique key for the cart."
    },
    "lineItems": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Initial line items to add to the cart."
    },
    "billingAddress": {
      "$ref": "#/components/schemas/Address"
    },
    "shippingAddress": {
      "$ref": "#/components/schemas/Address"
    },
    "taxMode": {
      "type": "string",
      "enum": [
        "Platform",
        "External",
        "ExternalAmount",
        "Disabled"
      ],
      "description": "Tax calculation mode."
    },
    "inventoryMode": {
      "type": "string",
      "enum": [
        "None",
        "TrackOnly",
        "ReserveOnOrder"
      ],
      "description": "Inventory tracking mode."
    },
    "store": {
      "$ref": "#/components/schemas/Reference"
    }
  }
}