Purchases

Columns

Name

Type

ReadOnly

References

Filterable

Sortable

Description

Id [KEY]

String

True

true

true

The Id of the purchase.

SyncToken

String

True

false

false

Version number of the object. It is used to lock an object for use by one app at a time. As soon as an application modifies an object, its SyncToken is incremented. Attempts to modify an object specifying an older SyncToken fails. Only the latest version of the object is maintained by QuickBooks Online.

MetaData_CreateTime

Datetime

True

true

true

The time the record was created.

MetaData_LastUpdatedTime

Datetime

True

true

true

The time the record was last updated.

DocNumber

String

False

true

true

Reference number for the transaction.

TxnDate

Date

False

true

true

The date when this transaction occurred.

PrivateNote

String

False

false

false

A private note about the transaction. This note will not appear on the transaction records by default. This field maps to the Memo field on the Check and CreditCard form.

LineAggregate

String

False

false

false

A line item of a transaction.

AccountRef

String

False

Accounts.Id

false

false

The Id of the account associated with the purchase. Check payments should reference a bank account and credit card purchases should refer to a credit card account.

AccountRef_Name

String

True

Accounts.Name

false

false

A name that identifies the account associated with the purchase. Checks should reference a bank account and credit card purchases should refer to a credit card account.

PaymentType

String

False

true

true

The payment type.

The allowed values are Cash, Check, CreditCard.

EntityRef

String

False

false

false

The Id of the entity for the party the expense is associated with.

EntityRef_Name

String

True

false

false

A name that identifies the party the expense is associated with.

Credit

Boolean

False

false

false

This field is valid only for the credit card payment type.

TotalAmt

Decimal

True

true

true

The total amount due, determined by the sum of the line item amounts. This includes all charges, allowances, taxes, discounts, etc.

PrintStatus

String

False

false

false

The print status of the purchase. This field is applicable only for checks and ignored for credit card charges or refunds.

DepartmentRef

String

False

Departments.Id

false

false

The Id of the department, which stores the location of the transaction.

DepartmentRef_Name

String

True

Departments.Name

false

false

The name of the department, which stores the location of the transaction.

Status

String

True

false

false

The status of the purchase.

TxnTaxDetail_TxnTaxCodeRef

String

False

TaxCodes.Id

false

false

The transaction tax code.

TxnTaxDetail_TotalTax

String

False

false

false

Total tax calculated for the transaction, excluding any tax lines manually inserted into the transaction line list.

TxnTaxDetail_TaxLineAggregate

String

False

false

false

An XML aggregate of tax line items.

CurrencyRef

String

False

false

false

The Id of the currency used in the transaction.

CurrencyRef_Name

String

True

false

false

The name of the currency used in the transaction.

ExchangeRate

Decimal

False

false

false

The currency exchange rate. This field is valid only if the company file is set up to use the multicurrency feature. In QuickBooks, exchange rates are always recorded as the number of home currency units it takes to equal one foreign currency unit. This field is available for the UK, AU, IN, and CA editions.

GlobalTaxCalculation

String

False

false

false

Method in which tax is applied. This field is valid in the UK, AU, IN, and CA editions.

The allowed values are TaxExcluded, TaxInclusive, NotApplicable.

Last updated