The Purchase Order object

The name of the custom field, unique for the specified ownerId. For public custom fields, this name is visible as a label in the QuickBooks UI.

The identifier of the owner of the custom field, which QuickBooks internally calls a "data extension". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always "0". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an ownerId of "0") for all objects.

The data type of this custom field.

The value of this custom field. The maximum length depends on the field's data type.

The custom fields for the purchase order line group object, added as user-defined data extensions, not included in the standard QuickBooks object.

A description of this purchase order line group.

The unique identifier assigned by QuickBooks to this purchase order line group. This ID is unique across all transaction line types.

The purchase order line group's item group, representing a predefined set of items bundled because they are commonly purchased together or grouped for faster entry.

The purchase order line group's line items, each representing a single product or service ordered.

The type of object. This value is always "qbd_purchase_order_line_group".

Specifies an alternative unit-of-measure set when updating this purchase order line group's unitOfMeasure field (e.g., "pound" or "kilogram"). This allows you to select units from a different set than the item's default unit-of-measure set, which remains unchanged on the item itself. The override applies only to this specific line. For example, you can sell an item typically measured in volume units using weight units in a specific transaction by specifying a different unit-of-measure set with this field.

The quantity of the item group associated with this purchase order line group. This field cannot be cleared.

Indicates whether the individual items in this purchase order line group and their separate amounts appear on printed forms.

The total monetary amount of this purchase order line group, equivalent to the sum of the amounts in lines, represented as a decimal string.

The unit-of-measure used for the quantity in this purchase order line group. Must be a valid unit within the item's available units of measure.

The monetary amount of this purchase order line, represented as a decimal string. If both quantity and rate are specified but not amount, QuickBooks will use them to calculate amount. If amount, rate, and quantity are all unspecified, then QuickBooks will calculate amount based on a quantity of 1 and the suggested rate. This field cannot be cleared.

The purchase order line's class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default. If a class is specified for the entire parent transaction, it is automatically applied to all purchase order lines unless overridden here, at the transaction line level.

The custom fields for the purchase order line object, added as user-defined data extensions, not included in the standard QuickBooks object.

A description of this purchase order line.

The unique identifier assigned by QuickBooks to this purchase order line. This ID is unique across all transaction line types.

The specific location (e.g., bin or shelf) within the inventory site where the item associated with this purchase order line is stored.

Indicates whether this purchase order line has been billed.

Indicates whether this purchase order line has been manually marked as closed, even if this item has not been received or its sale has not been cancelled. If all the purchase order lines are marked as closed, the purchase order itself is marked as closed as well. You cannot change isManuallyClosed to false after the purchase order line has been fully received.

The item associated with this purchase order line. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.

The type of object. This value is always "qbd_purchase_order_line".

A built-in custom field for additional information specific to this purchase order line. Unlike the user-defined fields in the customFields array, this is a standard QuickBooks field that exists for all purchase order lines for convenience. Developers often use this field for tracking information that doesn't fit into other standard QuickBooks fields. Hidden by default in the QuickBooks UI.

A second built-in custom field for additional information specific to this purchase order line. Unlike the user-defined fields in the customFields array, this is a standard QuickBooks field that exists for all purchase order lines for convenience. Like otherCustomField1, developers often use this field for tracking information that doesn't fit into other standard QuickBooks fields. Hidden by default in the QuickBooks UI.

Specifies an alternative unit-of-measure set when updating this purchase order line's unitOfMeasure field (e.g., "pound" or "kilogram"). This allows you to select units from a different set than the item's default unit-of-measure set, which remains unchanged on the item itself. The override applies only to this specific line. For example, you can sell an item typically measured in volume units using weight units in a specific transaction by specifying a different unit-of-measure set with this field.

If account refers to an Accounts-Payable (A/P) account, payee refers to the expense's vendor (not the customer). If account refers to any other type of account, payee refers to the expense's customer (not the vendor).

The quantity of the item associated with this purchase order line. This field cannot be cleared.

The price per unit for this purchase order line. If both rate and amount are specified, rate will be ignored. If both quantity and amount are specified but not rate, QuickBooks will use them to calculate rate. Represented as a decimal string. This field cannot be cleared.

The quantity that has been received against this purchase order line.

The sales-tax code for this purchase order line, determining whether it is taxable or non-taxable. If set, this overrides any sales-tax codes defined on the parent transaction or the associated item.

Default codes include "Non" (non-taxable) and "Tax" (taxable), but custom codes can also be created in QuickBooks. If QuickBooks is not set up to charge sales tax (via the "Do You Charge Sales Tax?" preference), it will assign the default non-taxable code to all sales.

The date on which the service for this purchase order line was or will be performed, in ISO 8601 format (YYYY-MM-DD). This is particularly relevant for service items.

The purchase order line's stock keeping unit (SKU), which is sometimes the manufacturer's part number.

The quantity that has not been billed for this purchase order line.

The unit-of-measure used for the quantity in this purchase order line. Must be a valid unit within the item's available units of measure.

The monetary amount of this linked transaction, represented as a decimal string.

The unique identifier assigned by QuickBooks to this linked transaction. This ID is unique across all transaction types.

Indicates the nature of the link between the transactions: amount denotes an amount-based link (e.g., an invoice linked to a payment), and quantity denotes a quantity-based link (e.g., an invoice created from a sales order based on the quantity of items received).

The type of object. This value is always "qbd_linked_transaction".

The case-sensitive user-defined reference number for this linked transaction, which can be used to identify the transaction in QuickBooks. This value is not required to be unique and can be arbitrarily changed by the QuickBooks user.

The date of this linked transaction, in ISO 8601 format (YYYY-MM-DD).

The type of transaction for this linked transaction.