When you install or upgrade Magento, the system assigns all existing products to the default source. Magento also assigns all subsequently-created products to the default source. For this tutorial, we want to unassign three products from the default source and assign them to custom sources.

The following table describes the products we’ll use in this tutorial.

Unassign products from the default source

Use the POST V1/inventory/source-items-delete endpoint to unassign one or more products from the specified source. The sku and source_code attributes are required for each product.

When you unassign a source from a product, all source data including inventory amounts is removed from that product. This can affect salable quantities and reservations for unprocessed orders. After checkout and before shipment, all product quantities in the order have associated reservations. If you unassign a source, you can cause issues with reservations and processing orders. In a production environment, Magento strongly recommends completing all orders and shipments for those products prior to removing the source.

Endpoint:

POST <host>/rest/all/V1/inventory/source-items-delete

Scope:

all store views

Headers:

Content-Type: application/json

Authorization: Bearer <admin_token>

Payload:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "sourceItems": [{
    "sku": "24-WB01",
    "source_code": "default"
  },
  {
    "sku": "24-WB03",
    "source_code": "default"
  },
  {
    "sku": "240-LV06",
    "source_code": "default"
  }]
}

Response:

Magento returns an empty array.

[]

Assign products to custom sources

Now we can assign each product to one or more sources. The POST V1/inventory/source-items endpoint allows you to specify the quantity of each product that is available at each source.

Endpoint:

POST <host>/rest/all/V1/inventory/source-items

Scope:

all store views

Headers:

Content-Type: application/json Authorization: Bearer <admin_token>`

Payload:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
{
  "sourceItems": [{
    "sku": "24-WB01",
    "source_code": "baltimore_wh",
    "quantity": 35,
    "status": 1
  },
  {
    "sku": "24-WB01",
    "source_code": "austin_wh",
    "quantity": 10,
    "status": 1
  },
  {
    "sku": "24-WB01",
    "source_code": "reno_wh",
    "quantity": 25,
    "status": 1
  },
  {
    "sku": "24-WB01",
    "source_code": "berlin_wh",
    "quantity": 15,
    "status": 1
  },
  {
    "sku": "24-WB01",
    "source_code": "frankfurt_wh",
    "quantity": 15,
    "status": 1
  },
  {
    "sku": "24-WB03",
    "source_code": "baltimore_wh",
    "quantity": 19,
    "status": 1
  },
  {
    "sku": "24-WB03",
    "source_code": "austin_wh",
    "quantity": 0,
    "status": 1
  },
  {
    "sku": "24-WB03",
    "source_code": "reno_wh",
    "quantity": 42,
    "status": 1
  },
  {
    "sku": "24-WB03",
    "source_code": "berlin_wh",
    "quantity": 32,
    "status": 1
  },
  {
    "sku": "24-WB03",
    "source_code": "frankfurt_wh",
    "quantity": 7,
    "status": 1
  },
  {
    "sku": "240-LV06",
    "source_code": "hq",
    "quantity": 9999,
    "status": 1
  }]
}

Response:

Magento returns an empty array.

[]

Verify this step

In Admin, click Catalog > Products. Products 24-WB01, 24-WB03, and 240-LV06 display quantities per assigned source in the Quantity Per Source column and an aggregated total of products per stock in the Salable Quantity column.