Purchase Orders

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"
}