# PurchaseOrders

A Purchasing document

## Starts the Tiered Purchase Order Approval process

 - [POST /purchaseOrders/{id}/requestTieredApproval](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/post-purchaseorders-tieredapproval-request.md)

## Approves a Purchase Order Tier

 - [PUT /purchaseOrders/tieredApproval](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/put-purchaseorders-tieredapproval.md)

## Gets Purchase Orders

 - [GET /purchaseOrders](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/get-purchaseorders.md): Example use cases

api/v2/purchaseOrders?pageNumber=1&pageSize=100&Filter=committed>2024-03-05T06:06:58.529Z&Filter=lastUpdated>2024-03-06&orderBy=committed

will get the first page of purchase orders where the committed date is later than 2024-03-05T06:06:58.529Z AND the lastUpdated date is later than 2024-03-06T00:00:00Z, ordering by the committed date


/api/v2/purchaseOrders?pageNumber=1&pageSize=100&Filter=committed>2024-03-05T06:06:58.529Z&orderBy=committed

will get the first page of purchase orders where the committed date is later than 2024-03-05T06:06:58.529Z ordering by the committed date.

## Creates Purchase Orders.

 - [POST /purchaseOrders](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/post-purchaseorders.md)

## Get Purchase Order by Id

 - [GET /purchaseOrders/{id}](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/get-purchaseorders-byid.md)

## Get Purchase Order by token

 - [GET /purchaseOrders/byToken](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/get-purchaseorders-bytoken.md)

## Get Purchase Order Approval Status by Id of Purchase Order

 - [GET /purchaseOrders/{id}/approvalStatus](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/get-purchaseorders-approvalstatus-byid.md)

## Get Purchase Order Approval Status using token

 - [GET /purchaseOrders/approvalStatusByToken](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/get-purchaseorders-approvalstatus-bytoken.md)

## Update Committed Purchase orders

 - [PATCH /purchaseOrders/updateCommitted](https://developer.yellowdogsoftware.com/rest/fetch/api/purchaseorders/patch-leafroute.md): Infrequently there are use cases where a previously committed purchase order would be allowed to have new Lines added or other adjustments to the document.

The following properties of a committed purchase order are prohibited from being updated
- Commdoc
- Committed Status 
- Committed Date Time 
- Vendor
- Store
- Arrival Log

The following requirements in place for a purchase order to be edited using this method.
- User making the request has the appropriate permissions to edit Purchase Orders after Commit.
- Only purchase orders that have been committed but do not have any kind of purchasing activity against them will be allowed to be edited.