Follows:
Authentication •
Caching •
Polling •
List Response Format
Creates a new purchase order issued to a vendor, with its line items.
Depending on your AppFolio configuration, creating a purchase order may enter
an approval workflow and notify approvers. The vendor must already exist;
create one first with Create a Vendor
if needed. Purchase orders issued to your management company or to a
supplier, and ship-to portfolios, are not yet supported.
Parameters
vendorIdstring
AppFolio ID of the vendor the purchase order is issued to. Look vendors up with the Vendors endpoint.
lineItemsmulti
Line items for the purchase order, as a JSON array. Each entry requires "glAccountId", "propertyId" and "itemAmount" (the per-unit cost as a decimal string such as "125.00"), and may carry "quantity" (a whole number as a string such as "2"; defaults to "1"), "description" and "unitId". At least one line item is required.
shipToPropertyIdstring
AppFolio ID of the property the order ships to. When omitted, no ship-to address is set.
workOrderIdsmulti
AppFolio IDs of work orders to associate the purchase order with, as a JSON array of strings. Look work orders up with the Work Orders endpoint.
requiredBystring
Date the order is required by, as MM/DD/YYYY.
invoiceNumberstring
Vendor invoice number to record on the purchase order.
instructionsstring
Instructions to the vendor, shown on the purchase order.
numberstring
Purchase order number. When omitted, AppFolio assigns the next number automatically.
Returns
The standard List Response Format with a data property containing an array with the created purchase order as a Purchase Order Detail object.
The response reflects the purchase order as stored in AppFolio, not the
request as submitted — the same shape
Get One Purchase Order
returns, not the list row. When number was omitted, the response carries the
number AppFolio assigned.