get https://{shopdomain}.myshoplaza.com/openapi/2022-01/center/procurements//items
Requires
read_inventory
access scope.
The Procurement Order Product List API retrieves the list of products associated with a specific procurement order. This API provides details about the items, including their quantities, variants, and other related metadata.
This API is especially useful for:
- Viewing the products included in a procurement order.
- Tracking the quantities and status of specific items in the procurement process.
- Managing product-level details for inventory or logistics purposes.
Request Parameters
Public Request Parameters
Path Parameters
Field | Type | Description | Required | Example |
---|---|---|---|---|
procurement_id | string | Unique identifier of the procurement order. | Yes | "385070142252984200" |
limit | string | Limit per page for the number of items returned. | Yes | "10" |
page | string | Page number for pagination. | Yes | "1" |
Response Explanation
Public Response Parameters
Success Response
Field | Type | Example | Description |
---|---|---|---|
count |
int32 | 1 |
Total number of items in the procurement order. |
items |
array | List of items in the procurement order. | |
items[]. |
int64 | 385700142268825400 |
Unique identifier for the procurement item. |
items[]. |
int32 | 10 |
Quantity of the item transferred. |
items[]. |
int32 | 0 |
Quantity of the item pending procurement. |
items[]. |
int32 | 10 |
Quantity of the item received. |
items[]. |
int32 | 0 |
Quantity of the item rejected. |
items[]. |
string | "1c5b9912-42af-41cb-bf7d-df609be87d20" |
Unique identifier of the product variant. |
items[]. |
string | "ac0b5372-4396-4415-979a-64e835abfd5b" |
Unique identifier of the product. |
items[]. |
object | Metadata about the product's image. | |
items[]. |
string | "//cdn.shoplazza.com/e1d7b475be103047d49d63c521ed0305.jpeg" |
Source URL of the product image. |
items[]. |
string | "" |
Alt text for the product image. |
items[]. |
int32 | 780 |
Width of the product image. |
items[]. |
int32 | 780 |
Height of the product image. |
items[]. |
string | "e1d7b475be103047d49d63c521ed0305.jpeg" |
Path of the product image in the storage system. |
items[]. |
string | "0415" |
Title of the product. |
items[]. |
string | "" |
Title of the product variant. |
items[]. |
string | "2024-05-30T07:54:40Z" |
Timestamp indicating when the procurement item was created. |
items[]. |
string | "2024-05-30T07:55:03Z" |
Timestamp indicating when the procurement item was last updated. |
items[]. |
int32 | 0 |
Indicator if the variant is deleted. |
items[]. |
int32 | 0 |
Purchase price of the item. |
items[]. |
string | "--A001125" |
SKU of the product variant. |
items[]. |
string | "20240530" |
Lot number of the item. |
items[]. |
string | "2026-05-29T17:00:00Z" |
Expiration date of the item, if applicable. |
items[]. |
int32 | 0 |
Quantity of the item shipped. |
items[]. |
int32 | 0 |
Quantity of the item shipped and received. |
Error Response
Error responses in the API can be represented using two different fields: errors
and error
. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.
Field | Type | Example | Description |
---|---|---|---|
error | String | "page not found" | Indicates an error encountered during the process |
Error Detail
Status Code | Message | Possible Reason | Example Response |
---|---|---|---|
400 | Bad Request | Invalid input format or request structure (e.g., missing required fields or incorrect data types). | Bad Request |
Unauthorized | The request is missing valid authentication credentials or the credentials provided are invalid. | Unauthorized |