Step 7. Create a cart and add products to it

Next, we’ll create a cart and add the items that we modified in Step 5. Reassign products to custom sources.

Create a cart

The call to create a cart and add items must contain the customer’s authorization token in the authorization header.

Endpoint:

POST <host>/rest/us/V1/carts/mine

Scope:

us store view

Headers:

Content-Type: application/json

Authorization: Bearer <customer_token>

Payload:

None

Response:

The response is the quoteId: 3

Check for product availability

In Step 5. Reassign products to custom sources, we defined the quantities of products 24-WB01 and 24-WB03 for the US source as follows:

Later in this step, we’ll order 20 24-WB01 items and 50 24-WB03 items. We can see that we have enough salable items for both products, but let’s check programmatically.

Check for product 24-WB01

The get-product-salable-quantity endpoint indicates how many items are available for sale for the specified product (24-WB01) and source (2).

Endpoint:

GET <host>/rest/us/V1/inventory/get-product-salable-quantity/24-WB01/2

Scope:

us store view

Headers:

Content-Type: application/json

Authorization: Bearer <admin_token>

Payload:

Not applicable

Response:

70

Check for product 24-WB03

Use the same endpoint to check the quantity available for product 24-WB03.

Endpoint:

GET <host>/rest/us/V1/inventory/get-product-salable-quantity/24-WB03/2

Scope:

us store view

Headers:

Content-Type: application/json

Authorization: Bearer <admin_token>

Payload:

Not applicable

Response:

61

Add items to the cart

We have ensured that we have enough physical products in stock to fulfill the potential order.

Add the first simple product

In this call, we’ll add 20 24-WB01 items. This portion of the order can be fulfilled from the Baltimore or Reno warehouse.

Endpoint:

POST <host>/rest/us/V1/carts/mine/items

Scope:

us store view

Headers:

Content-Type: application/json

Authorization: Bearer <customer_token>

Payload:

1
2
3
4
5
6
7
{
  "cartItem": {
    "sku": "24-WB01",
    "qty": 20,
    "quote_id": "3"
  }
}

Response:

Note the item_id for use in subsequent steps.

1
2
3
4
5
6
7
8
{
    "item_id": 5,
    "sku": "24-WB01",
    "qty": 20,
    "name": "Voyage Yoga Bag",
    "product_type": "simple",
    "quote_id": "3"
}

Add the second simple product

Use the same endpoint to add 50 items of 24-WB03 to the cart. Multiple sources will be required to fulfill this potential order.

Payload:

1
2
3
4
5
6
7
{
  "cartItem": {
    "sku": "24-WB03",
    "qty": 50,
    "quote_id": "3"
  }
}

Response:

Note the item_id for use in subsequent steps.

1
2
3
4
5
6
7
8
9
{
    "item_id": 6,
    "sku": "24-WB03",
    "qty": 50,
    "name": "Driven Backpack",
    "price": 36,
    "product_type": "simple",
    "quote_id": "3"
}

Add a downloadable product

Finally, we’ll add a single instance of a downloadable product to the cart.

Payload:

1
2
3
4
5
6
7
{
  "cartItem": {
    "sku": "240-LV06",
    "qty": 1,
    "quote_id": "3"
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
    "item_id": 7,
    "sku": "240-LV06",
    "qty": 1,
    "name": "Yoga Adventure",
    "price": 22,
    "product_type": "downloadable",
    "quote_id": "3",
    "product_option": {
        "extension_attributes": {
            "downloadable_option": {
                "downloadable_links": [
                    3
                ]
            }
        }
    }
}

Verify this step

Sign in as the customer at http://<host>/us and click on the shopping cart. All the items you added display in the cart.