Tax Handling on Invoices
How tax line items on NetSuite invoices are mapped to SAC entries on the outbound 810.
Overview
When a NetSuite invoice includes tax line items, the Orderful SuiteApp automatically captures them and maps them to SAC (Service, Promotion, Allowance, or Charge) entries on the outbound 810. No configuration is required — tax lines are detected by item type and included automatically.
How Tax Lines Are Mapped
The SuiteApp identifies tax lines by their NetSuite item type (TaxItem). Each tax line on the invoice generates its own SAC entry with the following mapping:
| SAC Field | Value |
|---|---|
| Allowance or Charge Indicator | Charge |
| SAC Code | H850 (Tax) |
| Amount | Absolute value of the tax amount, expressed in cents (implied two-decimal format) |
| Unit of Measure | Pulled from the tax line's units field, if present |
| Handling Method | Off Invoice |
Tax amounts are taken from the foreignAmount field on the invoice line, which ensures the correct currency value is used for multi-currency invoices.
What Gets Included
The SuiteApp includes any line item classified as TaxItem in NetSuite. This covers:
- Standard sales tax
- State and local tax
- VAT (Value Added Tax)
- Any other tax type that NetSuite applies as a
TaxItemline
All tax lines use the same SAC code (H850). If an invoice has multiple tax lines (e.g., state tax and local tax), each generates a separate SAC entry.
Where Tax Lines Appear on the 810
Tax amounts appear only in the SAC loop of the 810. They are excluded from the IT1 (line item detail) loop, which contains only inventory and physical product lines.
The SAC loop on an 810 can contain a mix of discount, shipping, and tax entries. The order is:
- Discount SAC entries (one per discount line, or consolidated if enabled)
- Shipping SAC entry (aggregated across all shipping lines)
- Tax SAC entries (one per tax line)
Related SAC Codes
The SuiteApp uses H850 (Tax) for all tax lines. For reference, the EDI standard defines additional tax-specific SAC codes that may be relevant for certain trading partner requirements:
| Code | Description |
|---|---|
H850 | Tax (used by the SuiteApp) |
H750 | Tax — Sales Tax, State and Local |
H770 | Tax — State Tax |
H800 | Tax — Value Added Tax (VAT) |
Note: The SuiteApp maps all tax lines toH850regardless of tax type. If a trading partner requires a more specific tax SAC code (e.g.,H750for state/local tax), contact Orderful support to discuss configuration options.
Troubleshooting
| Issue | Possible Cause | Resolution |
|---|---|---|
| Tax not appearing on 810 | The invoice does not have tax line items | Verify that tax is applied to the invoice in NetSuite |
| Tax not appearing on 810 | Tax lines are not classified as TaxItem | Check the item type of the tax lines on the invoice |
| Incorrect tax amount | Multi-currency rounding | Verify the foreignAmount value on the tax line matches expectations |
| Multiple tax SAC entries when expecting one | Invoice has multiple tax lines (e.g., state + local) | Each tax line generates a separate SAC entry — this is expected behavior |
What's Next
- SAC Loop Documentation — Full SAC mapping reference for discounts, shipping, and tax
- Invoicing Orders — General 810 invoice generation and configuration
- 810 Invoice — 810 transaction field mapping reference
Updated about 5 hours ago