Net tax amount at Tax Authority level

The net tax amount shows at the tax authority level to report final tax impacts from coupons, rebates, and other related line adjustments without additional work.

Overview

Determination provides tax calculation results at both the line level and the tax authority level. For transactions that include related lines like coupons, rebates, and discounts, tax amounts may be distributed across multiple lines while still impacting the tax owed to individual authorities.
To support accurate tax reporting in these scenarios, Determination now includes a net tax amount at the Tax Authority level, which reflects the final tax impact after related lines have been applied.
This enhancement ensures that customers can report correct tax amounts per authority without performing additional post-calculation logic.

Use case: Coupons and rebates applied to multiple lines

A common transaction pattern is to send coupons or rebates as separate lines that reference one or more source lines. For example:
  • Line 1: Item A – $100
  • Line 2: Item B – $100
  • Line 3: Coupon – $-150, related to Line 1 ($-100) and Line 2 ($-50)
In this model:
  • Item lines calculate tax based on their gross amounts
  • The coupon line reduces the taxable amounts of the related item lines
  • The tax impact of the coupon needs to be reflected in the final tax owed to each authority
Previously, while Determination provided net tax amounts at the line level, customers didn’t receive a net tax amount at the tax authority level. As a result, downstream systems had to calculate the final authority tax amount by combining tax amounts from item lines and related coupon or rebate lines.

What has changed

Determination now returns a netTaxAmount within each tax authority block for a line item. This value represents the final tax amount for that authority after all related line adjustments have been applied.
The netTaxAmount includes:
  • Document-level tax amount
  • Authority-level tax amount
  • Unrounded equivalents for both values
note
XML Tax Block:
"netTaxAmount": { "documentAmount": "0.34", "unroundedDocumentAmount": "0.3400000000", "authorityAmount": "0.34", "unroundedAuthorityAmount": "0.3400000000" }
This aligns tax authority reporting with the net tax values already available at the line level.
With this enhancement:
  • Downstream systems no longer need to calculate tax authority amounts by reconciling item lines with related coupon or rebate lines
  • Tax authority-level reporting can rely directly on the netTaxAmount provided in the Determination response
  • Reporting accuracy is improved, particularly for jurisdictions where authority-level tax amounts are required for compliance
  • Integration logic is simplified, reducing the risk of miscalculation or inconsistent results
  • This change is especially relevant for customers using Determination as a source of truth for tax reporting systems, data warehouses, or third-party compliance solutions.

No change to request structure

This enhancement affects response data only. There are no changes to request payloads, transaction modeling, or how related lines are submitted to Determination.
Existing integrations continue to function as expected, with the added benefit of more complete tax authority-level results.