Requireswrite_productaccess scope. More access scope
The Receive Procurement API processes the receipt of procurement items by updating their quantities (received and rejected) and recording any rejection reasons. This API is used for managing procurement workflows and tracking item status upon receipt.This API is especially useful for:
- Recording quantities of items received and rejected during the procurement process.
- Providing reasons for rejected items to ensure transparency in procurement workflows.
- Tracking and updating the state of procurement items for better inventory management.
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| id | string | Yes | "382451985837728044" | The unique identifier of the procurement record. |
Body Parameters
Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
items |
| Yes | See below | The array of items to update with received and rejected quantities. |
|
| Yes | | The unique identifier of the procurement item. |
|
| Yes |
| The quantity of the item that was successfully received. |
|
| Yes |
| The quantity of the item that was rejected. |
|
| No |
| The reason for rejecting the item. |
Response Explanation
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 |
|---|---|---|---|
errors | Array | ["Supplier not found"] | A list of errors encountered during the request processing. |
| Field | Type | Example | Description |
|---|---|---|---|
error | Array | "error": "store is not active" | Indicates an error encountered during the process. |
Error Details
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). |
|
Unauthorized | The request is missing valid authentication credentials or the credentials provided are invalid. |
| |
422 |
| One or more of the following conditions apply: | |
Duplicated procurement item id | API request contains multiple entries with the same procurement_item_id |