Purchase Orders

A purchase order is a commercial document and the first official offer issued by a buyer to a seller indicating types, quantities, and agreed prices for products or services. Using the Rutter Purchase Orders endpoint, you can get a list of all the purchase orders for a specified business.

Field	Type	Description
id	string	A Rutter designated ID for this purchase order. It always will be in UUID format.
platform_id	string	Unique Platform ID for the purchase order.
document_number	string	Reference document number for the purchase order.
vendor_id	string	The ID of the vendor that the purchase order is recorded against in the accounting system.
vendor_name	string	Name of the vendor to which the purchase order was sent.
line_items	Purchase Orders Line Item[]	An array of purchase order line items.
posted_date	string	Date of the purchase order as recorded in the accounting platform in ISO 8601 format.
status	string	Current status of a purchase order: `open` `closed`
total_quantity	number	The quantity within the purchase order.
total_amount	number	Amount of the purchase order.

Purchase Orders Line Item

Field	Type	Description
platform_id	string	The platform ID for this purchase order line item.
item_id	string	Platform ID of the product/service for this purchase order line item. Use this value to query a specific `item` by id from Items endpoint.
item_name	string	Name of the product/service for this purchase order line item.
quantity	number	The quantity of the product/service for this purchase order line item.
quantity_received	number	The quantity received of the product/service for this purchase order line item.
quantity_billed	number	The quantity billed of the product/service for this purchase order line item.
unit_amount	number	Price per quantity for this purchase order line item.
line_items	Purchase Orders Line Item[]	An array of purchase order line items within this line item.
amount	number	The amount for this purchase order line item.
amount_received	number	The amount received for this purchase order line item.
amount_billed	number	The amount billed for this purchase order line item.

{
   "id":"b22b2222-2b2b-2bb2-bbb2-bb222bb2b22",
   "platform_id":"1234",
   "purchase_order_id":"1000",
   "document_number":"PO-00-0000",
   "vendor_id":"12345",
   "name":"Rutter Swag",
   "line_items":[
      {
         "id":"b11b1111-1b1b-1bb1-bbb1-bb111bb1b11",
         "platform_id":"4321",
         "name":"Rutter T-shirt",
         "quantity":"300",
         "quantity_received":null,
         "quantity_bill":null,
         "unit_amount":"25",
         "line_items":[],
         "amount":"7500",
         "amount_received":null,
         "amount_billed":null,
         "amount_received_minus_billed":null
      },
      {
         "id":"a11a1111-1a1a-1aa1-aaa1-aa111aa1a11",
         "platform_id":"4433",
         "name":"Rutter Hoodie",
         "quantity":"10",
         "quantity_received":null,
         "quantity_bill":null,
         "unit_amount":"49.4",
         "line_items":[],
         "amount":"494",
         "amount_received":null,
         "amount_billed":null,
         "amount_received_minus_billed":null
      }
   ],
   "posted_date":"2022-01-26T16:00:00.000Z",
   "status":"Open",
   "total_quantity":"310",
   "total_amount":"9774"
}