Bills

Columns

Name

Type

ReadOnly

References

Filterable

Sortable

Description

Id [KEY]

String

True

true

true

The Id of the bill.

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

The reference number for the transaction.

TxnDate

Date

False

true

true

The date of the transaction. This field is often the date when the transaction was entered into the system, but it is not required to be. For posting transactions, this is the posting date that affects financial statements.

PrivateNote

String

False

false

false

A private note about the transaction. This note will not appear on the transaction records by default.

LinkedTxnAggregate

String

False

false

false

An XML aggregate of transactions linked to the estimate.

LineAggregate

String

False

false

false

An XML aggregate of the line items of the bill.

VendorRef

String

False

true

true

The Id of the vendor.

VendorRef_Name

String

True

Vendors.DisplayName

false

false

The name of the vendor associated with the transaction.

APAccountRef

String

False

Accounts.Id

true

true

The Id of the accounts-payable account.

APAccountRef_Name

String

True

Accounts.Name

false

false

The name of the accounts-payable account.

TotalAmt

Decimal

False

true

true

The total amount due, determined by taking the sum of the line items.

SalesTermRef

String

False

Terms.Id

true

true

The Id of the sales terms entity of the bill.

SalesTermRef_Name

String

True

Terms.Name

false

false

A name that identifies the sales terms entity of the bill.

DueDate

Date

False

true

true

The due date for the bill, excluding early payment discount incentives and late payment penalties.

Balance

Decimal

True

true

false

The unpaid amount of the bill. When paid in full this value is 0.

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.

TxnTaxDetail_TxnTaxCodeRef

String

False

TaxCodes.Id

false

false

The tax code of the transaction.

TxnTaxDetail_TotalTax

String

False

false

false

The 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 available only if the multicurrency feature has been set for the company file. 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 only the UK, AU, IN, and CA editions.

GlobalTaxCalculation

String

False

false

false

The method used to apply the tax. This field is valid in only the UK, AU, IN, and CA editions.

The allowed values are TaxExcluded, TaxInclusive, NotApplicable.

Last updated