Manage source items
If Adobe Commerce is configured to manage inventory, Commerce assigns all existing products to the default source. Currently, Commerce also assigns newly-created products to the default source. Single Source merchants do not need to manage source items, but Multi Source merchants may need to move products from the default source to a custom source, or move products from one custom source to another.
Service names:
Copied to your clipboardinventoryApiSourceItemsDeleteV1inventoryApiSourceItemsSaveV1inventoryApiSourceItemRepositoryV1
REST endpoints:
Copied to your clipboardPOST V1/inventory/source-items-deletePOST V1/inventory/source-itemsGET V1/inventory/source-items
sourceItems parameters:
| Name | Description | Type | Requirements |
|---|---|---|---|
sku | The SKU of an existing product | String | Required to assign or unassign a source |
source_code | The source to assign or unassign | String | Required to assign or unassign a source |
quantity | The total amount of inventory available for this SKU and source | Float | Optional |
status | Indicates whether the product is out of stock (0) or in stock (1) | Integer | Optional |
Unassign products from a 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.
Unassigning a source clears all quantity data. For this example, this is OK, because the default source did not contain any quantity data. Reassigning a source that contains real quantity data can potentially cause havoc with pending orders with reservations and affect the salable quantity counts. See the merchant documentation for more details.
Sample usage:
POST <host>/rest/<store_code>/V1/inventory/source-items-delete
Payload:
Copied to your clipboard{"sourceItems": [{"sku": "new_product1","source_code": "default"},{"sku": "new_product2","source_code": "default"}]}
Response:
Commerce returns an empty array.
[]
Assign products to a source
POST V1/inventory/source-items is a powerful endpoint that allows you to define which sources carry each product as well as how many units are available at each source. You can use the endpoint to set up the initial quantities for each SKU at each source or add quantities as you receive shipments to replenish your supply.
If a bundle product is configured so that all items must be shipped together, then all component products must be assigned to the same source.
The following example assigns 1000 units of product new_product1 to the central source and 2000 units to the east source. It also assigns 500 units of product new_product2 to the central source and 250 units to the east source.
Sample usage:
POST <host>/rest/<store_code>/V1/inventory/source-items
Payload:
Copied to your clipboard{"sourceItems": [{"sku": "new_product1","source_code": "central","quantity": 1000,"status": 1},{"sku": "new_product1","source_code": "east","quantity": 2000,"status": 1},{"sku": "new_product2","source_code": "central","quantity": 500,"status": 1},{"sku": "new_product2","source_code": "east","quantity": 250,"status": 1}]}
Response:
Commerce returns an empty array.
[]
Search for source items
The following call returns all source items for sku = new_product2.
See Search using REST APIs for information about constructing a search query.
Sample Usage:
GET <host>/rest/<store_code>/V1/inventory/source-items?searchCriteria[filter_groups][0][filters][0][field]=sku&searchCriteria[filter_groups][0][filters][0][value]=new_product2&searchCriteria[filter_groups][0][filters][0][condition_type]=eq
Payload:
None
Response:
Copied to your clipboard{"items": [{"sku": "new_product2","source_code": "central","quantity": 500,"status": 1},{"sku": "new_product2","source_code": "east","quantity": 250,"status": 1}],"search_criteria": {"filter_groups": [{"filters": [{"field": "sku","value": "new_product2","condition_type": "eq"}]}]},"total_count": 2}
