Overview

  • Updated

Nova Module's TaxCloud SuiteApp connects TaxCloud's sales tax engine to NetSuite, so tax is calculated automatically and accurately on your transactions — no manual rate lookups required.

What It Does

FeatureWhat It Means for You
Tax CalculationClick Calculate with TaxCloud on a Sales Order, standalone Invoice, or standalone Cash Sale to get an accurate, jurisdiction-specific tax figure in real time.
Address VerificationTaxCloud validates the customer's shipping address and suggests corrections, so tax is always applied to the right jurisdiction.
Order CommitmentSaving a finalized Invoice or Cash Sale automatically commits the transaction to TaxCloud for remittance and reporting.
Tax ExemptionsExempt customers (nonprofits, resellers, etc.) can have a TaxCloud Exemption Certificate stored on their record. TaxCloud applies it automatically.
Refunds & CreditsCash Refunds and Credit Memos sync back to TaxCloud automatically, keeping your tax records accurate.
Full Audit LogEvery API call — calculation, commitment, refund — is logged on the transaction record, giving you a complete audit trail.

How to Calculate Tax on a Transaction

Applies to Sales Orders, standalone Invoices, and standalone Cash Sales:

  1. Open the record and enter the customer, shipping address, and line items.
  2. Set the Tax Code field to TaxCloud on each line item — this triggers the integration.
  3. Click Verify Address and accept any suggested corrections.
  4. Click Calculate with TaxCloud to see the calculated tax in the Tax Total field.
  5. Review and Save. Saving an Invoice or Cash Sale automatically commits the transaction to TaxCloud.
     

Note: If an Invoice or Cash Sale was created by converting a Sales Order, tax is already calculated and carried over — the Calculate with TaxCloud button won't appear, and there's nothing extra to do.

Processing a Refund or Credit

  1. Open the original Cash Sale and click Refund (or the original Invoice and click Credit).
  2. Review the auto-populated details — no need to re-enter line items or recalculate tax.
  3. Save. The refund syncs to TaxCloud automatically.

Handling Tax-Exempt Customers

  1. Open the customer record and add a verified shipping address (required by TaxCloud).
  2. Go to the TaxCloud tab, fill in Business Type and Exemption Reason, check Create TaxCloud Exemption, and Save.
  3. An Exemption Certificate ID is generated automatically.
  4. On future transactions, check Apply Tax Exemption to have TaxCloud apply zero or reduced tax.

Transaction-Level Controls

Found on the TaxCloud tab of each transaction; these apply per-transaction only:

 

CheckboxAvailable OnWhat It Does
Disable Tax CalculationSales Orders, Invoices, Cash SalesSkips TaxCloud tax calculation for this transaction.
Disable Tax OrderSales Orders, Invoices, Cash SalesCalculates tax but doesn't commit the order to TaxCloud.
Export Tax OrderSales Orders, Invoices, Cash SalesPushes a historical transaction to TaxCloud for backfill (no address verification performed).
TaxCloud Override TaxSales Orders, Invoices, Cash SalesLets you manually enter a tax amount, overriding the TaxCloud-calculated value.

Quick Troubleshooting

Tax isn't calculating — Confirm the Tax Code field is set to TaxCloud on every line item, the Enable toggle is on, and the shipping address is complete.

Tax amount looks wrong — Check the item's Taxability Information Code (TIC) and verify the shipping address/ZIP. Review the TaxCloud API Log on the transaction for exact request/response details.


Exemption isn't applying — Confirm the customer has a valid Exemption Certificate ID and that Apply Tax Exemption is checked at the time of calculation.


Test Connection failed — Re-check the Connection ID and API Key for extra spaces, and confirm Live vs. Test mode matches your environment.

Key Terms

  • TIC (Taxability Information Code): Tells TaxCloud what type of product/service an item is, for correct tax rules.
  • Cart: A tax preview created when you calculate tax; expires after 90 days.
  • Captured Order: The finalized order in TaxCloud, created when you save an Invoice or Cash Sale.
  • Exemption Certificate: TaxCloud's record certifying a customer is tax-exempt.
  • Backfill: Exporting historical transactions to TaxCloud via Export Tax Order.
  • Nexus: Managed in your TaxCloud account, not in NetSuite.