APSync Documentation

How shipping and tax are calculated

This page explains what the Shipping & Handling and Sales Tax lines on a HubSpot invoice actually are, what order they're calculated in, and why they sometimes don't appear right away. It describes what the system does today — not what it will eventually do. Shipping in particular is a placeholder, not a real carrier rate; see "What this is not, today" below.

What "subtotal" means here

In most order/invoicing systems (this one included), a subtotal is the total price of the actual products/services on the order — after any per-item discount or volume pricing has been applied, but before shipping and tax are added. The total is subtotal + shipping + tax. This app follows that same convention: everywhere "subtotal" is used below, it means the discounted merchandise total, not the undiscounted list-price total.

The order things happen in, today

  1. You add or edit line items on the invoice in HubSpot, then click Revise Invoice Now — see How to revise invoices using the preview sidebar.
  2. Any breakout kit lines get expanded into their real component lines, in HubSpot.
  3. Any line eligible for volume/quantity pricing gets corrected to its tiered price for that quantity — this is the step that makes the subtotal "discounted" rather than list-price.
  4. Shipping & Handling is added as a placeholder: 10% of the subtotal at this point in the process (so it reflects the already-discounted, tiered pricing from step 3), with a $10.95 minimum — whichever is higher. If the invoice's Free Shipping checkbox is set, this step still runs the same calculation, but the line is charged $0 instead — see "Free shipping" below.
  5. If volume pricing saved money on this pass, an informational "Volume Pricing Savings" note may also be added — it's always $0 and never changes any total, it's just a summary for the reader.
  6. Once you open the invoice, HubSpot's own native sync copies it to QuickBooks on its own — see How does sync work for how long that can take.
  7. QuickBooks calculates real sales tax, per line, based on the ship-to address's state and whether that specific line is taxable.
  8. The real tax amount comes back and is written to HubSpot as a Sales Tax line.

Because of steps 6–8, a Sales Tax line never appears while an invoice is still a draft, and it can take a few minutes to show up even after opening — that's expected, not a bug.

What is and isn't included in each number

Free shipping

Added 2026-08-04. Every invoice has a Free Shipping checkbox (an internal property, not something a customer sees named that way). It's off by default and has to be set manually — nothing detects a promotion or discount automatically. When it's checked, the Shipping & Handling line is never removed — it stays on the invoice, still showing the line-item name, but the charge is $0 and a note appears explaining what happened: the amount that would have been charged, struck through, followed by how much was saved. For example, a line that would have computed to $209.50 shows that figure struck through, with "you saved $209.50" next to it, rather than a $209.50 charge.

The checkbox isn't visible on the main invoice view today — it currently has to be added to a list view's columns to see or set it (a HubSpot record-layout limitation for this property type, not something specific to this feature). Setting it doesn't change anything else about the invoice — the merchandise subtotal and tax calculation are unaffected; only the shipping line's own charge and description change.

How QuickBooks decides tax by state

What this is not, today

Related reading