Product Purchase Orders | Cloud Elements Help Center

Product Purchase Orders
A purchase order is a commercial document and first official offer issued by a customer indicating types, quantities, and agreed prices for products.

Field	Type	Description
amount	number	Amount of the purchase order, inclusive of tax.
currency	string	Currency of the purchase order.
id	string	Identifier for the purchase order, unique to the purchase order in the accounting platform.
lines	array	An array of purchase order lines
billingAddress	object	An object of billing address
purchaseOrderDate	date	Date of the invoice as recorded in the accounting system.
dueDate	date	Date the purchase order is due to be paid by.
modifiedDate	date	Date the record was last updated in the accounting system.
paymentTerms	object	An object of Payment Terms applicable to the purchase order
vendor	object	An object of vendor associated with the purchase order
createdDate	date	Date the record was created in the accounting system.
bill	array	An array of bills associated with this purchase order
externalId	string	Friendly reference of the purchase order/reference of purchase order from an external system
status	string	Current status of this purchase order
taxAmount	number	Amount of tax on the purchase order.
taxCode	string	Default tax code applied to the purchase order.
description	string	The description / reference / notes associated with the purchase order
totalAmountDue	number	Total amount that is due on the purchase order
totalAmountPaid	number	Total amount that is paid on that purchase order
glPostDate	date	The date of posting of this transaction in the accounting system (General Ledger)
account	string	The General Ledger account in which this transaction is posted
exchangeRate	number	Rate between the currency of the purchase order and the base currency.
subTotal	number	Total amount of the purchase order excluding any taxes.
shippingAddress	object	An object of shipping address
shippingMethod	string	The shipping method and terms used for the products in the purchase order
creditLimit	number	Current credit limit available from the vendor.
shipDate	date	The expected delivery date of the products in purchase order

lines

lines[*].department.id	string	The unique id of the department for which the product has been ordered.
lines[*].department.name	string	The name of the department for which the product has been ordered.
lines[*].description	string	The description / notes pertaining to the item
lines[*].location.id	string	The unique id of the location for which the product has been ordered.
lines[*].location.name	string	The name of the location for which the product has been ordered.
lines[*].product.cost	number	The unit cost of the product in the line
lines[*].product.id	string	The unique identifier of the product in the line
lines[*].product.name	string	The name of the product in the line
lines[*].customer.id	string	The unique identifier of the customer for whom the product is being procured.
lines[*].customer.name	string	The name of the customer for whom the product is being procured.
lines[*].product.purchaseUom	string	The purchase unit of measure of the product
lines[*].orderedQuantity	number	The ordered quantity of the product in the purchase order
lines[*].subTotal	number	Amount of the line, inclusive of discounts but exclusive of tax.
lines[*].taxAmount	number	The total tax amount of the line
lines[*].taxCode	string	The applied tax code pertaining to the line
lines[*].taxName	string	The applied tax description pertaining to the line
lines[*].account	string	The applicable General ledger account where the line is recorded
lines[*].taxRate	string	The percentage of tax applied to the line
lines[*].totalAmount	number	The total amount of the line including taxes
lines[*].discountAmount	number	Numerical value of any discounts applied.
lines[*].discountRate	string	The total discount rate applied on this line
lines[*].id	string	The unique identifier of the line in the purchase order
lines[*].isTaxable	boolean	Indicator whether the line is taxable or not

billingAddress

billingAddress.city	string	City of supplier's billing address
billingAddress.country	string	Country of supplier's billing address
billingAddress.id	string	Identifier of supplier's billing address in accounting system
billingAddress.line1	string	Address line1 of supplier's billing address
billingAddress.line2	string	Address line2 of supplier's billing address
billingAddress.phone	string	Phone number of supplier's billing address
billingAddress.postalCode	string	Postal code of supplier's billing address
billingAddress.province	string	Province of supplier's billing address
billingAddress.contact.firstName	string	First name of contact at supplier's billing address
billingAddress.contact.middleName	string	Middle name of contact at supplier's billing address
billingAddress.contact.lastName	string	Last name of contact at supplier's billing address
billingAddress.contact.salutation	string	Salutation / Title of contact at supplier's billing address
billingAddress.contact.email	string	Email of contact at supplier's billing address

shippingAddress

shippingAddress.city	string	City of supplier's shipping address
shippingAddress.country	string	Country of supplier's shipping address
shippingAddress.id	string	Identifier of supplier's shipping address in accounting system
shippingAddress.line1	string	Address line1 of supplier's shipping address
shippingAddress.line2	string	Address line2 of supplier's shipping address
shippingAddress.phone	string	Phone number of supplier's shipping address
shippingAddress.postalCode	string	Postal code of supplier's shipping address
shippingAddress.province	string	Province of supplier's shipping address
shippingAddress.contact.firstName	string	First name of contact at supplier's shipping address
shippingAddress.contact.middleName	string	Middle name of contact at supplier's shipping address
shippingAddress.contact.lastName	string	Last name of contact at supplier's shipping address
shippingAddress.contact.salutation	string	Salutation / Title of contact at supplier's shipping address
shippingAddress.contact.email	string	Email of contact at supplier's shipping address

paymentTerms

paymentTerms.id	string	Identifier of the payment terms.
paymentTerms.name	string	Name of the payment terms.

vendor

vendor.id	string	Identifier of the vendor
vendor.name	string	Name of the vendor
vendor.contact.address.city	string	The vendor contact person’s city
vendor.contact.address.country	string	The vendor contact person’s country
vendor.contact.address.line1	string	The vendor contact person’s Address Line 1
vendor.contact.address.line2	string	The vendor contact person’s Address Line 2
vendor.contact.address.postalCode	string	The vendor contact person’s Postal Code
vendor.contact.address.province	string	The vendor contact person’s Province
vendor.contact.email	string	The vendor contact person’s email
vendor.contact.firstName	string	The vendor contact person’s First name
vendor.contact.lastName	string	The vendor contact person’s Last name
vendor.contact.middleName	string	The vendor contact person’s Middle name
vendor.contact.mobile	string	The vendor contact person’s mobile
vendor.contact.phone	string	The vendor contact person’s phone number

bill

bill[*].id

string

Unique Identifier of the bill