delete
https://{subdomain}.myshoplaza.com/openapi/2025-06/procurements//items
Removes multiple items from a specific procurement order.
Requireswrite_inventoryaccess scope. More access scope
The Batch Update Procurement Items API allows users to removes multiple items from a procurement order in a single operation.
This API is especially useful for:
- Cleaning up erroneous procurement entries in bulk
- Removing discontinued items from active procurements
- Synchronizing procurement records with inventory changes
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
procurement_id | string | Yes | Unique identifier of the procurement record | "proc_123456789" |
Body Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
procurement_item_ids | array of strings | Yes | IDs of items to remove | ["item_987654", "item_555555"] |
Response Explanation
Public Response Parameters
Successful Response
| Parameter | Type | Example | Description |
|---|---|---|---|
code | string | "200" | HTTP status code |
message | string | "Items deleted successfully" | Operation result message |
data.deleted_count | int32 | 2 | Number of successfully removed items |
data.failed_ids | array of strings | ["item_111111"] | IDs that couldn't be deleted |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |