SalesReceipts
Columns
Name
Type
ReadOnly
References
Filterable
Sortable
Description
Id [KEY]
String
True
true
true
The Id of the sales receipt.
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.
CustomFieldAggregate
String
False
false
false
An XML aggregate of custom fields associated with the transaction.
DocNumber
String
False
true
true
Reference number for the transaction.
TxnDate
Date
False
true
true
The date when this transaction occurred.
DepartmentRef
String
False
Departments.Id
false
false
The Id of the department, which stores the location of the transaction as defined using location tracking in QuickBooks Online.
DepartmentRef_Name
String
True
Departments.Name
false
false
The name of the department, which stores the location of the transaction as defined using location tracking in QuickBooks Online.
PrivateNote
String
False
false
false
The private note about the transaction. This note will not appear on the transaction records by default.
TxnStatus
String
False
false
false
The status of the transaction. Depending on the transaction type it may have different values. For sales transactions, the acceptable values are defined in PaymentStatusEnum. For estimates, the values accepted are defined in QboEstimateStatusEnum.
LinkedTxnAggregate
String
False
false
false
Zero or more linked transactions.
LineAggregate
String
False
false
false
Zero or more lines for the transaction.
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.
CustomerRef
String
False
Customers.Id
true
false
The Id of the customer.
CustomerRef_Name
String
True
Customers.DisplayName
false
false
The name of the customer.
CustomerMemo
String
False
false
false
The message to the customer.
BillAddr_Id
String
False
false
false
The Id of the entity for the billing address, mainly used for modifying the address. This field is assigned by the data service.
BillAddr_Line1
String
False
false
false
First line of the address.
BillAddr_Line2
String
False
false
false
Second line of the address.
BillAddr_Line3
String
False
false
false
Third line of the address.
BillAddr_Line4
String
False
false
false
Fourth line of the address.
BillAddr_Line5
String
False
false
false
Fifth line of the address.
BillAddr_City
String
False
false
false
City name.
BillAddr_Country
String
False
false
false
Country name.
BillAddr_CountrySubDivisionCode
String
False
false
false
Region within a country. For example, the state name for the USA and the province name for Canada.
BillAddr_PostalCode
String
False
false
false
Postal code. For example, the zip code for the USA and Canada.
BillAddr_Note
String
False
false
false
The note for the customer.
BillAddr_Lat
String
False
false
false
Latitude coordinate of the geocoded address.
BillAddr_Long
String
False
false
false
Longitude coordinate of the geocoded address.
ShipAddr_Id
String
False
false
false
The Id of the entity for the shipping address, mainly used for modifying the address. This field is assigned by the data service.
ShipAddr_Line1
String
False
false
false
First line of the address.
ShipAddr_Line2
String
False
false
false
Second line of the address.
ShipAddr_Line3
String
False
false
false
Third line of the address.
ShipAddr_Line4
String
False
false
false
Fourth line of the address.
ShipAddr_Line5
String
False
false
false
Fifth line of the address.
ShipAddr_City
String
False
false
false
City name.
ShipAddr_Country
String
False
false
false
Country name.
ShipAddr_CountrySubDivisionCode
String
False
false
false
Region within a country. For example, the state name for the USA and the province name for Canada.
ShipAddr_PostalCode
String
False
false
false
Postal code. For example, the zip code for the USA and Canada.
ShipAddr_Note
String
False
false
false
Note for the customer.
ShipAddr_Lat
String
False
false
false
Latitude coordinate of the geocoded address.
ShipAddr_Long
String
False
false
false
Longitude coordinate of the geocoded address.
ClassRef
String
False
Class.Id
true
false
The Id of the class associated with the transaction.
ClassRef_Name
String
True
Class.FullyQualifiedName
false
false
The name of the class associated with the transaction.
ShipMethodRef
String
False
false
false
The Id of the shipping method associated with the transaction.
ShipMethodRef_Name
String
True
false
false
The name of the shipping method associated with the transaction.
ShipDate
Date
False
false
false
Date for delivery of goods or services.
TrackingNum
String
False
false
false
The tracking number of the shipping provider for the delivery of the goods associated with the transaction.
TotalAmt
Decimal
False
true
false
The total amount of the transaction. This includes the total of all the charges, allowances, and taxes. By default, this is recalculated and overriden based on total of the subitems. This field is calculated by QuickBooks business logic and cannot be written to QuickBooks.
PrintStatus
String
False
false
false
The print status of the invoice.
The allowed values are NotSet, NeedToPrint, PrintComplete.
The default value is NotSet.
EmailStatus
String
False
false
false
The email status of the invoice.
The allowed values are NotSet, NeedToSend, EmailSent.
The default value is NotSet.
BillEmail_Address
String
False
false
false
The email address where the sales receipt is sent.
Balance
Decimal
True
true
true
The balance reflecting any payments made against the transaction.
PaymentRefNum
String
False
false
false
The reference number for the payment.
PaymentMethodRef
String
False
PaymentMethods.Id
false
false
The Id of the payment method.
PaymentMethodRef_Name
String
True
PaymentMethods.Name
false
false
The name of the payment method.
DepositToAccountRef
String
False
Accounts.Id
false
false
The Id of the asset account where the payment money is deposited. If you do not specify this account, QBO uses the Undeposited Funds account.
DepositToAccountRef_Name
String
True
Accounts.Name
false
false
A name that identifies the asset account where the payment money is deposited. If you do not specify this account, QBO uses the Undeposited Funds account.
ApplyTaxAfterDiscount
Boolean
False
false
false
This field sets whether discounts are applied before the tax is calculated.
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
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.
HomeTotalAmt
Decimal
False
false
false
Total amount of the transaction in the home currency. This field is valid in the UK, AU, IN, and CA editions.
Last updated