Skip to content

QuickBooks: Sample batch request — request body — body Batch Item Request item

Sample batch request: request body, field body / BatchItemRequest / item. Complete fields and constraints for contract 2026-10-20.

API reference · Contract 2026-10-20

SDK schema: Sample batch request — request body — body Batch Item Request item

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)objectAlternativeAdditional keys: not allowed
$ (anyOf 1).bIdstringRequired within parentMinimum length: 1
$ (anyOf 1).QuerystringRequired within parentMinimum length: 1
$ (anyOf 2)objectAlternativeAdditional keys: not allowed
$ (anyOf 2).bIdstringRequired within parentMinimum length: 1
$ (anyOf 2).operationJSONRequired within parentMust equal: create
$ (anyOf 2).AccountobjectRequired within parentAdditional keys: not allowed
$ (anyOf 2).Account.AccountSubTypestringOptionalThe account sub-type classification and is based on the AccountType value. Required if AccountType is not specified.
Conditionally required
$ (anyOf 2).Account.AccountTypestringOptionalA detailed account classification that specifies the use of this account. The type is based on the Classification. Required if AccountSubType is not specified.
Conditionally required
$ (anyOf 2).Account.AcctNumstringOptionalUser-defined account number to help the user in identifying the account within the chart-of-accounts and in deciding what should be posted to the account. The Account.AcctNum attribute must not contain colon (:).
Conditionally required
$ (anyOf 2).Account.ActiveJSONOptionalWhether or not active inactive accounts may be hidden from most display purposes and may not be posted to.
$ (anyOf 2).Account.Active (anyOf 1)booleanAlternative
$ (anyOf 2).Account.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 2).Account.ClassificationstringOptionalThe classification of an account. Not supported for non-posting accounts. Valid values include: Asset , Equity , Expense , Liability , Revenue
Read only: true
$ (anyOf 2).Account.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which this account holds amounts.
Read only: true
$ (anyOf 2).Account.CurrentBalanceJSONOptionalSpecifies the balance amount for the current Account. Valid for Balance Sheet accounts.
Decimal string
Read only: true
$ (anyOf 2).Account.CurrentBalance (anyOf 1)numberAlternative
$ (anyOf 2).Account.CurrentBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 2).Account.CurrentBalanceWithSubAccountsJSONOptionalSpecifies the cumulative balance amount for the current Account and all its sub-accounts.
Decimal string
Read only: true
$ (anyOf 2).Account.CurrentBalanceWithSubAccounts (anyOf 1)numberAlternative
$ (anyOf 2).Account.CurrentBalanceWithSubAccounts (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 2).Account.DescriptionstringOptionalUser entered description for the account, which may include user entered information to guide bookkeepers/accountants in deciding what journal entries to post to the account.
$ (anyOf 2).Account.FullyQualifiedNamestringOptionalFully qualified name of the object; derived from Name and ParentRef . The fully qualified name prepends the topmost parent, followed by each subaccount separated by colons and takes the form of Parent:Account1:SubAccount1:SubAccount2 . System generated. Limited to 5 levels.
Read only: true
$ (anyOf 2).Account.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 2).Account.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 2).Account.NamestringRequired within parentUser recognizable name for the Account. Account.Name attribute must not contain double quotes (”) or colon (:).
$ (anyOf 2).Account.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the Parent AccountId if this represents a SubAccount.
$ (anyOf 2).Account.SubAccountJSONOptionalSpecifies whether this object represents a parent (false) or subaccount (true). Please note that accounts of these types - OpeningBalanceEquity , UndepositedFunds , RetainedEarnings , CashReceiptIncome , CashExpenditureExpense , ExchangeGainOrLoss cannot have a sub account and cannot be a sub account of another account.
Read only: true
$ (anyOf 2).Account.SubAccount (anyOf 1)booleanAlternative
$ (anyOf 2).Account.SubAccount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 2).Account.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 2).Account.TaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the default tax code used by this account. Tax codes are referenced by the TaxCode.Id in the TaxCode object. For global locales, only.
Conditionally required
$ (anyOf 2).Account.domainstringOptional
$ (anyOf 2).Account.sparsebooleanOptional
$ (anyOf 3)objectAlternativeAdditional keys: not allowed
$ (anyOf 3).bIdstringRequired within parentMinimum length: 1
$ (anyOf 3).operationJSONRequired within parentMust equal: update
$ (anyOf 3).AccountobjectRequired within parentAdditional keys: not allowed
$ (anyOf 3).Account.AccountSubTypestringOptionalThe account sub-type classification and is based on the AccountType value.
$ (anyOf 3).Account.AccountTypestringOptionalA detailed account classification that specifies the use of this account. The type is based on the Classification.
$ (anyOf 3).Account.AcctNumstringOptionalUser-defined account number to help the user in identifying the account within the chart-of-accounts and in deciding what should be posted to the account. The Account.AcctNum attribute must not contain colon (:). Name must be unique. Max length for Account.AcctNum : AU & CA: 20 characters. US, UK & IN: 7 characters
Conditionally required
$ (anyOf 3).Account.ActiveJSONOptionalWhether or not active inactive accounts may be hidden from most display purposes and may not be posted to.
$ (anyOf 3).Account.Active (anyOf 1)booleanAlternative
$ (anyOf 3).Account.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 3).Account.ClassificationstringOptionalThe classification of an account. Not supported for non-posting accounts. Valid values include: Asset , Equity , Expense , Liability , Revenue
Read only: true
$ (anyOf 3).Account.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which this account holds amounts.
Read only: true
$ (anyOf 3).Account.CurrentBalanceJSONOptionalSpecifies the balance amount for the current Account. Valid for Balance Sheet accounts.
Decimal string
Read only: true
$ (anyOf 3).Account.CurrentBalance (anyOf 1)numberAlternative
$ (anyOf 3).Account.CurrentBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 3).Account.CurrentBalanceWithSubAccountsJSONOptionalSpecifies the cumulative balance amount for the current Account and all its sub-accounts.
Decimal string
Read only: true
$ (anyOf 3).Account.CurrentBalanceWithSubAccounts (anyOf 1)numberAlternative
$ (anyOf 3).Account.CurrentBalanceWithSubAccounts (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 3).Account.DescriptionstringOptionalUser entered description for the account, which may include user entered information to guide bookkeepers/accountants in deciding what journal entries to post to the account.
$ (anyOf 3).Account.FullyQualifiedNamestringOptionalFully qualified name of the object; derived from Name and ParentRef . The fully qualified name prepends the topmost parent, followed by each subaccount separated by colons and takes the form of Parent:Account1:SubAccount1:SubAccount2 . System generated. Limited to 5 levels.
Read only: true
$ (anyOf 3).Account.IdstringRequired within parent
$ (anyOf 3).Account.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 3).Account.NamestringOptionalUser recognizable name for the Account. Account.Name attribute must not contain double quotes (”) or colon (:).
$ (anyOf 3).Account.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the Parent AccountId if this represents a SubAccount.
$ (anyOf 3).Account.SubAccountJSONOptionalSpecifies whether this object represents a parent (false) or subaccount (true). Please note that accounts of these types - OpeningBalanceEquity , UndepositedFunds , RetainedEarnings , CashReceiptIncome , CashExpenditureExpense , ExchangeGainOrLoss cannot have a sub account and cannot be a sub account of another account.
Read only: true
$ (anyOf 3).Account.SubAccount (anyOf 1)booleanAlternative
$ (anyOf 3).Account.SubAccount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 3).Account.SyncTokenstringRequired within parent
$ (anyOf 3).Account.TaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the default tax code used by this account. Tax codes are referenced by the TaxCode.Id in the TaxCode object. For global locales, only.
$ (anyOf 3).Account.domainstringOptional
$ (anyOf 3).Account.sparsebooleanOptional
$ (anyOf 4)objectAlternativeAdditional keys: not allowed
$ (anyOf 4).bIdstringRequired within parentMinimum length: 1
$ (anyOf 4).operationJSONRequired within parentMust equal: create
$ (anyOf 4).AttachableobjectRequired within parentAdditional keys: not allowed
$ (anyOf 4).Attachable.AttachableRefarrayOptionalSpecifies the transaction object to which this attachable file is to be linked.
$ (anyOf 4).Attachable.AttachableRef[]ModelEach itemExpand Delete an attachable — request body — body Attachable Ref item
$ (anyOf 4).Attachable.CategorystringOptionalCategory of the attachment. Valid values include (case sensitive): Contact Photo , Document , Image , Receipt , Signature , Sound , Other .
$ (anyOf 4).Attachable.ContentTypestringOptionalContentType of the attachment. Returned for file attachments.
$ (anyOf 4).Attachable.FileAccessUristringOptionalFullPath FileAccess URI of the attachment. Returned for file attachments.
Read only: true
$ (anyOf 4).Attachable.FileNamestringOptionalFileName of the attachment. Required for file attachments.
Conditionally required
$ (anyOf 4).Attachable.IdstringOptionalUnique Identifier for an Intuit entity (object). Required for the update operation.
Read only: true
$ (anyOf 4).Attachable.LatstringOptionalLatitude from where the attachment was requested.
$ (anyOf 4).Attachable.LongstringOptionalLongitude from where the attachment was requested.
$ (anyOf 4).Attachable.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 4).Attachable.NotestringOptionalThe note is either related to the attachment specified with the FileName attribute, or as a standalone note. Required for note attachments.
Conditionally required
$ (anyOf 4).Attachable.PlaceNamestringOptionalPlaceName from where the attachment was requested.
$ (anyOf 4).Attachable.SizeJSONOptionalSize of the attachment. Returned for file attachments.
Decimal string
Read only: true
$ (anyOf 4).Attachable.Size (anyOf 1)numberAlternative
$ (anyOf 4).Attachable.Size (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 4).Attachable.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 4).Attachable.TagstringOptionalTag name for the requested attachment.
$ (anyOf 4).Attachable.TempDownloadUristringOptionalTempDownload URI which can be directly downloaded by clients. Returned for file attachments.
Read only: true
$ (anyOf 4).Attachable.ThumbnailFileAccessUristringOptionalFullPath FileAccess URI of the attachment thumbnail if the attachment file is of a content type with thumbnail support. Returned for file attachments.
Read only: true
$ (anyOf 4).Attachable.ThumbnailTempDownloadUristringOptionalThumbnail TempDownload URI which can be directly downloaded by clients. This is only available if the attachment file is of a content type with thumbnail support. Returned for file attachments.
Read only: true
$ (anyOf 4).Attachable.domainstringOptional
$ (anyOf 4).Attachable.sparsebooleanOptional
$ (anyOf 5)objectAlternativeAdditional keys: not allowed
$ (anyOf 5).bIdstringRequired within parentMinimum length: 1
$ (anyOf 5).operationJSONRequired within parentMust equal: delete
$ (anyOf 5).AttachableModelRequired within parentExpand Delete an attachable — request body — body
$ (anyOf 6)objectAlternativeAdditional keys: not allowed
$ (anyOf 6).bIdstringRequired within parentMinimum length: 1
$ (anyOf 6).operationJSONRequired within parentMust equal: update
$ (anyOf 6).AttachableModelRequired within parentExpand Delete an attachable — request body — body
$ (anyOf 7)objectAlternativeAdditional keys: not allowed
$ (anyOf 7).bIdstringRequired within parentMinimum length: 1
$ (anyOf 7).operationJSONRequired within parentMust equal: create
$ (anyOf 7).BillobjectRequired within parentAdditional keys: not allowed
$ (anyOf 7).Bill.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 7).Bill.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the bill is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 7).Bill.Balance (anyOf 1)numberAlternative
$ (anyOf 7).Bill.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 7).Bill.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 7).Bill.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 7).Bill.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, a custom value can be provided. If no value is supplied, the resulting DocNumber is null. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 7).Bill.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 7).Bill.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 7).Bill.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 7).Bill.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 7).Bill.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 7).Bill.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 7).Bill.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 7).Bill.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 7).Bill.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 7).Bill.IncludeInAnnualTPARJSONOptionalInclude the supplier in the annual TPAR. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 7).Bill.IncludeInAnnualTPAR (anyOf 1)booleanAlternative
$ (anyOf 7).Bill.IncludeInAnnualTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 7).Bill.LinearrayRequired within parentThe minimum line item required for the request.
$ (anyOf 7).Bill.Line[]ModelEach itemExpand Create a bill — request body — body Line item
$ (anyOf 7).Bill.LinkedTxnarrayOptionalZero or more transactions linked to this Bill object. The LinkedTxn.TxnType can be set to PurchaseOrder , BillPaymentCheck , or ReimburseCharge . Use LinkedTxn.TxnId as the ID of the transaction.
$ (anyOf 7).Bill.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 7).Bill.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 7).Bill.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 7).Bill.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Bill was created from.
Read only: true
$ (anyOf 7).Bill.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 7).Bill.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 7).Bill.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 7).Bill.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 7).Bill.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 7).Bill.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 7).Bill.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details of all taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 7).Bill.VendorRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 7).Bill.domainstringOptional
$ (anyOf 7).Bill.sparsebooleanOptional
$ (anyOf 8)objectAlternativeAdditional keys: not allowed
$ (anyOf 8).bIdstringRequired within parentMinimum length: 1
$ (anyOf 8).operationJSONRequired within parentMust equal: delete
$ (anyOf 8).BillModelRequired within parentExpand Delete a bill — request body — body
$ (anyOf 9)objectAlternativeAdditional keys: not allowed
$ (anyOf 9).bIdstringRequired within parentMinimum length: 1
$ (anyOf 9).operationJSONRequired within parentMust equal: update
$ (anyOf 9).BillobjectRequired within parentAdditional keys: not allowed
$ (anyOf 9).Bill.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 9).Bill.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the bill is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 9).Bill.Balance (anyOf 1)numberAlternative
$ (anyOf 9).Bill.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 9).Bill.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 9).Bill.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 9).Bill.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, a custom value can be provided. If no value is supplied, the resulting DocNumber is null. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 9).Bill.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 9).Bill.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 9).Bill.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 9).Bill.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 9).Bill.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 9).Bill.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 9).Bill.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 9).Bill.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 9).Bill.IdstringRequired within parent
$ (anyOf 9).Bill.IncludeInAnnualTPARJSONOptionalInclude the supplier in the annual TPAR. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 9).Bill.IncludeInAnnualTPAR (anyOf 1)booleanAlternative
$ (anyOf 9).Bill.IncludeInAnnualTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 9).Bill.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: ItemBasedExpenseLine and AccountBasedExpenseLine
$ (anyOf 9).Bill.Line[]JSONEach item
$ (anyOf 9).Bill.Line[] (anyOf 1)ModelAlternativeExpand Delete a bill — request body — body Line item Amount, Custom Extensions, Description, Detail Type, Id, Item Based Expense Line Detail, Line Num, Linked Txn
$ (anyOf 9).Bill.Line[] (anyOf 2)ModelAlternativeExpand Delete a bill — request body — body Line item Account Based Expense Line Detail, Amount, Custom Extensions, Description, Detail Type, Id, Line Num, Linked Txn
$ (anyOf 9).Bill.LinkedTxnarrayOptionalZero or more transactions linked to this Bill object. The LinkedTxn.TxnType can be set to PurchaseOrder , BillPaymentCheck , or ReimburseCharge . Use LinkedTxn.TxnId as the ID of the transaction.
$ (anyOf 9).Bill.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 9).Bill.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 9).Bill.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 9).Bill.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Bill was created from.
Read only: true
$ (anyOf 9).Bill.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 9).Bill.SyncTokenstringRequired within parent
$ (anyOf 9).Bill.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 9).Bill.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 9).Bill.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 9).Bill.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 9).Bill.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details of all taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 9).Bill.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 9).Bill.domainstringOptional
$ (anyOf 9).Bill.sparsebooleanOptional
$ (anyOf 10)objectAlternativeAdditional keys: not allowed
$ (anyOf 10).bIdstringRequired within parentMinimum length: 1
$ (anyOf 10).operationJSONRequired within parentMust equal: create
$ (anyOf 10).BillPaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 10).BillPayment.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 10).BillPayment.CheckPaymentModelOptionalExpand Void a billpayment — request body — body Check Payment
Reference to the vendor for this transaction. Required when PayType is Check .
Conditionally required
$ (anyOf 10).BillPayment.CreditCardPaymentModelOptionalExpand Void a billpayment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Not applicable to Estimate and SalesOrder. Required when PayType is CreditCard .
Conditionally required
$ (anyOf 10).BillPayment.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 10).BillPayment.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 10).BillPayment.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, a custom value can be provided. If no value is supplied, the resulting DocNumber is null. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 10).BillPayment.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 10).BillPayment.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 10).BillPayment.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 10).BillPayment.IdstringOptionalUnique Identifier for an Intuit entity (object).
Read only: true
$ (anyOf 10).BillPayment.LinearrayRequired within parentIndividual line items representing zero or more Bill , VendorCredit , and JournalEntry objects linked to this BillPayment object. Valid Line types include: LinkedTxnLine:
$ (anyOf 10).BillPayment.Line[]ModelEach itemExpand Void a payment — request body — body Line item
$ (anyOf 10).BillPayment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 10).BillPayment.PayTypestringRequired within parentThe payment type. Valid values include: Check , CreditCard
$ (anyOf 10).BillPayment.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the form.
$ (anyOf 10).BillPayment.ProcessBillPaymentJSONOptionalIndicates that the payment should be processed by merchant account service. Valid for QuickBooks companies with credit card processing.
$ (anyOf 10).BillPayment.ProcessBillPayment (anyOf 1)booleanAlternative
$ (anyOf 10).BillPayment.ProcessBillPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 10).BillPayment.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 10).BillPayment.TotalAmtJSONRequired within parentIndicates the total amount of the associated with this payment. This includes the total of all the payments from the BillPayment Details.
Decimal string
$ (anyOf 10).BillPayment.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 10).BillPayment.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 10).BillPayment.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 10).BillPayment.VendorRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction.
$ (anyOf 10).BillPayment.domainstringOptional
$ (anyOf 10).BillPayment.sparsebooleanOptional
$ (anyOf 11)objectAlternativeAdditional keys: not allowed
$ (anyOf 11).bIdstringRequired within parentMinimum length: 1
$ (anyOf 11).operationJSONRequired within parentMust equal: delete
$ (anyOf 11).BillPaymentModelRequired within parentExpand Void a billpayment — request body — body
$ (anyOf 12)objectAlternativeAdditional keys: not allowed
$ (anyOf 12).bIdstringRequired within parentMinimum length: 1
$ (anyOf 12).operationJSONRequired within parentMust equal: update
$ (anyOf 12).BillPaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 12).BillPayment.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 12).BillPayment.CheckPaymentModelOptionalExpand Void a billpayment — request body — body Check Payment
Information about a check payment for the transaction. Not applicable to Estimate and SalesOrder. Used when PayType is Check .
$ (anyOf 12).BillPayment.CreditCardPaymentModelOptionalExpand Void a billpayment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Not applicable to Estimate and SalesOrder. Used when PayType is CreditCard .
$ (anyOf 12).BillPayment.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here .Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 12).BillPayment.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 12).BillPayment.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, a custom value can be provided. If no value is supplied, the resulting DocNumber is null. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 12).BillPayment.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 12).BillPayment.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 12).BillPayment.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 12).BillPayment.IdstringRequired within parent
$ (anyOf 12).BillPayment.LinearrayOptionalIndividual line items representing zero or more Bill , VendorCredit , and JournalEntry objects linked to this BillPayment object. Use Line.LinkedTxn.TxnId as the ID in a separate Bill, VendorCredit, or JournalEntry read request to retrieve details of the linked object. LinkedTxnLine:
$ (anyOf 12).BillPayment.Line[]ModelEach itemExpand Void a payment — request body — body Line item
$ (anyOf 12).BillPayment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 12).BillPayment.PayTypestringOptionalThe payment type. Valid values include: Check , CreditCard
$ (anyOf 12).BillPayment.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the form.
$ (anyOf 12).BillPayment.ProcessBillPaymentJSONOptionalIndicates that the payment should be processed by merchant account service. Valid for QuickBooks companies with credit card processing.
$ (anyOf 12).BillPayment.ProcessBillPayment (anyOf 1)booleanAlternative
$ (anyOf 12).BillPayment.ProcessBillPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 12).BillPayment.SyncTokenstringRequired within parent
$ (anyOf 12).BillPayment.TotalAmtJSONOptionalIndicates the total amount associated with this payment. This includes the total of all the payments from the payment line details. If TotalAmt is greater than the total on the lines being paid, the overpayment is treated as a credit and exposed as such on the QuickBooks UI. It cannot be negative.
Decimal string
$ (anyOf 12).BillPayment.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 12).BillPayment.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 12).BillPayment.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 12).BillPayment.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 12).BillPayment.domainstringOptional
$ (anyOf 12).BillPayment.sparsebooleanOptional
$ (anyOf 13)objectAlternativeAdditional keys: not allowed
$ (anyOf 13).bIdstringRequired within parentMinimum length: 1
$ (anyOf 13).operationJSONRequired within parentMust equal: create
$ (anyOf 13).BudgetobjectRequired within parentAdditional keys: not allowed
$ (anyOf 13).Budget.ActiveJSONOptionalWhether or not active inactive accounts may be hidden from most display purposes and may not be posted to.
$ (anyOf 13).Budget.Active (anyOf 1)booleanAlternative
$ (anyOf 13).Budget.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 13).Budget.BudgetDetailarrayOptionalContainer for the budget items.
$ (anyOf 13).Budget.BudgetDetail[]ModelEach itemExpand Create a budget — request body — body Budget Detail item
$ (anyOf 13).Budget.BudgetEntryTypestringOptionalPeriod that this budget detail covers.. Valid values include: Monthly , Quarterly , Annually .
Read only: true
$ (anyOf 13).Budget.BudgetTypestringOptionalBudget types. The only value currently supported is ProfitAndLoss .
Read only: true
$ (anyOf 13).Budget.CustomExtensionsModelOptionalExpand Create an item — request body — body Custom Extensions
Array of custom extension objects that associate additional attributes with the item. The ExtensionType field specifies the type of extension. The currently supported value is DIMENSION . The AssociatedValues array contains key/value pairs referencing Dimensions DefinitionID/Dimension ValueID. Multiple key/value pairs per extension type are supported. This field is designed to support additional extension types in the future. Dimensions is available for Intuit Enterprise Suite.
$ (anyOf 13).Budget.EndDatestringRequired within parentBudget end date.
$ (anyOf 13).Budget.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 13).Budget.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 13).Budget.NamestringOptionalUser recognizable name for the Account. Account.Name attribute must not contain double quotes (”) or colon (:).
Read only: true
$ (anyOf 13).Budget.StartDatestringRequired within parentBudget begin date.
$ (anyOf 13).Budget.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 13).Budget.domainstringOptional
$ (anyOf 13).Budget.sparsebooleanOptional
$ (anyOf 14)objectAlternativeAdditional keys: not allowed
$ (anyOf 14).bIdstringRequired within parentMinimum length: 1
$ (anyOf 14).operationJSONRequired within parentMust equal: delete
$ (anyOf 14).BudgetModelRequired within parentExpand Delete a budget — request body — body
$ (anyOf 15)objectAlternativeAdditional keys: not allowed
$ (anyOf 15).bIdstringRequired within parentMinimum length: 1
$ (anyOf 15).operationJSONRequired within parentMust equal: update
$ (anyOf 15).BudgetobjectRequired within parentAdditional keys: not allowed
$ (anyOf 15).Budget.ActiveJSONOptionalWhether or not active inactive accounts may be hidden from most display purposes and may not be posted to.
$ (anyOf 15).Budget.Active (anyOf 1)booleanAlternative
$ (anyOf 15).Budget.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 15).Budget.BudgetDetailarrayOptionalContainer for the budget items.
$ (anyOf 15).Budget.BudgetDetail[]ModelEach itemExpand Create a budget — request body — body Budget Detail item
$ (anyOf 15).Budget.BudgetEntryTypestringOptionalPeriod that this budget detail covers.. Valid values include: Monthly , Quarterly , Annually .
Read only: true
$ (anyOf 15).Budget.BudgetTypestringOptionalBudget types. The only value currently supported is ProfitAndLoss .
Read only: true
$ (anyOf 15).Budget.CustomExtensionsModelOptionalExpand Create an item — request body — body Custom Extensions
Array of custom extension objects that associate additional attributes with the item. The ExtensionType field specifies the type of extension. The currently supported value is DIMENSION . The AssociatedValues array contains key/value pairs referencing Dimensions DefinitionID/Dimension ValueID. Multiple key/value pairs per extension type are supported. This field is designed to support additional extension types in the future. Dimensions is available for Intuit Enterprise Suite.
$ (anyOf 15).Budget.EndDatestringOptionalBudget end date.
$ (anyOf 15).Budget.IdstringRequired within parent
$ (anyOf 15).Budget.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 15).Budget.NamestringOptionalUser recognizable name for the Account. Account.Name attribute must not contain double quotes (”) or colon (:).
Read only: true
$ (anyOf 15).Budget.StartDatestringOptionalBudget begin date.
$ (anyOf 15).Budget.SyncTokenstringRequired within parent
$ (anyOf 15).Budget.domainstringOptional
$ (anyOf 15).Budget.sparsebooleanOptional
$ (anyOf 16)objectAlternativeAdditional keys: not allowed
$ (anyOf 16).bIdstringRequired within parentMinimum length: 1
$ (anyOf 16).operationJSONRequired within parentMust equal: create
$ (anyOf 16).ChangeOrderobjectRequired within parentAdditional keys: not allowed
$ (anyOf 16).ChangeOrder.AcceptedBystringOptionalName of the customer or representative who accepted the change order. Populated when TxnStatus is set to Accepted .
$ (anyOf 16).ChangeOrder.AcceptedDatestringOptionalDate the change order was accepted. Populated when TxnStatus is set to Accepted .
$ (anyOf 16).ChangeOrder.ApplyTaxAfterDiscountJSONOptionalIf false or null, sales tax is calculated first and then any discount is applied. If true , the discount is subtracted first and then sales tax is calculated.
$ (anyOf 16).ChangeOrder.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 16).ChangeOrder.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 16).ChangeOrder.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Email address where the change order is sent. Required when EmailStatus is set to NeedToSend .
Conditionally required
$ (anyOf 16).ChangeOrder.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; visible on the Change Order document sent to the customer.
$ (anyOf 16).ChangeOrder.CustomerRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to the customer associated with this change order. Must match the customer on the parent project estimate. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 16).ChangeOrder.DocNumberstringOptionalReference number for the change order (for example, CO-001 ). If not provided, the value is null.
$ (anyOf 16).ChangeOrder.EmailStatusstringOptionalEmail status of the change order. Valid values: NotSet , NeedToSend , EmailSent .
$ (anyOf 16).ChangeOrder.ExpirationDatestringOptionalDate by which the change order must be accepted before it expires.
$ (anyOf 16).ChangeOrder.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 16).ChangeOrder.LinearrayRequired within parentIndividual line items describing the work being added or removed. Each line must include a LinkedTxn array referencing the parent project estimate with TxnType: “Estimate” . All lines must reference the same parent estimate. Supports SalesItemLineDetail line type.
$ (anyOf 16).ChangeOrder.Line[]ModelEach itemExpand Create a change order — request body — body Line item
$ (anyOf 16).ChangeOrder.LinkedTxnarrayOptionalOne or more linked transaction references at the header level, reflecting the parent project estimate. Also appears on each line item. Use LinkedTxn.TxnId as the ID in a separate Estimate read request to retrieve details of the linked object. TxnType must always be Estimate .
$ (anyOf 16).ChangeOrder.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 16).ChangeOrder.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 16).ChangeOrder.PrintStatusstringOptionalPrinting status of the change order. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 16).ChangeOrder.PrivateNotestringOptionalOrganization-private note about the change order. This note does not appear on documents sent to the customer.
$ (anyOf 16).ChangeOrder.ProjectRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to the project this change order belongs to. The project must be active. Without a valid ProjectRef , the change order will not appear in the Projects dashboard.
$ (anyOf 16).ChangeOrder.SyncTokenstringOptionalVersion 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 fail. Only the latest version of the object is maintained by QuickBooks Online.
Read only: true
$ (anyOf 16).ChangeOrder.TotalAmtJSONOptionalTotal amount of the transaction including all line charges and taxes. Calculated by QuickBooks business logic from the sum of all line Amount values plus applicable tax. Do not include in create or update request bodies; any value supplied is overwritten.
Decimal string
Read only: true
$ (anyOf 16).ChangeOrder.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 16).ChangeOrder.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 16).ChangeOrder.TotalCostAmountJSONOptionalTotal cost amount of the transaction, calculated from the sum of all line CostAmount values. Calculated by QuickBooks business logic; any value supplied is overwritten.
Decimal string
Read only: true
$ (anyOf 16).ChangeOrder.TotalCostAmount (anyOf 1)numberAlternative
$ (anyOf 16).ChangeOrder.TotalCostAmount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 16).ChangeOrder.TxnDatestringOptionalThe date entered by the user when this transaction occurred. If not supplied, the current date on the server is used.
$ (anyOf 16).ChangeOrder.TxnStatusstringOptionalCurrent status of the change order. Valid values: Pending , Accepted , Closed , Rejected .
$ (anyOf 16).ChangeOrder.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
Tax details for the transaction. Captures sales taxes calculated based on tax codes referenced by the transaction lines.
$ (anyOf 16).ChangeOrder.domainstringOptional
$ (anyOf 16).ChangeOrder.sparsebooleanOptional
$ (anyOf 17)objectAlternativeAdditional keys: not allowed
$ (anyOf 17).bIdstringRequired within parentMinimum length: 1
$ (anyOf 17).operationJSONRequired within parentMust equal: delete
$ (anyOf 17).ChangeOrderModelRequired within parentExpand Delete a change order — request body — body
$ (anyOf 18)objectAlternativeAdditional keys: not allowed
$ (anyOf 18).bIdstringRequired within parentMinimum length: 1
$ (anyOf 18).operationJSONRequired within parentMust equal: update
$ (anyOf 18).ChangeOrderobjectRequired within parentAdditional keys: not allowed
$ (anyOf 18).ChangeOrder.AcceptedBystringOptionalName of the customer or representative who accepted the change order. Populated when TxnStatus is set to Accepted .
$ (anyOf 18).ChangeOrder.AcceptedDatestringOptionalDate the change order was accepted. Populated when TxnStatus is set to Accepted .
$ (anyOf 18).ChangeOrder.ApplyTaxAfterDiscountJSONOptionalIf false or null, sales tax is calculated first and then any discount is applied. If true , the discount is subtracted first and then sales tax is calculated.
$ (anyOf 18).ChangeOrder.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 18).ChangeOrder.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 18).ChangeOrder.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Email address where the change order is sent. Required when EmailStatus is set to NeedToSend .
Conditionally required
$ (anyOf 18).ChangeOrder.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; visible on the Change Order document sent to the customer.
$ (anyOf 18).ChangeOrder.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the customer associated with this change order. Must match the customer on the parent project estimate. Use Customer.Id and Customer.DisplayName from the Customer object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 18).ChangeOrder.DocNumberstringOptionalReference number for the change order (for example, CO-001 ). If not provided, the value is null.
$ (anyOf 18).ChangeOrder.EmailStatusstringOptionalEmail status of the change order. Valid values: NotSet , NeedToSend , EmailSent .
$ (anyOf 18).ChangeOrder.ExpirationDatestringOptionalDate by which the change order must be accepted before it expires.
$ (anyOf 18).ChangeOrder.IdstringRequired within parent
$ (anyOf 18).ChangeOrder.LinearrayOptionalIndividual line items describing the work being added or removed. Supports SalesItemLineDetail and SubTotalLineDetail line types. Every line must include a LinkedTxn array referencing the parent project estimate with TxnType: “Estimate” . All lines must reference the same parent estimate. The Line array uses full-replace behavior on update — lines omitted from an update request are deleted.
$ (anyOf 18).ChangeOrder.Line[]JSONEach item
$ (anyOf 18).ChangeOrder.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 18).ChangeOrder.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 18).ChangeOrder.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 18).ChangeOrder.LinkedTxnarrayOptionalOne or more linked transaction references at the header level, reflecting the parent project estimate. Also appears on each line item. Use LinkedTxn.TxnId as the ID in a separate Estimate read request to retrieve details of the linked object. TxnType must always be Estimate .
$ (anyOf 18).ChangeOrder.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 18).ChangeOrder.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 18).ChangeOrder.PrintStatusstringOptionalPrinting status of the change order. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 18).ChangeOrder.PrivateNotestringOptionalOrganization-private note about the change order. This note does not appear on documents sent to the customer.
$ (anyOf 18).ChangeOrder.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the project this change order belongs to. Must reference an active project. Without a valid ProjectRef , the change order will not appear in the Projects dashboard.
$ (anyOf 18).ChangeOrder.SyncTokenstringRequired within parent
$ (anyOf 18).ChangeOrder.TotalAmtJSONOptionalTotal amount of the transaction including all line charges and taxes. Calculated by QuickBooks business logic from the sum of all line Amount values plus applicable tax. Do not include in create or update request bodies; any value supplied is overwritten.
Decimal string
Read only: true
$ (anyOf 18).ChangeOrder.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 18).ChangeOrder.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 18).ChangeOrder.TotalCostAmountJSONOptionalTotal cost amount of the transaction, calculated from the sum of all line CostAmount values. Calculated by QuickBooks business logic; any value supplied is overwritten.
Decimal string
Read only: true
$ (anyOf 18).ChangeOrder.TotalCostAmount (anyOf 1)numberAlternative
$ (anyOf 18).ChangeOrder.TotalCostAmount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 18).ChangeOrder.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 18).ChangeOrder.TxnStatusstringOptionalCurrent status of the change order. Valid values: Pending (default — created but not yet reviewed), Accepted (customer approved; project contracted total increases accordingly), Closed (converted to an Invoice or manually closed), Rejected (customer declined; does not affect project total).
$ (anyOf 18).ChangeOrder.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
Tax details for the transaction. Captures sales taxes calculated based on tax codes referenced by the transaction lines.
$ (anyOf 18).ChangeOrder.domainstringOptional
$ (anyOf 18).ChangeOrder.sparsebooleanOptional
$ (anyOf 19)objectAlternativeAdditional keys: not allowed
$ (anyOf 19).bIdstringRequired within parentMinimum length: 1
$ (anyOf 19).operationJSONRequired within parentMust equal: create
$ (anyOf 19).ClassobjectRequired within parentAdditional keys: not allowed
$ (anyOf 19).Class.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 19).Class.Active (anyOf 1)booleanAlternative
$ (anyOf 19).Class.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 19).Class.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub class separated by colons. Takes the form of Parent:Class1:SubClass1:SubClass2 . Limited to 5 levels.
Read only: true
$ (anyOf 19).Class.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 19).Class.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 19).Class.NamestringRequired within parentUser recognizable name for the Class.
$ (anyOf 19).Class.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
For class objects that are sub-classes: the immediate parent of this object. Required if this object is a subclass.
Conditionally required
$ (anyOf 19).Class.SubClassJSONOptionalSpecifies whether this object is a subclass. true —this object represents a subclass. false or null—this object represents a top-level class.
$ (anyOf 19).Class.SubClass (anyOf 1)booleanAlternative
$ (anyOf 19).Class.SubClass (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 19).Class.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 19).Class.domainstringOptional
$ (anyOf 19).Class.sparsebooleanOptional
$ (anyOf 20)objectAlternativeAdditional keys: not allowed
$ (anyOf 20).bIdstringRequired within parentMinimum length: 1
$ (anyOf 20).operationJSONRequired within parentMust equal: update
$ (anyOf 20).ClassobjectRequired within parentAdditional keys: not allowed
$ (anyOf 20).Class.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 20).Class.Active (anyOf 1)booleanAlternative
$ (anyOf 20).Class.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 20).Class.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub class separated by colons. Takes the form of Parent:Class1:SubClass1:SubClass2 . Limited to 5 levels.
Read only: true
$ (anyOf 20).Class.IdstringRequired within parent
$ (anyOf 20).Class.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 20).Class.NamestringOptionalUser recognizable name for the Class.
$ (anyOf 20).Class.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
The immediate parent of the SubClass. Required if this object is a subclass.
Conditionally required
$ (anyOf 20).Class.SubClassJSONOptionalSpecifies whether this object is a subclass. true —this object represents a subclass. false or null—this object represents a top-level class.
$ (anyOf 20).Class.SubClass (anyOf 1)booleanAlternative
$ (anyOf 20).Class.SubClass (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 20).Class.SyncTokenstringRequired within parent
$ (anyOf 20).Class.domainstringOptional
$ (anyOf 20).Class.sparsebooleanOptional
$ (anyOf 21)objectAlternativeAdditional keys: not allowed
$ (anyOf 21).bIdstringRequired within parentMinimum length: 1
$ (anyOf 21).operationJSONRequired within parentMust equal: create
$ (anyOf 21).CompanyCurrencyobjectRequired within parentAdditional keys: not allowed
$ (anyOf 21).CompanyCurrency.ActiveJSONOptionalIndicates whether this currency is active in the company or not. true —This currency is active and enabled for use by QuickBooks. false —This currency is inactive, is hidden from most display purposes, and is not availble for use with financial transactions.
$ (anyOf 21).CompanyCurrency.Active (anyOf 1)booleanAlternative
$ (anyOf 21).CompanyCurrency.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 21).CompanyCurrency.CodestringRequired within parentA three letter string representing the ISO 4217 code for the currency. For example, USD , AUD , EUR , and so on.
$ (anyOf 21).CompanyCurrency.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 21).CompanyCurrency.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 21).CompanyCurrency.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 21).CompanyCurrency.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 21).CompanyCurrency.NamestringOptionalThe full name of the currency.
$ (anyOf 21).CompanyCurrency.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 21).CompanyCurrency.domainstringOptional
$ (anyOf 21).CompanyCurrency.sparsebooleanOptional
$ (anyOf 22)objectAlternativeAdditional keys: not allowed
$ (anyOf 22).bIdstringRequired within parentMinimum length: 1
$ (anyOf 22).operationJSONRequired within parentMust equal: update
$ (anyOf 22).CompanyCurrencyModelRequired within parentExpand Update a companycurrency — request body — body
$ (anyOf 23)objectAlternativeAdditional keys: not allowed
$ (anyOf 23).bIdstringRequired within parentMinimum length: 1
$ (anyOf 23).operationJSONRequired within parentMust equal: update
$ (anyOf 23).CompanyInfoobjectRequired within parentAdditional keys: not allowed
$ (anyOf 23).CompanyInfo.CompanyAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Company Address as described in preference. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 23).CompanyInfo.CompanyNamestringOptionalThe name of the company.
$ (anyOf 23).CompanyInfo.CompanyStartDatestringOptionalDateTime when company file was created. This field and Metadata.CreateTime contain the same value.
Read only: true
$ (anyOf 23).CompanyInfo.CountrystringOptionalCountry name to which the company belongs for financial calculations.
$ (anyOf 23).CompanyInfo.CustomerCommunicationAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address of the company as given to their customer, sometimes the address given to the customer mail address is different from Company address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 23).CompanyInfo.EmailModelOptionalExpand Full update companyinfo — request body — body Email
Default email address.
$ (anyOf 23).CompanyInfo.EmployerIdstringOptionalIf your QuickBooks company has defined an EIN in company settings, this value is returned.
$ (anyOf 23).CompanyInfo.FiscalYearStartMonthstringOptionalThe start month of fiscal year.
$ (anyOf 23).CompanyInfo.IdstringRequired within parent
$ (anyOf 23).CompanyInfo.LegalAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Legal Address given to the government for any government communication. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 23).CompanyInfo.LegalNamestringOptionalThe legal name of the company.
$ (anyOf 23).CompanyInfo.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 23).CompanyInfo.NameValuearrayOptionalAny other preference not covered with the standard set of attributes. See Data Services Extensions, below, for special reserved name/value pairs. NameValue.Name—Name of the element. NameValue.Value—Value of the element.
$ (anyOf 23).CompanyInfo.NameValue[]objectEach itemAdditional keys: allowed
$ (anyOf 23).CompanyInfo.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 23).CompanyInfo.SupportedLanguagesstringOptionalComma separated list of languages.
$ (anyOf 23).CompanyInfo.SyncTokenstringRequired within parent
$ (anyOf 23).CompanyInfo.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 23).CompanyInfo.domainstringOptional
$ (anyOf 23).CompanyInfo.sparsebooleanOptional
$ (anyOf 24)objectAlternativeAdditional keys: not allowed
$ (anyOf 24).bIdstringRequired within parentMinimum length: 1
$ (anyOf 24).operationJSONRequired within parentMust equal: update
$ (anyOf 24).CompanyInfoobjectRequired within parentAdditional keys: not allowed
$ (anyOf 24).CompanyInfo.CompanyAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Company Address as described in preference. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 24).CompanyInfo.CompanyNamestringOptionalThe name of the company.
$ (anyOf 24).CompanyInfo.CompanyStartDatestringOptionalDateTime when company file was created. This field and Metadata.CreateTime contain the same value.
Read only: true
$ (anyOf 24).CompanyInfo.CountrystringOptionalCountry name to which the company belongs for financial calculations.
$ (anyOf 24).CompanyInfo.CustomerCommunicationAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address of the company as given to their customer, sometimes the address given to the customer mail address is different from Company address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 24).CompanyInfo.EmailModelOptionalExpand Full update companyinfo — request body — body Email
Default email address.
$ (anyOf 24).CompanyInfo.EmployerIdstringOptionalIf your QuickBooks company has defined an EIN in company settings, this value is returned.
$ (anyOf 24).CompanyInfo.FiscalYearStartMonthstringOptionalThe start month of fiscal year.
$ (anyOf 24).CompanyInfo.IdstringRequired within parent
$ (anyOf 24).CompanyInfo.LegalAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Legal Address given to the government for any government communication. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 24).CompanyInfo.LegalNamestringOptionalThe legal name of the company.
$ (anyOf 24).CompanyInfo.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 24).CompanyInfo.NameValuearrayOptionalAny other preference not covered with the standard set of attributes. See Data Services Extensions, below, for special reserved name/value pairs. NameValue.Name—Name of the element. NameValue.Value—Value of the element.
$ (anyOf 24).CompanyInfo.NameValue[]objectEach itemAdditional keys: allowed
$ (anyOf 24).CompanyInfo.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 24).CompanyInfo.SupportedLanguagesstringOptionalComma separated list of languages.
$ (anyOf 24).CompanyInfo.SyncTokenstringRequired within parent
$ (anyOf 24).CompanyInfo.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 24).CompanyInfo.domainstringOptional
$ (anyOf 24).CompanyInfo.sparsebooleanRequired within parentMust equal: true
$ (anyOf 25)objectAlternativeAdditional keys: not allowed
$ (anyOf 25).bIdstringRequired within parentMinimum length: 1
$ (anyOf 25).operationJSONRequired within parentMust equal: create
$ (anyOf 25).CreditCardPaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 25).CreditCardPayment.AmountJSONRequired within parentTotal amount of the payment. Denominated in the currency of the credit card account.
Decimal string
$ (anyOf 25).CreditCardPayment.Amount (anyOf 1)numberAlternative
$ (anyOf 25).CreditCardPayment.Amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 25).CreditCardPayment.BankAccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Bank account used to pay the Credit Card balance. Must be a Bank account.
$ (anyOf 25).CreditCardPayment.CheckNumstringOptionalUser entered, Check number. This field maps to the Check no. field on the Pay down credit card form.
$ (anyOf 25).CreditCardPayment.CreditCardAccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Credit Card account for which a payment is being entered. Must be a Credit Card account.
$ (anyOf 25).CreditCardPayment.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 25).CreditCardPayment.MemostringOptionalUser entered, organization-private note about the transaction. This field maps to the Memo field on the Pay down credit card form.
$ (anyOf 25).CreditCardPayment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 25).CreditCardPayment.PrintStatusstringOptionalPrinting status of the credit-card-payment. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 25).CreditCardPayment.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This field maps to the Memo field on the Pay down credit card form.
$ (anyOf 25).CreditCardPayment.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 25).CreditCardPayment.TxnDatestringRequired within parentDate of transaction.
$ (anyOf 25).CreditCardPayment.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 25).CreditCardPayment.domainstringOptional
$ (anyOf 25).CreditCardPayment.sparsebooleanOptional
$ (anyOf 26)objectAlternativeAdditional keys: not allowed
$ (anyOf 26).bIdstringRequired within parentMinimum length: 1
$ (anyOf 26).operationJSONRequired within parentMust equal: delete
$ (anyOf 26).CreditCardPaymentModelRequired within parentExpand Delete a creditcardpayment — request body — body
$ (anyOf 27)objectAlternativeAdditional keys: not allowed
$ (anyOf 27).bIdstringRequired within parentMinimum length: 1
$ (anyOf 27).operationJSONRequired within parentMust equal: update
$ (anyOf 27).CreditCardPaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 27).CreditCardPayment.AmountJSONOptionalTotal amount of the payment. Denominated in the currency of the credit card account.
Decimal string
$ (anyOf 27).CreditCardPayment.Amount (anyOf 1)numberAlternative
$ (anyOf 27).CreditCardPayment.Amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 27).CreditCardPayment.BankAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Bank account used to pay the Credit Card balance. Must be a Bank account.
$ (anyOf 27).CreditCardPayment.CheckNumstringOptionalUser entered, Check number. This field maps to the Check no. field on the Pay down credit card form.
$ (anyOf 27).CreditCardPayment.CreditCardAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Credit Card account for which a payment is being entered. Must be a Credit Card account.
$ (anyOf 27).CreditCardPayment.IdstringRequired within parent
$ (anyOf 27).CreditCardPayment.MemostringOptionalUser entered, organization-private note about the transaction. This field maps to the Memo field on the Pay down credit card form.
$ (anyOf 27).CreditCardPayment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 27).CreditCardPayment.PrintStatusstringOptionalPrinting status of the credit-card-payment. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 27).CreditCardPayment.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This field maps to the Memo field on the Pay down credit card form.
$ (anyOf 27).CreditCardPayment.SyncTokenstringRequired within parent
$ (anyOf 27).CreditCardPayment.TxnDatestringOptionalDate of transaction.
$ (anyOf 27).CreditCardPayment.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 27).CreditCardPayment.domainstringOptional
$ (anyOf 27).CreditCardPayment.sparsebooleanOptional
$ (anyOf 28)objectAlternativeAdditional keys: not allowed
$ (anyOf 28).bIdstringRequired within parentMinimum length: 1
$ (anyOf 28).operationJSONRequired within parentMust equal: update
$ (anyOf 28).CreditCardPaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 28).CreditCardPayment.AmountJSONOptionalTotal amount of the payment. Denominated in the currency of the credit card account.
Decimal string
$ (anyOf 28).CreditCardPayment.Amount (anyOf 1)numberAlternative
$ (anyOf 28).CreditCardPayment.Amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 28).CreditCardPayment.BankAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Bank account used to pay the Credit Card balance. Must be a Bank account.
$ (anyOf 28).CreditCardPayment.CheckNumstringOptionalUser entered, Check number. This field maps to the Check no. field on the Pay down credit card form.
$ (anyOf 28).CreditCardPayment.CreditCardAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Credit Card account for which a payment is being entered. Must be a Credit Card account.
$ (anyOf 28).CreditCardPayment.IdstringRequired within parent
$ (anyOf 28).CreditCardPayment.MemostringOptionalUser entered, organization-private note about the transaction. This field maps to the Memo field on the Pay down credit card form.
$ (anyOf 28).CreditCardPayment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 28).CreditCardPayment.PrintStatusstringOptionalPrinting status of the credit-card-payment. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 28).CreditCardPayment.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This field maps to the Memo field on the Pay down credit card form.
$ (anyOf 28).CreditCardPayment.SyncTokenstringRequired within parent
$ (anyOf 28).CreditCardPayment.TxnDatestringOptionalDate of transaction.
$ (anyOf 28).CreditCardPayment.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 28).CreditCardPayment.domainstringOptional
$ (anyOf 28).CreditCardPayment.sparsebooleanRequired within parentMust equal: true
$ (anyOf 29)objectAlternativeAdditional keys: not allowed
$ (anyOf 29).bIdstringRequired within parentMinimum length: 1
$ (anyOf 29).operationJSONRequired within parentMust equal: create
$ (anyOf 29).CreditMemoobjectRequired within parentAdditional keys: not allowed
$ (anyOf 29).CreditMemo.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. US versions of QuickBooks only.
$ (anyOf 29).CreditMemo.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 29).CreditMemo.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 29).CreditMemo.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 29).CreditMemo.Balance (anyOf 1)numberAlternative
$ (anyOf 29).CreditMemo.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 29).CreditMemo.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the credit memo. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 29).CreditMemo.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the credit-memo is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 29).CreditMemo.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerLine is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 29).CreditMemo.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 29).CreditMemo.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 29).CreditMemo.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 29).CreditMemo.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 29).CreditMemo.CustomerRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 29).CreditMemo.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 29).CreditMemo.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 29).CreditMemo.EmailStatusstringOptionalEmail status of the credit-memo. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 29).CreditMemo.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 29).CreditMemo.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 29).CreditMemo.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 29).CreditMemo.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 29).CreditMemo.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 29).CreditMemo.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 29).CreditMemo.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 29).CreditMemo.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 29).CreditMemo.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 29).CreditMemo.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 29).CreditMemo.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 29).CreditMemo.LinearrayRequired within parentThe minimum line item required for the request is one of the following. Sales item line type Group item line type
$ (anyOf 29).CreditMemo.Line[]JSONEach item
$ (anyOf 29).CreditMemo.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 29).CreditMemo.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 29).CreditMemo.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 29).CreditMemo.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 29).CreditMemo.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 29).CreditMemo.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
Read only: true
$ (anyOf 29).CreditMemo.PrintStatusstringOptionalPrinting status of the credit-memo. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 29).CreditMemo.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the deposit form.
$ (anyOf 29).CreditMemo.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 29).CreditMemo.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the CreditMemo was created from.
Read only: true
$ (anyOf 29).CreditMemo.RemainingCreditJSONOptionalIndicates the total credit amount still available to apply towards the payment.
Decimal string
Read only: true
$ (anyOf 29).CreditMemo.RemainingCredit (anyOf 1)numberAlternative
$ (anyOf 29).CreditMemo.RemainingCredit (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 29).CreditMemo.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 29).CreditMemo.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 29).CreditMemo.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 29).CreditMemo.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 29).CreditMemo.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
$ (anyOf 29).CreditMemo.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 29).CreditMemo.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 29).CreditMemo.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 29).CreditMemo.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 29).CreditMemo.domainstringOptional
$ (anyOf 29).CreditMemo.sparsebooleanOptional
$ (anyOf 30)objectAlternativeAdditional keys: not allowed
$ (anyOf 30).bIdstringRequired within parentMinimum length: 1
$ (anyOf 30).operationJSONRequired within parentMust equal: delete
$ (anyOf 30).CreditMemoModelRequired within parentExpand Delete a credit memo — request body — body
$ (anyOf 31)objectAlternativeAdditional keys: not allowed
$ (anyOf 31).bIdstringRequired within parentMinimum length: 1
$ (anyOf 31).operationJSONRequired within parentMust equal: update
$ (anyOf 31).CreditMemoobjectRequired within parentAdditional keys: not allowed
$ (anyOf 31).CreditMemo.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. US versions of QuickBooks only.
$ (anyOf 31).CreditMemo.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 31).CreditMemo.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 31).CreditMemo.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 31).CreditMemo.Balance (anyOf 1)numberAlternative
$ (anyOf 31).CreditMemo.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 31).CreditMemo.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the credit memo. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 31).CreditMemo.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the credit-memo is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 31).CreditMemo.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerLine is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 31).CreditMemo.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 31).CreditMemo.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 31).CreditMemo.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 31).CreditMemo.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 31).CreditMemo.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 31).CreditMemo.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 31).CreditMemo.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 31).CreditMemo.EmailStatusstringOptionalEmail status of the credit-memo. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 31).CreditMemo.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 31).CreditMemo.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 31).CreditMemo.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 31).CreditMemo.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 31).CreditMemo.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 31).CreditMemo.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 31).CreditMemo.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 31).CreditMemo.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 31).CreditMemo.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 31).CreditMemo.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 31).CreditMemo.IdstringRequired within parent
$ (anyOf 31).CreditMemo.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: SalesItemLine , GroupLine , DescriptionOnlyLine , DiscountLine and SubTotalLine
$ (anyOf 31).CreditMemo.Line[]JSONEach item
$ (anyOf 31).CreditMemo.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 31).CreditMemo.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 31).CreditMemo.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 31).CreditMemo.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 31).CreditMemo.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 31).CreditMemo.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 31).CreditMemo.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
Read only: true
$ (anyOf 31).CreditMemo.PrintStatusstringOptionalPrinting status of the credit-memo. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 31).CreditMemo.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the deposit form.
$ (anyOf 31).CreditMemo.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 31).CreditMemo.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the CreditMemo was created from.
Read only: true
$ (anyOf 31).CreditMemo.RemainingCreditJSONOptionalIndicates the total credit amount still available to apply towards the payment.
Decimal string
Read only: true
$ (anyOf 31).CreditMemo.RemainingCredit (anyOf 1)numberAlternative
$ (anyOf 31).CreditMemo.RemainingCredit (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 31).CreditMemo.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 31).CreditMemo.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 31).CreditMemo.SyncTokenstringRequired within parent
$ (anyOf 31).CreditMemo.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 31).CreditMemo.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
$ (anyOf 31).CreditMemo.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 31).CreditMemo.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 31).CreditMemo.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 31).CreditMemo.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 31).CreditMemo.domainstringOptional
$ (anyOf 31).CreditMemo.sparsebooleanOptional
$ (anyOf 32)objectAlternativeAdditional keys: not allowed
$ (anyOf 32).bIdstringRequired within parentMinimum length: 1
$ (anyOf 32).operationJSONRequired within parentMust equal: create
$ (anyOf 32).CustomerobjectRequired within parentAdditional keys: not allowed
$ (anyOf 32).Customer.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks. If there is an amount in Customer.Balance when setting this Customer object to inactive through the QuickBooks UI, a CreditMemo balancing transaction is created for the amount.
$ (anyOf 32).Customer.Active (anyOf 1)booleanAlternative
$ (anyOf 32).Customer.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 32).Customer.AlternatePhoneModelOptionalExpand Create a vendor — request body — body Fax
Alternate phone number.
$ (anyOf 32).Customer.BalanceJSONOptionalSpecifies the open balance amount or the amount unpaid by the customer. For the create operation, this represents the opening balance for the customer. When returned in response to the query request it represents the current open balance (unpaid amount) for that customer. Write-on-create.
Decimal string
$ (anyOf 32).Customer.Balance (anyOf 1)numberAlternative
$ (anyOf 32).Customer.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 32).Customer.BalanceWithJobsJSONOptionalCumulative open balance amount for the Customer (or Job) and all its sub-jobs. Cannot be written to QuickBooks.
Decimal string
$ (anyOf 32).Customer.BalanceWithJobs (anyOf 1)numberAlternative
$ (anyOf 32).Customer.BalanceWithJobs (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 32).Customer.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default billing address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 32).Customer.BillWithParentJSONOptionalIf true, this Customer object is billed with its parent. If false, or null the customer is not to be billed with its parent. This attribute is valid only if this entity is a Job or sub Customer.
$ (anyOf 32).Customer.BillWithParent (anyOf 1)booleanAlternative
$ (anyOf 32).Customer.BillWithParent (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 32).Customer.CompanyNamestringOptionalThe name of the company associated with the person or organization.
$ (anyOf 32).Customer.CurrencyRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the currency in which all amounts associated with this customer are expressed. Once set, it cannot be changed. If specified currency is not currently in the company’s currency list, it is added. If not specified, currency for this customer is the home currency of the company, as defined by Preferences.CurrencyPrefs.HomeCurrency .
Read only: true
$ (anyOf 32).Customer.CustomerTypeRefModelOptionalExpand Create a customer — request body — body Customer Type Ref
Reference to the customer type assigned to a customer. This field is only returned if the customer is assigned a customer type.
$ (anyOf 32).Customer.DefaultTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a default tax code associated with this Customer object. Reference is valid if Customer.Taxable is set to true; otherwise, it is ignored. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) the default tax code is set by the system and can not be overridden. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for DefaultTaxCodeRef.value and DefaultTaxCodeRef.name , respectively.
$ (anyOf 32).Customer.DisplayNamestringOptionalThe name of the person or organization as displayed. Must be unique across all Customer, Vendor, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating customer name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix .
Conditionally required
$ (anyOf 32).Customer.FamilyNamestringOptionalFamily name or the last name of the person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 32).Customer.FaxModelOptionalExpand Create a vendor — request body — body Fax
Fax number.
$ (anyOf 32).Customer.FullyQualifiedNamestringOptionalFully qualified name of the object. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Customer:Job:Sub-job . System generated. Limited to 5 levels.
Read only: true
$ (anyOf 32).Customer.GivenNamestringOptionalGiven name or first name of a person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 32).Customer.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 32).Customer.IsProjectJSONOptionalIf true, indicates this is a Project.
Read only: true
$ (anyOf 32).Customer.IsProject (anyOf 1)booleanAlternative
$ (anyOf 32).Customer.IsProject (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 32).Customer.JobJSONOptionalIf true, this is a Job or sub-customer. If false or null, this is a top level customer, not a Job or sub-customer.
$ (anyOf 32).Customer.Job (anyOf 1)booleanAlternative
$ (anyOf 32).Customer.Job (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 32).Customer.LevelJSONOptionalSpecifies the level of the hierarchy in which the entity is located. Zero specifies the top level of the hierarchy; anything above will be level with respect to the parent. Constraints: up to 5 levels
Read only: true
$ (anyOf 32).Customer.Level (anyOf 1)integerAlternative
$ (anyOf 32).Customer.Level (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 32).Customer.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 32).Customer.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 32).Customer.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 32).Customer.NotesstringOptionalFree form text describing the Customer.
$ (anyOf 32).Customer.OpenBalanceDatestringOptionalDate of the Open Balance for the create operation. Write-on-create.
$ (anyOf 32).Customer.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Customer object that is the immediate parent of the Sub-Customer/Job in the hierarchical Customer:Job list. Required for the create operation if this object is a sub-customer or Job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 32).Customer.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this Customer object. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 32).Customer.PreferredDeliveryMethodstringOptionalPreferred delivery method. Values are Print, Email, or None.
$ (anyOf 32).Customer.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 32).Customer.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 32).Customer.PrimaryTaxIdentifierstringOptionalAlso called Tax Reg. No in ( UK ) , ( CA ) , ( IN ) , ( AU ) represents the tax ID of the Person or Organization. This value is masked in responses, exposing only last five characters. For example, the ID of 123-45-6789 is returned as XXXXXX56789 .
$ (anyOf 32).Customer.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName. Constraints: Cannot be removed with sparse update.
$ (anyOf 32).Customer.ResaleNumstringOptionalResale number or some additional info about the customer.
$ (anyOf 32).Customer.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a SalesTerm associated with this Customer object. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 32).Customer.SecondaryTaxIdentifierstringOptionalAlso called UTR No. in ( UK ) , CST Reg No. ( IN ) also represents the tax registration number of the Person or Organization. This value is masked in responses, exposing only last five characters. For example, the ID of 123-45-6789 is returned as XXXXXX56789 .
$ (anyOf 32).Customer.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default shipping address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 32).Customer.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 32).Customer.SuffixstringOptionalSuffix of the name. For example, Jr . The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 32).Customer.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 32).Customer.TaxExemptionReasonIdstringOptionalThe tax exemption reason associated with this customer object. Applicable if automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) for the company. Set TaxExemptionReasonId: to one of the following: Id Reason 1 Federal government 2 State government 3 Local government 4 Tribal government 5 Charitable organization 6 Religious organization 7 Educational organization 8 Hospital 9 Resale 10 Direct pay permit 11 Multiple points of use 12 Direct mail 13 Agricultural production 14 Industrial production / manufacturing 15 Foreign diplomat
$ (anyOf 32).Customer.TaxableJSONOptionalIf true, transactions for this customer are taxable. Default behavior: true, if DefaultTaxCodeRef is defined or false if TaxExemptionReasonId is set.
$ (anyOf 32).Customer.Taxable (anyOf 1)booleanAlternative
$ (anyOf 32).Customer.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 32).Customer.TitlestringOptionalTitle of the person. This tag supports i18n, all locales. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , Suffix , or FullyQualifiedName attributes are required during create.
Conditionally required
$ (anyOf 32).Customer.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 32).Customer.domainstringOptional
$ (anyOf 32).Customer.sparsebooleanOptional
$ (anyOf 33)objectAlternativeAdditional keys: not allowed
$ (anyOf 33).bIdstringRequired within parentMinimum length: 1
$ (anyOf 33).operationJSONRequired within parentMust equal: update
$ (anyOf 33).CustomerobjectRequired within parentAdditional keys: not allowed
$ (anyOf 33).Customer.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks. If there is an amount in Customer.Balance when setting this Customer object to inactive through the QuickBooks UI, a CreditMemo balancing transaction is created for the amount.
$ (anyOf 33).Customer.Active (anyOf 1)booleanAlternative
$ (anyOf 33).Customer.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 33).Customer.AlternatePhoneModelOptionalExpand Create a vendor — request body — body Fax
Alternate phone number.
$ (anyOf 33).Customer.BalanceJSONOptionalSpecifies the open balance amount or the amount unpaid by the customer. For the create operation, this represents the opening balance for the customer. When returned in response to the query request it represents the current open balance (unpaid amount) for that customer. Write-on-create.
Decimal string
$ (anyOf 33).Customer.Balance (anyOf 1)numberAlternative
$ (anyOf 33).Customer.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 33).Customer.BalanceWithJobsJSONOptionalCumulative open balance amount for the Customer (or Job) and all its sub-jobs. Cannot be written to QuickBooks.
Decimal string
$ (anyOf 33).Customer.BalanceWithJobs (anyOf 1)numberAlternative
$ (anyOf 33).Customer.BalanceWithJobs (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 33).Customer.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default billing address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 33).Customer.BillWithParentJSONOptionalIf true, this Customer object is billed with its parent. If false, or null the customer is not to be billed with its parent. This attribute is valid only if this entity is a Job or sub Customer.
$ (anyOf 33).Customer.BillWithParent (anyOf 1)booleanAlternative
$ (anyOf 33).Customer.BillWithParent (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 33).Customer.CompanyNamestringOptionalThe name of the company associated with the person or organization.
$ (anyOf 33).Customer.CurrencyRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the currency in which all amounts associated with this customer are expressed. Once set, it cannot be changed. If specified currency is not currently in the company’s currency list, it is added. If not specified, currency for this customer is the home currency of the company, as defined by Preferences.CurrencyPrefs.HomeCurrency .
Read only: true
$ (anyOf 33).Customer.CustomerTypeRefModelOptionalExpand Create a customer — request body — body Customer Type Ref
Reference to the customer type assigned to a customer. This field is only returned if the customer is assigned a customer type.
$ (anyOf 33).Customer.DefaultTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a default tax code associated with this Customer object. Reference is valid if Customer.Taxable is set to true; otherwise, it is ignored. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) the default tax code is set by the system and can not be overridden. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for DefaultTaxCodeRef.value and DefaultTaxCodeRef.name , respectively.
$ (anyOf 33).Customer.DisplayNamestringOptionalThe name of the person or organization as displayed. Must be unique across all Customer, Vendor, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating customer name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix .
Conditionally required
$ (anyOf 33).Customer.FamilyNamestringOptionalFamily name or the last name of the person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 33).Customer.FaxModelOptionalExpand Create a vendor — request body — body Fax
Fax number.
$ (anyOf 33).Customer.FullyQualifiedNamestringOptionalFully qualified name of the object. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Customer:Job:Sub-job . System generated. Limited to 5 levels.
Read only: true
$ (anyOf 33).Customer.GivenNamestringOptionalGiven name or first name of a person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 33).Customer.IdstringRequired within parent
$ (anyOf 33).Customer.IsProjectJSONOptionalIf true, indicates this is a Project.
Read only: true
$ (anyOf 33).Customer.IsProject (anyOf 1)booleanAlternative
$ (anyOf 33).Customer.IsProject (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 33).Customer.JobJSONOptionalIf true, this is a Job or sub-customer. If false or null, this is a top level customer, not a Job or sub-customer.
$ (anyOf 33).Customer.Job (anyOf 1)booleanAlternative
$ (anyOf 33).Customer.Job (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 33).Customer.LevelJSONOptionalSpecifies the level of the hierarchy in which the entity is located. Zero specifies the top level of the hierarchy; anything above will be level with respect to the parent. Constraints: up to 5 levels
Read only: true
$ (anyOf 33).Customer.Level (anyOf 1)integerAlternative
$ (anyOf 33).Customer.Level (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 33).Customer.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 33).Customer.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 33).Customer.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 33).Customer.NotesstringOptionalFree form text describing the Customer.
$ (anyOf 33).Customer.OpenBalanceDatestringOptionalDate of the Open Balance for the create operation. Write-on-create.
$ (anyOf 33).Customer.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Customer object that is the immediate parent of the Sub-Customer/Job in the hierarchical Customer:Job list. Required for the create operation if this object is a sub-customer or Job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 33).Customer.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this Customer object. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 33).Customer.PreferredDeliveryMethodstringOptionalPreferred delivery method. Values are Print, Email, or None.
$ (anyOf 33).Customer.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 33).Customer.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 33).Customer.PrimaryTaxIdentifierstringOptionalAlso called Tax Reg. No in ( UK ) , ( CA ) , ( IN ) , ( AU ) represents the tax ID of the Person or Organization. This value is masked in responses, exposing only last five characters. For example, the ID of 123-45-6789 is returned as XXXXXX56789 .
$ (anyOf 33).Customer.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName. Constraints: Cannot be removed with sparse update.
$ (anyOf 33).Customer.ResaleNumstringOptionalResale number or some additional info about the customer.
$ (anyOf 33).Customer.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a SalesTerm associated with this Customer object. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 33).Customer.SecondaryTaxIdentifierstringOptionalAlso called UTR No. in ( UK ) , CST Reg No. ( IN ) also represents the tax registration number of the Person or Organization. This value is masked in responses, exposing only last five characters. For example, the ID of 123-45-6789 is returned as XXXXXX56789 .
$ (anyOf 33).Customer.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default shipping address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 33).Customer.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 33).Customer.SuffixstringOptionalSuffix of the name. For example, Jr . The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 33).Customer.SyncTokenstringRequired within parent
$ (anyOf 33).Customer.TaxExemptionReasonIdstringOptionalThe tax exemption reason associated with this customer object. Applicable if automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) for the company. Set TaxExemptionReasonId: to one of the following: Id Reason 1 Federal government 2 State government 3 Local government 4 Tribal government 5 Charitable organization 6 Religious organization 7 Educational organization 8 Hospital 9 Resale 10 Direct pay permit 11 Multiple points of use 12 Direct mail 13 Agricultural production 14 Industrial production / manufacturing 15 Foreign diplomat
$ (anyOf 33).Customer.TaxableJSONOptionalIf true, transactions for this customer are taxable. Default behavior: true, if DefaultTaxCodeRef is defined or false if TaxExemptionReasonId is set.
$ (anyOf 33).Customer.Taxable (anyOf 1)booleanAlternative
$ (anyOf 33).Customer.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 33).Customer.TitlestringOptionalTitle of the person. This tag supports i18n, all locales. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 33).Customer.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 33).Customer.domainstringOptional
$ (anyOf 33).Customer.sparsebooleanOptional
$ (anyOf 34)objectAlternativeAdditional keys: not allowed
$ (anyOf 34).bIdstringRequired within parentMinimum length: 1
$ (anyOf 34).operationJSONRequired within parentMust equal: update
$ (anyOf 34).CustomerobjectRequired within parentAdditional keys: not allowed
$ (anyOf 34).Customer.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks. If there is an amount in Customer.Balance when setting this Customer object to inactive through the QuickBooks UI, a CreditMemo balancing transaction is created for the amount.
$ (anyOf 34).Customer.Active (anyOf 1)booleanAlternative
$ (anyOf 34).Customer.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 34).Customer.AlternatePhoneModelOptionalExpand Create a vendor — request body — body Fax
Alternate phone number.
$ (anyOf 34).Customer.BalanceJSONOptionalSpecifies the open balance amount or the amount unpaid by the customer. For the create operation, this represents the opening balance for the customer. When returned in response to the query request it represents the current open balance (unpaid amount) for that customer. Write-on-create.
Decimal string
$ (anyOf 34).Customer.Balance (anyOf 1)numberAlternative
$ (anyOf 34).Customer.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 34).Customer.BalanceWithJobsJSONOptionalCumulative open balance amount for the Customer (or Job) and all its sub-jobs. Cannot be written to QuickBooks.
Decimal string
$ (anyOf 34).Customer.BalanceWithJobs (anyOf 1)numberAlternative
$ (anyOf 34).Customer.BalanceWithJobs (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 34).Customer.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default billing address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 34).Customer.BillWithParentJSONOptionalIf true, this Customer object is billed with its parent. If false, or null the customer is not to be billed with its parent. This attribute is valid only if this entity is a Job or sub Customer.
$ (anyOf 34).Customer.BillWithParent (anyOf 1)booleanAlternative
$ (anyOf 34).Customer.BillWithParent (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 34).Customer.CompanyNamestringOptionalThe name of the company associated with the person or organization.
$ (anyOf 34).Customer.CurrencyRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the currency in which all amounts associated with this customer are expressed. Once set, it cannot be changed. If specified currency is not currently in the company’s currency list, it is added. If not specified, currency for this customer is the home currency of the company, as defined by Preferences.CurrencyPrefs.HomeCurrency .
Read only: true
$ (anyOf 34).Customer.CustomerTypeRefModelOptionalExpand Create a customer — request body — body Customer Type Ref
Reference to the customer type assigned to a customer. This field is only returned if the customer is assigned a customer type.
$ (anyOf 34).Customer.DefaultTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a default tax code associated with this Customer object. Reference is valid if Customer.Taxable is set to true; otherwise, it is ignored. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) the default tax code is set by the system and can not be overridden. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for DefaultTaxCodeRef.value and DefaultTaxCodeRef.name , respectively.
$ (anyOf 34).Customer.DisplayNamestringOptionalThe name of the person or organization as displayed. Must be unique across all Customer, Vendor, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating customer name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix .
Conditionally required
$ (anyOf 34).Customer.FamilyNamestringOptionalFamily name or the last name of the person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 34).Customer.FaxModelOptionalExpand Create a vendor — request body — body Fax
Fax number.
$ (anyOf 34).Customer.FullyQualifiedNamestringOptionalFully qualified name of the object. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Customer:Job:Sub-job . System generated. Limited to 5 levels.
Read only: true
$ (anyOf 34).Customer.GivenNamestringOptionalGiven name or first name of a person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 34).Customer.IdstringRequired within parent
$ (anyOf 34).Customer.IsProjectJSONOptionalIf true, indicates this is a Project.
Read only: true
$ (anyOf 34).Customer.IsProject (anyOf 1)booleanAlternative
$ (anyOf 34).Customer.IsProject (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 34).Customer.JobJSONOptionalIf true, this is a Job or sub-customer. If false or null, this is a top level customer, not a Job or sub-customer.
$ (anyOf 34).Customer.Job (anyOf 1)booleanAlternative
$ (anyOf 34).Customer.Job (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 34).Customer.LevelJSONOptionalSpecifies the level of the hierarchy in which the entity is located. Zero specifies the top level of the hierarchy; anything above will be level with respect to the parent. Constraints: up to 5 levels
Read only: true
$ (anyOf 34).Customer.Level (anyOf 1)integerAlternative
$ (anyOf 34).Customer.Level (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 34).Customer.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 34).Customer.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 34).Customer.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 34).Customer.NotesstringOptionalFree form text describing the Customer.
$ (anyOf 34).Customer.OpenBalanceDatestringOptionalDate of the Open Balance for the create operation. Write-on-create.
$ (anyOf 34).Customer.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Customer object that is the immediate parent of the Sub-Customer/Job in the hierarchical Customer:Job list. Required for the create operation if this object is a sub-customer or Job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 34).Customer.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this Customer object. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 34).Customer.PreferredDeliveryMethodstringOptionalPreferred delivery method. Values are Print, Email, or None.
$ (anyOf 34).Customer.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 34).Customer.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 34).Customer.PrimaryTaxIdentifierstringOptionalAlso called Tax Reg. No in ( UK ) , ( CA ) , ( IN ) , ( AU ) represents the tax ID of the Person or Organization. This value is masked in responses, exposing only last five characters. For example, the ID of 123-45-6789 is returned as XXXXXX56789 .
$ (anyOf 34).Customer.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName. Constraints: Cannot be removed with sparse update.
$ (anyOf 34).Customer.ResaleNumstringOptionalResale number or some additional info about the customer.
$ (anyOf 34).Customer.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a SalesTerm associated with this Customer object. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 34).Customer.SecondaryTaxIdentifierstringOptionalAlso called UTR No. in ( UK ) , CST Reg No. ( IN ) also represents the tax registration number of the Person or Organization. This value is masked in responses, exposing only last five characters. For example, the ID of 123-45-6789 is returned as XXXXXX56789 .
$ (anyOf 34).Customer.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default shipping address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 34).Customer.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 34).Customer.SuffixstringOptionalSuffix of the name. For example, Jr . The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 34).Customer.SyncTokenstringRequired within parent
$ (anyOf 34).Customer.TaxExemptionReasonIdstringOptionalThe tax exemption reason associated with this customer object. Applicable if automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) for the company. Set TaxExemptionReasonId: to one of the following: Id Reason 1 Federal government 2 State government 3 Local government 4 Tribal government 5 Charitable organization 6 Religious organization 7 Educational organization 8 Hospital 9 Resale 10 Direct pay permit 11 Multiple points of use 12 Direct mail 13 Agricultural production 14 Industrial production / manufacturing 15 Foreign diplomat
$ (anyOf 34).Customer.TaxableJSONOptionalIf true, transactions for this customer are taxable. Default behavior: true, if DefaultTaxCodeRef is defined or false if TaxExemptionReasonId is set.
$ (anyOf 34).Customer.Taxable (anyOf 1)booleanAlternative
$ (anyOf 34).Customer.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 34).Customer.TitlestringOptionalTitle of the person. This tag supports i18n, all locales. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required.
Conditionally required
$ (anyOf 34).Customer.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 34).Customer.domainstringOptional
$ (anyOf 34).Customer.sparsebooleanRequired within parentMust equal: true
$ (anyOf 35)objectAlternativeAdditional keys: not allowed
$ (anyOf 35).bIdstringRequired within parentMinimum length: 1
$ (anyOf 35).operationJSONRequired within parentMust equal: create
$ (anyOf 35).DepartmentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 35).Department.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks. If set to false, this entity is not available.
$ (anyOf 35).Department.Active (anyOf 1)booleanAlternative
$ (anyOf 35).Department.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 35).Department.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Parent:Department1:SubDepartment1:SubDepartment2 . Limited to 5 levels.
Read only: true
$ (anyOf 35).Department.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 35).Department.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 35).Department.NamestringRequired within parentUser recognizable name for the department.
$ (anyOf 35).Department.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
The immediate parent of the SubDepartment. Required for the create operation if this object is a SubDepartment. Required if this object is a subdepartment
Conditionally required
$ (anyOf 35).Department.SubDepartmentJSONOptionalSpecifies whether this Department object is a SubDepartment. true —SubDepartment. false or null—top-level Department.
Read only: true
$ (anyOf 35).Department.SubDepartment (anyOf 1)booleanAlternative
$ (anyOf 35).Department.SubDepartment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 35).Department.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 35).Department.domainstringOptional
$ (anyOf 35).Department.sparsebooleanOptional
$ (anyOf 36)objectAlternativeAdditional keys: not allowed
$ (anyOf 36).bIdstringRequired within parentMinimum length: 1
$ (anyOf 36).operationJSONRequired within parentMust equal: update
$ (anyOf 36).DepartmentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 36).Department.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks. If set to false, this entity is not available.
$ (anyOf 36).Department.Active (anyOf 1)booleanAlternative
$ (anyOf 36).Department.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 36).Department.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Parent:Department1:SubDepartment1:SubDepartment2 . Limited to 5 levels.
Read only: true
$ (anyOf 36).Department.IdstringRequired within parent
$ (anyOf 36).Department.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 36).Department.NamestringOptionalUser recognizable name for the Department.
$ (anyOf 36).Department.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
The immediate parent of the SubDepartment. Required for the create operation if this object is a SubDepartment. Required if this object is a subdepartment.
Conditionally required
$ (anyOf 36).Department.SubDepartmentJSONOptionalSpecifies whether this Department object is a SubDepartment. true —SubDepartment. false or null—top-level Department.
Read only: true
$ (anyOf 36).Department.SubDepartment (anyOf 1)booleanAlternative
$ (anyOf 36).Department.SubDepartment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 36).Department.SyncTokenstringRequired within parent
$ (anyOf 36).Department.domainstringOptional
$ (anyOf 36).Department.sparsebooleanOptional
$ (anyOf 37)objectAlternativeAdditional keys: not allowed
$ (anyOf 37).bIdstringRequired within parentMinimum length: 1
$ (anyOf 37).operationJSONRequired within parentMust equal: create
$ (anyOf 37).DepositobjectRequired within parentAdditional keys: not allowed
$ (anyOf 37).Deposit.CashBackModelOptionalExpand Create a deposit — request body — body Cash Back
$ (anyOf 37).Deposit.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . The CurrencyRef can be overwritten by the Line.DepositLineDetail Entity. If the customer that you are referring to has a default currency of USD then the currency for this Deposit will always be set as USD.
Conditionally required
$ (anyOf 37).Deposit.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate Department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 37).Deposit.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the account to be used for this deposit. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepostiToAccountRef.name , respectively.
$ (anyOf 37).Deposit.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 37).Deposit.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 37).Deposit.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 37).Deposit.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 37).Deposit.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 37).Deposit.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 37).Deposit.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 37).Deposit.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 37).Deposit.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: DepositLine
$ (anyOf 37).Deposit.Line[]ModelEach itemExpand Create a deposit — request body — body Line item
$ (anyOf 37).Deposit.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 37).Deposit.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 37).Deposit.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Deposit was created from.
Read only: true
$ (anyOf 37).Deposit.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 37).Deposit.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 37).Deposit.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 37).Deposit.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 37).Deposit.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 37).Deposit.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 37).Deposit.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 37).Deposit.domainstringOptional
$ (anyOf 37).Deposit.sparsebooleanOptional
$ (anyOf 38)objectAlternativeAdditional keys: not allowed
$ (anyOf 38).bIdstringRequired within parentMinimum length: 1
$ (anyOf 38).operationJSONRequired within parentMust equal: delete
$ (anyOf 38).DepositModelRequired within parentExpand Delete a deposit — request body — body
$ (anyOf 39)objectAlternativeAdditional keys: not allowed
$ (anyOf 39).bIdstringRequired within parentMinimum length: 1
$ (anyOf 39).operationJSONRequired within parentMust equal: update
$ (anyOf 39).DepositobjectRequired within parentAdditional keys: not allowed
$ (anyOf 39).Deposit.CashBackModelOptionalExpand Create a deposit — request body — body Cash Back
$ (anyOf 39).Deposit.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . The CurrencyRef can be overwritten by the Line.DepositLineDetail Entity. If the customer that you are referring to has a default currency of USD then the currency for this Deposit will always be set as USD.
Conditionally required
$ (anyOf 39).Deposit.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate Department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 39).Deposit.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the account to be used for this deposit. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepostiToAccountRef.name , respectively.
$ (anyOf 39).Deposit.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 39).Deposit.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 39).Deposit.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 39).Deposit.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 39).Deposit.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 39).Deposit.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 39).Deposit.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 39).Deposit.IdstringRequired within parent
$ (anyOf 39).Deposit.LinearrayOptionalIndividual line items comprising the deposit. Specify a Line.LinkedTxn element along with DepositLine detail type if this line is to record a deposit for an existing transaction. Select UndepositedFunds account on the existing transaction to make it available for the Deposit. Possible types of transactions that can be linked to a Deposit include: Transfer , Payment (for Cash, CreditCard, and Check payment method types), SalesReceipt , RefundReceipt , JournalEntry . In addition, any expense object whose line item has AccountReceivable can be linked to a Payment and then that Payment can be linked to a Deposit object. Use Line.LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object. Valid Line types include: LinkedTxn and DepositLine
$ (anyOf 39).Deposit.Line[]JSONEach item
$ (anyOf 39).Deposit.Line[] (anyOf 1)ModelAlternativeExpand Void a payment — request body — body Line item
$ (anyOf 39).Deposit.Line[] (anyOf 2)ModelAlternativeExpand Create a deposit — request body — body Line item
$ (anyOf 39).Deposit.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 39).Deposit.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 39).Deposit.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Deposit was created from.
Read only: true
$ (anyOf 39).Deposit.SyncTokenstringRequired within parent
$ (anyOf 39).Deposit.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 39).Deposit.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 39).Deposit.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 39).Deposit.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 39).Deposit.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 39).Deposit.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 39).Deposit.domainstringOptional
$ (anyOf 39).Deposit.sparsebooleanOptional
$ (anyOf 40)objectAlternativeAdditional keys: not allowed
$ (anyOf 40).bIdstringRequired within parentMinimum length: 1
$ (anyOf 40).operationJSONRequired within parentMust equal: update
$ (anyOf 40).DepositobjectRequired within parentAdditional keys: not allowed
$ (anyOf 40).Deposit.CashBackModelOptionalExpand Create a deposit — request body — body Cash Back
$ (anyOf 40).Deposit.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . The CurrencyRef can be overwritten by the Line.DepositLineDetail Entity. If the customer that you are referring to has a default currency of USD then the currency for this Deposit will always be set as USD.
Conditionally required
$ (anyOf 40).Deposit.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction, as defined using location tracking in QuickBooks Online. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate Department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 40).Deposit.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the account to be used for this deposit. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepostiToAccountRef.name , respectively.
$ (anyOf 40).Deposit.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 40).Deposit.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 40).Deposit.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 40).Deposit.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 40).Deposit.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 40).Deposit.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 40).Deposit.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 40).Deposit.IdstringRequired within parent
$ (anyOf 40).Deposit.LinearrayOptionalIndividual line items comprising the deposit. Specify a Line.LinkedTxn element along with DepositLine detail type if this line is to record a deposit for an existing transaction. Select UndepositedFunds account on the existing transaction to make it available for the Deposit. Possible types of transactions that can be linked to a Deposit include: Transfer , Payment (for Cash, CreditCard, and Check payment method types), SalesReceipt , RefundReceipt , JournalEntry . In addition, any expense object whose line item has AccountReceivable can be linked to a Payment and then that Payment can be linked to a Deposit object. Use Line.LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object. Valid Line types include: LinkedTxn and DepositLine
$ (anyOf 40).Deposit.Line[]JSONEach item
$ (anyOf 40).Deposit.Line[] (anyOf 1)ModelAlternativeExpand Void a payment — request body — body Line item
$ (anyOf 40).Deposit.Line[] (anyOf 2)ModelAlternativeExpand Create a deposit — request body — body Line item
$ (anyOf 40).Deposit.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 40).Deposit.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 40).Deposit.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Deposit was created from.
Read only: true
$ (anyOf 40).Deposit.SyncTokenstringRequired within parent
$ (anyOf 40).Deposit.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 40).Deposit.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 40).Deposit.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 40).Deposit.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 40).Deposit.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 40).Deposit.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 40).Deposit.domainstringOptional
$ (anyOf 40).Deposit.sparsebooleanRequired within parentMust equal: true
$ (anyOf 41)objectAlternativeAdditional keys: not allowed
$ (anyOf 41).bIdstringRequired within parentMinimum length: 1
$ (anyOf 41).operationJSONRequired within parentMust equal: create
$ (anyOf 41).EmployeeobjectRequired within parentAdditional keys: not allowed
$ (anyOf 41).Employee.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 41).Employee.Active (anyOf 1)booleanAlternative
$ (anyOf 41).Employee.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 41).Employee.BillRateJSONOptionalThis attribute can only be set if BillableTime is true. Not supported when QuickBooks Payroll is enabled.
Decimal string
$ (anyOf 41).Employee.BillRate (anyOf 1)numberAlternative
$ (anyOf 41).Employee.BillRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 41).Employee.BillableTimeJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 41).Employee.BillableTime (anyOf 1)booleanAlternative
$ (anyOf 41).Employee.BillableTime (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 41).Employee.BirthDatestringOptionalBirth date of the employee.
$ (anyOf 41).Employee.CostRateJSONOptionalPay rate of the employee
Decimal string
$ (anyOf 41).Employee.CostRate (anyOf 1)numberAlternative
$ (anyOf 41).Employee.CostRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 41).Employee.DisplayNamestringOptionalThe name of the person or organization as displayed. Default Value: If not supplied, the system generates DisplayName by concatenating employee name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix . When QuickBooks Payroll is enabled, this attribute is read-only and a concatenation of GivenName , MiddleName , and FamilyName .
$ (anyOf 41).Employee.EmployeeNumberstringOptionalSpecifies the ID number of the employee in the employer’s directory.
$ (anyOf 41).Employee.FamilyNamestringOptionalFamily name or the last name of the person. At least one of GivenName or FamilyName attributes is required.
$ (anyOf 41).Employee.GenderstringOptionalGender of the employee. To clear the gender value, set to Null in a full update request. Supported values include: Male or Female .
$ (anyOf 41).Employee.GivenNamestringOptionalGiven name or Family name of a person. At least one of GivenName or FamilyName attributes is required.
$ (anyOf 41).Employee.HiredDatestringOptionalHire date of the employee.
$ (anyOf 41).Employee.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 41).Employee.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 41).Employee.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names.
$ (anyOf 41).Employee.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 41).Employee.OrganizationJSONOptionaltrue —the object represents an organization. false —the object represents a person.
$ (anyOf 41).Employee.Organization (anyOf 1)booleanAlternative
$ (anyOf 41).Employee.Organization (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 41).Employee.PrimaryAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Represents the physical street address for this employee. If QuickBooks Payroll is enabled for the company, the following PhysicalAddress fields are required: City , maximum of 255 chars CountrySubDivisionCode , maximum of 255 chars PostalCode Required when QuickBooks Payroll is enabled. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 41).Employee.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 41).Employee.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 41).Employee.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName . Cannot be removed with sparse update. Not supported when QuickBooks Payroll is enabled.
$ (anyOf 41).Employee.ReleasedDatestringOptionalRelease date of the employee.
$ (anyOf 41).Employee.SSNstringOptionalSocial security number (SSN) of the employee. If SSN is set, it is masked in the response with XXX-XX-XXXX. If XXX-XX-XXXX is sent in the create or update request, XXX-XX-XXXX is ignored and the old value is preserved. This attribute cannot be passed in a request when QuickBooks Payroll is enabled. Code for this field must be removed before submitting.
$ (anyOf 41).Employee.SuffixstringOptionalSuffix of the name. For example, Jr . Not supported when QuickBooks Payroll is enabled.
$ (anyOf 41).Employee.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 41).Employee.TitlestringOptionalTitle of the person. This tag supports i18n, all locale. Not supported when QuickBooks Payroll is enabled.
$ (anyOf 41).Employee.V4IDPseudonymstringOptionalEmployee reference number. For internal use only.
Read only: true
$ (anyOf 41).Employee.domainstringOptional
$ (anyOf 41).Employee.sparsebooleanOptional
$ (anyOf 42)objectAlternativeAdditional keys: not allowed
$ (anyOf 42).bIdstringRequired within parentMinimum length: 1
$ (anyOf 42).operationJSONRequired within parentMust equal: update
$ (anyOf 42).EmployeeobjectRequired within parentAdditional keys: not allowed
$ (anyOf 42).Employee.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 42).Employee.Active (anyOf 1)booleanAlternative
$ (anyOf 42).Employee.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 42).Employee.BillRateJSONOptionalThis attribute can only be set if BillableTime is true. Not supported when QuickBooks Payroll is enabled.
Decimal string
$ (anyOf 42).Employee.BillRate (anyOf 1)numberAlternative
$ (anyOf 42).Employee.BillRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 42).Employee.BillableTimeJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 42).Employee.BillableTime (anyOf 1)booleanAlternative
$ (anyOf 42).Employee.BillableTime (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 42).Employee.BirthDatestringOptionalBirth date of the employee.
$ (anyOf 42).Employee.CostRateJSONOptionalPay rate of the employee
Decimal string
$ (anyOf 42).Employee.CostRate (anyOf 1)numberAlternative
$ (anyOf 42).Employee.CostRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 42).Employee.DisplayNamestringOptionalThe name of the person or organization as displayed. Default Value: If not supplied, the system generates DisplayName by concatenating employee name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix . When QuickBooks Payroll is enabled, this attribute is read-only and a concatenation of GivenName , MiddleName , and FamilyName .
$ (anyOf 42).Employee.EmployeeNumberstringOptionalSpecifies the ID number of the employee in the employer’s directory.
$ (anyOf 42).Employee.FamilyNamestringOptionalFamily name or the last name of the person. At least one of GivenName or FamilyName attributes is required.
$ (anyOf 42).Employee.GenderstringOptionalGender of the employee. To clear the gender value, set to Null in a full update request. Supported values include: Male or Female .
$ (anyOf 42).Employee.GivenNamestringOptionalGiven name or family name of a person. At least one of GivenName or FamilyName attributes is required.
$ (anyOf 42).Employee.HiredDatestringOptionalHire date of the employee.
$ (anyOf 42).Employee.IdstringRequired within parent
$ (anyOf 42).Employee.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 42).Employee.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names.
$ (anyOf 42).Employee.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 42).Employee.OrganizationJSONOptionaltrue —the object represents an organization. false —the object represents a person.
$ (anyOf 42).Employee.Organization (anyOf 1)booleanAlternative
$ (anyOf 42).Employee.Organization (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 42).Employee.PrimaryAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Represents the physical street address for this employee. If QuickBooks Payroll is enabled for the company, the following PhysicalAddress fields are required: City , maximum of 255 chars CountrySubDivisionCode , maximum of 255 chars PostalCode Required when QuickBooks Payroll is enabled. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 42).Employee.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 42).Employee.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 42).Employee.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName . Cannot be removed with sparse update. Not supported when QuickBooks Payroll is enabled.
$ (anyOf 42).Employee.ReleasedDatestringOptionalRelease date of the employee.
$ (anyOf 42).Employee.SSNstringOptionalSocial security number (SSN) of the employee. If SSN is set, it is masked in the response with XXX-XX-XXXX. If XXX-XX-XXXX is sent in the create or update request, XXX-XX-XXXX is ignored and the old value is preserved. This attribute cannot be passed in a request when QuickBooks Payroll is enabled. Code for this field must be removed before submitting.
$ (anyOf 42).Employee.SuffixstringOptionalSuffix of the name. For example, Jr . Not supported when QuickBooks Payroll is enabled.
$ (anyOf 42).Employee.SyncTokenstringRequired within parent
$ (anyOf 42).Employee.TitlestringOptionalTitle of the person. This tag supports i18n, all locale. Not supported when QuickBooks Payroll is enabled.
$ (anyOf 42).Employee.V4IDPseudonymstringOptionalEmployee reference number. For internal use only.
Read only: true
$ (anyOf 42).Employee.domainstringOptional
$ (anyOf 42).Employee.sparsebooleanOptional
$ (anyOf 43)objectAlternativeAdditional keys: not allowed
$ (anyOf 43).bIdstringRequired within parentMinimum length: 1
$ (anyOf 43).operationJSONRequired within parentMust equal: create
$ (anyOf 43).EstimateobjectRequired within parentAdditional keys: not allowed
$ (anyOf 43).Estimate.AcceptedBystringOptionalName of customer who accepted the estimate.
$ (anyOf 43).Estimate.AcceptedDatestringOptionalDate estimate was accepted.
$ (anyOf 43).Estimate.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax.
$ (anyOf 43).Estimate.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 43).Estimate.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 43).Estimate.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 43).Estimate.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the estimate is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 43).Estimate.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 43).Estimate.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 43).Estimate.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 43).Estimate.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 43).Estimate.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 43).Estimate.CustomerRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 43).Estimate.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 43).Estimate.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 43).Estimate.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 43).Estimate.EmailStatusstringOptionalEmail status of the invoice. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 43).Estimate.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 43).Estimate.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 43).Estimate.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 43).Estimate.ExpirationDatestringOptionalDate by which estimate must be accepted before invalidation.
$ (anyOf 43).Estimate.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 43).Estimate.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 43).Estimate.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 43).Estimate.GlobalTaxCalculationstringOptionalTaxExcluded Method in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable .Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 43).Estimate.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 43).Estimate.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 43).Estimate.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 43).Estimate.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 43).Estimate.LinearrayRequired within parentThe minimum line item required for the request is one of the following. Sales item line type Group item line type
$ (anyOf 43).Estimate.Line[]JSONEach item
$ (anyOf 43).Estimate.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 43).Estimate.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 43).Estimate.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 43).Estimate.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 43).Estimate.LinkedTxnarrayOptionalZero or more Invoice objects related to this transaction. Use LinkedTxn.TxnId as the ID in a separate Invoice read request to retrieve details of the linked object.
$ (anyOf 43).Estimate.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 43).Estimate.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 43).Estimate.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 43).Estimate.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 43).Estimate.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction. When ProjectRef is passed in the US region for QuickBooks Online Advanced and Intuit Enterprise Suite SKUs, a project estimate is created if the user has projects enabled.
Conditionally required
$ (anyOf 43).Estimate.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Estimate was created from.
Read only: true
$ (anyOf 43).Estimate.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 43).Estimate.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 43).Estimate.ShipDatestringOptionalDate for delivery of goods or services.
$ (anyOf 43).Estimate.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 43).Estimate.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string. Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 43).Estimate.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 43).Estimate.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 43).Estimate.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 43).Estimate.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 43).Estimate.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 43).Estimate.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 43).Estimate.TxnStatusstringOptionalOne of the following status settings: Accepted, Closed, Pending, Rejected, Converted
$ (anyOf 43).Estimate.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 43).Estimate.domainstringOptional
$ (anyOf 43).Estimate.sparsebooleanOptional
$ (anyOf 44)objectAlternativeAdditional keys: not allowed
$ (anyOf 44).bIdstringRequired within parentMinimum length: 1
$ (anyOf 44).operationJSONRequired within parentMust equal: delete
$ (anyOf 44).EstimateModelRequired within parentExpand Delete an estimate — request body — body
$ (anyOf 45)objectAlternativeAdditional keys: not allowed
$ (anyOf 45).bIdstringRequired within parentMinimum length: 1
$ (anyOf 45).operationJSONRequired within parentMust equal: update
$ (anyOf 45).EstimateobjectRequired within parentAdditional keys: not allowed
$ (anyOf 45).Estimate.AcceptedBystringOptionalName of customer who accepted the estimate.
$ (anyOf 45).Estimate.AcceptedDatestringOptionalDate estimate was accepted.
$ (anyOf 45).Estimate.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax.
$ (anyOf 45).Estimate.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 45).Estimate.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 45).Estimate.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 45).Estimate.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the estimate is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 45).Estimate.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 45).Estimate.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 45).Estimate.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 45).Estimate.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 45).Estimate.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 45).Estimate.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 45).Estimate.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 45).Estimate.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 45).Estimate.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 45).Estimate.EmailStatusstringOptionalEmail status of the invoice. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 45).Estimate.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 45).Estimate.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 45).Estimate.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 45).Estimate.ExpirationDatestringOptionalDate by which estimate must be accepted before invalidation.
$ (anyOf 45).Estimate.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 45).Estimate.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 45).Estimate.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 45).Estimate.GlobalTaxCalculationstringOptionalTaxExcluded Method in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable .Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 45).Estimate.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 45).Estimate.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 45).Estimate.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 45).Estimate.IdstringRequired within parent
$ (anyOf 45).Estimate.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: SalesItemLine , GroupLine , DescriptionOnlyLine (also used for inline Subtotal lines), DiscountLine and SubTotalLine (used for the overall transaction). If the transaction is taxable there is a limit of 750 lines per transaction.
$ (anyOf 45).Estimate.Line[]JSONEach item
$ (anyOf 45).Estimate.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 45).Estimate.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 45).Estimate.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 45).Estimate.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 45).Estimate.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 45).Estimate.LinkedTxnarrayOptionalZero or more Invoice objects related to this transaction. Use LinkedTxn.TxnId as the ID in a separate Invoice read request to retrieve details of the linked object.
$ (anyOf 45).Estimate.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 45).Estimate.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 45).Estimate.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 45).Estimate.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 45).Estimate.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction. When ProjectRef is passed in the US region for QuickBooks Online Advanced and Intuit Enterprise Suite SKUs, a project estimate is created if the user has projects enabled.
Conditionally required
$ (anyOf 45).Estimate.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Estimate was created from.
Read only: true
$ (anyOf 45).Estimate.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 45).Estimate.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 45).Estimate.ShipDatestringOptionalDate for delivery of goods or services.
$ (anyOf 45).Estimate.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 45).Estimate.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string. Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 45).Estimate.SyncTokenstringRequired within parent
$ (anyOf 45).Estimate.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 45).Estimate.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 45).Estimate.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 45).Estimate.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 45).Estimate.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 45).Estimate.TxnStatusstringOptionalOne of the following status settings: Accepted, Closed, Pending, Rejected, Converted
$ (anyOf 45).Estimate.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 45).Estimate.domainstringOptional
$ (anyOf 45).Estimate.sparsebooleanOptional
$ (anyOf 46)objectAlternativeAdditional keys: not allowed
$ (anyOf 46).bIdstringRequired within parentMinimum length: 1
$ (anyOf 46).operationJSONRequired within parentMust equal: update
$ (anyOf 46).EstimateobjectRequired within parentAdditional keys: not allowed
$ (anyOf 46).Estimate.AcceptedBystringOptionalName of customer who accepted the estimate.
$ (anyOf 46).Estimate.AcceptedDatestringOptionalDate estimate was accepted.
$ (anyOf 46).Estimate.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax.
$ (anyOf 46).Estimate.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 46).Estimate.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 46).Estimate.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 46).Estimate.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the estimate is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 46).Estimate.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 46).Estimate.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 46).Estimate.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 46).Estimate.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 46).Estimate.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 46).Estimate.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 46).Estimate.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 46).Estimate.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 46).Estimate.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 46).Estimate.EmailStatusstringOptionalEmail status of the invoice. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 46).Estimate.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 46).Estimate.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 46).Estimate.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 46).Estimate.ExpirationDatestringOptionalDate by which estimate must be accepted before invalidation.
$ (anyOf 46).Estimate.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 46).Estimate.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 46).Estimate.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 46).Estimate.GlobalTaxCalculationstringOptionalTaxExcluded Method in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable .Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 46).Estimate.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 46).Estimate.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 46).Estimate.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 46).Estimate.IdstringRequired within parent
$ (anyOf 46).Estimate.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: SalesItemLine , GroupLine , DescriptionOnlyLine (also used for inline Subtotal lines), DiscountLine and SubTotalLine (used for the overall transaction). If the transaction is taxable there is a limit of 750 lines per transaction.
$ (anyOf 46).Estimate.Line[]JSONEach item
$ (anyOf 46).Estimate.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 46).Estimate.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 46).Estimate.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 46).Estimate.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 46).Estimate.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 46).Estimate.LinkedTxnarrayOptionalZero or more Invoice objects related to this transaction. Use LinkedTxn.TxnId as the ID in a separate Invoice read request to retrieve details of the linked object.
$ (anyOf 46).Estimate.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 46).Estimate.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 46).Estimate.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 46).Estimate.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 46).Estimate.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction. When ProjectRef is passed in the US region for QuickBooks Online Advanced and Intuit Enterprise Suite SKUs, a project estimate is created if the user has projects enabled.
Conditionally required
$ (anyOf 46).Estimate.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Estimate was created from.
Read only: true
$ (anyOf 46).Estimate.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 46).Estimate.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 46).Estimate.ShipDatestringOptionalDate for delivery of goods or services.
$ (anyOf 46).Estimate.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 46).Estimate.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string. Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 46).Estimate.SyncTokenstringRequired within parent
$ (anyOf 46).Estimate.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 46).Estimate.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 46).Estimate.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 46).Estimate.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 46).Estimate.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 46).Estimate.TxnStatusstringOptionalOne of the following status settings: Accepted, Closed, Pending, Rejected, Converted
$ (anyOf 46).Estimate.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 46).Estimate.domainstringOptional
$ (anyOf 46).Estimate.sparsebooleanRequired within parentMust equal: true
$ (anyOf 47)objectAlternativeAdditional keys: not allowed
$ (anyOf 47).bIdstringRequired within parentMinimum length: 1
$ (anyOf 47).operationJSONRequired within parentMust equal: update
$ (anyOf 47).ExchangerateModelRequired within parentExpand Update an exchangerate — request body — body
$ (anyOf 48)objectAlternativeAdditional keys: not allowed
$ (anyOf 48).bIdstringRequired within parentMinimum length: 1
$ (anyOf 48).operationJSONRequired within parentMust equal: create
$ (anyOf 48).InventoryAdjustmentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 48).InventoryAdjustment.AdjustAccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Specifies which account is debited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for AdjustAccountRef.value and AdjustAccountRef.name , respectively.
$ (anyOf 48).InventoryAdjustment.DocNumberstringRequired within parentReference number for the transaction.
$ (anyOf 48).InventoryAdjustment.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 48).InventoryAdjustment.LinearrayRequired within parentIndividual line items of an inventory adjustment.
$ (anyOf 48).InventoryAdjustment.Line[]ModelEach itemExpand Create an inventory adjustment — request body — body Line item
$ (anyOf 48).InventoryAdjustment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 48).InventoryAdjustment.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Statement Memo field on the Invoice form in the QuickBooks Online UI.
$ (anyOf 48).InventoryAdjustment.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 48).InventoryAdjustment.TxnDatestringRequired within parentThe date entered by the user when this transaction occurred. yyyy/MM/dd is the valid date format. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 48).InventoryAdjustment.domainstringOptional
$ (anyOf 48).InventoryAdjustment.sparsebooleanOptional
$ (anyOf 49)objectAlternativeAdditional keys: not allowed
$ (anyOf 49).bIdstringRequired within parentMinimum length: 1
$ (anyOf 49).operationJSONRequired within parentMust equal: delete
$ (anyOf 49).InventoryAdjustmentModelRequired within parentExpand Delete an inventory adjustment — request body — body
$ (anyOf 50)objectAlternativeAdditional keys: not allowed
$ (anyOf 50).bIdstringRequired within parentMinimum length: 1
$ (anyOf 50).operationJSONRequired within parentMust equal: update
$ (anyOf 50).InventoryAdjustmentModelRequired within parentExpand Update an inventory adjustment — request body — body
$ (anyOf 51)objectAlternativeAdditional keys: not allowed
$ (anyOf 51).bIdstringRequired within parentMinimum length: 1
$ (anyOf 51).operationJSONRequired within parentMust equal: create
$ (anyOf 51).InvoiceobjectRequired within parentAdditional keys: not allowed
$ (anyOf 51).Invoice.AllowIPNPaymentJSONOptionalFlag to allow payments from legacy Intuit Payment Network (IPN). Provided to maintain backward compatibility and must always be set to false . Do not modify
$ (anyOf 51).Invoice.AllowIPNPayment (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.AllowIPNPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.AllowOnlineACHPaymentJSONOptionalSpecifies if this invoice can be paid with online bank transfers and corresponds to the Bank transfer check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true . If set to true , allow invoice to be paid with online bank transfers. The Bank transfer check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with ACH. If set to false , online bank transfers are not allowed. The Bank transfer check box is not checked on the QuickBooks UI for this invoice.
$ (anyOf 51).Invoice.AllowOnlineACHPayment (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.AllowOnlineACHPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.AllowOnlineAffirmPaymentJSONOptionalSpecifies if online Affirm payments are allowed for this invoice and corresponds to the Affirm check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true and the company has been onboarded for Affirm with an ACTIVE subscription status. If set to true , allow invoice to be paid with online Affirm payments. The Affirm check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with Affirm. If set to false , online Affirm payments are not allowed. The Affirm check box is not checked on the QuickBooks UI for this invoice. Defaults to the active subscription status. If a value is explicitly sent, that value is used. If no value is sent, the default value is used.
$ (anyOf 51).Invoice.AllowOnlineAffirmPayment (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.AllowOnlineAffirmPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.AllowOnlineCreditCardPaymentJSONOptionalSpecifies if online credit card payments are allowed for this invoice and corresponds to the Credit card check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true . If set to true , allow invoice to be paid with online credit card payments. The Credit card check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with credit cards. If set to false , online credit card payments are not allowed. The Credit card check box is not checked on the QuickBooks UI for this invoice.
$ (anyOf 51).Invoice.AllowOnlineCreditCardPayment (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.AllowOnlineCreditCardPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.AllowOnlinePayPalPaymentJSONOptionalSpecifies if online PayPal/Venmo payments are allowed for this invoice and corresponds to the PayPal check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true and the company has been onboarded for PayPal with an ACTIVE subscription status. If set to true , allow invoice to be paid with online PayPal payments. The PayPal check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with PayPal. If set to false , online PayPal payments are not allowed. The PayPal check box is not checked on the QuickBooks UI for this invoice. Defaults to the active subscription status. If a value is explicitly sent, that value is used. If no value is sent, the default value is used.
$ (anyOf 51).Invoice.AllowOnlinePayPalPayment (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.AllowOnlinePayPalPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.AllowOnlinePaymentJSONOptionalDeprecated flag to allow online payments. In use before AllowOnlineCreditCardPayment and AllowOnlineACHPayment flags existed and provided to maintain backward compatibility. If set to true , this invoice was created before AllowOnlinePayment was deprecated and denotes both CC and ACH payments are allowed. In addition, the AllowOnlineCreditCardPayment and AllowOnlineACHPayment flags must be set to true . If set to false , this invoice was created after the AllowOnlinePayment flag was deprecated and is not used. Do not modify.
$ (anyOf 51).Invoice.AllowOnlinePayment (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.AllowOnlinePayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax.
$ (anyOf 51).Invoice.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks. If you process a linked transaction against a specific transaction, the balance value won’t change. It will remain the same.
Decimal string
Read only: true
$ (anyOf 51).Invoice.Balance (anyOf 1)numberAlternative
$ (anyOf 51).Invoice.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 51).Invoice.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings. If you update the CustomerRef , the address passed using BillAddr will be honored.
$ (anyOf 51).Invoice.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 51).Invoice.BillEmailBccModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the blind carbon copy e-mail address where the invoice is sent. If not specified, this field is populated from that defined in Preferences.SalesFormsPrefs.SalesEmailBcc . If this email address is invalid, blind carbon copy email is not sent.
$ (anyOf 51).Invoice.BillEmailCcModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the carbon copy e-mail address where the invoice is sent. If not specified, this field is populated from that defined in Preferences.SalesFormsPrefs.SalesEmailCc . If this email address is invalid, carbon copy email is not sent.
$ (anyOf 51).Invoice.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 51).Invoice.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 51).Invoice.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 51).Invoice.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 51).Invoice.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 51).Invoice.CustomerRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 51).Invoice.DeliveryInfoModelOptionalExpand Void an invoice — request body — body Delivery Info
Email delivery information. Returned when a request has been made to deliver email with the send operation.
Read only: true
$ (anyOf 51).Invoice.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 51).Invoice.DepositJSONOptionalThe deposit made towards this invoice.
Decimal string
$ (anyOf 51).Invoice.Deposit (anyOf 1)numberAlternative
$ (anyOf 51).Invoice.Deposit (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 51).Invoice.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account to which money is deposited. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. Before you can use this field ensure that the company allows deposits in their invoices first. This can be found by querying the Preferences endpoint . SalesFormsPrefs.AllowDeposit must be equal to true. If you do not specify this account the payment is applied to the Undeposited Funds account.
$ (anyOf 51).Invoice.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI.
Conditionally required
$ (anyOf 51).Invoice.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 51).Invoice.EmailStatusstringOptionalEmail status of the invoice. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 51).Invoice.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 51).Invoice.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 51).Invoice.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 51).Invoice.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 51).Invoice.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 51).Invoice.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 51).Invoice.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 51).Invoice.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 51).Invoice.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 51).Invoice.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 51).Invoice.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 51).Invoice.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 51).Invoice.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 51).Invoice.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 51).Invoice.InvoiceLinkstringOptionalSharable link for the invoice sent to external customers. The link is generated only for invoices with online payment enabled and having a valid customer email address. Include query param `include=invoiceLink` to get the link back on query response.
Read only: true
$ (anyOf 51).Invoice.LinearrayRequired within parentThe minimum line item required for the request is one of the following. SalesItemLine , GroupLine and Inline subtotal using DescriptionOnlyLine
$ (anyOf 51).Invoice.Line[]JSONEach item
$ (anyOf 51).Invoice.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 51).Invoice.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 51).Invoice.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 51).Invoice.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 51).Invoice.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 51).Invoice.LinkedTxnarrayOptionalZero or more related transactions to this Invoice object. The following linked relationships are supported: Links to Estimate and TimeActivity objects can be established directly to this Invoice object with UI or with the API. Create, Read, Update, and Query operations are avaialble at the API level for these types of links. Only one link can be made to an Estimate . Progress Invoicing is not supported via the API. Links to expenses incurred on behalf of the customer are returned in the response with LinkedTxn.TxnType set to ReimburseCharge , ChargeCredit or StatementCharge corresponding to billable customer expenses of type Cash , Delayed Credit , and Delayed Charge , respectively. Links to these types of transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links to payments applied to an Invoice object are returned in the response with LinkedTxn.TxnType set to Payment . Links to Payment transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Use LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 51).Invoice.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 51).Invoice.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 51).Invoice.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 51).Invoice.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Statement Memo field on the Invoice form in the QuickBooks Online UI.
$ (anyOf 51).Invoice.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 51).Invoice.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Invoice was created from.
Read only: true
$ (anyOf 51).Invoice.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 51).Invoice.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 51).Invoice.ShipDatestringOptionalDate for delivery of goods or services.
$ (anyOf 51).Invoice.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 51).Invoice.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string. Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 51).Invoice.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 51).Invoice.TaxExemptionRefJSONOptional
$ (anyOf 51).Invoice.TaxExemptionRef (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only
Read only: true
$ (anyOf 51).Invoice.TaxExemptionRef (anyOf 2)objectAlternativeMaximum fields: 0
$ (anyOf 51).Invoice.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 51).Invoice.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 51).Invoice.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 51).Invoice.TrackingNumstringOptionalShipping provider’s tracking number for the delivery of the goods associated with the transaction.
$ (anyOf 51).Invoice.TransactionLocationTypestringOptionalThe account location. For UAE, valid values include ABUDHABI AJMAN SHARJAH DUBAI FUJAIRAH RAS_AL_KHAIMAH UMM_AL_QUWAIN OTHER_GCC
$ (anyOf 51).Invoice.TxnDatestringOptionalThe date entered by the user when this transaction occurred. yyyy/MM/dd is the valid date format. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 51).Invoice.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 51).Invoice.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 51).Invoice.domainstringOptional
$ (anyOf 51).Invoice.sparsebooleanOptional
$ (anyOf 52)objectAlternativeAdditional keys: not allowed
$ (anyOf 52).bIdstringRequired within parentMinimum length: 1
$ (anyOf 52).operationJSONRequired within parentMust equal: delete
$ (anyOf 52).InvoiceModelRequired within parentExpand Void an invoice — request body — body
$ (anyOf 53)objectAlternativeAdditional keys: not allowed
$ (anyOf 53).bIdstringRequired within parentMinimum length: 1
$ (anyOf 53).operationJSONRequired within parentMust equal: update
$ (anyOf 53).InvoiceobjectRequired within parentAdditional keys: not allowed
$ (anyOf 53).Invoice.AllowIPNPaymentJSONOptionalFlag to allow payments from legacy Intuit Payment Network (IPN). Provided to maintain backward compatibility and must always be set to false . Do not modify
$ (anyOf 53).Invoice.AllowIPNPayment (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.AllowIPNPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.AllowOnlineACHPaymentJSONOptionalSpecifies if this invoice can be paid with online bank transfers and corresponds to the Bank transfer check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true . If set to true , allow invoice to be paid with online bank transfers. The Bank transfer check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with ACH. If set to false , online bank transfers are not allowed. The Bank transfer check box is not checked on the QuickBooks UI for this invoice.
$ (anyOf 53).Invoice.AllowOnlineACHPayment (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.AllowOnlineACHPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.AllowOnlineAffirmPaymentJSONOptionalSpecifies if online Affirm payments are allowed for this invoice and corresponds to the Affirm check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true and the company has been onboarded for Affirm with an ACTIVE subscription status. If set to true , allow invoice to be paid with online Affirm payments. The Affirm check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with Affirm. If set to false , online Affirm payments are not allowed. The Affirm check box is not checked on the QuickBooks UI for this invoice. Defaults to the active subscription status. If a value is explicitly sent, that value is used. If no value is sent, the default value is used.
$ (anyOf 53).Invoice.AllowOnlineAffirmPayment (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.AllowOnlineAffirmPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.AllowOnlineCreditCardPaymentJSONOptionalSpecifies if online credit card payments are allowed for this invoice and corresponds to the Credit card check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true . If set to true , allow invoice to be paid with online credit card payments. The Credit card check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with credit cards. If set to false , online credit card payments are not allowed. The Credit card check box is not checked on the QuickBooks UI for this invoice.
$ (anyOf 53).Invoice.AllowOnlineCreditCardPayment (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.AllowOnlineCreditCardPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.AllowOnlinePayPalPaymentJSONOptionalSpecifies if online PayPal/Venmo payments are allowed for this invoice and corresponds to the PayPal check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true and the company has been onboarded for PayPal with an ACTIVE subscription status. If set to true , allow invoice to be paid with online PayPal payments. The PayPal check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with PayPal. If set to false , online PayPal payments are not allowed. The PayPal check box is not checked on the QuickBooks UI for this invoice. Defaults to the active subscription status. If a value is explicitly sent, that value is used. If no value is sent, the default value is used.
$ (anyOf 53).Invoice.AllowOnlinePayPalPayment (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.AllowOnlinePayPalPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.AllowOnlinePaymentJSONOptionalDeprecated flag to allow online payments. In use before AllowOnlineCreditCardPayment and AllowOnlineACHPayment flags existed and provided to maintain backward compatibility. If set to true , this invoice was created before AllowOnlinePayment was deprecated and denotes both CC and ACH payments are allowed. In addition, the AllowOnlineCreditCardPayment and AllowOnlineACHPayment flags must be set to true . If set to false , this invoice was created after the AllowOnlinePayment flag was deprecated and is not used. Do not modify.
$ (anyOf 53).Invoice.AllowOnlinePayment (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.AllowOnlinePayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax.
$ (anyOf 53).Invoice.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks. If you process a linked transaction against a specific transaction, the balance value won’t change. It will remain the same.
Decimal string
Read only: true
$ (anyOf 53).Invoice.Balance (anyOf 1)numberAlternative
$ (anyOf 53).Invoice.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 53).Invoice.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings. If you update the CustomerRef , the address passed using BillAddr will be honored.
$ (anyOf 53).Invoice.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 53).Invoice.BillEmailBccModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the blind carbon copy e-mail address where the invoice is sent. If not specified, this field is populated from that defined in Preferences.SalesFormsPrefs.SalesEmailBcc . If this email address is invalid, blind carbon copy email is not sent.
$ (anyOf 53).Invoice.BillEmailCcModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the carbon copy e-mail address where the invoice is sent. If not specified, this field is populated from that defined in Preferences.SalesFormsPrefs.SalesEmailCc . If this email address is invalid, carbon copy email is not sent.
$ (anyOf 53).Invoice.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 53).Invoice.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 53).Invoice.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 53).Invoice.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 53).Invoice.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 53).Invoice.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 53).Invoice.DeliveryInfoModelOptionalExpand Void an invoice — request body — body Delivery Info
Email delivery information. Returned when a request has been made to deliver email with the send operation.
Read only: true
$ (anyOf 53).Invoice.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 53).Invoice.DepositJSONOptionalThe deposit made towards this invoice.
Decimal string
$ (anyOf 53).Invoice.Deposit (anyOf 1)numberAlternative
$ (anyOf 53).Invoice.Deposit (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 53).Invoice.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account to which money is deposited. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. Before you can use this field ensure that the company allows deposits in their invoices first. This can be found by querying the Preferences endpoint . SalesFormsPrefs.AllowDeposit must be equal to true. If you do not specify this account the payment is applied to the Undeposited Funds account.
$ (anyOf 53).Invoice.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI.
Conditionally required
$ (anyOf 53).Invoice.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 53).Invoice.EmailStatusstringOptionalEmail status of the invoice. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 53).Invoice.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 53).Invoice.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 53).Invoice.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 53).Invoice.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 53).Invoice.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 53).Invoice.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 53).Invoice.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 53).Invoice.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 53).Invoice.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 53).Invoice.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 53).Invoice.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 53).Invoice.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 53).Invoice.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 53).Invoice.IdstringRequired within parent
$ (anyOf 53).Invoice.InvoiceLinkstringOptionalSharable link for the invoice sent to external customers. The link is generated only for invoices with online payment enabled and having a valid customer email address. Include query param `include=invoiceLink` to get the link back on query response.
Read only: true
$ (anyOf 53).Invoice.LinearrayOptionalThe minimum line item required for the request is one of the following. SalesItemLine , GroupLine and Inline subtotal using DescriptionOnlyLine
$ (anyOf 53).Invoice.Line[]JSONEach item
$ (anyOf 53).Invoice.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 53).Invoice.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 53).Invoice.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 53).Invoice.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 53).Invoice.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 53).Invoice.LinkedTxnarrayOptionalZero or more related transactions to this Invoice object. The following linked relationships are supported: Links to Estimate and TimeActivity objects can be established directly to this Invoice object with UI or with the API. Create, Read, Update, and Query operations are avaialble at the API level for these types of links. Only one link can be made to an Estimate . Progress Invoicing is not supported via the API. Links to expenses incurred on behalf of the customer are returned in the response with LinkedTxn.TxnType set to ReimburseCharge , ChargeCredit or StatementCharge corresponding to billable customer expenses of type Cash , Delayed Credit , and Delayed Charge , respectively. Links to these types of transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links to payments applied to an Invoice object are returned in the response with LinkedTxn.TxnType set to Payment . Links to Payment transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Use LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 53).Invoice.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 53).Invoice.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 53).Invoice.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 53).Invoice.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Statement Memo field on the Invoice form in the QuickBooks Online UI.
$ (anyOf 53).Invoice.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 53).Invoice.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Invoice was created from.
Read only: true
$ (anyOf 53).Invoice.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 53).Invoice.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 53).Invoice.ShipDatestringOptionalDate for delivery of goods or services.
$ (anyOf 53).Invoice.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 53).Invoice.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string. Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 53).Invoice.SyncTokenstringRequired within parent
$ (anyOf 53).Invoice.TaxExemptionRefJSONOptional
$ (anyOf 53).Invoice.TaxExemptionRef (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only
Read only: true
$ (anyOf 53).Invoice.TaxExemptionRef (anyOf 2)objectAlternativeMaximum fields: 0
$ (anyOf 53).Invoice.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 53).Invoice.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 53).Invoice.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 53).Invoice.TrackingNumstringOptionalShipping provider’s tracking number for the delivery of the goods associated with the transaction.
$ (anyOf 53).Invoice.TransactionLocationTypestringOptionalThe account location. For UAE, valid values include ABUDHABI AJMAN SHARJAH DUBAI FUJAIRAH RAS_AL_KHAIMAH UMM_AL_QUWAIN OTHER_GCC
$ (anyOf 53).Invoice.TxnDatestringOptionalThe date entered by the user when this transaction occurred. yyyy/MM/dd is the valid date format. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 53).Invoice.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 53).Invoice.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 53).Invoice.domainstringOptional
$ (anyOf 53).Invoice.sparsebooleanOptional
$ (anyOf 54)objectAlternativeAdditional keys: not allowed
$ (anyOf 54).bIdstringRequired within parentMinimum length: 1
$ (anyOf 54).operationJSONRequired within parentMust equal: update
$ (anyOf 54).InvoiceobjectRequired within parentAdditional keys: not allowed
$ (anyOf 54).Invoice.AllowIPNPaymentJSONOptionalFlag to allow payments from legacy Intuit Payment Network (IPN). Provided to maintain backward compatibility and must always be set to false . Do not modify
$ (anyOf 54).Invoice.AllowIPNPayment (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.AllowIPNPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.AllowOnlineACHPaymentJSONOptionalSpecifies if this invoice can be paid with online bank transfers and corresponds to the Bank transfer check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true . If set to true , allow invoice to be paid with online bank transfers. The Bank transfer check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with ACH. If set to false , online bank transfers are not allowed. The Bank transfer check box is not checked on the QuickBooks UI for this invoice.
$ (anyOf 54).Invoice.AllowOnlineACHPayment (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.AllowOnlineACHPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.AllowOnlineAffirmPaymentJSONOptionalSpecifies if online Affirm payments are allowed for this invoice and corresponds to the Affirm check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true and the company has been onboarded for Affirm with an ACTIVE subscription status. If set to true , allow invoice to be paid with online Affirm payments. The Affirm check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with Affirm. If set to false , online Affirm payments are not allowed. The Affirm check box is not checked on the QuickBooks UI for this invoice. Defaults to the active subscription status. If a value is explicitly sent, that value is used. If no value is sent, the default value is used.
$ (anyOf 54).Invoice.AllowOnlineAffirmPayment (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.AllowOnlineAffirmPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.AllowOnlineCreditCardPaymentJSONOptionalSpecifies if online credit card payments are allowed for this invoice and corresponds to the Credit card check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true . If set to true , allow invoice to be paid with online credit card payments. The Credit card check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with credit cards. If set to false , online credit card payments are not allowed. The Credit card check box is not checked on the QuickBooks UI for this invoice.
$ (anyOf 54).Invoice.AllowOnlineCreditCardPayment (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.AllowOnlineCreditCardPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.AllowOnlinePayPalPaymentJSONOptionalSpecifies if online PayPal/Venmo payments are allowed for this invoice and corresponds to the PayPal check box on the QuickBooks UI. Active when the company is payments-enabled, i.e., Preferences.SalesFormsPrefs.ETransactionPaymentEnabled is set to true and the company has been onboarded for PayPal with an ACTIVE subscription status. If set to true , allow invoice to be paid with online PayPal payments. The PayPal check box is checked on the QuickBooks UI for this invoice. True by default if the company allows invoices to be paid with PayPal. If set to false , online PayPal payments are not allowed. The PayPal check box is not checked on the QuickBooks UI for this invoice. Defaults to the active subscription status. If a value is explicitly sent, that value is used. If no value is sent, the default value is used.
$ (anyOf 54).Invoice.AllowOnlinePayPalPayment (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.AllowOnlinePayPalPayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.AllowOnlinePaymentJSONOptionalDeprecated flag to allow online payments. In use before AllowOnlineCreditCardPayment and AllowOnlineACHPayment flags existed and provided to maintain backward compatibility. If set to true , this invoice was created before AllowOnlinePayment was deprecated and denotes both CC and ACH payments are allowed. In addition, the AllowOnlineCreditCardPayment and AllowOnlineACHPayment flags must be set to true . If set to false , this invoice was created after the AllowOnlinePayment flag was deprecated and is not used. Do not modify.
$ (anyOf 54).Invoice.AllowOnlinePayment (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.AllowOnlinePayment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax.
$ (anyOf 54).Invoice.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks. If you process a linked transaction against a specific transaction, the balance value won’t change. It will remain the same.
Decimal string
Read only: true
$ (anyOf 54).Invoice.Balance (anyOf 1)numberAlternative
$ (anyOf 54).Invoice.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 54).Invoice.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings. If you update the CustomerRef , the address passed using BillAddr will be honored.
$ (anyOf 54).Invoice.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 54).Invoice.BillEmailBccModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the blind carbon copy e-mail address where the invoice is sent. If not specified, this field is populated from that defined in Preferences.SalesFormsPrefs.SalesEmailBcc . If this email address is invalid, blind carbon copy email is not sent.
$ (anyOf 54).Invoice.BillEmailCcModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the carbon copy e-mail address where the invoice is sent. If not specified, this field is populated from that defined in Preferences.SalesFormsPrefs.SalesEmailCc . If this email address is invalid, carbon copy email is not sent.
$ (anyOf 54).Invoice.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 54).Invoice.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Applicable if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 54).Invoice.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 54).Invoice.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 54).Invoice.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 54).Invoice.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 54).Invoice.DeliveryInfoModelOptionalExpand Void an invoice — request body — body Delivery Info
Email delivery information. Returned when a request has been made to deliver email with the send operation.
Read only: true
$ (anyOf 54).Invoice.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 54).Invoice.DepositJSONOptionalThe deposit made towards this invoice.
Decimal string
$ (anyOf 54).Invoice.Deposit (anyOf 1)numberAlternative
$ (anyOf 54).Invoice.Deposit (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 54).Invoice.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account to which money is deposited. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. Before you can use this field ensure that the company allows deposits in their invoices first. This can be found by querying the Preferences endpoint . SalesFormsPrefs.AllowDeposit must be equal to true. If you do not specify this account the payment is applied to the Undeposited Funds account.
$ (anyOf 54).Invoice.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI.
Conditionally required
$ (anyOf 54).Invoice.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 54).Invoice.EmailStatusstringOptionalEmail status of the invoice. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 54).Invoice.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 54).Invoice.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 54).Invoice.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 54).Invoice.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 54).Invoice.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 54).Invoice.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 54).Invoice.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 54).Invoice.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 54).Invoice.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 54).Invoice.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 54).Invoice.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 54).Invoice.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 54).Invoice.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 54).Invoice.IdstringRequired within parent
$ (anyOf 54).Invoice.InvoiceLinkstringOptionalSharable link for the invoice sent to external customers. The link is generated only for invoices with online payment enabled and having a valid customer email address. Include query param `include=invoiceLink` to get the link back on query response.
Read only: true
$ (anyOf 54).Invoice.LinearrayOptionalIndividual line items of a transaction. Valid Line types include SalesItemLine , GroupLine , DescriptionOnlyLine (also used for inline Subtotal lines), DiscountLine and SubTotalLine (used for the overall transaction). If the transaction is taxable there is a limit of 750 lines per transaction.
$ (anyOf 54).Invoice.Line[]JSONEach item
$ (anyOf 54).Invoice.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 54).Invoice.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 54).Invoice.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 54).Invoice.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 54).Invoice.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 54).Invoice.LinkedTxnarrayOptionalZero or more related transactions to this Invoice object. The following linked relationships are supported: Links to Estimate and TimeActivity objects can be established directly to this Invoice object with UI or with the API. Create, Read, Update, and Query operations are avaialble at the API level for these types of links. Only one link can be made to an Estimate . Progress Invoicing is not supported via the API. Links to expenses incurred on behalf of the customer are returned in the response with LinkedTxn.TxnType set to ReimburseCharge , ChargeCredit or StatementCharge corresponding to billable customer expenses of type Cash , Delayed Credit , and Delayed Charge , respectively. Links to these types of transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links to payments applied to an Invoice object are returned in the response with LinkedTxn.TxnType set to Payment . Links to Payment transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Use LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 54).Invoice.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 54).Invoice.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 54).Invoice.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 54).Invoice.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Statement Memo field on the Invoice form in the QuickBooks Online UI.
$ (anyOf 54).Invoice.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 54).Invoice.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Invoice was created from.
Read only: true
$ (anyOf 54).Invoice.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 54).Invoice.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 54).Invoice.ShipDatestringOptionalDate for delivery of goods or services.
$ (anyOf 54).Invoice.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 54).Invoice.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string. Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 54).Invoice.SyncTokenstringRequired within parent
$ (anyOf 54).Invoice.TaxExemptionRefJSONOptional
$ (anyOf 54).Invoice.TaxExemptionRef (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only
Read only: true
$ (anyOf 54).Invoice.TaxExemptionRef (anyOf 2)objectAlternativeMaximum fields: 0
$ (anyOf 54).Invoice.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 54).Invoice.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 54).Invoice.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 54).Invoice.TrackingNumstringOptionalShipping provider’s tracking number for the delivery of the goods associated with the transaction.
$ (anyOf 54).Invoice.TransactionLocationTypestringOptionalThe account location. For UAE, valid values include ABUDHABI AJMAN SHARJAH DUBAI FUJAIRAH RAS_AL_KHAIMAH UMM_AL_QUWAIN OTHER_GCC
$ (anyOf 54).Invoice.TxnDatestringOptionalThe date entered by the user when this transaction occurred. yyyy/MM/dd is the valid date format. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 54).Invoice.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 54).Invoice.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 54).Invoice.domainstringOptional
$ (anyOf 54).Invoice.sparsebooleanRequired within parentMust equal: true
$ (anyOf 55)objectAlternativeAdditional keys: not allowed
$ (anyOf 55).bIdstringRequired within parentMinimum length: 1
$ (anyOf 55).operationJSONRequired within parentMust equal: update
$ (anyOf 55).InvoiceModelRequired within parentExpand Void an invoice — request body — body
$ (anyOf 55).optionsDataJSONRequired within parentMust equal: void
$ (anyOf 56)objectAlternativeAdditional keys: not allowed
$ (anyOf 56).bIdstringRequired within parentMinimum length: 1
$ (anyOf 56).operationJSONRequired within parentMust equal: create
$ (anyOf 56).ItemobjectRequired within parentAdditional keys: not allowed
$ (anyOf 56).Item.ActiveJSONOptionalIf true, the object is currently enabled for use by QuickBooks.
$ (anyOf 56).Item.Active (anyOf 1)booleanAlternative
$ (anyOf 56).Item.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 56).Item.AssetAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Inventory Asset account that tracks the current value of the inventory. If the same account is used for all inventory items, the current balance of this account will represent the current total value of the inventory. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for AssetAccountRef.value and AssetAccountRef.name , respectively. Required for Inventory item types.
Conditionally required
$ (anyOf 56).Item.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class for the item. Query the Class name list resource to determine the appropriate object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 56).Item.CustomExtensionsModelOptionalExpand Create an item — request body — body Custom Extensions
Array of custom extension objects that associate additional attributes with the item. The ExtensionType field specifies the type of extension. The currently supported value is DIMENSION . The AssociatedValues array contains key/value pairs referencing Dimensions DefinitionID/Dimension ValueID. Multiple key/value pairs per extension type are supported. This field is designed to support additional extension types in the future. Dimensions is available for Intuit Enterprise Suite.
$ (anyOf 56).Item.DescriptionstringOptionalDescription of the item.
$ (anyOf 56).Item.ExpenseAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the expense account used to pay the vendor for this item. Must be an account with account type of Cost of Goods Sold . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for ExpenseAccountRef.value and ExpenseAccountRef.name , respectively. Required for Inventory , NonInventory , and Service item types.
$ (anyOf 56).Item.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Item:SubItem . Returned from an existing object and not input on a new object.Limited to 5 levels.
Read only: true
$ (anyOf 56).Item.IdstringOptionalUnique Identifier for an Intuit entity (object). Required for the update operation.
Read only: true
$ (anyOf 56).Item.IncomeAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the posting account, that is, the account that records the proceeds from the sale of this item. Must be an account with account type of Sales of Product Income . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for IncomeAccountRef.value and IncomeAccountRef.name , respectively. Required for Inventory and Service item types.
$ (anyOf 56).Item.InvStartDatestringOptionalDate of opening balance for the inventory transaction. For read operations, the date returned in this field is always the originally provided inventory start date. For update operations, the date supplied is interpreted as the inventory adjust date, is stored as such in the underlying data model, and is reflected in the QuickBooks Online UI for the object. The inventory adjust date is not exposed for read operations through the API. Required for Inventory type items.
Conditionally required
$ (anyOf 56).Item.LevelJSONOptionalSpecifies the level of the hierarchy in which the entity is located. Zero specifies the top level of the hierarchy; anything above will be the next level with respect to the parent. Limited to 5 levels.
Read only: true
$ (anyOf 56).Item.Level (anyOf 1)integerAlternative
$ (anyOf 56).Item.Level (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 56).Item.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 56).Item.NamestringRequired within parentName of the category.
$ (anyOf 56).Item.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
The immediate parent of the sub item in the hierarchical Category:Sub-category list. If SubItem is true, then ParenRef is required. Query the Item name list resource to determine the appropriate object for this reference. Use Item.Id and Item.Name from that object for ParentRef.value and ParentRef.name , respectively.
Conditionally required
$ (anyOf 56).Item.PrefVendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the preferred vendor of this item. Query the Vendor name list resource to determine the appropriate object for this reference. Use Vendor.Id and Vendor.Name from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 56).Item.PurchaseCostJSONOptionalAmount paid when buying or ordering the item, as expressed in the home currency.
Decimal string
$ (anyOf 56).Item.PurchaseCost (anyOf 1)numberAlternative
$ (anyOf 56).Item.PurchaseCost (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 56).Item.PurchaseDescstringOptionalPurchase description for the item.
$ (anyOf 56).Item.PurchaseTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the purchase tax code for the item. Applicable to Service, Other Charge, and Product (Non-Inventory) item types. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for PurchaseTaxCodeRef.value and PurchaseTaxCodeRef.name , respectively.
$ (anyOf 56).Item.PurchaseTaxIncludedJSONOptionalTrue if the purchase tax is included in the item amount, and therefore is not calculated for the transaction.
$ (anyOf 56).Item.PurchaseTaxIncluded (anyOf 1)booleanAlternative
$ (anyOf 56).Item.PurchaseTaxIncluded (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 56).Item.QtyOnHandJSONOptionalCurrent quantity of the Inventory items available for sale. Not used for Service or NonInventory type items.Required for Inventory type items.
Conditionally required
Decimal string
$ (anyOf 56).Item.QtyOnHand (anyOf 1)numberAlternative
$ (anyOf 56).Item.QtyOnHand (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 56).Item.ReorderPointJSONOptionalThe minimum quantity of a particular inventory item that you need to restock at any given time. The ReorderPoint value cannot be set to null for sparse updates(sparse=true). It can be set to null only for full updates.
Decimal string
$ (anyOf 56).Item.ReorderPoint (anyOf 1)numberAlternative
$ (anyOf 56).Item.ReorderPoint (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 56).Item.SalesTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
For non-US companies only. Reference to the sales tax code for the Sales item. Applicable to Service and Sales item types only. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for SalesTaxCodeRef.value and SalesTaxCodeRef.name , respectively.
$ (anyOf 56).Item.SalesTaxIncludedJSONOptionalTrue if the sales tax is included in the item amount, and therefore is not calculated for the transaction.
$ (anyOf 56).Item.SalesTaxIncluded (anyOf 1)booleanAlternative
$ (anyOf 56).Item.SalesTaxIncluded (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 56).Item.SkustringOptionalThe stock keeping unit (SKU) for this Item. This is a company-defined identifier for an item or product used in tracking inventory.
$ (anyOf 56).Item.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 56).Item.SubItemJSONOptionaltrue —The object is a sub-category. false —The object is a top-level category (default). Sub-categories can be nested to a maximum depth of three levels below a top-level category. Required for sub-category.
Conditionally required
$ (anyOf 56).Item.SubItem (anyOf 1)booleanAlternative
$ (anyOf 56).Item.SubItem (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 56).Item.SyncTokenstringOptionalVersion number of the entity. Required for the update operation.
Read only: true
$ (anyOf 56).Item.TaxClassificationRefModelOptionalExpand Create a purchase order — request body — body Ship To
Tax classification segregates different items into different classifications and the tax classification is one of the key parameters to determine appropriate tax on transactions involving items. Tax classifications are sourced by either tax governing authorities as in Malaysia or externally like Exactor. ‘Fuel’, ‘Garments’ and ‘Soft drinks’ are a few examples of tax classification in layman terms. User can choose a specific tax classification for an item while creating it. A level 1 tax classification cannot be associated to an Item.
$ (anyOf 56).Item.TaxableJSONOptionalIf true, transactions for this item are taxable. Applicable to US companies, only.
$ (anyOf 56).Item.Taxable (anyOf 1)booleanAlternative
$ (anyOf 56).Item.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 56).Item.TrackQtyOnHandJSONOptionalTrue if there is quantity on hand to be tracked. Once this value is true, it cannot be updated to false. Applicable for items of type Inventory . Not applicable for Service or NonInventory item types.
$ (anyOf 56).Item.TrackQtyOnHand (anyOf 1)booleanAlternative
$ (anyOf 56).Item.TrackQtyOnHand (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 56).Item.TypestringRequired within parentMust be set to the literal string, Category .
$ (anyOf 56).Item.UnitPriceJSONOptionalCorresponds to the Price/Rate column on the QuickBooks Online UI to specify either unit price, a discount, or a tax rate for item. If used for unit price, the monetary value of the service or product, as expressed in the home currency. If used for a discount or tax rate, express the percentage as a fraction. For example, specify 0.4 for 40% tax.
Decimal string
$ (anyOf 56).Item.UnitPrice (anyOf 1)numberAlternative
$ (anyOf 56).Item.UnitPrice (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 56).Item.domainstringOptional
$ (anyOf 56).Item.sparsebooleanOptional
$ (anyOf 57)objectAlternativeAdditional keys: not allowed
$ (anyOf 57).bIdstringRequired within parentMinimum length: 1
$ (anyOf 57).operationJSONRequired within parentMust equal: create
$ (anyOf 57).ItemobjectRequired within parentAdditional keys: not allowed
$ (anyOf 57).Item.ActiveJSONOptionalIf true, the object is currently enabled for use by QuickBooks.
$ (anyOf 57).Item.Active (anyOf 1)booleanAlternative
$ (anyOf 57).Item.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 57).Item.AssetAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Inventory Asset account that tracks the current value of the inventory. If the same account is used for all inventory items, the current balance of this account will represent the current total value of the inventory. Must be an account with account type of Other Current Asset . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for AssetAccountRef.value and AssetAccountRef.name , respectively. Required for Inventory item types.
$ (anyOf 57).Item.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class for the item. Query the Class name list resource to determine the appropriate object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 57).Item.CustomExtensionsModelOptionalExpand Create an item — request body — body Custom Extensions
Array of custom extension objects that associate additional attributes with the item. The ExtensionType field specifies the type of extension. The currently supported value is DIMENSION . The AssociatedValues array contains key/value pairs referencing Dimensions DefinitionID/Dimension ValueID. Multiple key/value pairs per extension type are supported. This field is designed to support additional extension types in the future. Dimensions is available for Intuit Enterprise Suite.
$ (anyOf 57).Item.DescriptionstringOptionalDescription of the item.
$ (anyOf 57).Item.ExpenseAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the expense account used to pay the vendor for this item. Must be an account with account type of Cost of Goods Sold . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for ExpenseAccountRef.value and ExpenseAccountRef.name , respectively. For France locales: This is an optional field. This is the purchase account id, If not provided it defaults to the default purchase account: 605100 and 601100 are the default expense accounts used for Service and Product type of item, respectively. Required for Inventory , NonInventory , and Service item types.
$ (anyOf 57).Item.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Item:SubItem . Returned from an existing object and not input on a new object.Limited to 5 levels.
Read only: true
$ (anyOf 57).Item.IdstringOptionalUnique Identifier for an Intuit entity (object). Required for the update operation.
Read only: true
$ (anyOf 57).Item.IncomeAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the posting account, that is, the account that records the proceeds from the sale of this item. Must be an account with account type of Sales of Product Income . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for IncomeAccountRef.value and IncomeAccountRef.name , respectively. For France locales: This is an optional field. This is the sales account id, If not provided it defaults to the default sales account: 706100 and 707100 are the default expense accounts used for Service and Product type of item, respectively. Required for Inventory and Service item types.
Conditionally required
$ (anyOf 57).Item.InvStartDatestringOptionalDate of opening balance for the inventory transaction. Required when creating an Item.Type=Inventory . Required for Inventory item types.
$ (anyOf 57).Item.LevelJSONOptionalSpecifies the level of the hierarchy in which the entity is located. Zero specifies the top level of the hierarchy; anything above will be the next level with respect to the parent. Limited to 5 levels.
Read only: true
$ (anyOf 57).Item.Level (anyOf 1)integerAlternative
$ (anyOf 57).Item.Level (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 57).Item.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 57).Item.NamestringRequired within parentName of the item. This value must be unique, at least one character in length, and cannot include tabs, new lines, or colons. Required for create.
$ (anyOf 57).Item.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
The immediate parent of the sub item in the hierarchical Item:SubItem list. If SubItem is true, then ParenRef is required. If SubItem is true, then ParenRef is required. Query the Item name list resource to determine the appropriate object for this reference. Use Item.Id and Item.Name from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 57).Item.PrefVendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the preferred vendor of this item. Query the Vendor name list resource to determine the appropriate object for this reference. Use Vendor.Id and Vendor.Name from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 57).Item.PurchaseCostJSONOptionalAmount paid when buying or ordering the item, as expressed in the home currency.
Decimal string
$ (anyOf 57).Item.PurchaseCost (anyOf 1)numberAlternative
$ (anyOf 57).Item.PurchaseCost (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 57).Item.PurchaseDescstringOptionalPurchase description for the item.
$ (anyOf 57).Item.PurchaseTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the purchase tax code for the item. Applicable to Service, Other Charge, and Product (Non-Inventory) item types. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for PurchaseTaxCodeRef.value and PurchaseTaxCodeRef.name , respectively.
$ (anyOf 57).Item.PurchaseTaxIncludedJSONOptionalTrue if the purchase tax is included in the item amount, and therefore is not calculated for the transaction.
$ (anyOf 57).Item.PurchaseTaxIncluded (anyOf 1)booleanAlternative
$ (anyOf 57).Item.PurchaseTaxIncluded (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 57).Item.QtyOnHandJSONOptionalCurrent quantity of the Inventory items available for sale. Not used for Service or NonInventory type items.Required for Inventory type items.
Conditionally required
Decimal string
$ (anyOf 57).Item.QtyOnHand (anyOf 1)numberAlternative
$ (anyOf 57).Item.QtyOnHand (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 57).Item.ReorderPointJSONOptionalThe minimum quantity of a particular inventory item that you need to restock at any given time. The ReorderPoint value cannot be set to null for sparse updates(sparse=true). It can be set to null only for full updates.
Decimal string
$ (anyOf 57).Item.ReorderPoint (anyOf 1)numberAlternative
$ (anyOf 57).Item.ReorderPoint (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 57).Item.SalesTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
For non-US companies only. Reference to the sales tax code for the Sales item. Applicable to Service and Sales item types only. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for SalesTaxCodeRef.value and SalesTaxCodeRef.name , respectively.
$ (anyOf 57).Item.SalesTaxIncludedJSONOptionalTrue if the sales tax is included in the item amount, and therefore is not calculated for the transaction.
$ (anyOf 57).Item.SalesTaxIncluded (anyOf 1)booleanAlternative
$ (anyOf 57).Item.SalesTaxIncluded (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 57).Item.SkustringOptionalThe stock keeping unit (SKU) for this Item. This is a company-defined identifier for an item or product used in tracking inventory.
$ (anyOf 57).Item.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 57).Item.SubItemJSONOptionalIf true, this is a sub item. If false or null, this is a top-level item. Creating inventory hierarchies with traditional inventory items is being phased out in lieu of using categories and sub categories.
$ (anyOf 57).Item.SubItem (anyOf 1)booleanAlternative
$ (anyOf 57).Item.SubItem (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 57).Item.SyncTokenstringOptionalVersion number of the entity. Required for the update operation.
Read only: true
$ (anyOf 57).Item.TaxClassificationRefModelOptionalExpand Create a purchase order — request body — body Ship To
Tax classification segregates different items into different classifications and the tax classification is one of the key parameters to determine appropriate tax on transactions involving items. Tax classifications are sourced by either tax governing authorities as in Malaysia or externally like Exactor. ‘Fuel’, ‘Garments’ and ‘Soft drinks’ are a few examples of tax classification in layman terms. User can choose a specific tax classification for an item while creating it. A level 1 tax classification cannot be associated to an Item.
$ (anyOf 57).Item.TaxableJSONOptionalIf true, transactions for this item are taxable. Applicable to US companies, only.
$ (anyOf 57).Item.Taxable (anyOf 1)booleanAlternative
$ (anyOf 57).Item.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 57).Item.TrackQtyOnHandJSONOptionalTrue if there is quantity on hand to be tracked. Once this value is true, it cannot be updated to false. Applicable for items of type Inventory . Not applicable for Service or NonInventory item types.
$ (anyOf 57).Item.TrackQtyOnHand (anyOf 1)booleanAlternative
$ (anyOf 57).Item.TrackQtyOnHand (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 57).Item.TypestringOptionalClassification that specifies the use of this item. See the description at the top of the Item entity page for details about supported item types. Used for goods the company sells and buys that are tracked as inventory. Service —Default setting when TrackQtyOnHand , InvStartDate , and AssetAccountRef are not specified. Used for non-tangible goods the company sells and buys that are not tracked as inventory. For example, specialized labor, consulting hours, and professional fees. This field is required to be explicitly set with one of the following: Inventory —Used for goods the company sells and buys that are tracked as inventory. Service —Used for non-tangible goods the company sells and buys that are not tracked as inventory. For example, specialized labor, consulting hours, and professional fees. NonInventory —Use for goods the company sells and buys that are not tracked as inventory. For example, office supplies or goods bought on behalf of the customer. .
Conditionally required
$ (anyOf 57).Item.UnitPriceJSONOptionalCorresponds to the Price/Rate column on the QuickBooks Online UI to specify either unit price, a discount, or a tax rate for item. If used for unit price, the monetary value of the service or product, as expressed in the home currency. If used for a discount or tax rate, express the percentage as a fraction. For example, specify 0.4 for 40% tax.
Decimal string
$ (anyOf 57).Item.UnitPrice (anyOf 1)numberAlternative
$ (anyOf 57).Item.UnitPrice (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 57).Item.domainstringOptional
$ (anyOf 57).Item.sparsebooleanOptional
$ (anyOf 58)objectAlternativeAdditional keys: not allowed
$ (anyOf 58).bIdstringRequired within parentMinimum length: 1
$ (anyOf 58).operationJSONRequired within parentMust equal: update
$ (anyOf 58).ItemobjectRequired within parentAdditional keys: not allowed
$ (anyOf 58).Item.ActiveJSONOptionalIf true, the object is currently enabled for use by QuickBooks.
$ (anyOf 58).Item.Active (anyOf 1)booleanAlternative
$ (anyOf 58).Item.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 58).Item.AssetAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Inventory Asset account that tracks the current value of the inventory. If the same account is used for all inventory items, the current balance of this account will represent the current total value of the inventory. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for AssetAccountRef.value and AssetAccountRef.name , respectively. Required for Inventory item types.
Conditionally required
$ (anyOf 58).Item.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class for the item. Query the Class name list resource to determine the appropriate object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 58).Item.CustomExtensionsModelOptionalExpand Create an item — request body — body Custom Extensions
Array of custom extension objects that associate additional attributes with the item. The ExtensionType field specifies the type of extension. The currently supported value is DIMENSION . The AssociatedValues array contains key/value pairs referencing Dimensions DefinitionID/Dimension ValueID. Multiple key/value pairs per extension type are supported. This field is designed to support additional extension types in the future. Dimensions is available for Intuit Enterprise Suite.
$ (anyOf 58).Item.DescriptionstringOptionalDescription of the item.
$ (anyOf 58).Item.ExpenseAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the expense account used to pay the vendor for this item. Must be an account with account type of Cost of Goods Sold . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for ExpenseAccountRef.value and ExpenseAccountRef.name , respectively. Required for Inventory , NonInventory , and Service item types.
$ (anyOf 58).Item.FullyQualifiedNamestringOptionalFully qualified name of the entity. The fully qualified name prepends the topmost parent, followed by each sub element separated by colons. Takes the form of Item:SubItem . Returned from an existing object and not input on a new object.Limited to 5 levels.
Read only: true
$ (anyOf 58).Item.IdstringRequired within parent
$ (anyOf 58).Item.IncomeAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the posting account, that is, the account that records the proceeds from the sale of this item. Must be an account with account type of Sales of Product Income . Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for IncomeAccountRef.value and IncomeAccountRef.name , respectively. Required for Inventory and Service item types.
$ (anyOf 58).Item.InvStartDatestringOptionalDate of opening balance for the inventory transaction. For read operations, the date returned in this field is always the originally provided inventory start date. For update operations, the date supplied is interpreted as the inventory adjust date, is stored as such in the underlying data model, and is reflected in the QuickBooks Online UI for the object. The inventory adjust date is not exposed for read operations through the API. Required for Inventory type items.
Conditionally required
$ (anyOf 58).Item.LevelJSONOptionalSpecifies the level of the hierarchy in which the entity is located. Zero specifies the top level of the hierarchy; anything above will be the next level with respect to the parent. Limited to 5 levels.
Read only: true
$ (anyOf 58).Item.Level (anyOf 1)integerAlternative
$ (anyOf 58).Item.Level (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 58).Item.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 58).Item.NamestringOptionalName of the item. This value is unique.
$ (anyOf 58).Item.ParentRefModelOptionalExpand Create a purchase order — request body — body Ship To
The immediate parent of the sub item in the hierarchical Item:SubItem list. If SubItem is true, then ParenRef is required. If SubItem is true, then ParenRef is required. Query the Item name list resource to determine the appropriate object for this reference. Use Item.Id and Item.Name from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 58).Item.PrefVendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the preferred vendor of this item. Query the Vendor name list resource to determine the appropriate object for this reference. Use Vendor.Id and Vendor.Name from that object for ParentRef.value and ParentRef.name , respectively.
$ (anyOf 58).Item.PurchaseCostJSONOptionalAmount paid when buying or ordering the item, as expressed in the home currency.
Decimal string
$ (anyOf 58).Item.PurchaseCost (anyOf 1)numberAlternative
$ (anyOf 58).Item.PurchaseCost (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 58).Item.PurchaseDescstringOptionalPurchase description for the item.
$ (anyOf 58).Item.PurchaseTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the purchase tax code for the item. Applicable to Service, Other Charge, and Product (Non-Inventory) item types. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for PurchaseTaxCodeRef.value and PurchaseTaxCodeRef.name , respectively.
$ (anyOf 58).Item.PurchaseTaxIncludedJSONOptionalTrue if the purchase tax is included in the item amount, and therefore is not calculated for the transaction.
$ (anyOf 58).Item.PurchaseTaxIncluded (anyOf 1)booleanAlternative
$ (anyOf 58).Item.PurchaseTaxIncluded (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 58).Item.QtyOnHandJSONOptionalCurrent quantity of the Inventory items available for sale. Not used for Service or NonInventory type items.Required for Inventory type items.
Conditionally required
Decimal string
$ (anyOf 58).Item.QtyOnHand (anyOf 1)numberAlternative
$ (anyOf 58).Item.QtyOnHand (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 58).Item.ReorderPointJSONOptionalThe minimum quantity of a particular inventory item that you need to restock at any given time. The ReorderPoint value cannot be set to null for sparse updates(sparse=true). It can be set to null only for full updates.
Decimal string
$ (anyOf 58).Item.ReorderPoint (anyOf 1)numberAlternative
$ (anyOf 58).Item.ReorderPoint (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 58).Item.SalesTaxCodeRefModelOptionalExpand Create a purchase order — request body — body Ship To
For non-US companies only. Reference to the sales tax code for the Sales item. Applicable to Service and Sales item types only. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for SalesTaxCodeRef.value and SalesTaxCodeRef.name , respectively.
$ (anyOf 58).Item.SalesTaxIncludedJSONOptionalTrue if the sales tax is included in the item amount, and therefore is not calculated for the transaction.
$ (anyOf 58).Item.SalesTaxIncluded (anyOf 1)booleanAlternative
$ (anyOf 58).Item.SalesTaxIncluded (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 58).Item.SkustringOptionalThe stock keeping unit (SKU) for this Item. This is a company-defined identifier for an item or product used in tracking inventory.
$ (anyOf 58).Item.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 58).Item.SubItemJSONOptionalIf true, this is a sub item. If false or null, this is a top-level item. Creating inventory hierarchies with traditional inventory items is being phased out in lieu of using categories and sub categories.
$ (anyOf 58).Item.SubItem (anyOf 1)booleanAlternative
$ (anyOf 58).Item.SubItem (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 58).Item.SyncTokenstringRequired within parent
$ (anyOf 58).Item.TaxClassificationRefModelOptionalExpand Create a purchase order — request body — body Ship To
Tax classification segregates different items into different classifications and the tax classification is one of the key parameters to determine appropriate tax on transactions involving items. Tax classifications are sourced by either tax governing authorities as in Malaysia or externally like Exactor. ‘Fuel’, ‘Garments’ and ‘Soft drinks’ are a few examples of tax classification in layman terms. User can choose a specific tax classification for an item while creating it. A level 1 tax classification cannot be associated to an Item.
$ (anyOf 58).Item.TaxableJSONOptionalIf true, transactions for this item are taxable. Applicable to US companies, only.
$ (anyOf 58).Item.Taxable (anyOf 1)booleanAlternative
$ (anyOf 58).Item.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 58).Item.TrackQtyOnHandJSONOptionalTrue if there is quantity on hand to be tracked. Once this value is true, it cannot be updated to false. Applicable for items of type Inventory . Not applicable for Service or NonInventory item types.
$ (anyOf 58).Item.TrackQtyOnHand (anyOf 1)booleanAlternative
$ (anyOf 58).Item.TrackQtyOnHand (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 58).Item.TypestringOptionalClassification that specifies the use of this item. See the description at the top of the Item entity page for details about supported item types. This field is required to be explicitly set with one of the following: Inventory —Used for goods the company sells and buys that are tracked as inventory. Service —Used for non-tangible goods the company sells and buys that are not tracked as inventory. For example, specialized labor, consulting hours, and professional fees. NonInventory —Use for goods the company sells and buys that are not tracked as inventory. For example, office supplies or goods bought on behalf of the customer. .
Conditionally required
$ (anyOf 58).Item.UnitPriceJSONOptionalCorresponds to the Price/Rate column on the QuickBooks Online UI to specify either unit price, a discount, or a tax rate for item. If used for unit price, the monetary value of the service or product, as expressed in the home currency. If used for a discount or tax rate, express the percentage as a fraction. For example, specify 0.4 for 40% tax.
Decimal string
$ (anyOf 58).Item.UnitPrice (anyOf 1)numberAlternative
$ (anyOf 58).Item.UnitPrice (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 58).Item.domainstringOptional
$ (anyOf 58).Item.sparsebooleanOptional
$ (anyOf 59)objectAlternativeAdditional keys: not allowed
$ (anyOf 59).bIdstringRequired within parentMinimum length: 1
$ (anyOf 59).operationJSONRequired within parentMust equal: update
$ (anyOf 59).ItemModelRequired within parentExpand Update a category — request body — body
$ (anyOf 60)objectAlternativeAdditional keys: not allowed
$ (anyOf 60).bIdstringRequired within parentMinimum length: 1
$ (anyOf 60).operationJSONRequired within parentMust equal: create
$ (anyOf 60).JournalEntryobjectRequired within parentAdditional keys: not allowed
$ (anyOf 60).JournalEntry.AdjustmentJSONOptionalIndicates whether this transaction is a journal entry adjustment.
$ (anyOf 60).JournalEntry.Adjustment (anyOf 1)booleanAlternative
$ (anyOf 60).JournalEntry.Adjustment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 60).JournalEntry.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 60).JournalEntry.DocNumberstringOptionalReference number for the transaction. Throws an error when duplicate DocNumber is sent in the request and if Preferences:OtherPrefs:NameValue.Name = WarnDuplicateJournalNumber is true. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = WarnDuplicateJournalNumber before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default. If null value is sent in the request null will be saved. If there is a need to support assigning a docNumber when null, it can be achieved through include param, include=allowautodocnum
$ (anyOf 60).JournalEntry.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 60).JournalEntry.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 60).JournalEntry.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 60).JournalEntry.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 60).JournalEntry.HomeTotalAmtJSONOptionalThe value of this field will always be set to zero. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 60).JournalEntry.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 60).JournalEntry.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 60).JournalEntry.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 60).JournalEntry.LinearrayRequired within parentIndividual line items of a journal entry. Two line items are required: one with PostingType set to Debit and one with PostingType set to Credit . Set Line.DetailType to JournalEntryLine for both lines.
$ (anyOf 60).JournalEntry.Line[]ModelEach itemExpand Create a journalentry — request body — body Line item
$ (anyOf 60).JournalEntry.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 60).JournalEntry.PrivateNotestringOptionalUser entered, organization-private note about the transaction.
$ (anyOf 60).JournalEntry.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the JournalEntry was created from.
Read only: true
$ (anyOf 60).JournalEntry.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 60).JournalEntry.TaxRateRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Tax Adjustment Rate Ids for this item. Query the TaxRate list resource to determine the appropriate TaxRate object for this reference. Use TaxRate.Id and TaxRate.Name from that object for TaxRateRef.value and TaxRateRef.name, respectively.
$ (anyOf 60).JournalEntry.TotalAmtJSONOptionalThe value of this field will always be set to zero. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 60).JournalEntry.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 60).JournalEntry.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 60).JournalEntry.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 60).JournalEntry.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 60).JournalEntry.domainstringOptional
$ (anyOf 60).JournalEntry.sparsebooleanOptional
$ (anyOf 61)objectAlternativeAdditional keys: not allowed
$ (anyOf 61).bIdstringRequired within parentMinimum length: 1
$ (anyOf 61).operationJSONRequired within parentMust equal: delete
$ (anyOf 61).JournalEntryModelRequired within parentExpand Delete a journalentry — request body — body
$ (anyOf 62)objectAlternativeAdditional keys: not allowed
$ (anyOf 62).bIdstringRequired within parentMinimum length: 1
$ (anyOf 62).operationJSONRequired within parentMust equal: update
$ (anyOf 62).JournalEntryobjectRequired within parentAdditional keys: not allowed
$ (anyOf 62).JournalEntry.AdjustmentJSONOptionalIndicates whether this transaction is a journal entry adjustment.
$ (anyOf 62).JournalEntry.Adjustment (anyOf 1)booleanAlternative
$ (anyOf 62).JournalEntry.Adjustment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 62).JournalEntry.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 62).JournalEntry.DocNumberstringOptionalReference number for the transaction. Throws an error when duplicate DocNumber is sent in the request and if Preferences:OtherPrefs:NameValue.Name = WarnDuplicateJournalNumber is true. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = WarnDuplicateJournalNumber before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default. If null value is sent in the request null will be saved. If there is a need to support assigning a docNumber when null, it can be achieved through include param, include=allowautodocnum
$ (anyOf 62).JournalEntry.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 62).JournalEntry.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 62).JournalEntry.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 62).JournalEntry.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 62).JournalEntry.HomeTotalAmtJSONOptionalThe value of this field will always be set to zero. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 62).JournalEntry.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 62).JournalEntry.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 62).JournalEntry.IdstringRequired within parent
$ (anyOf 62).JournalEntry.LinearrayOptionalIndividual line items of a transaction. There must be at least one pair of Journal Entry Line elements, representing a debit and a credit, called distribution lines. Valid Line types include: JournalEntryLine and DescriptionOnlyLine
$ (anyOf 62).JournalEntry.Line[]JSONEach item
$ (anyOf 62).JournalEntry.Line[] (anyOf 1)ModelAlternativeExpand Create a journalentry — request body — body Line item
$ (anyOf 62).JournalEntry.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 62).JournalEntry.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 62).JournalEntry.PrivateNotestringOptionalUser entered, organization-private note about the transaction.
$ (anyOf 62).JournalEntry.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the JournalEntry was created from.
Read only: true
$ (anyOf 62).JournalEntry.SyncTokenstringRequired within parent
$ (anyOf 62).JournalEntry.TaxRateRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Tax Adjustment Rate Ids for this item. Query the TaxRate list resource to determine the appropriate TaxRate object for this reference. Use TaxRate.Id and TaxRate.Name from that object for TaxRateRef.value and TaxRateRef.name, respectively.
$ (anyOf 62).JournalEntry.TotalAmtJSONOptionalThe value of this field will always be set to zero. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 62).JournalEntry.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 62).JournalEntry.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 62).JournalEntry.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 62).JournalEntry.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 62).JournalEntry.domainstringOptional
$ (anyOf 62).JournalEntry.sparsebooleanOptional
$ (anyOf 63)objectAlternativeAdditional keys: not allowed
$ (anyOf 63).bIdstringRequired within parentMinimum length: 1
$ (anyOf 63).operationJSONRequired within parentMust equal: update
$ (anyOf 63).JournalEntryobjectRequired within parentAdditional keys: not allowed
$ (anyOf 63).JournalEntry.AdjustmentJSONOptionalIndicates whether this transaction is a journal entry adjustment.
$ (anyOf 63).JournalEntry.Adjustment (anyOf 1)booleanAlternative
$ (anyOf 63).JournalEntry.Adjustment (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 63).JournalEntry.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 63).JournalEntry.DocNumberstringOptionalReference number for the transaction. Throws an error when duplicate DocNumber is sent in the request and if Preferences:OtherPrefs:NameValue.Name = WarnDuplicateJournalNumber is true. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = WarnDuplicateJournalNumber before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default. If null value is sent in the request null will be saved. If there is a need to support assigning a docNumber when null, it can be achieved through include param, include=allowautodocnum
$ (anyOf 63).JournalEntry.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 63).JournalEntry.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 63).JournalEntry.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 63).JournalEntry.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 63).JournalEntry.HomeTotalAmtJSONOptionalThe value of this field will always be set to zero. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 63).JournalEntry.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 63).JournalEntry.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 63).JournalEntry.IdstringRequired within parent
$ (anyOf 63).JournalEntry.LinearrayOptionalIndividual line items of a transaction. There must be at least one pair of Journal Entry Line elements, representing a debit and a credit, called distribution lines. Valid Line types include: JournalEntryLine and DescriptionOnlyLine
$ (anyOf 63).JournalEntry.Line[]JSONEach item
$ (anyOf 63).JournalEntry.Line[] (anyOf 1)ModelAlternativeExpand Create a journalentry — request body — body Line item
$ (anyOf 63).JournalEntry.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 63).JournalEntry.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 63).JournalEntry.PrivateNotestringOptionalUser entered, organization-private note about the transaction.
$ (anyOf 63).JournalEntry.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the JournalEntry was created from.
Read only: true
$ (anyOf 63).JournalEntry.SyncTokenstringRequired within parent
$ (anyOf 63).JournalEntry.TaxRateRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Tax Adjustment Rate Ids for this item. Query the TaxRate list resource to determine the appropriate TaxRate object for this reference. Use TaxRate.Id and TaxRate.Name from that object for TaxRateRef.value and TaxRateRef.name, respectively.
$ (anyOf 63).JournalEntry.TotalAmtJSONOptionalThe value of this field will always be set to zero. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 63).JournalEntry.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 63).JournalEntry.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 63).JournalEntry.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 63).JournalEntry.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 63).JournalEntry.domainstringOptional
$ (anyOf 63).JournalEntry.sparsebooleanRequired within parentMust equal: true
$ (anyOf 64)objectAlternativeAdditional keys: not allowed
$ (anyOf 64).bIdstringRequired within parentMinimum length: 1
$ (anyOf 64).operationJSONRequired within parentMust equal: create
$ (anyOf 64).PaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 64).Payment.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a payment received by credit card. Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 64).Payment.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 64).Payment.CustomerRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 64).Payment.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the account to be used for this payment. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepostiToAccountRef.name , respectively. If you do not specify this account, payment is applied to the Undeposited Funds account.
$ (anyOf 64).Payment.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company
Decimal string
$ (anyOf 64).Payment.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 64).Payment.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 64).Payment.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 64).Payment.LinearrayOptionalZero or more transactions accounting for this payment. Values for Line.LinkedTxn.TxnType can be one of the following: Expense —Payment is reimbursement for expense paid by cash made on behalf of the customer Check —Payment is reimbursement for expense paid by check made on behalf of the customer CreditCardCredit —Payment is reimbursement for a credit card credit made on behalf of the customer JournalEntry —Payment is linked to the representative journal entry CreditMemo —Payment is linked to the credit memo the customer has with the business Invoice —The invoice to which payment is applied Use Line.LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 64).Payment.Line[]ModelEach itemExpand Void a payment — request body — body Line item
$ (anyOf 64).Payment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 64).Payment.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 64).Payment.PaymentRefNumstringOptionalThe reference number for the payment received. For example, Check # for a check, envelope # for a cash donation.
$ (anyOf 64).Payment.PrivateNotestringOptionalUser entered, organization-private note about the transaction.
$ (anyOf 64).Payment.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 64).Payment.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 64).Payment.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only
Read only: true
$ (anyOf 64).Payment.TotalAmtJSONRequired within parentIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes.
Decimal string
$ (anyOf 64).Payment.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 64).Payment.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 64).Payment.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 64).Payment.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 64).Payment.UnappliedAmtJSONOptionalIndicates the amount that has not been applied to pay amounts owed for sales transactions.
Decimal string
Read only: true
$ (anyOf 64).Payment.UnappliedAmt (anyOf 1)numberAlternative
$ (anyOf 64).Payment.UnappliedAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 64).Payment.domainstringOptional
$ (anyOf 64).Payment.sparsebooleanOptional
$ (anyOf 64).Payment.ARAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
$ (anyOf 64).Payment.ProcessPaymentbooleanOptional
$ (anyOf 64).Payment.TxnStatusstringOptional
$ (anyOf 64).Payment.TransactionLocationTypestringOptional
$ (anyOf 64).Payment.statusstringOptional
$ (anyOf 65)objectAlternativeAdditional keys: not allowed
$ (anyOf 65).bIdstringRequired within parentMinimum length: 1
$ (anyOf 65).operationJSONRequired within parentMust equal: delete
$ (anyOf 65).PaymentModelRequired within parentExpand Void a payment — request body — body
$ (anyOf 66)objectAlternativeAdditional keys: not allowed
$ (anyOf 66).bIdstringRequired within parentMinimum length: 1
$ (anyOf 66).operationJSONRequired within parentMust equal: update
$ (anyOf 66).PaymentobjectRequired within parentAdditional keys: not allowed
$ (anyOf 66).Payment.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a payment received by credit card. Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 66).Payment.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 66).Payment.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 66).Payment.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the account to be used for this payment. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepostiToAccountRef.name , respectively. If you do not specify this account, payment is applied to the Undeposited Funds account.
$ (anyOf 66).Payment.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company
Decimal string
$ (anyOf 66).Payment.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 66).Payment.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 66).Payment.IdstringRequired within parent
$ (anyOf 66).Payment.LinearrayOptionalZero or more transactions accounting for this payment. Values for Line.LinkedTxn.TxnType can be one of the following: Expense —Payment is reimbursement for expense paid by cash made on behalf of the customer Check —Payment is reimbursement for expense paid by check made on behalf of the customer CreditCardCredit —Payment is reimbursement for a credit card credit made on behalf of the customer JournalEntry —Payment is linked to the representative journal entry CreditMemo —Payment is linked to the credit memo the customer has with the business Invoice —The invoice to which payment is applied Use Line.LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 66).Payment.Line[]ModelEach itemExpand Void a payment — request body — body Line item
$ (anyOf 66).Payment.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 66).Payment.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 66).Payment.PaymentRefNumstringOptionalThe reference number for the payment received. For example, Check # for a check, envelope # for a cash donation.
$ (anyOf 66).Payment.PrivateNotestringOptionalUser entered, organization-private note about the transaction.
$ (anyOf 66).Payment.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 66).Payment.SyncTokenstringRequired within parent
$ (anyOf 66).Payment.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only
Read only: true
$ (anyOf 66).Payment.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. If you process a linked refund transaction against a specific transaction, the totalAmt value won’t change. It will remain the same. However, voiding the linked refund will change the totalAmt value to O.
Decimal string
$ (anyOf 66).Payment.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 66).Payment.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 66).Payment.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 66).Payment.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 66).Payment.UnappliedAmtJSONOptionalIndicates the amount that has not been applied to pay amounts owed for sales transactions.
Decimal string
Read only: true
$ (anyOf 66).Payment.UnappliedAmt (anyOf 1)numberAlternative
$ (anyOf 66).Payment.UnappliedAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 66).Payment.domainstringOptional
$ (anyOf 66).Payment.sparsebooleanOptional
$ (anyOf 67)objectAlternativeAdditional keys: not allowed
$ (anyOf 67).bIdstringRequired within parentMinimum length: 1
$ (anyOf 67).operationJSONRequired within parentMust equal: create
$ (anyOf 67).PaymentMethodobjectRequired within parentAdditional keys: not allowed
$ (anyOf 67).PaymentMethod.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 67).PaymentMethod.Active (anyOf 1)booleanAlternative
$ (anyOf 67).PaymentMethod.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 67).PaymentMethod.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 67).PaymentMethod.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 67).PaymentMethod.NamestringRequired within parentUser recognizable name for the payment method.
$ (anyOf 67).PaymentMethod.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 67).PaymentMethod.TypestringOptionalDefines the type of payment. Valid values include CREDIT_CARD or NON_CREDIT_CARD .
$ (anyOf 67).PaymentMethod.domainstringOptional
$ (anyOf 67).PaymentMethod.sparsebooleanOptional
$ (anyOf 68)objectAlternativeAdditional keys: not allowed
$ (anyOf 68).bIdstringRequired within parentMinimum length: 1
$ (anyOf 68).operationJSONRequired within parentMust equal: update
$ (anyOf 68).PaymentMethodobjectRequired within parentAdditional keys: not allowed
$ (anyOf 68).PaymentMethod.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 68).PaymentMethod.Active (anyOf 1)booleanAlternative
$ (anyOf 68).PaymentMethod.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 68).PaymentMethod.IdstringRequired within parent
$ (anyOf 68).PaymentMethod.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 68).PaymentMethod.NamestringOptionalUser recognizable name for the payment method.
$ (anyOf 68).PaymentMethod.SyncTokenstringRequired within parent
$ (anyOf 68).PaymentMethod.TypestringOptionalDefines the type of payment. Valid values include CREDIT_CARD or NON_CREDIT_CARD .
$ (anyOf 68).PaymentMethod.domainstringOptional
$ (anyOf 68).PaymentMethod.sparsebooleanOptional
$ (anyOf 69)objectAlternativeAdditional keys: not allowed
$ (anyOf 69).bIdstringRequired within parentMinimum length: 1
$ (anyOf 69).operationJSONRequired within parentMust equal: update
$ (anyOf 69).PreferencesobjectRequired within parentAdditional keys: not allowed
$ (anyOf 69).Preferences.AccountingInfoPrefsModelOptionalExpand Full update preferences — request body — body Accounting Info Prefs
The following settings are available for QuickBooks Online Plus editions, only. To determine this edition type, query the value of the OfferingSku CustomerInfo.Name name/value pair for QuickBooks Online Plus .
$ (anyOf 69).Preferences.CurrencyPrefsModelOptionalExpand Full update preferences — request body — body Currency Prefs
$ (anyOf 69).Preferences.EmailMessagesPrefsModelOptionalExpand Full update preferences — request body — body Email Messages Prefs
$ (anyOf 69).Preferences.IdstringRequired within parent
$ (anyOf 69).Preferences.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 69).Preferences.OtherPrefsobjectOptionalSpecifies extension of Preference resource to allow extension of Name-Value pair based extension at the top level.
Additional keys: allowed
$ (anyOf 69).Preferences.ProductAndServicesPrefsModelOptionalExpand Full update preferences — request body — body Product And Services Prefs
$ (anyOf 69).Preferences.ReportPrefsModelOptionalExpand Full update preferences — request body — body Report Prefs
$ (anyOf 69).Preferences.SalesFormsPrefsModelOptionalExpand Full update preferences — request body — body Sales Forms Prefs
$ (anyOf 69).Preferences.SyncTokenstringRequired within parent
$ (anyOf 69).Preferences.TaxPrefsModelOptionalExpand Full update preferences — request body — body Tax Prefs
$ (anyOf 69).Preferences.TimeTrackingPrefsModelOptionalExpand Full update preferences — request body — body Time Tracking Prefs
$ (anyOf 69).Preferences.VendorAndPurchasesPrefsModelOptionalExpand Full update preferences — request body — body Vendor And Purchases Prefs
$ (anyOf 69).Preferences.domainstringOptional
$ (anyOf 69).Preferences.sparsebooleanOptional
$ (anyOf 70)objectAlternativeAdditional keys: not allowed
$ (anyOf 70).bIdstringRequired within parentMinimum length: 1
$ (anyOf 70).operationJSONRequired within parentMust equal: create
$ (anyOf 70).PurchaseobjectRequired within parentAdditional keys: not allowed
$ (anyOf 70).Purchase.AccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Specifies the account reference. Check must specify bank account, CreditCard must specify credit card account. Validation Rules:Valid and Active Account Reference of an appropriate type.
$ (anyOf 70).Purchase.CreditJSONOptionalFalse —it represents a charge. True —it represents a refund. Valid only for CreditCard payment type. Validation Rules: Valid only for CreditCard transactions.
$ (anyOf 70).Purchase.Credit (anyOf 1)booleanAlternative
$ (anyOf 70).Purchase.Credit (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 70).Purchase.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 70).Purchase.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 70).Purchase.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers as follows: If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is true a custom value can be provided; duplicate values are not accepted. If no value is supplied, the resulting DocNumber is null. If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is false, resulting DocNumber is system generated by incrementing the last number by 1. For Cash/CreditCard transactions, throws an error when duplicate DocNumber is sent in the request. For Check transactions, error is thrown when duplicate DocNumber is sent in the request and Preferences:OtherPrefs:NameValue.Name = WarnDuplicateCheckNumber is true. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 70).Purchase.EntityRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the party with whom an expense is associated. Can be Customer , Vendor, or Employee. Query the corresponding name list resource of the associated type to determine the appropriate object for this reference. Use the Id and DisplayName values from that object for EntityRef.value and EntityRef.name , respectively. Set EntityRef.type to the type of object associated with this expense. For example, if this object represents a purchase from a vendor, then set EntityRef.type to Vendor and query the Vendor resource for the appropriate object to reference.
$ (anyOf 70).Purchase.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company
Decimal string
$ (anyOf 70).Purchase.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 70).Purchase.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 70).Purchase.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable .
$ (anyOf 70).Purchase.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 70).Purchase.IncludeInAnnualTPARJSONOptionalInclude the supplier in the annual TPAR. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 70).Purchase.IncludeInAnnualTPAR (anyOf 1)booleanAlternative
$ (anyOf 70).Purchase.IncludeInAnnualTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 70).Purchase.LinearrayRequired within parentIndividual line items of a transaction. Valid Line type for create: AccountBasedExpenseLine
$ (anyOf 70).Purchase.Line[]ModelEach itemExpand Create a bill — request body — body Line item
$ (anyOf 70).Purchase.LinkedTxnarrayOptionalZero or more transactions linked to this object. The LinkedTxn.TxnType can be set to ReimburseCharge . The LinkedTxn.TxnId can be set as the ID of the transaction.
$ (anyOf 70).Purchase.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 70).Purchase.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 70).Purchase.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 70).Purchase.PaymentTypestringRequired within parentPayment Type can be: Cash , Check , or CreditCard .
$ (anyOf 70).Purchase.PrintStatusstringOptionalPrintStatus is applicable only for Check . Ignored for CreditCard charge or refund. Valid values: NotSet , NeedToPrint , PrintComplete.
$ (anyOf 70).Purchase.PrivateNotestringOptionalUser-entered, organization-private note about the transaction. This field maps to the Memo field on the Expense form in the QuickBooks UI.
$ (anyOf 70).Purchase.PurchaseExobjectOptionalFor internal use.
Additional keys: allowed
$ (anyOf 70).Purchase.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Purchase was created from.
Read only: true
$ (anyOf 70).Purchase.RemitToAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address to which the payment should be sent. This attribute is applicable only for Check . Ignored for CreditCard charge or refund. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Read only: true
$ (anyOf 70).Purchase.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 70).Purchase.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 70).Purchase.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 70).Purchase.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 70).Purchase.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 70).Purchase.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 70).Purchase.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 70).Purchase.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 70).Purchase.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 70).Purchase.domainstringOptional
$ (anyOf 70).Purchase.sparsebooleanOptional
$ (anyOf 71)objectAlternativeAdditional keys: not allowed
$ (anyOf 71).bIdstringRequired within parentMinimum length: 1
$ (anyOf 71).operationJSONRequired within parentMust equal: delete
$ (anyOf 71).PurchaseModelRequired within parentExpand Delete a purchase — request body — body
$ (anyOf 72)objectAlternativeAdditional keys: not allowed
$ (anyOf 72).bIdstringRequired within parentMinimum length: 1
$ (anyOf 72).operationJSONRequired within parentMust equal: update
$ (anyOf 72).PurchaseobjectRequired within parentAdditional keys: not allowed
$ (anyOf 72).Purchase.AccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the account reference to which this purchase is applied based on the PaymentType . A type of Check should have bank account, CreditCard should specify credit card account, etc. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for AccountRef.value and AccountRef.name , respectively.
$ (anyOf 72).Purchase.CreditJSONOptionalFalse —it represents a charge. True —it represents a refund. Valid only for CreditCard payment type. Validation Rules: Valid only for CreditCard transactions.
$ (anyOf 72).Purchase.Credit (anyOf 1)booleanAlternative
$ (anyOf 72).Purchase.Credit (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 72).Purchase.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 72).Purchase.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 72).Purchase.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers as follows: If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is true a custom value can be provided; duplicate values are not accepted. If no value is supplied, the resulting DocNumber is null. If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is false, resulting DocNumber is system generated by incrementing the last number by 1. For Cash/CreditCard transactions, throws an error when duplicate DocNumber is sent in the request. For Check transactions, error is thrown when duplicate DocNumber is sent in the request and Preferences:OtherPrefs:NameValue.Name = WarnDuplicateCheckNumber is true. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 72).Purchase.EntityRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the party with whom an expense is associated. Can be Customer , Vendor, or Employee. Query the corresponding name list resource of the associated type to determine the appropriate object for this reference. Use the Id and DisplayName values from that object for EntityRef.value and EntityRef.name , respectively. Set EntityRef.type to the type of object associated with this expense. For example, if this object represents a purchase from a vendor, then set EntityRef.type to Vendor and query the Vendor resource for the appropriate object to reference.
$ (anyOf 72).Purchase.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company
Decimal string
$ (anyOf 72).Purchase.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 72).Purchase.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 72).Purchase.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable .
$ (anyOf 72).Purchase.IdstringRequired within parent
$ (anyOf 72).Purchase.IncludeInAnnualTPARJSONOptionalInclude the supplier in the annual TPAR. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 72).Purchase.IncludeInAnnualTPAR (anyOf 1)booleanAlternative
$ (anyOf 72).Purchase.IncludeInAnnualTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 72).Purchase.LinearrayOptionalIndividual line items of a transaction. Valid Line types include ItemBasedExpenseLine (Available if Preferences.ProductAndServicesPrefs.ForPurchase is set to true ) and AccountBasedExpenseLine
$ (anyOf 72).Purchase.Line[]JSONEach item
$ (anyOf 72).Purchase.Line[] (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Line item
$ (anyOf 72).Purchase.Line[] (anyOf 2)ModelAlternativeExpand Create a bill — request body — body Line item
$ (anyOf 72).Purchase.LinkedTxnarrayOptionalZero or more transactions linked to this object. The LinkedTxn.TxnType can be set to ReimburseCharge . The LinkedTxn.TxnId can be set as the ID of the transaction.
$ (anyOf 72).Purchase.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 72).Purchase.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 72).Purchase.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 72).Purchase.PaymentTypestringOptionalType can be Cash , Check , or CreditCard .
$ (anyOf 72).Purchase.PrintStatusstringOptionalPrintStatus is applicable only for Check . Ignored for CreditCard charge or refund. Valid values: NotSet , NeedToPrint , PrintComplete.
$ (anyOf 72).Purchase.PrivateNotestringOptionalUser-entered, organization-private note about the transaction. This field maps to the Memo field on the Expense form in the QuickBooks UI.
$ (anyOf 72).Purchase.PurchaseExobjectOptionalFor internal use.
Additional keys: allowed
$ (anyOf 72).Purchase.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Purchase was created from.
Read only: true
$ (anyOf 72).Purchase.RemitToAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address to which the payment should be sent. This attribute is applicable only for Check . Ignored for CreditCard charge or refund. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Read only: true
$ (anyOf 72).Purchase.SyncTokenstringRequired within parent
$ (anyOf 72).Purchase.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 72).Purchase.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 72).Purchase.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 72).Purchase.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 72).Purchase.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 72).Purchase.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 72).Purchase.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 72).Purchase.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 72).Purchase.domainstringOptional
$ (anyOf 72).Purchase.sparsebooleanOptional
$ (anyOf 73)objectAlternativeAdditional keys: not allowed
$ (anyOf 73).bIdstringRequired within parentMinimum length: 1
$ (anyOf 73).operationJSONRequired within parentMust equal: create
$ (anyOf 73).PurchaseOrderobjectRequired within parentAdditional keys: not allowed
$ (anyOf 73).PurchaseOrder.APAccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Specifies which AP account to which the bill is credited. Many/most small businesses have a single AP account, so the account can be implied. When specified, the account must be a Liability account, and further, the sub-type must be of type Payables. We strongly recommend that the AP Account be explicitly specified in all cases as companies that have more then one AP account will encounter unexpected errors when relating transactions to each other.
$ (anyOf 73).PurchaseOrder.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 73).PurchaseOrder.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 73).PurchaseOrder.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 73).PurchaseOrder.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 73).PurchaseOrder.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers as follows: If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is false, resulting DocNumber is system generated by incrementing the last number by 1. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 73).PurchaseOrder.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 73).PurchaseOrder.EmailStatusstringOptionalEmail status of the purchase order. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 73).PurchaseOrder.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 73).PurchaseOrder.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 73).PurchaseOrder.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 73).PurchaseOrder.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 73).PurchaseOrder.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 73).PurchaseOrder.LinearrayRequired within parentIndividual line items of a transaction. Valid Line types include: Item line. Note: The ItemRef in the ItemBasedExpenseLine below must reference an Item in QBO that has an expense account linked to it (e.g. in the ExpenseAccountRef field of the Item). Otherwise the request fails in QBO with a ‘You must select an account for this transaction.’ error.
$ (anyOf 73).PurchaseOrder.Line[]ModelEach itemExpand Create a purchase order — request body — body Line item
$ (anyOf 73).PurchaseOrder.LinkedTxnarrayOptionalZero or more Bill objects linked to this purchase order; LinkedTxn.TxnType is set to Bill . To retrieve details of a linked Bill transaction, issue a separate request to read the Bill whose ID is linkedTxn.TxnId .
$ (anyOf 73).PurchaseOrder.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 73).PurchaseOrder.MemostringOptionalA message for the vendor. This text appears on the Purchase Order object sent to the vendor.
$ (anyOf 73).PurchaseOrder.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 73).PurchaseOrder.POEmailModelOptionalExpand Full update companyinfo — request body — body Email
Used to specify the vendor e-mail address where the purchase req is sent.
$ (anyOf 73).PurchaseOrder.POStatusstringOptionalPurchase order status. Valid values are: Open and Closed .
$ (anyOf 73).PurchaseOrder.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the purchase order to the vendor. This field maps to the Memo field on the Purchase Order form.
$ (anyOf 73).PurchaseOrder.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the PurchaseOrder was created from.
Read only: true
$ (anyOf 73).PurchaseOrder.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 73).PurchaseOrder.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address to which the vendor shipped or will ship any goods associated with the purchase. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 73).PurchaseOrder.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the user-defined ShipMethod associated with the transaction. Store shipping method string in both ShipMethodRef.value and ShipMethodRef.name .
$ (anyOf 73).PurchaseOrder.ShipToModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the customer to whose shipping address the order will be shipped to.
$ (anyOf 73).PurchaseOrder.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 73).PurchaseOrder.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 73).PurchaseOrder.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 73).PurchaseOrder.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 73).PurchaseOrder.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 73).PurchaseOrder.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 73).PurchaseOrder.VendorAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address to which the payment should be sent. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 73).PurchaseOrder.VendorRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
The vendor reference for this transaction.
$ (anyOf 73).PurchaseOrder.domainstringOptional
$ (anyOf 73).PurchaseOrder.sparsebooleanOptional
$ (anyOf 74)objectAlternativeAdditional keys: not allowed
$ (anyOf 74).bIdstringRequired within parentMinimum length: 1
$ (anyOf 74).operationJSONRequired within parentMust equal: delete
$ (anyOf 74).PurchaseOrderModelRequired within parentExpand Delete a purchase order — request body — body
$ (anyOf 75)objectAlternativeAdditional keys: not allowed
$ (anyOf 75).bIdstringRequired within parentMinimum length: 1
$ (anyOf 75).operationJSONRequired within parentMust equal: update
$ (anyOf 75).PurchaseOrderobjectRequired within parentAdditional keys: not allowed
$ (anyOf 75).PurchaseOrder.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 75).PurchaseOrder.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 75).PurchaseOrder.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 75).PurchaseOrder.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 75).PurchaseOrder.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 75).PurchaseOrder.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers as follows: If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is false, resulting DocNumber is system generated by incrementing the last number by 1. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 75).PurchaseOrder.DueDatestringOptionalDate when the payment of the transaction is due. If date is not provided, the number of days specified in SalesTermRef added the transaction date will be used.
$ (anyOf 75).PurchaseOrder.EmailStatusstringOptionalEmail status of the purchase order. Valid values: NotSet , NeedToSend , EmailSent
$ (anyOf 75).PurchaseOrder.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 75).PurchaseOrder.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 75).PurchaseOrder.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 75).PurchaseOrder.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 75).PurchaseOrder.IdstringRequired within parent
$ (anyOf 75).PurchaseOrder.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: ItemBasedExpenseLine and AccountBasedExpenseLine
$ (anyOf 75).PurchaseOrder.Line[]JSONEach item
$ (anyOf 75).PurchaseOrder.Line[] (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Line item
$ (anyOf 75).PurchaseOrder.Line[] (anyOf 2)ModelAlternativeExpand Create a bill — request body — body Line item
$ (anyOf 75).PurchaseOrder.LinkedTxnarrayOptionalZero or more Bill objects linked to this purchase order; LinkedTxn.TxnType is set to Bill . To retrieve details of a linked Bill transaction, issue a separate request to read the Bill whose ID is linkedTxn.TxnId .
$ (anyOf 75).PurchaseOrder.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 75).PurchaseOrder.MemostringOptionalA message for the vendor. This text appears on the Purchase Order object sent to the vendor.
$ (anyOf 75).PurchaseOrder.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 75).PurchaseOrder.POEmailModelOptionalExpand Full update companyinfo — request body — body Email
Used to specify the vendor e-mail address where the purchase req is sent.
$ (anyOf 75).PurchaseOrder.POStatusstringOptionalPurchase order status. Valid values are: Open and Closed .
$ (anyOf 75).PurchaseOrder.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the purchase order to the vendor. This field maps to the Memo field on the Purchase Order form.
$ (anyOf 75).PurchaseOrder.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the PurchaseOrder was created from.
Read only: true
$ (anyOf 75).PurchaseOrder.SalesTermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the sales term associated with the transaction. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for SalesTermRef.value and SalesTermRef.name , respectively.
$ (anyOf 75).PurchaseOrder.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address to which the vendor shipped or will ship any goods associated with the purchase. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 75).PurchaseOrder.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the user-defined ShipMethod associated with the transaction. Store shipping method string in both ShipMethodRef.value and ShipMethodRef.name .
$ (anyOf 75).PurchaseOrder.ShipToModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the customer to whose shipping address the order will be shipped to.
$ (anyOf 75).PurchaseOrder.SyncTokenstringRequired within parent
$ (anyOf 75).PurchaseOrder.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 75).PurchaseOrder.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 75).PurchaseOrder.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 75).PurchaseOrder.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 75).PurchaseOrder.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 75).PurchaseOrder.VendorAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Address to which the payment should be sent. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 75).PurchaseOrder.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the vendor for this transaction. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
$ (anyOf 75).PurchaseOrder.domainstringOptional
$ (anyOf 75).PurchaseOrder.sparsebooleanOptional
$ (anyOf 76)objectAlternativeAdditional keys: not allowed
$ (anyOf 76).bIdstringRequired within parentMinimum length: 1
$ (anyOf 76).operationJSONRequired within parentMust equal: create
$ (anyOf 76).RecurringTransactionobjectRequired within parentMinimum fields: 1
Maximum fields: 1
Additional keys: not allowed
$ (anyOf 76).RecurringTransaction.BillModelOptionalExpand Create a recurring transaction — request body — body Bill
$ (anyOf 76).RecurringTransaction.DepositModelOptionalExpand Create a recurring transaction — request body — body Deposit
$ (anyOf 76).RecurringTransaction.EstimateModelOptionalExpand Create a recurring transaction — request body — body Estimate
$ (anyOf 76).RecurringTransaction.InvoiceModelOptionalExpand Create a recurring transaction — request body — body Invoice
$ (anyOf 76).RecurringTransaction.JournalEntryModelOptionalExpand Create a recurring transaction — request body — body Journal Entry
$ (anyOf 76).RecurringTransaction.PurchaseModelOptionalExpand Create a recurring transaction — request body — body Purchase
$ (anyOf 76).RecurringTransaction.RefundReceiptModelOptionalExpand Create a recurring transaction — request body — body Refund Receipt
$ (anyOf 76).RecurringTransaction.SalesReceiptModelOptionalExpand Create a recurring transaction — request body — body Sales Receipt
$ (anyOf 76).RecurringTransaction.TransferModelOptionalExpand Create a recurring transaction — request body — body Transfer
$ (anyOf 76).RecurringTransaction.VendorCreditModelOptionalExpand Create a recurring transaction — request body — body Vendor Credit
$ (anyOf 77)objectAlternativeAdditional keys: not allowed
$ (anyOf 77).bIdstringRequired within parentMinimum length: 1
$ (anyOf 77).operationJSONRequired within parentMust equal: delete
$ (anyOf 77).RecurringTransactionModelRequired within parentExpand Delete a recurring transaction — request body — body
$ (anyOf 78)objectAlternativeAdditional keys: not allowed
$ (anyOf 78).bIdstringRequired within parentMinimum length: 1
$ (anyOf 78).operationJSONRequired within parentMust equal: create
$ (anyOf 78).RefundReceiptobjectRequired within parentAdditional keys: not allowed
$ (anyOf 78).RefundReceipt.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. Default Value: false Constraints: US versions of QuickBooks only.
$ (anyOf 78).RefundReceipt.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 78).RefundReceipt.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 78).RefundReceipt.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 78).RefundReceipt.Balance (anyOf 1)numberAlternative
$ (anyOf 78).RefundReceipt.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 78).RefundReceipt.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 78).RefundReceipt.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 78).RefundReceipt.CheckPaymentModelOptionalExpand Create a refund receipt — request body — body Check Payment
Information about a check payment for the transaction. Used when PaymentType is Check .
$ (anyOf 78).RefundReceipt.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 78).RefundReceipt.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Used when PaymentType is CreditCard . Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 78).RefundReceipt.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 78).RefundReceipt.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 78).RefundReceipt.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 78).RefundReceipt.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transaction.
$ (anyOf 78).RefundReceipt.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 78).RefundReceipt.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 78).RefundReceipt.DepositToAccountRefJSONRequired within parentAccounts receivable asset account from which payment money is refunded. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. CurrencyRefType Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here .
$ (anyOf 78).RefundReceipt.DepositToAccountRef (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Ship To
$ (anyOf 78).RefundReceipt.DepositToAccountRef (anyOf 2)ModelAlternativeExpand Create a bill — request body — body Currency Ref
$ (anyOf 78).RefundReceipt.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. Recommended best practice: check the setting of Preferences:CustomTxnNumber before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field. Sort order is ASC by default.
$ (anyOf 78).RefundReceipt.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 78).RefundReceipt.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 78).RefundReceipt.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 78).RefundReceipt.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 78).RefundReceipt.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Applicable if multicurrency is enabled for the company
Decimal string
Read only: true
$ (anyOf 78).RefundReceipt.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 78).RefundReceipt.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 78).RefundReceipt.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 78).RefundReceipt.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 78).RefundReceipt.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 78).RefundReceipt.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 78).RefundReceipt.LinearrayRequired within parentThe minimum line item required for the request is one of the following: SalesItemLine and GroupLine
$ (anyOf 78).RefundReceipt.Line[]JSONEach item
$ (anyOf 78).RefundReceipt.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 78).RefundReceipt.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 78).RefundReceipt.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 78).RefundReceipt.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 78).RefundReceipt.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 78).RefundReceipt.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 78).RefundReceipt.PaymentRefNumstringOptionalThe reference number for the payment received. For example, check # for a check, envelope # for a cash donation. Provide when DepositToAccountRef references an Account object where Account.AccountType=Bank . Required when PrintStatus is set to PrintComplete . If PrintStatus is set to NeedToPrint , the system sets PaymentRefNum to To Print .
Conditionally required
$ (anyOf 78).RefundReceipt.PaymentTypestringOptionalValid values are Cash , Check , CreditCard , or Other .
$ (anyOf 78).RefundReceipt.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 78).RefundReceipt.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the refund receipt to the customer. This field maps to the Memo field on the refund receipt form.
$ (anyOf 78).RefundReceipt.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 78).RefundReceipt.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the RefundReceipt was created from.
Read only: true
$ (anyOf 78).RefundReceipt.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 78).RefundReceipt.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 78).RefundReceipt.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 78).RefundReceipt.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 78).RefundReceipt.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 78).RefundReceipt.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 78).RefundReceipt.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 78).RefundReceipt.TxnSourcestringOptionalThe originating source of the credit card transaction. Used in eCommerce apps where credit card transactions are processed by a merchant account. When set to IntuitPayment , this transaction is inserted into a list of pending deposits to be automatically matched and reconciled with the merchant’s account when the transactions made via QuickBooks Payments settle. Currently, the only supported value is IntuitPayment .
$ (anyOf 78).RefundReceipt.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 78).RefundReceipt.domainstringOptional
$ (anyOf 78).RefundReceipt.sparsebooleanOptional
$ (anyOf 79)objectAlternativeAdditional keys: not allowed
$ (anyOf 79).bIdstringRequired within parentMinimum length: 1
$ (anyOf 79).operationJSONRequired within parentMust equal: delete
$ (anyOf 79).RefundReceiptModelRequired within parentExpand Delete a refund receipt — request body — body
$ (anyOf 80)objectAlternativeAdditional keys: not allowed
$ (anyOf 80).bIdstringRequired within parentMinimum length: 1
$ (anyOf 80).operationJSONRequired within parentMust equal: update
$ (anyOf 80).RefundReceiptobjectRequired within parentAdditional keys: not allowed
$ (anyOf 80).RefundReceipt.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. Default Value: false Constraints: US versions of QuickBooks only.
$ (anyOf 80).RefundReceipt.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 80).RefundReceipt.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 80).RefundReceipt.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 80).RefundReceipt.Balance (anyOf 1)numberAlternative
$ (anyOf 80).RefundReceipt.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 80).RefundReceipt.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 80).RefundReceipt.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 80).RefundReceipt.CheckPaymentModelOptionalExpand Create a refund receipt — request body — body Check Payment
Information about a check payment for the transaction. Used when PaymentType is Check .
$ (anyOf 80).RefundReceipt.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 80).RefundReceipt.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Used when PaymentType is CreditCard . Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 80).RefundReceipt.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 80).RefundReceipt.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 80).RefundReceipt.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 80).RefundReceipt.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transaction.
$ (anyOf 80).RefundReceipt.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 80).RefundReceipt.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 80).RefundReceipt.DepositToAccountRefJSONOptionalAccounts receivable asset account from which payment money is refunded. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. CurrencyRefType Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here .
$ (anyOf 80).RefundReceipt.DepositToAccountRef (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Ship To
$ (anyOf 80).RefundReceipt.DepositToAccountRef (anyOf 2)ModelAlternativeExpand Create a bill — request body — body Currency Ref
$ (anyOf 80).RefundReceipt.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. Recommended best practice: check the setting of Preferences:CustomTxnNumber before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field. Sort order is ASC by default.
$ (anyOf 80).RefundReceipt.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 80).RefundReceipt.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 80).RefundReceipt.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 80).RefundReceipt.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 80).RefundReceipt.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Applicable if multicurrency is enabled for the company
Decimal string
Read only: true
$ (anyOf 80).RefundReceipt.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 80).RefundReceipt.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 80).RefundReceipt.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 80).RefundReceipt.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 80).RefundReceipt.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 80).RefundReceipt.IdstringRequired within parent
$ (anyOf 80).RefundReceipt.LinearrayOptionalThe minimum line item required for the request is one of the following: SalesItemLine and GroupLine
$ (anyOf 80).RefundReceipt.Line[]JSONEach item
$ (anyOf 80).RefundReceipt.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 80).RefundReceipt.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 80).RefundReceipt.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 80).RefundReceipt.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 80).RefundReceipt.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 80).RefundReceipt.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 80).RefundReceipt.PaymentRefNumstringOptionalThe reference number for the payment received. For example, check # for a check, envelope # for a cash donation. Provide when DepositToAccountRef references an Account object where Account.AccountType=Bank . Required when PrintStatus is set to PrintComplete . If PrintStatus is set to NeedToPrint , the system sets PaymentRefNum to To Print .
Conditionally required
$ (anyOf 80).RefundReceipt.PaymentTypestringOptionalValid values are Cash , Check , CreditCard , or Other .
$ (anyOf 80).RefundReceipt.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 80).RefundReceipt.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the refund receipt to the customer. This field maps to the Memo field on the refund receipt form.
$ (anyOf 80).RefundReceipt.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 80).RefundReceipt.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the RefundReceipt was created from.
Read only: true
$ (anyOf 80).RefundReceipt.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 80).RefundReceipt.SyncTokenstringRequired within parent
$ (anyOf 80).RefundReceipt.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 80).RefundReceipt.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 80).RefundReceipt.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 80).RefundReceipt.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 80).RefundReceipt.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 80).RefundReceipt.TxnSourcestringOptionalThe originating source of the credit card transaction. Used in eCommerce apps where credit card transactions are processed by a merchant account. When set to IntuitPayment , this transaction is inserted into a list of pending deposits to be automatically matched and reconciled with the merchant’s account when the transactions made via QuickBooks Payments settle. Currently, the only supported value is IntuitPayment .
$ (anyOf 80).RefundReceipt.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 80).RefundReceipt.domainstringOptional
$ (anyOf 80).RefundReceipt.sparsebooleanOptional
$ (anyOf 81)objectAlternativeAdditional keys: not allowed
$ (anyOf 81).bIdstringRequired within parentMinimum length: 1
$ (anyOf 81).operationJSONRequired within parentMust equal: update
$ (anyOf 81).RefundReceiptobjectRequired within parentAdditional keys: not allowed
$ (anyOf 81).RefundReceipt.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. Default Value: false Constraints: US versions of QuickBooks only.
$ (anyOf 81).RefundReceipt.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 81).RefundReceipt.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 81).RefundReceipt.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 81).RefundReceipt.Balance (anyOf 1)numberAlternative
$ (anyOf 81).RefundReceipt.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 81).RefundReceipt.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 81).RefundReceipt.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. If EmailStatus=NeedToSend , BillEmail is a required input.
Conditionally required
$ (anyOf 81).RefundReceipt.CheckPaymentModelOptionalExpand Create a refund receipt — request body — body Check Payment
Information about a check payment for the transaction. Used when PaymentType is Check .
$ (anyOf 81).RefundReceipt.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 81).RefundReceipt.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Used when PaymentType is CreditCard . Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 81).RefundReceipt.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company.
Conditionally required
$ (anyOf 81).RefundReceipt.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 81).RefundReceipt.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 81).RefundReceipt.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transaction.
$ (anyOf 81).RefundReceipt.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 81).RefundReceipt.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 81).RefundReceipt.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account from which payment money is refunded. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively.
$ (anyOf 81).RefundReceipt.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. Recommended best practice: check the setting of Preferences:CustomTxnNumber before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field. Sort order is ASC by default.
$ (anyOf 81).RefundReceipt.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 81).RefundReceipt.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 81).RefundReceipt.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 81).RefundReceipt.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 81).RefundReceipt.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Applicable if multicurrency is enabled for the company
Decimal string
Read only: true
$ (anyOf 81).RefundReceipt.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 81).RefundReceipt.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 81).RefundReceipt.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 81).RefundReceipt.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 81).RefundReceipt.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 81).RefundReceipt.IdstringRequired within parent
$ (anyOf 81).RefundReceipt.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: SalesItemLine , GroupLine , DescriptionOnlyLine , DiscountLine and SubTotalLine (read-only)
$ (anyOf 81).RefundReceipt.Line[]JSONEach item
$ (anyOf 81).RefundReceipt.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 81).RefundReceipt.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 81).RefundReceipt.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 81).RefundReceipt.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 81).RefundReceipt.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 81).RefundReceipt.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 81).RefundReceipt.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 81).RefundReceipt.PaymentRefNumstringOptionalThe reference number for the payment received. For example, check # for a check, envelope # for a cash donation. Provide when DepositToAccountRef references an Account object where Account.AccountType=Bank . Required when PrintStatus is set to PrintComplete . If PrintStatus is set to NeedToPrint , the system sets PaymentRefNum to To Print .
Conditionally required
$ (anyOf 81).RefundReceipt.PaymentTypestringOptionalValid values are Cash , Check , CreditCard , or Other .
$ (anyOf 81).RefundReceipt.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 81).RefundReceipt.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the refund receipt to the customer. This field maps to the Memo field on the refund receipt form.
$ (anyOf 81).RefundReceipt.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 81).RefundReceipt.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the RefundReceipt was created from.
Read only: true
$ (anyOf 81).RefundReceipt.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 81).RefundReceipt.SyncTokenstringRequired within parent
$ (anyOf 81).RefundReceipt.TaxExemptionRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the TaxExepmtion ID associated with this object. Available for companies that have automated sales tax enabled. TaxExemptionRef.Name : The Tax Exemption Id for the customer to which this object is associated. This Id is typically issued by the state. TaxExemptionRef.value : The system-generated Id of the exemption type. For internal use only.
Read only: true
$ (anyOf 81).RefundReceipt.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 81).RefundReceipt.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 81).RefundReceipt.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 81).RefundReceipt.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 81).RefundReceipt.TxnSourcestringOptionalThe originating source of the credit card transaction. Used in eCommerce apps where credit card transactions are processed by a merchant account. When set to IntuitPayment , this transaction is inserted into a list of pending deposits to be automatically matched and reconciled with the merchant’s account when the transactions made via QuickBooks Payments settle. Currently, the only supported value is IntuitPayment .
$ (anyOf 81).RefundReceipt.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This data type provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 81).RefundReceipt.domainstringOptional
$ (anyOf 81).RefundReceipt.sparsebooleanRequired within parentMust equal: true
$ (anyOf 82)objectAlternativeAdditional keys: not allowed
$ (anyOf 82).bIdstringRequired within parentMinimum length: 1
$ (anyOf 82).operationJSONRequired within parentMust equal: create
$ (anyOf 82).SalesReceiptobjectRequired within parentAdditional keys: not allowed
$ (anyOf 82).SalesReceipt.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. Default Value: false Constraints: US versions of QuickBooks only.
$ (anyOf 82).SalesReceipt.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 82).SalesReceipt.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 82).SalesReceipt.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 82).SalesReceipt.Balance (anyOf 1)numberAlternative
$ (anyOf 82).SalesReceipt.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 82).SalesReceipt.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 82).SalesReceipt.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. Required if EmailStatus=NeedToSend
Conditionally required
$ (anyOf 82).SalesReceipt.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 82).SalesReceipt.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Used when PaymentType is CreditCard . Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 82).SalesReceipt.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 82).SalesReceipt.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 82).SalesReceipt.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 82).SalesReceipt.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 82).SalesReceipt.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 82).SalesReceipt.DeliveryInfoModelOptionalExpand Void an invoice — request body — body Delivery Info
Email delivery information. Returned when a request has been made to deliver email with the send operation.
Read only: true
$ (anyOf 82).SalesReceipt.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 82).SalesReceipt.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account to which payment money is deposited. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. If you do not specify this account, payment is applied to the Undeposited Funds account.
$ (anyOf 82).SalesReceipt.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 82).SalesReceipt.EmailStatusstringOptionalEmail status of the receipt. Valid values: NotSet , NeedToSend , EmailSent .
$ (anyOf 82).SalesReceipt.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 82).SalesReceipt.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 82).SalesReceipt.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 82).SalesReceipt.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 82).SalesReceipt.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 82).SalesReceipt.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 82).SalesReceipt.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 82).SalesReceipt.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 82).SalesReceipt.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 82).SalesReceipt.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 82).SalesReceipt.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company
Decimal string
Read only: true
$ (anyOf 82).SalesReceipt.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 82).SalesReceipt.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 82).SalesReceipt.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 82).SalesReceipt.LinearrayRequired within parentThe minimum line item required for the request is one of the following: SalesItemLine and GroupLine
$ (anyOf 82).SalesReceipt.Line[]JSONEach item
$ (anyOf 82).SalesReceipt.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 82).SalesReceipt.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 82).SalesReceipt.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 82).SalesReceipt.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 82).SalesReceipt.LinkedTxnarrayOptionalZero or more related transactions to this sales receipt object. The following linked relationships are supported: Links to Estimate and TimeActivity objects can be established directly to this sales receipt object with UI or with the API. Create, Read, Update, and Query operations are avaialble at the API level for these types of links. Only one link can be made to an Estimate . Links to expenses incurred on behalf of the customer are returned in the response with LinkedTxn.TxnType set to ReimburseCharge , ChargeCredit or StatementCharge corresponding to billable customer expenses of type Cash , Delayed Credit , and Delayed Charge , respectively. Links to these types of transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links to payments applied to an sales receipt object are returned in the response with LinkedTxn.TxnType set to Payment . Links to Payment transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links the sales receipt to refundReceipt objects that are applied to the sales receipt. Returned in the response if linkedTxnTxnType is a refundReceipt. Note that linking sales receipts to refund receipts can only be done via the customer-facing QuickBooks UI. This is only available as read-only via our API Use LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 82).SalesReceipt.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 82).SalesReceipt.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 82).SalesReceipt.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 82).SalesReceipt.PaymentRefNumstringOptionalThe reference number for the payment received. For example, Â Check # for a check, envelope # for a cash donation.
$ (anyOf 82).SalesReceipt.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 82).SalesReceipt.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the transaction form to the customer. This field maps to the Memo field on the Sales Receipt form.
$ (anyOf 82).SalesReceipt.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 82).SalesReceipt.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the SalesReceipt was created from.
Read only: true
$ (anyOf 82).SalesReceipt.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 82).SalesReceipt.ShipDatestringOptionalLocation of the transaction, as defined using location tracking in QuickBooks Online.
$ (anyOf 82).SalesReceipt.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 82).SalesReceipt.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 82).SalesReceipt.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 82).SalesReceipt.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks. If you process a linked refund transaction against a specific transaction, the totalAmt value won’t change. It will remain the same. However, voiding the linked refund will change the totalAmt value to O.
Decimal string
Read only: true
$ (anyOf 82).SalesReceipt.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 82).SalesReceipt.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 82).SalesReceipt.TrackingNumstringOptionalShipping provider’s tracking number for the delivery of the goods associated with the transaction.
$ (anyOf 82).SalesReceipt.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 82).SalesReceipt.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 82).SalesReceipt.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This element provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 82).SalesReceipt.domainstringOptional
$ (anyOf 82).SalesReceipt.sparsebooleanOptional
$ (anyOf 83)objectAlternativeAdditional keys: not allowed
$ (anyOf 83).bIdstringRequired within parentMinimum length: 1
$ (anyOf 83).operationJSONRequired within parentMust equal: delete
$ (anyOf 83).SalesReceiptModelRequired within parentExpand Void a salesreceipt — request body — body
$ (anyOf 84)objectAlternativeAdditional keys: not allowed
$ (anyOf 84).bIdstringRequired within parentMinimum length: 1
$ (anyOf 84).operationJSONRequired within parentMust equal: update
$ (anyOf 84).SalesReceiptobjectRequired within parentAdditional keys: not allowed
$ (anyOf 84).SalesReceipt.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. Default Value: false Constraints: US versions of QuickBooks only.
$ (anyOf 84).SalesReceipt.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 84).SalesReceipt.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 84).SalesReceipt.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 84).SalesReceipt.Balance (anyOf 1)numberAlternative
$ (anyOf 84).SalesReceipt.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 84).SalesReceipt.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 84).SalesReceipt.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. Required if EmailStatus=NeedToSend
Conditionally required
$ (anyOf 84).SalesReceipt.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 84).SalesReceipt.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Used when PaymentType is CreditCard . Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 84).SalesReceipt.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 84).SalesReceipt.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 84).SalesReceipt.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 84).SalesReceipt.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 84).SalesReceipt.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 84).SalesReceipt.DeliveryInfoModelOptionalExpand Void an invoice — request body — body Delivery Info
Email delivery information. Returned when a request has been made to deliver email with the send operation.
Read only: true
$ (anyOf 84).SalesReceipt.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 84).SalesReceipt.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account to which payment money is deposited. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. If you do not specify this account, payment is applied to the Undeposited Funds account.
$ (anyOf 84).SalesReceipt.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 84).SalesReceipt.EmailStatusstringOptionalEmail status of the receipt. Valid values: NotSet , NeedToSend , EmailSent .
$ (anyOf 84).SalesReceipt.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 84).SalesReceipt.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 84).SalesReceipt.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 84).SalesReceipt.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 84).SalesReceipt.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 84).SalesReceipt.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 84).SalesReceipt.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 84).SalesReceipt.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 84).SalesReceipt.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 84).SalesReceipt.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 84).SalesReceipt.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company
Decimal string
Read only: true
$ (anyOf 84).SalesReceipt.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 84).SalesReceipt.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 84).SalesReceipt.IdstringRequired within parent
$ (anyOf 84).SalesReceipt.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: SalesItemLine , GroupLine , DescriptionOnlyLine , DiscountLine and SubTotalLine (read-only). If the transaction is taxable there is a limit of 750 lines per transaction.
$ (anyOf 84).SalesReceipt.Line[]JSONEach item
$ (anyOf 84).SalesReceipt.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 84).SalesReceipt.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 84).SalesReceipt.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 84).SalesReceipt.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 84).SalesReceipt.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 84).SalesReceipt.LinkedTxnarrayOptionalZero or more related transactions to this sales receipt object. The following linked relationships are supported: Links to Estimate and TimeActivity objects can be established directly to this sales receipt object with UI or with the API. Create, Read, Update, and Query operations are avaialble at the API level for these types of links. Only one link can be made to an Estimate . Links to expenses incurred on behalf of the customer are returned in the response with LinkedTxn.TxnType set to ReimburseCharge , ChargeCredit or StatementCharge corresponding to billable customer expenses of type Cash , Delayed Credit , and Delayed Charge , respectively. Links to these types of transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links to payments applied to an sales receipt object are returned in the response with LinkedTxn.TxnType set to Payment . Links to Payment transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links the sales receipt to refundReceipt objects that are applied to the sales receipt. Returned in the response if linkedTxnTxnType is a refundReceipt. Note that linking sales receipts to refund receipts can only be done via the customer-facing QuickBooks UI. This is only available as read-only via our API Use LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 84).SalesReceipt.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 84).SalesReceipt.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 84).SalesReceipt.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 84).SalesReceipt.PaymentRefNumstringOptionalThe reference number for the payment received. For example, Â Check # for a check, envelope # for a cash donation.
$ (anyOf 84).SalesReceipt.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 84).SalesReceipt.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the transaction form to the customer. This field maps to the Memo field on the Sales Receipt form.
$ (anyOf 84).SalesReceipt.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 84).SalesReceipt.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the SalesReceipt was created from.
Read only: true
$ (anyOf 84).SalesReceipt.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 84).SalesReceipt.ShipDatestringOptionalLocation of the transaction, as defined using location tracking in QuickBooks Online.
$ (anyOf 84).SalesReceipt.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 84).SalesReceipt.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 84).SalesReceipt.SyncTokenstringRequired within parent
$ (anyOf 84).SalesReceipt.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks. If you process a linked refund transaction against a specific transaction, the totalAmt value won’t change. It will remain the same. However, voiding the linked refund will change the totalAmt value to O.
Decimal string
Read only: true
$ (anyOf 84).SalesReceipt.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 84).SalesReceipt.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 84).SalesReceipt.TrackingNumstringOptionalShipping provider’s tracking number for the delivery of the goods associated with the transaction.
$ (anyOf 84).SalesReceipt.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 84).SalesReceipt.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 84).SalesReceipt.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This element provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 84).SalesReceipt.domainstringOptional
$ (anyOf 84).SalesReceipt.sparsebooleanOptional
$ (anyOf 85)objectAlternativeAdditional keys: not allowed
$ (anyOf 85).bIdstringRequired within parentMinimum length: 1
$ (anyOf 85).operationJSONRequired within parentMust equal: update
$ (anyOf 85).SalesReceiptobjectRequired within parentAdditional keys: not allowed
$ (anyOf 85).SalesReceipt.ApplyTaxAfterDiscountJSONOptionalIf false or null, calculate the sales tax first, and then apply the discount. If true, subtract the discount first and then calculate the sales tax. Default Value: false Constraints: US versions of QuickBooks only.
$ (anyOf 85).SalesReceipt.ApplyTaxAfterDiscount (anyOf 1)booleanAlternative
$ (anyOf 85).SalesReceipt.ApplyTaxAfterDiscount (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 85).SalesReceipt.BalanceJSONOptionalThe balance reflecting any payments made against the transaction. Initially set to the value of TotalAmt . A Balance of 0 indicates the invoice is fully paid. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 85).SalesReceipt.Balance (anyOf 1)numberAlternative
$ (anyOf 85).SalesReceipt.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 85).SalesReceipt.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Bill-to address of the Invoice. If BillAddr is not specified, and a default Customer:BillingAddr is specified in QuickBooks for this customer, the default bill-to address is used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 85).SalesReceipt.BillEmailModelOptionalExpand Full update companyinfo — request body — body Email
Identifies the e-mail address where the invoice is sent. Required if EmailStatus=NeedToSend
Conditionally required
$ (anyOf 85).SalesReceipt.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with the transaction. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 85).SalesReceipt.CreditCardPaymentModelOptionalExpand Void a payment — request body — body Credit Card Payment
Information about a credit card payment for the transaction. Used when PaymentType is CreditCard . Inject with data only if the payment was transacted through Intuit Payments API.
$ (anyOf 85).SalesReceipt.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 85).SalesReceipt.CustomFieldarrayOptionalOne of, up to three custom fields for the transaction. Available for custom fields so configured for the company. Check Preferences.SalesFormsPrefs.CustomField and Preferences.VendorAndPurchasesPrefs.POCustomField for custom fields currenly configured. Click here to learn about managing custom fields.
$ (anyOf 85).SalesReceipt.CustomField[]ModelEach itemExpand Void an invoice — request body — body Custom Field item
$ (anyOf 85).SalesReceipt.CustomerMemoModelOptionalExpand Void an invoice — request body — body Customer Memo
User-entered message to the customer; this message is visible to end user on their transactions.
$ (anyOf 85).SalesReceipt.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 85).SalesReceipt.DeliveryInfoModelOptionalExpand Void an invoice — request body — body Delivery Info
Email delivery information. Returned when a request has been made to deliver email with the send operation.
Read only: true
$ (anyOf 85).SalesReceipt.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 85).SalesReceipt.DepositToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Account to which payment money is deposited. Query the Account name list resource to determine the appropriate Account object for this reference, where Account.AccountType is Other Current Asset or Bank . Use Account.Id and Account.Name from that object for DepositToAccountRef.value and DepositToAccountRef.name , respectively. If you do not specify this account, payment is applied to the Undeposited Funds account.
$ (anyOf 85).SalesReceipt.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:CustomTxnNumber as follows: If Preferences:CustomTxnNumber is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:CustomTxnNumber is false, resulting DocNumber is system generated by incrementing the last number by 1. If Preferences:CustomTxnNumber is false then do not send a value as it can lead to unwanted duplicates. If a DocNumber value is sent for an Update operation, then it just updates that particular invoice and does not alter the internal system DocNumber. Note: DocNumber is an optional field for all locales except France. For France locale if Preferences:CustomTxnNumber is enabled it will not be automatically generated and is a required field.
$ (anyOf 85).SalesReceipt.EmailStatusstringOptionalEmail status of the receipt. Valid values: NotSet , NeedToSend , EmailSent .
$ (anyOf 85).SalesReceipt.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 85).SalesReceipt.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 85).SalesReceipt.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 85).SalesReceipt.FreeFormAddressJSONOptionalDenotes how ShipAddr is stored: formatted or unformatted. The value of this flag is system defined based on format of shipping address at object create time. If set to false , shipping address is returned in a formatted style using City, Country, CountrySubDivisionCode, Postal code. If set to true , shipping address is returned in an unformatted style using Line1 through Line5 attributes.
$ (anyOf 85).SalesReceipt.FreeFormAddress (anyOf 1)booleanAlternative
$ (anyOf 85).SalesReceipt.FreeFormAddress (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 85).SalesReceipt.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 85).SalesReceipt.HomeBalanceJSONOptionalConvenience field containing the amount in Balance expressed in terms of the home currency. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company.
Decimal string
Read only: true
$ (anyOf 85).SalesReceipt.HomeBalance (anyOf 1)numberAlternative
$ (anyOf 85).SalesReceipt.HomeBalance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 85).SalesReceipt.HomeTotalAmtJSONOptionalTotal amount of the transaction in the home currency. Includes the total of all the charges, allowances and taxes. Calculated by QuickBooks business logic. Value is valid only when CurrencyRef is specified. Applicable if multicurrency is enabled for the company
Decimal string
Read only: true
$ (anyOf 85).SalesReceipt.HomeTotalAmt (anyOf 1)numberAlternative
$ (anyOf 85).SalesReceipt.HomeTotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 85).SalesReceipt.IdstringRequired within parent
$ (anyOf 85).SalesReceipt.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: SalesItemLine , GroupLine , DescriptionOnlyLine , DiscountLine and SubTotalLine (read-only). If the transaction is taxable there is a limit of 750 lines per transaction.
$ (anyOf 85).SalesReceipt.Line[]JSONEach item
$ (anyOf 85).SalesReceipt.Line[] (anyOf 1)ModelAlternativeExpand Create a change order — request body — body Line item
$ (anyOf 85).SalesReceipt.Line[] (anyOf 2)ModelAlternativeExpand Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num
$ (anyOf 85).SalesReceipt.Line[] (anyOf 3)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num
$ (anyOf 85).SalesReceipt.Line[] (anyOf 4)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num
$ (anyOf 85).SalesReceipt.Line[] (anyOf 5)ModelAlternativeExpand Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail
$ (anyOf 85).SalesReceipt.LinkedTxnarrayOptionalZero or more related transactions to this sales receipt object. The following linked relationships are supported: Links to Estimate and TimeActivity objects can be established directly to this sales receipt object with UI or with the API. Create, Read, Update, and Query operations are avaialble at the API level for these types of links. Only one link can be made to an Estimate . Links to expenses incurred on behalf of the customer are returned in the response with LinkedTxn.TxnType set to ReimburseCharge , ChargeCredit or StatementCharge corresponding to billable customer expenses of type Cash , Delayed Credit , and Delayed Charge , respectively. Links to these types of transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links to payments applied to an sales receipt object are returned in the response with LinkedTxn.TxnType set to Payment . Links to Payment transactions are established within the QuickBooks UI, only, and are available as read-only at the API level. Links the sales receipt to refundReceipt objects that are applied to the sales receipt. Returned in the response if linkedTxnTxnType is a refundReceipt. Note that linking sales receipts to refund receipts can only be done via the customer-facing QuickBooks UI. This is only available as read-only via our API Use LinkedTxn.TxnId as the ID in a separate read request for the specific resource to retrieve details of the linked object.
$ (anyOf 85).SalesReceipt.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 85).SalesReceipt.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 85).SalesReceipt.PaymentMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a PaymentMethod associated with this transaction. Query the PaymentMethod name list resource to determine the appropriate PaymentMethod object for this reference. Use PaymentMethod.Id and PaymentMethod.Name from that object for PaymentMethodRef.value and PaymentMethodRef.name , respectively.
$ (anyOf 85).SalesReceipt.PaymentRefNumstringOptionalThe reference number for the payment received. For example, Â Check # for a check, envelope # for a cash donation.
$ (anyOf 85).SalesReceipt.PrintStatusstringOptionalPrinting status of the invoice. Valid values: NotSet , NeedToPrint , PrintComplete .
$ (anyOf 85).SalesReceipt.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the transaction form to the customer. This field maps to the Memo field on the Sales Receipt form.
$ (anyOf 85).SalesReceipt.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 85).SalesReceipt.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the SalesReceipt was created from.
Read only: true
$ (anyOf 85).SalesReceipt.ShipAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods must be shipped. If ShipAddr is not specified, and a default Customer:ShippingAddr is specified in QuickBooks for this customer, the default ship-to address will be used by QuickBooks. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 85).SalesReceipt.ShipDatestringOptionalLocation of the transaction, as defined using location tracking in QuickBooks Online.
$ (anyOf 85).SalesReceipt.ShipFromAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Identifies the address where the goods are shipped from. For transactions without shipping, it represents the address where the sale took place. If automated sales tax is enabled ( Preferences.TaxPrefs.PartnerTaxEnabled is set to true ) and automated tax calculations are being used, this field is required for an accurate sales tax calculation. For international addresses - countries should be passed as 3 ISO alpha-3 characters or the full name of the country. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
Conditionally required
$ (anyOf 85).SalesReceipt.ShipMethodRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the ShipMethod associated with the transaction. There is no shipping method list. Reference resolves to a string.
$ (anyOf 85).SalesReceipt.SyncTokenstringRequired within parent
$ (anyOf 85).SalesReceipt.TotalAmtJSONOptionalIndicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks. If you process a linked refund transaction against a specific transaction, the totalAmt value won’t change. It will remain the same. However, voiding the linked refund will change the totalAmt value to O.
Decimal string
Read only: true
$ (anyOf 85).SalesReceipt.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 85).SalesReceipt.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 85).SalesReceipt.TrackingNumstringOptionalShipping provider’s tracking number for the delivery of the goods associated with the transaction.
$ (anyOf 85).SalesReceipt.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 85).SalesReceipt.TxnSourcestringOptionalUsed internally to specify originating source of a credit card transaction.
$ (anyOf 85).SalesReceipt.TxnTaxDetailModelOptionalExpand Create a bill — request body — body Txn Tax Detail
This element provides information for taxes charged on the transaction as a whole. It captures the details sales taxes calculated for the transaction based on the tax codes referenced by the transaction. This can be calculated by QuickBooks business logic or you may supply it when adding a transaction. See Global tax model for more information about this element. If sales tax is disabled ( Preferences.TaxPrefs.UsingSalesTax is set to false ) then TxnTaxDetail is ignored and not stored.
$ (anyOf 85).SalesReceipt.domainstringOptional
$ (anyOf 85).SalesReceipt.sparsebooleanRequired within parentMust equal: true
$ (anyOf 86)objectAlternativeAdditional keys: not allowed
$ (anyOf 86).bIdstringRequired within parentMinimum length: 1
$ (anyOf 86).operationJSONRequired within parentMust equal: create
$ (anyOf 86).TaxAgencyobjectRequired within parentAdditional keys: not allowed
$ (anyOf 86).TaxAgency.DisplayNamestringRequired within parentName of the agency.
$ (anyOf 86).TaxAgency.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 86).TaxAgency.LastFileDatestringOptionalThe last tax filing date for this tax agency. This field is automatically populated by QuickBooks business logic at tax filing time.
Read only: true
$ (anyOf 86).TaxAgency.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the entity. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 86).TaxAgency.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 86).TaxAgency.TaxAgencyConfigstringOptionalFlag to identify whether the TaxAgency is system defined by Automated Sales Tax engine or user generated. Valid values include USER_DEFINED , SYSTEM_GENERATED SYSTEM_GENERATED.
Read only: true
$ (anyOf 86).TaxAgency.TaxRegistrationNumberstringOptionalRegistration number for the agency.
Read only: true
$ (anyOf 86).TaxAgency.TaxTrackedOnPurchasesJSONOptionalDenotes whether this tax agency is used to track tax on purchases.
Read only: true
$ (anyOf 86).TaxAgency.TaxTrackedOnPurchases (anyOf 1)booleanAlternative
$ (anyOf 86).TaxAgency.TaxTrackedOnPurchases (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 86).TaxAgency.TaxTrackedOnSalesJSONOptionalDenotes whether this tax agency is used to track tax on sales.
Read only: true
$ (anyOf 86).TaxAgency.TaxTrackedOnSales (anyOf 1)booleanAlternative
$ (anyOf 86).TaxAgency.TaxTrackedOnSales (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 86).TaxAgency.domainstringOptional
$ (anyOf 86).TaxAgency.sparsebooleanOptional
$ (anyOf 87)objectAlternativeAdditional keys: not allowed
$ (anyOf 87).bIdstringRequired within parentMinimum length: 1
$ (anyOf 87).operationJSONRequired within parentMust equal: create
$ (anyOf 87).TermobjectRequired within parentAdditional keys: not allowed
$ (anyOf 87).Term.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 87).Term.Active (anyOf 1)booleanAlternative
$ (anyOf 87).Term.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 87).Term.DayOfMonthDueJSONOptionalPayment must be received by this day of the month. Required if DueDays not present
Conditionally required
$ (anyOf 87).Term.DayOfMonthDue (anyOf 1)integerAlternative
$ (anyOf 87).Term.DayOfMonthDue (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 87).Term.DiscountDayOfMonthJSONOptionalDiscount applies if paid before this day of month. Required if DueDays not present
Minimum: 1
$ (anyOf 87).Term.DiscountDayOfMonth (anyOf 1)integerAlternative
$ (anyOf 87).Term.DiscountDayOfMonth (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 87).Term.DiscountDaysJSONOptionalDiscount applies if paid within this number of days. Used only when DueDays is specified.
$ (anyOf 87).Term.DiscountDays (anyOf 1)integerAlternative
$ (anyOf 87).Term.DiscountDays (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 87).Term.DiscountPercentJSONOptionalDiscount percentage available against an amount if paid within the days specified by DiscountDays .
Decimal string
$ (anyOf 87).Term.DiscountPercent (anyOf 1)numberAlternative
$ (anyOf 87).Term.DiscountPercent (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 87).Term.DueDaysJSONOptionalNumber of days from delivery of goods or services until the payment is due. Required if DayOfMonthDue not present
Conditionally required
$ (anyOf 87).Term.DueDays (anyOf 1)integerAlternative
$ (anyOf 87).Term.DueDays (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 87).Term.DueNextMonthDaysJSONOptionalPayment due next month if issued that many days before the DayOfMonthDue . Required if DueDays not present.
Minimum: 1
$ (anyOf 87).Term.DueNextMonthDays (anyOf 1)integerAlternative
$ (anyOf 87).Term.DueNextMonthDays (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 87).Term.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 87).Term.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 87).Term.NamestringRequired within parentUser recognizable name for the term. For example, Net 30 .
$ (anyOf 87).Term.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 87).Term.TypestringOptionalType of the Sales Term. Valid values: STANDARD —Used if DueDays is not null. DATE_DRIVEN —Used if DueDays is null.
$ (anyOf 87).Term.domainstringOptional
$ (anyOf 87).Term.sparsebooleanOptional
$ (anyOf 88)objectAlternativeAdditional keys: not allowed
$ (anyOf 88).bIdstringRequired within parentMinimum length: 1
$ (anyOf 88).operationJSONRequired within parentMust equal: update
$ (anyOf 88).TermobjectRequired within parentAdditional keys: not allowed
$ (anyOf 88).Term.ActiveJSONOptionalIf true, this entity is currently enabled for use by QuickBooks.
$ (anyOf 88).Term.Active (anyOf 1)booleanAlternative
$ (anyOf 88).Term.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 88).Term.DayOfMonthDueJSONOptionalPayment must be received by this day of the month. Required if DueDays not present
Conditionally required
$ (anyOf 88).Term.DayOfMonthDue (anyOf 1)integerAlternative
$ (anyOf 88).Term.DayOfMonthDue (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 88).Term.DiscountDayOfMonthJSONOptionalDiscount applies if paid before this day of month. Required if DueDays not present
Minimum: 1
$ (anyOf 88).Term.DiscountDayOfMonth (anyOf 1)integerAlternative
$ (anyOf 88).Term.DiscountDayOfMonth (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 88).Term.DiscountDaysJSONOptionalDiscount applies if paid within this number of days. Used only when DueDays is specified.
$ (anyOf 88).Term.DiscountDays (anyOf 1)integerAlternative
$ (anyOf 88).Term.DiscountDays (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 88).Term.DiscountPercentJSONOptionalDiscount percentage available against an amount if paid within the days specified by DiscountDays .
Decimal string
$ (anyOf 88).Term.DiscountPercent (anyOf 1)numberAlternative
$ (anyOf 88).Term.DiscountPercent (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 88).Term.DueDaysJSONOptionalNumber of days from delivery of goods or services until the payment is due. Required if DayOfMonthDue not present
Conditionally required
$ (anyOf 88).Term.DueDays (anyOf 1)integerAlternative
$ (anyOf 88).Term.DueDays (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 88).Term.DueNextMonthDaysJSONOptionalPayment due next month if issued that many days before the DayOfMonthDue . Required if DueDays not present.
Minimum: 1
$ (anyOf 88).Term.DueNextMonthDays (anyOf 1)integerAlternative
$ (anyOf 88).Term.DueNextMonthDays (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 88).Term.IdstringRequired within parent
$ (anyOf 88).Term.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 88).Term.NamestringOptionalUser recognizable name for the term. For example, Net 30 .
$ (anyOf 88).Term.SyncTokenstringRequired within parent
$ (anyOf 88).Term.TypestringOptionalType of the Sales Term. Valid values: STANDARD —Used if DueDays is not null. DATE_DRIVEN —Used if DueDays is null.
$ (anyOf 88).Term.domainstringOptional
$ (anyOf 88).Term.sparsebooleanOptional
$ (anyOf 89)objectAlternativeAdditional keys: not allowed
$ (anyOf 89).bIdstringRequired within parentMinimum length: 1
$ (anyOf 89).operationJSONRequired within parentMust equal: create
$ (anyOf 89).TimeActivityobjectRequired within parentAdditional keys: not allowed
$ (anyOf 89).TimeActivity.BillableStatusstringOptionalBillable status of the time recorded. This field is not updatable through an API request. The value automatically changes when an invoice is created. Valid values: Billable , NotBillable , HasBeenBilled . You cannot directly update the status to HasBeenBilled . To set the status to HasBeenBilled , create an Invoice object and attach this TimeActivity object as a linked transaction to that Invoice.
Read only: true
$ (anyOf 89).TimeActivity.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with this object. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 89).TimeActivity.CostRateJSONOptionalPay rate of the employee or vendor for this time activity.
Decimal string
$ (anyOf 89).TimeActivity.CostRate (anyOf 1)numberAlternative
$ (anyOf 89).TimeActivity.CostRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 89).TimeActivity.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
$ (anyOf 89).TimeActivity.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of this object. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 89).TimeActivity.DescriptionstringOptionalDescription of work completed during time activity.
$ (anyOf 89).TimeActivity.EmployeeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the employee whose time is being recorded. Query the Employee name list resource to determine the appropriate Employee object for this reference. Use Employee.Id and Employee.DisplayName from that object for EmployeerRef.value and EmployeeRef.Name , respectively.
$ (anyOf 89).TimeActivity.EndTimestringOptionalTime that work ends. Required if Hours and Minutes not specified. Note: Kindly consider only the Hours without including the timeZone offset as it does not impact time activity hours calculation. If TnxDate is provided then consider passing the StartTime and EndTime wihtout including the timeZone offset, then the the date passed on the TxnDate is used. If TnxDate is NOT provided, passing the StartTime and EndTime with/wihtout including the timeZone offset, then the the current date on the server is used. For any transactions with historical/future dates kindly include TxnDate in YYYY-MM-DD format and StartTime and EndTime in Hours and Minutes
Conditionally required
$ (anyOf 89).TimeActivity.HourlyRateJSONOptionalHourly bill rate of the employee or vendor for this time activity. Required if BillableStatus is set to Billable
Conditionally required
Decimal string
$ (anyOf 89).TimeActivity.HourlyRate (anyOf 1)numberAlternative
$ (anyOf 89).TimeActivity.HourlyRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 89).TimeActivity.HoursJSONOptionalHours and minutes worked. Required if StartTime and EndTime not specified
Conditionally required
$ (anyOf 89).TimeActivity.Hours (anyOf 1)integerAlternative
$ (anyOf 89).TimeActivity.Hours (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 89).TimeActivity.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 89).TimeActivity.ItemRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the service item associated with this object. Query the Item name list resource, where Item.Type is set to Service , to determine the appropriate Item object for this reference. Use Item.Id and Item.Name from that object for ItemRef.value and ItemRef.name , respectively. For France locales: The account associated with the referenced Item object is looked up in the account category list. If this account has same location as specified in the transaction by the TransactionLocationType attribute and the same VAT as in the line item TaxCodeRef attribute, then the item account is used. If there is a mismatch, then the account from the account category list that matches the transaction location and VAT is used. If this account is not present in the account category list, then a new account is created with the new location, new VAT code, and all other attributes as in the default account.
$ (anyOf 89).TimeActivity.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 89).TimeActivity.NameOfstringRequired within parentEnumeration of time activity types. Required in conjunction with either EmployeeRef or VendorRef attributes for create operations. Valid values: Vendor or Employee .
$ (anyOf 89).TimeActivity.PayrollItemRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies how much the employee should be paid for doing the work specified by the Compensation Id. Query the EmployeeCompensation resource to determine the appropriate PayrollCompensation object for an employee. Use EmployeeCompensation.Id and EmployerCompensation.Name from that object for PayrollItemRef.value and PayrollItemRef.name , respectively. This field is available as part of the Payroll Compensation resource in the Workforce API. Read more about the Payroll Compensation resource , available to Silver, Gold, and Platinum partners.
$ (anyOf 89).TimeActivity.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 89).TimeActivity.StartTimestringOptionalTime that work starts. Required if Hours and Minutes not specified. Note: Kindly consider only the Hours without including the timeZone offset as it does not impact time activity hours calculation. If TnxDate is provided then consider passing the StartTime and EndTime wihtout including the timeZone offset, then the the date passed on the TxnDate is used. If TnxDate is NOT provided, passing the StartTime and EndTime with/wihtout including the timeZone offset, then the the current date on the server is used. For any transactions with historical/future dates kindly include TxnDate in YYYY-MM-DD format and StartTime and EndTime in Hours and Minutes
Conditionally required
$ (anyOf 89).TimeActivity.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 89).TimeActivity.TaxableJSONOptionalTrue if the time recorded is both billable and taxable.
$ (anyOf 89).TimeActivity.Taxable (anyOf 1)booleanAlternative
$ (anyOf 89).TimeActivity.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 89).TimeActivity.TxnDatestringOptionalThe date for the time activity. This is the posting date that affects financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default. If you provide the StartTime and EndTime without including the timeZone offset, then you would need to pass the TxnDate for any historical or future dates. Lets say if you want to create a historical time activity then pass the TxnDate as the date and pass StartTime and EndTime as Hours without including the timeZone offset.
Conditionally required
$ (anyOf 89).TimeActivity.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the vendor whose time is being recorded. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively.
Conditionally required
$ (anyOf 89).TimeActivity.MinutesJSONOptionalHours and minutes worked. Required if StartTime and EndTime not specified
Conditionally required
$ (anyOf 89).TimeActivity.Minutes (anyOf 1)integerAlternative
$ (anyOf 89).TimeActivity.Minutes (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 89).TimeActivity.BreakHoursJSONOptionalHours and minutes of break taken between StartTime and EndTime . use when StartTime and EndTime are specified
Conditionally required
$ (anyOf 89).TimeActivity.BreakHours (anyOf 1)integerAlternative
$ (anyOf 89).TimeActivity.BreakHours (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 89).TimeActivity.BreakMinutesJSONOptionalHours and minutes of break taken between StartTime and EndTime . use when StartTime and EndTime are specified
Conditionally required
$ (anyOf 89).TimeActivity.BreakMinutes (anyOf 1)integerAlternative
$ (anyOf 89).TimeActivity.BreakMinutes (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 89).TimeActivity.domainstringOptional
$ (anyOf 89).TimeActivity.sparsebooleanOptional
$ (anyOf 90)objectAlternativeAdditional keys: not allowed
$ (anyOf 90).bIdstringRequired within parentMinimum length: 1
$ (anyOf 90).operationJSONRequired within parentMust equal: delete
$ (anyOf 90).TimeActivityModelRequired within parentExpand Delete a timeactivity object — request body — body
$ (anyOf 91)objectAlternativeAdditional keys: not allowed
$ (anyOf 91).bIdstringRequired within parentMinimum length: 1
$ (anyOf 91).operationJSONRequired within parentMust equal: update
$ (anyOf 91).TimeActivityobjectRequired within parentAdditional keys: not allowed
$ (anyOf 91).TimeActivity.BillableStatusstringOptionalBillable status of the time recorded. This field is not updatable through an API request. The value automatically changes when an invoice is created. Valid values: Billable , NotBillable , HasBeenBilled . You cannot directly update the status to HasBeenBilled . To set the status to HasBeenBilled , create an Invoice object and attach this TimeActivity object as a linked transaction to that Invoice.
Read only: true
$ (anyOf 91).TimeActivity.ClassRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Class associated with this object. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerTxn is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
$ (anyOf 91).TimeActivity.CostRateJSONOptionalPay rate of the employee or vendor for this time activity.
Decimal string
$ (anyOf 91).TimeActivity.CostRate (anyOf 1)numberAlternative
$ (anyOf 91).TimeActivity.CostRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 91).TimeActivity.CustomerRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively. Required if BillableStatus is set to Billable
Conditionally required
$ (anyOf 91).TimeActivity.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of this object. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 91).TimeActivity.DescriptionstringOptionalDescription of work completed during time activity.
$ (anyOf 91).TimeActivity.EmployeeRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the employee whose time is being recorded. Query the Employee name list resource to determine the appropriate Employee object for this reference. Use Employee.Id and Employee.DisplayName from that object for EmployeerRef.value and EmployeeRef.Name , respectively. Required if NameOf is set to Employee
Conditionally required
$ (anyOf 91).TimeActivity.EndTimestringOptionalTime that work starts and ends, respectively. Required if Hours and Minutes not specified. Note: Kindly consider only the Hours without including the timeZone offset as it does not impact time activity hours calculation.
Conditionally required
$ (anyOf 91).TimeActivity.HourlyRateJSONOptionalHourly bill rate of the employee or vendor for this time activity. Required if BillableStatus is set to Billable
Conditionally required
Decimal string
$ (anyOf 91).TimeActivity.HourlyRate (anyOf 1)numberAlternative
$ (anyOf 91).TimeActivity.HourlyRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 91).TimeActivity.HoursJSONOptionalHours and minutes worked. Required if StartTime and EndTime not specified
Conditionally required
$ (anyOf 91).TimeActivity.Hours (anyOf 1)integerAlternative
$ (anyOf 91).TimeActivity.Hours (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 91).TimeActivity.IdstringRequired within parent
$ (anyOf 91).TimeActivity.ItemRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the service item associated with this object. Query the Item name list resource, where Item.Type is set to Service , to determine the appropriate Item object for this reference. Use Item.Id and Item.Name from that object for ItemRef.value and ItemRef.name , respectively. For France locales: The account associated with the referenced Item object is looked up in the account category list. If this account has same location as specified in the transaction by the TransactionLocationType attribute and the same VAT as in the line item TaxCodeRef attribute, then the item account is used. If there is a mismatch, then the account from the account category list that matches the transaction location and VAT is used. If this account is not present in the account category list, then a new account is created with the new location, new VAT code, and all other attributes as in the default account.
$ (anyOf 91).TimeActivity.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 91).TimeActivity.NameOfstringOptionalEnumeration of time activity types. Required in conjunction with either EmployeeRef or VendorRef attributes for create operations. Valid values: Vendor or Employee .
$ (anyOf 91).TimeActivity.PayrollItemRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies how much the employee should be paid for doing the work specified by the Compensation Id. Query the EmployeeCompensation resource to determine the appropriate PayrollCompensation object for an employee. Use EmployeeCompensation.Id and EmployerCompensation.Name from that object for PayrollItemRef.value and PayrollItemRef.name , respectively. This field is available as part of the Payroll Compensation resource in the Workforce API. Read more about the Payroll Compensation resource , available to Silver, Gold, and Platinum partners.
$ (anyOf 91).TimeActivity.ProjectRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to the Project ID associated with this transaction.
Conditionally required
$ (anyOf 91).TimeActivity.StartTimestringOptionalTime that work starts and ends, respectively. Required if Hours and Minutes not specified. Note: Kindly consider only the Hours without including the timeZone offset as it does not impact time activity hours calculation.
Conditionally required
$ (anyOf 91).TimeActivity.SyncTokenstringRequired within parent
$ (anyOf 91).TimeActivity.TaxableJSONOptionalTrue if the time recorded is both billable and taxable.
$ (anyOf 91).TimeActivity.Taxable (anyOf 1)booleanAlternative
$ (anyOf 91).TimeActivity.Taxable (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 91).TimeActivity.TxnDatestringOptionalThe date for the time activity. This is the posting date that affects financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default. If you provide the StartTime and EndTime without including the timeZone offset, then you would need to pass the TxnDate for any historical or future dates. Lets say if you want to create a historical time activity then pass the TxnDate as the date and pass StartTime and EndTime as Hours without including the timeZone offset.
Conditionally required
$ (anyOf 91).TimeActivity.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies the vendor whose time is being recorded. Query the Vendor name list resource to determine the appropriate Vendor object for this reference. Use Vendor.Id and Vendor.Name from that object for VendorRef.value and VendorRef.name , respectively. Required if NameOf is set to Vendor
Conditionally required
$ (anyOf 91).TimeActivity.MinutesJSONOptionalHours and minutes worked. Required if StartTime and EndTime not specified
Conditionally required
$ (anyOf 91).TimeActivity.Minutes (anyOf 1)integerAlternative
$ (anyOf 91).TimeActivity.Minutes (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 91).TimeActivity.BreakHoursJSONOptionalHours and minutes of break taken between StartTime and EndTime . use when StartTime and EndTime are specified
Conditionally required
$ (anyOf 91).TimeActivity.BreakHours (anyOf 1)integerAlternative
$ (anyOf 91).TimeActivity.BreakHours (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 91).TimeActivity.BreakMinutesJSONOptionalHours and minutes of break taken between StartTime and EndTime . use when StartTime and EndTime are specified
Conditionally required
$ (anyOf 91).TimeActivity.BreakMinutes (anyOf 1)integerAlternative
$ (anyOf 91).TimeActivity.BreakMinutes (anyOf 2)stringAlternativePattern: ^-?[0-9]+$
$ (anyOf 91).TimeActivity.domainstringOptional
$ (anyOf 91).TimeActivity.sparsebooleanOptional
$ (anyOf 92)objectAlternativeAdditional keys: not allowed
$ (anyOf 92).bIdstringRequired within parentMinimum length: 1
$ (anyOf 92).operationJSONRequired within parentMust equal: create
$ (anyOf 92).TransferobjectRequired within parentAdditional keys: not allowed
$ (anyOf 92).Transfer.AmountJSONRequired within parentIndicates the total amount of the transaction.
Decimal string
$ (anyOf 92).Transfer.Amount (anyOf 1)numberAlternative
$ (anyOf 92).Transfer.Amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 92).Transfer.FromAccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Identifies the asset account from which funds are transfered. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for FromAccountRef.value and FromAccountRef.name , respectively. The specified account must have Account.Classification set to Asset .
$ (anyOf 92).Transfer.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 92).Transfer.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 92).Transfer.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 92).Transfer.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Transfer was created from.
Read only: true
$ (anyOf 92).Transfer.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 92).Transfer.ToAccountRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Identifies the asset account to which funds are transfered. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for ToAccountRef.value and ToAccountRef.name , respectively. The specified account must have Account.Classification set to Asset .
$ (anyOf 92).Transfer.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 92).Transfer.domainstringOptional
$ (anyOf 92).Transfer.sparsebooleanOptional
$ (anyOf 93)objectAlternativeAdditional keys: not allowed
$ (anyOf 93).bIdstringRequired within parentMinimum length: 1
$ (anyOf 93).operationJSONRequired within parentMust equal: delete
$ (anyOf 93).TransferModelRequired within parentExpand Delete an transfer — request body — body
$ (anyOf 94)objectAlternativeAdditional keys: not allowed
$ (anyOf 94).bIdstringRequired within parentMinimum length: 1
$ (anyOf 94).operationJSONRequired within parentMust equal: update
$ (anyOf 94).TransferModelRequired within parentExpand Delete an transfer — request body — body
$ (anyOf 95)objectAlternativeAdditional keys: not allowed
$ (anyOf 95).bIdstringRequired within parentMinimum length: 1
$ (anyOf 95).operationJSONRequired within parentMust equal: update
$ (anyOf 95).TransferobjectRequired within parentAdditional keys: not allowed
$ (anyOf 95).Transfer.AmountJSONOptionalIndicates the total amount of the transaction.
Decimal string
$ (anyOf 95).Transfer.Amount (anyOf 1)numberAlternative
$ (anyOf 95).Transfer.Amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 95).Transfer.FromAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the asset account from which funds are transfered. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for FromAccountRef.value and FromAccountRef.name , respectively. The specified account must have Account.Classification set to Asset .
$ (anyOf 95).Transfer.IdstringRequired within parent
$ (anyOf 95).Transfer.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 95).Transfer.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the invoice to the customer. This field maps to the Memo field on the Invoice form.
$ (anyOf 95).Transfer.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the Transfer was created from.
Read only: true
$ (anyOf 95).Transfer.SyncTokenstringRequired within parent
$ (anyOf 95).Transfer.ToAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Identifies the asset account to which funds are transfered. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for ToAccountRef.value and ToAccountRef.name , respectively. The specified account must have Account.Classification set to Asset .
$ (anyOf 95).Transfer.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 95).Transfer.domainstringOptional
$ (anyOf 95).Transfer.sparsebooleanRequired within parentMust equal: true
$ (anyOf 96)objectAlternativeAdditional keys: not allowed
$ (anyOf 96).bIdstringRequired within parentMinimum length: 1
$ (anyOf 96).operationJSONRequired within parentMust equal: create
$ (anyOf 96).VendorobjectRequired within parentAdditional keys: not allowed
$ (anyOf 96).Vendor.AcctNumstringOptionalName or number of the account associated with this vendor.
$ (anyOf 96).Vendor.ActiveJSONOptionalIf true, this object is currently enabled for use by QuickBooks.
$ (anyOf 96).Vendor.Active (anyOf 1)booleanAlternative
$ (anyOf 96).Vendor.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 96).Vendor.AlternatePhoneModelOptionalExpand Create a vendor — request body — body Fax
Alternate phone number.
$ (anyOf 96).Vendor.BalanceJSONOptionalSpecifies the open balance amount or the amount unpaid by the customer. For the create operation, this represents the opening balance for the customer. When returned in response to the query request it represents the current open balance (unpaid amount) for that customer. Write-on-create, read-only otherwise.
Decimal string
Read only: true
$ (anyOf 96).Vendor.Balance (anyOf 1)numberAlternative
$ (anyOf 96).Vendor.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 96).Vendor.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default billing address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 96).Vendor.BillRateJSONOptionalBillRate can be set to specify this vendor’s hourly billing rate.
Decimal string
$ (anyOf 96).Vendor.BillRate (anyOf 1)numberAlternative
$ (anyOf 96).Vendor.BillRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 96).Vendor.CompanyNamestringOptionalThe name of the company associated with the person or organization.
$ (anyOf 96).Vendor.CostRateJSONOptionalPay rate of the vendor
Decimal string
$ (anyOf 96).Vendor.CostRate (anyOf 1)numberAlternative
$ (anyOf 96).Vendor.CostRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 96).Vendor.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts associated with this vendor are expressed. Once set, it cannot be changed. If specified currency is not currently in the company’s currency list, it is added. If not specified, currency for this vendor is the home currency of the company, as defined by Preferences.CurrencyPrefs.HomeCurrency . Read-only after object is created.
Read only: true
$ (anyOf 96).Vendor.DisplayNamestringOptionalThe name of the vendor as displayed. Must be unique across all Vendor, Customer, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating vendor name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix .
$ (anyOf 96).Vendor.FamilyNamestringOptionalFamily name or the last name of the person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 96).Vendor.FaxModelOptionalExpand Create a vendor — request body — body Fax
Fax number.
$ (anyOf 96).Vendor.GivenNamestringOptionalGiven name or first name of a person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 96).Vendor.HasTPARJSONOptionalIndicate if the vendor has TPAR enabled. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 96).Vendor.HasTPAR (anyOf 1)booleanAlternative
$ (anyOf 96).Vendor.HasTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 96).Vendor.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 96).Vendor.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 96).Vendor.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 96).Vendor.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 96).Vendor.OtherContactInfoModelOptionalExpand Create a vendor — request body — body Other Contact Info
List of ContactInfo entities of any contact info type.
$ (anyOf 96).Vendor.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 96).Vendor.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 96).Vendor.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName . Cannot be removed with sparse update.
$ (anyOf 96).Vendor.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 96).Vendor.SuffixstringOptionalSuffix of the name. For example, Jr . The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 96).Vendor.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 96).Vendor.T4AEligibleJSONOptionalTrue if vendor is T4A eligible. Valid for CA locale
$ (anyOf 96).Vendor.T4AEligible (anyOf 1)booleanAlternative
$ (anyOf 96).Vendor.T4AEligible (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 96).Vendor.T5018EligibleJSONOptionalTrue if vendor is T5018 eligible. Valid for CA locale
$ (anyOf 96).Vendor.T5018Eligible (anyOf 1)booleanAlternative
$ (anyOf 96).Vendor.T5018Eligible (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 96).Vendor.TaxIdentifierstringOptionalThe tax ID of the Person or Organization. The value is masked in responses, exposing only last four characters. For example, the ID of 123-45-6789 is returned as XXXXXXX6789 .
$ (anyOf 96).Vendor.TermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a default Term associated with this Vendor object. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for TermRef.value and TermRef.name , respectively.
$ (anyOf 96).Vendor.TitlestringOptionalTitle of the person. This tag supports i18n, all locales. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , Suffix , or FullyQualifiedName attributes are required during create.
Conditionally required
$ (anyOf 96).Vendor.Vendor1099JSONOptionalThis vendor is an independent contractor; someone who is given a 1099-MISC form at the end of the year. A 1099 vendor is paid with regular checks, and taxes are not withheld on their behalf.
$ (anyOf 96).Vendor.Vendor1099 (anyOf 1)booleanAlternative
$ (anyOf 96).Vendor.Vendor1099 (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 96).Vendor.VendorPaymentBankDetailModelOptionalExpand Create a vendor — request body — body Vendor Payment Bank Detail
Vendor Payment Bank Detail.
$ (anyOf 96).Vendor.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 96).Vendor.domainstringOptional
$ (anyOf 96).Vendor.sparsebooleanOptional
$ (anyOf 97)objectAlternativeAdditional keys: not allowed
$ (anyOf 97).bIdstringRequired within parentMinimum length: 1
$ (anyOf 97).operationJSONRequired within parentMust equal: update
$ (anyOf 97).VendorobjectRequired within parentAdditional keys: not allowed
$ (anyOf 97).Vendor.AcctNumstringOptionalName or number of the account associated with this vendor.
$ (anyOf 97).Vendor.ActiveJSONOptionalIf true, this object is currently enabled for use by QuickBooks.
$ (anyOf 97).Vendor.Active (anyOf 1)booleanAlternative
$ (anyOf 97).Vendor.Active (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 97).Vendor.AlternatePhoneModelOptionalExpand Create a vendor — request body — body Fax
Alternate phone number.
$ (anyOf 97).Vendor.BalanceJSONOptionalSpecifies the open balance amount or the amount unpaid by the customer. For the create operation, this represents the opening balance for the customer. When returned in response to the query request it represents the current open balance (unpaid amount) for that customer. Write-on-create, read-only otherwise.
Decimal string
Read only: true
$ (anyOf 97).Vendor.Balance (anyOf 1)numberAlternative
$ (anyOf 97).Vendor.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 97).Vendor.BillAddrModelOptionalExpand Create a vendor — request body — body Bill Addr
Default billing address. If a physical address is updated from within the transaction object, the QuickBooks Online API flows individual address components differently into the Line elements of the transaction response then when the transaction was first created: Line1 and Line2 elements are populated with the customer name and company name. Original Line1 through Line 5 contents, City , SubDivisionCode , and PostalCode flow into Line3 through Line5 as a free format strings.
$ (anyOf 97).Vendor.BillRateJSONOptionalBillRate can be set to specify this vendor’s hourly billing rate.
Decimal string
$ (anyOf 97).Vendor.BillRate (anyOf 1)numberAlternative
$ (anyOf 97).Vendor.BillRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 97).Vendor.CompanyNamestringOptionalThe name of the company associated with the person or organization.
$ (anyOf 97).Vendor.CostRateJSONOptionalPay rate of the vendor
Decimal string
$ (anyOf 97).Vendor.CostRate (anyOf 1)numberAlternative
$ (anyOf 97).Vendor.CostRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 97).Vendor.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts associated with this vendor are expressed. Once set, it cannot be changed. If specified currency is not currently in the company’s currency list, it is added. If not specified, currency for this vendor is the home currency of the company, as defined by Preferences.CurrencyPrefs.HomeCurrency . Read-only after object is created.
Read only: true
$ (anyOf 97).Vendor.DisplayNamestringOptionalThe name of the vendor as displayed. Must be unique across all Vendor, Customer, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating vendor name components supplied in the request from the following list: Title , GivenName , MiddleName , FamilyName , and Suffix .
$ (anyOf 97).Vendor.FamilyNamestringOptionalFamily name or the last name of the person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 97).Vendor.FaxModelOptionalExpand Create a vendor — request body — body Fax
Fax number.
$ (anyOf 97).Vendor.GivenNamestringOptionalGiven name or first name of a person. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 97).Vendor.HasTPARJSONOptionalIndicate if the vendor has TPAR enabled. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 97).Vendor.HasTPAR (anyOf 1)booleanAlternative
$ (anyOf 97).Vendor.HasTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 97).Vendor.IdstringRequired within parent
$ (anyOf 97).Vendor.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 97).Vendor.MiddleNamestringOptionalMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 97).Vendor.MobileModelOptionalExpand Create a vendor — request body — body Fax
Mobile phone number.
$ (anyOf 97).Vendor.OtherContactInfoModelOptionalExpand Create a vendor — request body — body Other Contact Info
List of ContactInfo entities of any contact info type.
$ (anyOf 97).Vendor.PrimaryEmailAddrModelOptionalExpand Full update companyinfo — request body — body Email
Primary email address.
$ (anyOf 97).Vendor.PrimaryPhoneModelOptionalExpand Create a vendor — request body — body Fax
Primary phone number.
$ (anyOf 97).Vendor.PrintOnCheckNamestringOptionalName of the person or organization as printed on a check. If not provided, this is populated from DisplayName . Cannot be removed with sparse update.
$ (anyOf 97).Vendor.SourcestringOptionalThe Source type of the transactions created by QuickBooks Commerce. Valid values include: QBCommerce
$ (anyOf 97).Vendor.SuffixstringOptionalSuffix of the name. For example, Jr . The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes is required for object create.
Conditionally required
$ (anyOf 97).Vendor.SyncTokenstringRequired within parent
$ (anyOf 97).Vendor.T4AEligibleJSONOptionalTrue if vendor is T4A eligible. Valid for CA locale
$ (anyOf 97).Vendor.T4AEligible (anyOf 1)booleanAlternative
$ (anyOf 97).Vendor.T4AEligible (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 97).Vendor.T5018EligibleJSONOptionalTrue if vendor is T5018 eligible. Valid for CA locale
$ (anyOf 97).Vendor.T5018Eligible (anyOf 1)booleanAlternative
$ (anyOf 97).Vendor.T5018Eligible (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 97).Vendor.TaxIdentifierstringOptionalThe tax ID of the Person or Organization. The value is masked in responses, exposing only last four characters. For example, the ID of 123-45-6789 is returned as XXXXXXX6789 .
$ (anyOf 97).Vendor.TermRefModelOptionalExpand Create a purchase order — request body — body Ship To
Reference to a default Term associated with this Vendor object. Query the Term name list resource to determine the appropriate Term object for this reference. Use Term.Id and Term.Name from that object for TermRef.value and TermRef.name , respectively.
$ (anyOf 97).Vendor.TitlestringOptionalTitle of the person. This tag supports i18n, all locales. The DisplayName attribute or at least one of Title , GivenName , MiddleName , FamilyName , or Suffix attributes are required during create.
Conditionally required
$ (anyOf 97).Vendor.Vendor1099JSONOptionalThis vendor is an independent contractor; someone who is given a 1099-MISC form at the end of the year. A 1099 vendor is paid with regular checks, and taxes are not withheld on their behalf.
$ (anyOf 97).Vendor.Vendor1099 (anyOf 1)booleanAlternative
$ (anyOf 97).Vendor.Vendor1099 (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 97).Vendor.VendorPaymentBankDetailModelOptionalExpand Create a vendor — request body — body Vendor Payment Bank Detail
Vendor Payment Bank Detail.
$ (anyOf 97).Vendor.WebAddrModelOptionalExpand Create a vendor — request body — body Web Addr
Website address.
$ (anyOf 97).Vendor.domainstringOptional
$ (anyOf 97).Vendor.sparsebooleanOptional
$ (anyOf 98)objectAlternativeAdditional keys: not allowed
$ (anyOf 98).bIdstringRequired within parentMinimum length: 1
$ (anyOf 98).operationJSONRequired within parentMust equal: create
$ (anyOf 98).VendorCreditobjectRequired within parentAdditional keys: not allowed
$ (anyOf 98).VendorCredit.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 98).VendorCredit.BalanceJSONOptionalThe current amount of the vendor credit reflecting any adjustments to the original credit amount. Initially set to the value of TotalAmt . Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 98).VendorCredit.Balance (anyOf 1)numberAlternative
$ (anyOf 98).VendorCredit.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 98).VendorCredit.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 98).VendorCredit.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 98).VendorCredit.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers as follows: If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is false, resulting DocNumber is system generated by incrementing the last number by 1. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 98).VendorCredit.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 98).VendorCredit.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 98).VendorCredit.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 98).VendorCredit.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 98).VendorCredit.IdstringOptionalUnique identifier for this object.
Read only: true
$ (anyOf 98).VendorCredit.IncludeInAnnualTPARJSONOptionalInclude the supplier in the annual TPAR. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 98).VendorCredit.IncludeInAnnualTPAR (anyOf 1)booleanAlternative
$ (anyOf 98).VendorCredit.IncludeInAnnualTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 98).VendorCredit.LinearrayRequired within parentIndividual line items of a transaction. Valid Line types include: ItemBasedExpenseLine and AccountBasedExpenseLine
$ (anyOf 98).VendorCredit.Line[]JSONEach item
$ (anyOf 98).VendorCredit.Line[] (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Line item
$ (anyOf 98).VendorCredit.Line[] (anyOf 2)ModelAlternativeExpand Create a bill — request body — body Line item
$ (anyOf 98).VendorCredit.LinkedTxnarrayOptionalZero or more transactions linked to this object. The LinkedTxn.TxnType can be set to ReimburseCharge . The LinkedTxn.TxnId can be set as the ID of the transaction.
$ (anyOf 98).VendorCredit.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 98).VendorCredit.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 98).VendorCredit.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the transaction to the vendor. This field maps to the Memo field on the transaction form.
$ (anyOf 98).VendorCredit.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the VendorCredit was created from.
Read only: true
$ (anyOf 98).VendorCredit.SyncTokenstringOptionalVersion 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.
Read only: true
$ (anyOf 98).VendorCredit.TotalAmtJSONOptionalIndicates the total credit amount, determined by taking the total of all all lines of the transaction. This includes all charges, allowances, discounts, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 98).VendorCredit.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 98).VendorCredit.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 98).VendorCredit.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 98).VendorCredit.VendorRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
The vendor reference for this transaction.
$ (anyOf 98).VendorCredit.domainstringOptional
$ (anyOf 98).VendorCredit.sparsebooleanOptional
$ (anyOf 99)objectAlternativeAdditional keys: not allowed
$ (anyOf 99).bIdstringRequired within parentMinimum length: 1
$ (anyOf 99).operationJSONRequired within parentMust equal: delete
$ (anyOf 99).VendorCreditModelRequired within parentExpand Delete a vendorcredit — request body — body
$ (anyOf 100)objectAlternativeAdditional keys: not allowed
$ (anyOf 100).bIdstringRequired within parentMinimum length: 1
$ (anyOf 100).operationJSONRequired within parentMust equal: update
$ (anyOf 100).VendorCreditobjectRequired within parentAdditional keys: not allowed
$ (anyOf 100).VendorCredit.APAccountRefModelOptionalExpand Create a purchase order — request body — body Ship To
Specifies to which AP account the bill is credited. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for APAccountRef.value and APAccountRef.name , respectively. The specified account must have Account.Classification set to Liability and Account.AccountSubType set to AccountsPayable . If the company has a single AP account, the account is implied. However, it is recommended that the AP Account be explicitly specified in all cases to prevent unexpected errors when relating transactions to each other.
$ (anyOf 100).VendorCredit.BalanceJSONOptionalThe current amount of the vendor credit reflecting any adjustments to the original credit amount. Initially set to the value of TotalAmt . Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 100).VendorCredit.Balance (anyOf 1)numberAlternative
$ (anyOf 100).VendorCredit.Balance (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 100).VendorCredit.CurrencyRefModelOptionalExpand Create a bill — request body — body Currency Ref
Reference to the currency in which all amounts on the associated transaction are expressed. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true . Read more about multicurrency support here . Required if multicurrency is enabled for the company
Conditionally required
$ (anyOf 100).VendorCredit.DepartmentRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to a Department object specifying the location of the transaction. Available if Preferences.AccountingInfoPrefs.TrackDepartments is set to true . Query the Department name list resource to determine the appropriate department object for this reference. Use Department.Id and Department.Name from that object for DepartmentRef.value and DepartmentRef.name , respectively.
$ (anyOf 100).VendorCredit.DocNumberstringOptionalReference number for the transaction. If not explicitly provided at create time, this field is populated based on the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers as follows: If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is true a custom value can be provided. If no value is supplied, the resulting DocNumber is null. If Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers is false, resulting DocNumber is system generated by incrementing the last number by 1. Throws an error when duplicate DocNumber is sent in the request. Recommended best practice: check the setting of Preferences:OtherPrefs:NameValue.Name = VendorAndPurchasesPrefs.UseCustomTxnNumbers before setting DocNumber. If a duplicate DocNumber needs to be supplied, add the query parameter name/value pair, include=allowduplicatedocnum to the URI. Sort order is ASC by default.
$ (anyOf 100).VendorCredit.ExchangeRateJSONOptionalThe number of home currency units it takes to equal one unit of currency specified by CurrencyRef . Applicable if multicurrency is enabled for the company.
Decimal string
$ (anyOf 100).VendorCredit.ExchangeRate (anyOf 1)numberAlternative
$ (anyOf 100).VendorCredit.ExchangeRate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 100).VendorCredit.GlobalTaxCalculationstringOptionalMethod in which tax is applied. Allowed values are: TaxExcluded , TaxInclusive , and NotApplicable . Not applicable to US companies; required for non-US companies.
Conditionally required
$ (anyOf 100).VendorCredit.IdstringRequired within parent
$ (anyOf 100).VendorCredit.IncludeInAnnualTPARJSONOptionalInclude the supplier in the annual TPAR. TPAR stands for Taxable Payments Annual Report. The TPAR is mandated by ATO to get the details payments that businesses make to contractors for providing services. Some government entities also need to report the grants they have paid in a TPAR.
$ (anyOf 100).VendorCredit.IncludeInAnnualTPAR (anyOf 1)booleanAlternative
$ (anyOf 100).VendorCredit.IncludeInAnnualTPAR (anyOf 2)stringAlternativeOne of: true, false
$ (anyOf 100).VendorCredit.LinearrayOptionalIndividual line items of a transaction. Valid Line types include: ItemBasedExpenseLine and AccountBasedExpenseLine
$ (anyOf 100).VendorCredit.Line[]JSONEach item
$ (anyOf 100).VendorCredit.Line[] (anyOf 1)ModelAlternativeExpand Create a purchase order — request body — body Line item
$ (anyOf 100).VendorCredit.Line[] (anyOf 2)ModelAlternativeExpand Create a bill — request body — body Line item
$ (anyOf 100).VendorCredit.LinkedTxnarrayOptionalZero or more transactions linked to this object. The LinkedTxn.TxnType can be set to ReimburseCharge . The LinkedTxn.TxnId can be set as the ID of the transaction.
$ (anyOf 100).VendorCredit.LinkedTxn[]ModelEach itemExpand Create a bill — request body — body Linked Txn item
$ (anyOf 100).VendorCredit.MetaDataModelOptionalExpand Read a bill — response body — Bill Meta Data
Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
$ (anyOf 100).VendorCredit.PrivateNotestringOptionalUser entered, organization-private note about the transaction. This note does not appear on the transaction to the vendor. This field maps to the Memo field on the transaction form.
$ (anyOf 100).VendorCredit.RecurDataRefModelOptionalExpand Create a purchase order — request body — body Ship To
A reference to the Recurring Transaction. It captures what recurring transaction template the VendorCredit was created from.
Read only: true
$ (anyOf 100).VendorCredit.SyncTokenstringRequired within parent
$ (anyOf 100).VendorCredit.TotalAmtJSONOptionalIndicates the total credit amount, determined by taking the total of all all lines of the transaction. This includes all charges, allowances, discounts, and taxes. Calculated by QuickBooks business logic; any value you supply is over-written by QuickBooks.
Decimal string
Read only: true
$ (anyOf 100).VendorCredit.TotalAmt (anyOf 1)numberAlternative
$ (anyOf 100).VendorCredit.TotalAmt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
$ (anyOf 100).VendorCredit.TxnDatestringOptionalThe date entered by the user when this transaction occurred. For posting transactions, this is the posting date that affects the financial statements. If the date is not supplied, the current date on the server is used. Sort order is ASC by default.
$ (anyOf 100).VendorCredit.VendorRefModelOptionalExpand Create a purchase order — request body — body Ship To
The vendor reference for this transaction.
$ (anyOf 100).VendorCredit.domainstringOptional
$ (anyOf 100).VendorCredit.sparsebooleanOptional

