Skip to content

North America

Tax handling for United States and Canada.

Multi-Tax Support

North American jurisdictions often require multiple taxes per line item (e.g., state + county + city taxes, or GST + PST in Canada).

Multi taxtypescript
// title: Multi-tax (US/Canada)
const invoice = await sdk.invoices.create({
  customer: { name: "US Client", country: "US", state: "CA" },
  items: [
    {
      name: "Software License",
      quantity: 1,
      price: 1000,
      taxes: [
        { name: "State Tax", rate: 7.25 },
        { name: "County Tax", rate: 1.0 },
      ],
    },
  ],
});

Each line item can have multiple taxes applied, each calculated and displayed separately on the invoice.

Use Cases

United States

  • State sales tax
  • County tax
  • City/local tax
  • Special district tax

Canada

  • GST (Federal)
  • PST (Provincial)
  • HST (Harmonized - some provinces)
  • QST (Quebec)