--- title: "0.21 NetSuite SuiteApp Release" slug: "0-21-0-netsuite-suiteapp-release" updated: 2026-11-18T18:19:18Z published: 2026-11-18T18:19:18Z canonical: "help.servicetitan.com/0-21-0-netsuite-suiteapp-release" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt > Use this file to discover all available pages before exploring further. # 0.21 NetSuite SuiteApp Release Review the new features, improvements, and fixes in version 0.21 of the ServiceTitan SuiteApp for NetSuite. This version changed how ServiceTitan refunds are recorded in NetSuite and added a way to write refund checks in bulk. Updates are listed newest first. > [!NOTE] > **Note:** To check your SuiteApp version, in NetSuite go to the **SuiteApps** menu, search **ServiceTitan**, select the ServiceTitan SuiteApp, and review **Current Version**. **In this release:** [0.21.6](/construction/docs/0-21-0-netsuite-suiteapp-release#v0216) · [0.21.2](/construction/docs/0-21-0-netsuite-suiteapp-release#v0212) · [0.21.1](/construction/docs/0-21-0-netsuite-suiteapp-release#v0211) · [0.21.0](/construction/docs/0-21-0-netsuite-suiteapp-release#v0210) ## 0.21.6 This release focuses on Write Refund Checks, with a smoother workflow, more data carried through to NetSuite, and a more accurate confirmation dialog. It also includes reliability fixes for accounts with non-standard NetSuite configurations. ### Enhancements - Enhancement**Trace refund checks to their refunds.** Each row in the Refund Checks grid now shows its NetSuite refund ID. - Enhancement**Tax Code carries through to refund checks.** Tax Code now fills in automatically on refund check expense lines. On SuiteTax accounts, where it doesn't apply, the field is disabled. - Enhancement**A confirmation dialog you can trust.** The confirmation dialog now shows the correct customer name and includes the Tax Code, so what you see is what gets written. - Enhancement**Clearer refund check errors.** When a refund check can't be created, the error now explains what went wrong instead of showing a generic failure. - Enhancement**Department, class, and location on refund checks.** Refund checks now carry department, class, and location on both the header and the expense lines, matching other synced transactions. - Enhancement**Business unit mapping respects NetSuite Locations.** Business unit to location mapping now follows whether the NetSuite Locations feature is turned on. A general preferences setting lets accounts opt in or out. ### Fixes - Fix**Business Unit Mapping screen works on more accounts.** The Business Unit Mapping screen now loads correctly on NetSuite accounts with configurations where it previously didn't. - Fix**Chained negative adjustment invoices sync.** A negative adjustment invoice based on another negative adjustment now syncs. Previously, it failed because the original had already synced as a credit memo. - Fix**No more false "failed" runs.** The dashboard no longer reports a successful run as failed when two runs start back to back, such as clicking **Execute** right as the hourly scheduled sync begins. - Fix**Account Mapping saves reliably.** Accounts with many account mappings could time out when saving the Account Mapping screen. Saving is now faster. If a save can't complete, you see a clear message instead of a system error. --- ## 0.21.2 This release improves how invoices, discounts, refunds, and journal entries sync between ServiceTitan and NetSuite, and adds a safety net for in-progress journal entries that could previously be left behind. ### Update - Update**Refund status follows the payment type:** A refund's status is now determined by its payment type, rather than by the type of GL account behind the payment. ### Enhancements - Enhancement**Fewer stuck journal entries.** A new check picks up in-progress journal entries that the regular sync would otherwise miss. - Enhancement**Empty journal entries handled cleanly.** Journal entries with no lines, including ones that never synced before, are now handled without creating error rows in NetSuite. After an empty journal entry is zeroed out in NetSuite, its status in ServiceTitan correctly changes to **Synced**. - Enhancement**Journal entry counts on the dashboard.** The Journal Entry row on the integration dashboard now shows a record count instead of *Unknown*. - Enhancement**More complete diagnostic exports.** Diagnostic exports now include more logs, so ServiceTitan Support can troubleshoot issues faster. ### Fixes - Fix**Discounts apply correctly.** Discount items sometimes synced to NetSuite as positive amounts, which inflated the invoice total. They now apply as negative amounts. - Fix**Adjustment invoices link to the right job.** The NetSuite transaction for an adjustment invoice is now linked to the job, so it keeps its work order context. - Fix**Re-bills to a different customer sync correctly.** Adjustment invoices billed to a different customer, such as a financing company, are now routed to that customer instead of staying with the original. When the customers don't match, the credit memo is created on its own instead of failing. - Fix**Execute button behaves as expected.** The loading indicator now appears reliably when you click **Execute** on the integration dashboard. Double-clicking **Execute** no longer starts duplicate sync runs. --- ## 0.21.1 This release includes a reliability fix for tenant records. ### Fixes - Fix**Tenant records save without a cutoff date.** Tenant records no longer fail to save when the **Integration Data Cutoff Date/Time** field is blank. --- ## 0.21.0 This is a larger release that changes how ServiceTitan refunds are recorded in NetSuite and adds a new way to write refund checks in bulk. > [!WARNING] > **Before you upgrade:** > > - Turn on the **Custom Transactions** feature in NetSuite. Installation fails if this feature is off. > - This release changes how refunds are recorded in NetSuite. Review the refund changes below with your accounting team before you upgrade. > - Users who write refund checks need a NetSuite role with access to the ServiceTitan Refund transaction and **View** permission for **Custom Transaction Types** on the **Setup** tab. ### New - New**ServiceTitan Refund transaction:** Refunds (negative payments) from ServiceTitan now sync to a new **ServiceTitan Refund** transaction in NetSuite. Each refund shows one of three statuses: **Credit Card Refunded**, **Pending Refund**, or **Check Refunded**. This covers refunds on an already-paid invoice, refunds paired with a credit memo, and refunds of a customer deposit. - New**Write Refund Checks:** Review pending ServiceTitan refunds and create checks for them in bulk. Filter by date, choose the bank account, and confirm before checks are written. To open it, go to the SuiteApp menu and select **Write Refund Checks**. ### Update - Update**Choose the field used to link existing customers:** You can now name the ServiceTitan custom field that holds each customer's NetSuite internal ID. The integration uses that field to link customers before it tries its standard matching. If you leave the setting blank, the integration ignores it. Previously, a field named Legacy ID was always used, which could cause errors or incorrect links for accounts that used that field for something else. ### Enhancements - Enhancement**Original transactions sync first.** Invoices and payments now sync before credit memos and refunds, so the original record already exists in NetSuite when the related transaction is applied. - Enhancement**Better customer merge and multi-subsidiary handling.** Customer sync now detects inactive and merged customers more reliably and handles customers assigned to multiple subsidiaries in OneWorld accounts. Alternate phone numbers now sync too. - Enhancement**Long memos no longer block a sync.** Memos longer than NetSuite's 999-character limit are now shortened with an ellipsis on invoices, payments, journal entries, inventory transactions, and purchase orders. - Enhancement**ServiceTitan reference number on purchase transactions.** Purchase transactions now include a **ServiceTitan Ref Num** field. - Enhancement**Cleaner tenant record.** The last-modified date fields for purchase orders, payments, jobs, and customers moved to a new **Last Modified Dates** subtab on the tenant record. - Enhancement**Ready for NetSuite 2026.1.** The SuiteApp is updated to stay compatible with NetSuite release 2026.1. Sync notification emails now come from a servicetitan.com address. ### Fixes - Fix**In-progress journal entries sync.** Journal entries that were in progress are no longer skipped during sync. - Fix**Payment applications stay within the open balance.** A payment application is now limited to the invoice's open balance in NetSuite, so it can't over-apply. - Fix**Tenant settings update between runs.** Changes to tenant record settings now take effect on the next run instead of appearing to be ignored. - Fix**More reliable connection to ServiceTitan.** Fixed an issue that could interrupt the SuiteApp's connection to ServiceTitan.