Referenced models: Create a refund receipt — request body — body Check Payment, Create a vendor — request body — body Other Contact Info, Void an invoice — request body — body Delivery Info, Full update companyinfo — request body — body Email, Full update preferences — request body — body Email Messages Prefs, Read a bill — response body — Bill Meta Data, Create a vendor — request body — body Bill Addr, Create a vendor — request body — body Fax, Create a vendor — request body — body Vendor Payment Bank Detail, Create a vendor — request body — body Web Addr, Create a bill — request body — body Line item, Delete a bill — request body — body Line item Account Based Expense Line Detail, Amount, Custom Extensions, Description, Detail Type, Id, Line Num, Linked Txn, Full update preferences — request body — body Accounting Info Prefs, Delete an attachable — request body — body Attachable Ref item, Void a billpayment — request body — body Check Payment, Void a billpayment — request body — body Credit Card Payment, Create a budget — request body — body Budget Detail item, Create a deposit — request body — body Cash Back, Void a payment — request body — body Credit Card Payment, Full update preferences — request body — body Currency Prefs, Create a bill — request body — body Currency Ref, Create a customer — request body — body Customer Type Ref, Create an item — request body — body Custom Extensions, Void an invoice — request body — body Custom Field item, Create a deposit — request body — body Line item, Void an invoice — request body — body Line item Amount, Description, Description Line Detail, Detail Type, Id, Line Num, Void an invoice — request body — body Line item Amount, Description, Detail Type, Discount Line Detail, Id, Line Num, Void an invoice — request body — body Line item Custom Extensions, Description, Detail Type, Group Line Detail, Id, Line Num, Create an inventory adjustment — request body — body Line item, Create a purchase order — request body — body Line item, Delete a bill — request body — body Line item Amount, Custom Extensions, Description, Detail Type, Id, Item Based Expense Line Detail, Line Num, Linked Txn, Create a journalentry — request body — body Line item, Void a payment — request body — body Line item, Create a bill — request body — body Linked Txn item, Void an invoice — request body — body Customer Memo, Full update preferences — request body — body Product And Services Prefs, Create a purchase order — request body — body Ship To, Full update preferences — request body — body Report Prefs, Full update preferences — request body — body Sales Forms Prefs, Create a change order — request body — body Line item, Void an invoice — request body — body Line item Amount, Description, Detail Type, Id, Line Num, Sub Total Line Detail, Full update preferences — request body — body Tax Prefs, Full update preferences — request body — body Time Tracking Prefs, Create a bill — request body — body Txn Tax Detail, Full update preferences — request body — body Vendor And Purchases Prefs, Delete an attachable — request body — body, Create a recurring transaction — request body — body Bill, Delete a bill — request body — body, Void a billpayment — request body — body, Delete a budget — request body — body, Delete a change order — request body — body, Update a companycurrency — request body — body, Delete a creditcardpayment — request body — body, Delete a credit memo — request body — body, Delete a deposit — request body — body, Create a recurring transaction — request body — body Deposit, Delete an estimate — request body — body, Create a recurring transaction — request body — body Estimate, Update an exchangerate — request body — body, Update an inventory adjustment — request body — body, Delete an inventory adjustment — request body — body, Create a recurring transaction — request body — body Invoice, Void an invoice — request body — body, Update a category — request body — body, Create a recurring transaction — request body — body Journal Entry, Delete a journalentry — request body — body, Void a payment — request body — body, Create a recurring transaction — request body — body Purchase, Delete a purchase — request body — body, Delete a purchase order — request body — body, Delete a recurring transaction — request body — body, Delete a refund receipt — request body — body, Create a recurring transaction — request body — body Refund Receipt, Void a salesreceipt — request body — body, Create a recurring transaction — request body — body Sales Receipt, Delete a timeactivity object — request body — body, Create a recurring transaction — request body — body Transfer, Delete an transfer — request body — body, Delete a vendorcredit — request body — body, Create a recurring transaction — request body — body Vendor Credit

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.