Interface CartDraft

interface CartDraft {
    anonymousId?: string;
    billingAddress?: _BaseAddress;
    businessUnit?: BusinessUnitResourceIdentifier;
    country?: string;
    currency: string;
    custom?: CustomFieldsDraft;
    customerEmail?: string;
    customerGroup?: CustomerGroupResourceIdentifier;
    customerId?: string;
    customLineItems?: CustomLineItemDraft[];
    customShipping?: CustomShippingDraft[];
    deleteDaysAfterLastModification?: number;
    discountCodes?: string[];
    externalTaxRateForShippingMethod?: ExternalTaxRateDraft;
    inventoryMode?: string;
    itemShippingAddresses?: BaseAddress[];
    key?: string;
    lineItems?: LineItemDraft[];
    locale?: string;
    origin?: string;
    shipping?: ShippingDraft[];
    shippingAddress?: _BaseAddress;
    shippingMethod?: ShippingMethodResourceIdentifier;
    shippingMode?: string;
    shippingRateInput?: ShippingRateInputDraft;
    store?: StoreResourceIdentifier;
    taxCalculationMode?: string;
    taxMode?: string;
    taxRoundingMode?: string;
}

Properties

anonymousId? billingAddress? businessUnit? country? currency custom? customerEmail? customerGroup? customerId? customLineItems? customShipping? deleteDaysAfterLastModification? discountCodes? externalTaxRateForShippingMethod? inventoryMode? itemShippingAddresses? key? lineItems? locale? origin? shipping? shippingAddress? shippingMethod? shippingMode? shippingRateInput? store? taxCalculationMode? taxMode? taxRoundingMode?

Properties

Optional ReadonlyanonymousId

anonymousId?: string

Anonymous session associated with the Cart.

Optional ReadonlybillingAddress

billingAddress?: _BaseAddress

Billing address associated with the Cart.

Optional ReadonlybusinessUnit

businessUnit?: BusinessUnitResourceIdentifier

ResourceIdentifier to the Business Unit the Cart should belong to. When the customerId of the Cart is also set, the Customer must be an Associate of the Business Unit.

Optional Readonlycountry

country?: string

Used for Line Item price selection. If used for Create Cart in Store, the provided country must be one of the Store's countries.

Readonlycurrency

currency: string

Currency the Cart uses.

Optional Readonlycustom

custom?: CustomFieldsDraft

Custom Fields for the Cart.

Optional ReadonlycustomerEmail

customerEmail?: string

Email address of the Customer that the Cart belongs to.

Optional ReadonlycustomerGroup

customerGroup?: CustomerGroupResourceIdentifier

ResourceIdentifier to the Customer Group of the Customer that the Cart belongs to. Used for Line Item price selection.

It is automatically set if the Customer referenced in `customerId` belongs to a Customer Group.
It can also be set explicitly when no `customerId` is present.

Optional ReadonlycustomerId

customerId?: string

id of the Customer that the Cart belongs to.

Optional ReadonlycustomLineItems

customLineItems?: CustomLineItemDraft[]

Custom Line Items to add to the Cart.

Optional ReadonlycustomShipping

customShipping?: CustomShippingDraft[]

Custom Shipping Methods for a Cart with Multiple ShippingMode.

Optional ReadonlydeleteDaysAfterLastModification

deleteDaysAfterLastModification?: number

Number of days after which an active Cart is deleted since its last modification. If not provided, the default value for this field configured in Project settings is assigned.

Create a [ChangeSubscription](ctp:api:type:ChangeSubscription) for Carts to receive a [ResourceDeletedDeliveryPayload](ctp:api:type:ResourceDeletedDeliveryPayload) upon deletion of the Cart.

Optional ReadonlydiscountCodes

discountCodes?: string[]

code of the existing DiscountCodes to add to the Cart.

Optional ReadonlyexternalTaxRateForShippingMethod

externalTaxRateForShippingMethod?: ExternalTaxRateDraft

External Tax Rate for the shippingMethod if the Cart has External TaxMode.

Optional ReadonlyinventoryMode

inventoryMode?: string

Determines how stock quantities are tracked for Line Items in the Cart.

Optional ReadonlyitemShippingAddresses

itemShippingAddresses?: BaseAddress[]

Multiple shipping addresses of the Cart. Each address must contain a key that is unique in this Cart. The keys are used by LineItems to reference these addresses under their shippingDetails.

For Carts with `Single` [ShippingMode](ctp:api:type:ShippingMode): eligible Shipping Methods or applicable Tax Rates are determined by the address `shippingAddress`, and not `itemShippingAddresses`.

Optional Readonlykey

key?: string

User-defined unique identifier for the Cart.

Optional ReadonlylineItems

lineItems?: LineItemDraft[]

Line Items to add to the Cart.

Optional Readonlylocale

locale?: string

Languages of the Cart. Can only contain languages supported by the Project.

Optional Readonlyorigin

origin?: string

Indicates how the Cart was created.

Optional Readonlyshipping

shipping?: ShippingDraft[]

Shipping Methods for a Cart with Multiple ShippingMode.

Optional ReadonlyshippingAddress

shippingAddress?: _BaseAddress

Shipping address for a Cart with Single ShippingMode. Determines eligible ShippingMethod rates and Tax Rates of Line Items. Must be one of the itemShippingAddresses when that field is also provided.

Optional ReadonlyshippingMethod

shippingMethod?: ShippingMethodResourceIdentifier

Shipping Method for a Cart with Single ShippingMode. If the referenced ShippingMethod has a predicate that does not match the Cart, an InvalidOperation error is returned when creating a Cart.

Optional ReadonlyshippingMode

shippingMode?: string
  • If set to Single, only a single Shipping Method can be added to the Cart.
    • If set to Multiple, multiple Shipping Methods can be added to the Cart.

Optional ReadonlyshippingRateInput

shippingRateInput?: ShippingRateInputDraft

Used as an input to select a ShippingRatePriceTier. The data type of this field depends on the shippingRateInputType.type configured in the Project:

- If `CartClassification`, it must be [ClassificationShippingRateInputDraft](ctp:api:type:ClassificationShippingRateInputDraft).
- If `CartScore`, it must be [ScoreShippingRateInputDraft](ctp:api:type:ScoreShippingRateInputDraft).
- If `CartValue`, it cannot be set.

Optional Readonlystore

store?: StoreResourceIdentifier

ResourceIdentifier to the Store the Cart should belong to. Once set, it cannot be updated.

Optional ReadonlytaxCalculationMode

taxCalculationMode?: string

Determines how taxes are calculated for taxedPrice.

Optional ReadonlytaxMode

taxMode?: string

Determines how Tax Rates are set.

Optional ReadonlytaxRoundingMode

taxRoundingMode?: string

Determines how monetary values are rounded when calculating taxes for taxedPrice.

Settings

Member Visibility

On This Page

Properties