Purchase Order API
The Inventory Purchase Order Model
The Inventory Purchase Order object represents a purchase order in the system. Below is an example of an Inventory Purchase Order object with all possible fields.
{
"rush": true,
"status": "Ordered",
"supplierId": "SUP12345",
"vendorOrderNumber": "VON67890",
"shipper": "FedEx",
"trackingNumber": "TRK123456789",
"shippingCost": 25.5,
"taxes": 5.75,
"otherCostAdjustments": 2.0,
"note": "Urgent order"
}Inventory Purchase Order Object Properties
This model supports multiple types of updates. An update can contain:
- A rush order flag.
- A status update.
- Detailed order information updates.
Field | Type | Required | Description |
|---|---|---|---|
|
| No | Indicates if the order is a rush order. |
|
| No | The status of the purchase order (Ordered/Reconciled). |
|
| No | The supplier ID for the purchase order. |
|
| No | The vendor's order number for reference. |
|
| No | The shipping provider (e.g., FedEx, UPS). |
|
| No | The tracking number for the shipment. |
|
| No | The cost of shipping the order. |
|
| No | The tax amount for the purchase order. |
|
| No | Any additional cost adjustments. |
|
| No | Any additional notes related to the order. |
Update Options
Updates to an Inventory Purchase Order can be made using any of the following bodies:
- Rush Order Update: Contains only the
rushfield. - Status Update: Contains only the
statusfield. - Order Info Update: Contains fields such as
supplierId,vendorOrderNumber,shipper,trackingNumber,shippingCost,taxes,otherCostAdjustments, andnote.
All three updates are possible and can be applied separately or together based on the update requirements.
Purchase Order Resources
Get all purchase orders
This endpoint returns a list of all purchase orders.
HTTP Request
GET https://www.myrepairapp.com/api/v2/inventory/orderResponse
If successful, the response will include a list of all purchase orders from the inventory.
Create a purchase order
This endpoint creates an empty purchase order.
HTTP Request
POST https://www.myrepairapp.com/api/v2/inventory/orderRequest Body
There should be no request body for this endpoint.
Response
If successful, the response will include the details of the newly created purchase order.
Get a purchase order by ID
This endpoint returns a single purchase order by ID.
HTTP Request
GET https://www.myrepairapp.com/api/v2/inventory/order/{id}Response
If successful, the response will include the details of the requested purchase order.
Update a purchase order
This endpoint updates a purchase order's information.
HTTP Request
PATCH https://www.myrepairapp.com/api/v2/inventory/order/{id}Request Body
The request body can contain any of the following fields:
rushstatussupplierIdvendorOrderNumbershippertrackingNumbershippingCosttaxesotherCostAdjustmentsnote
Response
If successful, the response will include the updated purchase order's details.
Delete a purchase order
This endpoint deletes a purchase order.
HTTP Request
DELETE https://www.myrepairapp.com/api/v2/inventory/order/{id}Response
If successful, the response will include a confirmation message that the purchase order has been deleted.