Bills
Last updated
Last updated
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
Vendors.Id
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.