An invoice's AppliedAmount comes back negative (-80.00 for an invoice paid 80.00), so BalanceRemaining is the total plus AppliedAmount, not minus

Observed 2026-10-09 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.

QuickBooks answers an invoice's AppliedAmount as a negative number: an invoice of 80.00 paid in full answers <AppliedAmount>-80.00</AppliedAmount>. Its BalanceRemaining is therefore (Subtotal + SalesTaxTotal) + AppliedAmount. Intuit's reference gives the formula with a minus sign, which with the sign QuickBooks uses would give 160.00 instead of 0.00.

An InvoiceQueryRq for the paid invoice answered (reduced to the amounts):

qbXML
<InvoiceRet>
<TxnID>4F4E-1791591367</TxnID>
<RefNumber>INV-0004</RefNumber>
<Subtotal>80.00</Subtotal>
<SalesTaxTotal>0.00</SalesTaxTotal>
<AppliedAmount>-80.00</AppliedAmount>
<BalanceRemaining>0.00</BalanceRemaining>
<IsPaid>true</IsPaid>
</InvoiceRet>

Credits count the same way. An invoice of 189.97 with a 9.99 credit memo and a 30.00 payment applied answered AppliedAmount -39.99 and BalanceRemaining 149.98. An invoice with nothing applied answers 0.00, not -0.00. An invoice's LinkedTxns carry the same sign: a 40.00 payment and a 12.50 credit memo applied to one invoice were listed with <Amount>-40.00</Amount> and <Amount>-12.50</Amount>.

The payment's own side stays positive. The answer to the 80.00 payment had an AppliedToTxnRet with <Amount>80.00</Amount> and <BalanceRemaining>0.00</BalanceRemaining>.

What to do

Read an invoice's AppliedAmount as the negative of what has been paid and credited, and take its absolute value if you show it to users. If you need the balance, read BalanceRemaining rather than working it out from Intuit's formula. Expect the same negative sign on the Amount of an invoice's LinkedTxns, and a positive one on a payment's AppliedToTxnRet.

Not observed

  • Whether a DiscountAmount on a payment counts in AppliedAmount.
  • Statement charges and bills, which have no AppliedAmount of their own.

QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.