SuiteTax Gets Line-Level Nexus Determination and Automated Tax on Term Discounts
SuiteTax now resolves nexus per item line based on line-level location instead of header-only, and can automatically generate credit memos for tax adjustments on term discounts for sales transactions.
NetSuite 2026.1 delivers two notable SuiteTax changes that affect how tax is calculated on transactions and how term-discount adjustments are handled. This release note also lists several Brazil, Chile, and Philippines localization enhancements — those are covered only at summary level here because Oracle provides no technical detail beyond feature names.
Line-Level Location in SuiteTax
Previously, SuiteTax nexus determination used only the header-level location on a transaction. Starting in 2026.1, the engine now evaluates the location field on each item line (the Location subtab column) when determining nexus. Shipping address and entity tax registration are still factors, but line-level location takes precedence when populated.
Key constraint: single-nexus validation
All item lines on a transaction must resolve to the same nexus. If lines point to locations in different nexuses, the transaction will fail validation — you must split them into separate transactions. This is enforced on both create and update operations.
Oracle references a "Single Nexus Validation on Transactions" help topic for the full rule set, but does not detail the exact precedence order among line location, shipping address, and entity registration. Verify the precedence in your sandbox before relying on it for multi-location fulfillment scenarios.
What this means for integrations
- Any SuiteScript, CSV import, or REST/SOAP integration that creates or updates transactions with item lines should be reviewed. If you set
locationat the line level, nexus determination behavior changes immediately upon 2026.1 rollout. - If your integration creates transactions with items shipping from multiple warehouses (different nexuses), those transactions will now fail validation unless split.
- The
locationfield on item sublist lines is not new, but its tax significance is. Existing scripts that set it for inventory/fulfillment purposes may now inadvertently affect tax nexus.
Tax on Term Discounts in SuiteTax
When a customer takes an early-payment term discount on a sales invoice, the discount reduces the amount owed — but the associated tax adjustment previously required manual calculation and a manual credit memo. In 2026.1, SuiteTax can automatically generate a credit memo covering both the discount amount and the corresponding tax adjustment.
Configuration
- Accounting Preference: Enable Create Adjustment Transactions for Term Discounts (Setup > Accounting > Accounting Preferences). This triggers automatic credit memo creation when a term discount is applied during payment.
- Nexus-Level Preference: Enable Include Tax for Term Discounts on each relevant nexus record if you want the credit memo to include the tax portion — not just the discount itself.
- Role Permissions: Any role that records payments with term discounts needs:
- Edit-level access to the Tax Details tab.
- The Create Credit Memo Transaction permission.
If you do not enable the nexus-level preference, the system still creates an adjustment transaction for the discount amount only — tax remains unadjusted, preserving the legacy behavior.
Brazil, Chile, and Philippines Localization (Summary)
The release note lists several localization features with no technical detail beyond their names:
- Brazil: Certification Tax Authorities Enhancement, Localization Enhancements, Brazilian Hub Enhancement, Custom Transaction for Tax Payments, SuiteTax Latam Engine – Brazil Records Enhancements (listed twice under both SuiteTax and Legacy Tax sections).
- Chile: Chile Localization Now Available.
- Philippines: Advanced Intercompany Journal Entries in Philippine Tax Audit Files.
Oracle provides no field-level, record-level, or API-level detail for any of these. If you operate in these jurisdictions, check the individual help topics linked from the full release notes or test in sandbox after 2026.1 rolls out.
What to do
- Audit scripts and integrations that set line-level
location. Any transaction-creation code (SuiteScript, SuiteTalk SOAP/REST, CSV imports) that populates item-line locations may now change nexus determination. Search your codebase for sublist field sets onlocationwithin transaction records. - Test multi-location transactions in sandbox. If you ship from multiple warehouses on a single order, confirm that all lines resolve to the same nexus — or build logic to split transactions before submission.
- Enable term-discount tax automation if applicable. Turn on both preferences (accounting-level and nexus-level), grant the two required permissions to relevant roles, and verify credit memo output against your current manual process in sandbox.
- Review role permissions. The new Credit Memo auto-generation requires explicit Create Credit Memo Transaction permission. Roles that previously only recorded payments may now need this added.
- LATAM / APAC localization: If you use Brazil, Chile, or Philippines tax features, monitor Oracle's detailed help topics post-release for specifics on record and field changes.
Source: Oracle NetSuite Release Notes