Skip to content

QuickBooks: Create a bill — request body — body Txn Tax Detail Tax Line item Tax Line Detail

Create a bill: request body, field body / TxnTaxDetail / TaxLine / item / TaxLineDetail. Complete fields and constraints for contract 2026-10-20.

API reference · Contract 2026-10-20

SDK schema: Create a bill — request body — body Txn Tax Detail Tax Line item Tax Line Detail

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
NetAmountTaxableJSONOptionalThis is the taxable amount on the total of the applicable tax rates. If TaxRate is applicable on two lines, this attribute represents the total of the two lines for which this rate is applied. This is different from the Line.Amount , which represents the final tax amount after the tax has been applied. Default Value: Null
Decimal string
NetAmountTaxable (anyOf 1)numberAlternative
NetAmountTaxable (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
OverrideDeltaAmountJSONOptionalThe difference between the actual tax and the overridden amount supplied by the user.
Decimal string
OverrideDeltaAmount (anyOf 1)numberAlternative
OverrideDeltaAmount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
PercentBasedJSONOptionalTrue —sales tax rate is expressed as a percentage. False —sales tax rate is expressed as a number amount.
PercentBased (anyOf 1)booleanAlternative
PercentBased (anyOf 2)stringAlternativeOne of: true, false
TaxInclusiveAmountJSONOptionalThis is the total amount, including tax.
Decimal string
TaxInclusiveAmount (anyOf 1)numberAlternative
TaxInclusiveAmount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
TaxPercentJSONOptionalNumerical expression of the sales tax percent. For example, use “8.5” not “0.085”.
Decimal string
TaxPercent (anyOf 1)numberAlternative
TaxPercent (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?$
TaxRateRefModelRequired within parentExpand Create a purchase order — request body — body Ship To
Reference to a TaxRate to apply to the entire transaction. Query the TaxRate name list resource to determine the appropriate TaxRage object for this reference. Use TaxRate.Id and TaxRate.Name from that object for TaxRateRef.value and TaxRateRef.name , respectively. For non-US versions of QuickBooks, the TaxRate referenced here must also be one of the rates in the referenced tax code’s rate list—either the SalesTaxRateList or the PurchaseTaxRateList—as applies to the transaction type. Any given rate may only be listed once.

Referenced models: Create a purchase order — request body — body Ship To

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.