---
title: "cartCreate"
description: "创建购物车"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/cart/mutations/cart-create'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/cart/mutations/cart-create.md'
---
# cartCreate

创建购物车

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`CartCreatePayload`

## Arguments

* `input`

  [CartInput](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/cart/inputs/cart-input.md)

  入参

## Returns

* `cart`

  [Cart](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/cart/objects/cart.md)

  购物车

* `userErrors`

  [[CartUserError]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/cart/objects/cart-user-error.md)

  错误信息列表

## Code Example

```graphql
mutation cartCreate($input: CartInput ) {
	cartCreate(input: $input ) 
		 {
			# CartCreatePayload fields
		}
		
	}

```

## Variables

```json
{
  "input": {
    "attributes": {
      "key": "",
      "value": ""
    },
    "buyerIdentity": {
      "countryCode": "",
      "customerAccessToken": "",
      "email": "",
      "phone": ""
    },
    "countryCode": "",
    "isNeedReturnCartDetail": {},
    "language": "",
    "lines": {
      "attributes": "{}",
      "quantity": {},
      "variantId": ""
    },
    "note": {},
    "userToken": ""
  }
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。