---
title: Configure the NetSuite Integration
url: https://docs.maxio.com/accounting/general-ledger-integrations/netsuite/configuration/configure-the-netsuite-integration
applies_to: Maxio Core
updated: 2026-11-13
---

# Configure the NetSuite Integration

Control how Maxio exchanges data with NetSuite by configuring sync schedules, item behavior, and record mappings. These settings determine which customers, invoices, payments, and refunds are sent or received, and help align NetSuite data with your Maxio workflows.

> Complete this after connecting a Maxio Platform account to NetSuite. If your account isn't connected yet, follow <a href="https://docs.maxio.com/accounting/general-ledger-integrations/netsuite/setup/setup-the-netsuite-integration" target="_blank" rel="noopener noreferrer">Setup the NetSuite Integration</a> first.

## Configure sync

The integration between NetSuite and Maxio Platform allows for many different options for syncing between the two platforms. Some of the first options to edit and troubleshoot will be in the **Update Settings** section of the NetSuite Integration.

This can be found in **NetSuite** > **Integration Settings** > **Update Settings**.

![NetSuite settings form covering sync schedule, item naming, tax, date filters, bank account and deposit mapping, each with help text](https://docs.maxio.com/content-images/accounting/general-ledger-integrations/netsuite/configuration/configure-the-netsuite-integration/29632206694669_ex_UpdateNetSuiteSettings_02.png)

*Update Settings options for syncing preferences*

| Setting | Description |
| :--- | :--- |
| Sync Schedule | Choose from one of four times for Maxio Platform to automatically sync with NetSuite.<ul><li><strong>Manual Sync Only</strong> - Requires the Sync button to be manually pressed for any action to take place. This is the <em>default</em> setting.</li><li><strong>Nightly Sync</strong> - An automatic sync occurs once every night.</li><li><strong>Every 4 Hours Sync</strong> - An automatic sync occurs once every four hours.</li><li><strong>Hourly Sync</strong> - An automatic sync occurs once every hour.</li></ul> |
| Automatically Generate Maxio Profiles for Items | Creates Maxio Platform profiles for items in the NetSuite. This will be based on the default Maxio Platform settings within the Admin item presets. |
| Automatically Generate Transactions After Sync | Enabling this will execute the Transactions step as part of the integration. Transaction will be created based on NetSuite if the items are configured to do so. |
| Prepend Parent Item Name | Adds the parent item name from NetSuite to improve uniqueness amongst items of the same name. |
| Append Item Internal ID | Adds the item internal ID from NetSuite to improve uniqueness amongst items of the same name. |
| Send Invoice Sales Tax As | Select an item to represent the sales tax in NetSuite.<br>If left *blank*, any invoice with sales tax will not sync to NetSuite. |
| Default NetSuite Tax Schedule | Select a default tax schedule to be assigned when creating new items. |
| Sync Invoices From NetSuite Only After Date | Sets a date that will sync all future invoices into Maxio Platform. |
| Sync Credit Memos From NetSuite Only After Date | Sets a date that will sync all future credit memos into Maxio Platform. |
| Sync Payments From NetSuite Only After Date | Sets a date that will sync all future payments into Maxio Platform. |
| Sync Refunds From NetSuite Only After Date | Sets a date that will sync all future refunds into Maxio Platform. |
| Sync Test Data to NetSuite | Check ONLY if testing Maxio Platform to NetSuite payment/deposit sync. |
| Bank Deposit Account | Typically, this is the Bank Account into which your Transfers are made. Chart of Accounts are listed in alphabetical order.<br>This option is visible only if **Send Deposits** is enabled. |
| Credit Card and ACH Fee Account | Select the account to receive debits for payment processing fees. Chart of Accounts are listed in alphabetical order.<br>This option is visible only if **Send Deposits** is enabled. |
| Unassociated Payments Account | Select the account for which payments that cannot be associated with an Invoice (that is, receivable) will be credited. Chart of Accounts are listed in alphabetical order.<br>This option is visible only if **Send Deposits** is enabled. |
| Map Number for Sent Deposits | Enable to map the Maxio Platform Deposit number to the NetSuite Deposit number.<br>This option is visible only if **Send Deposits** is enabled. Keep disabled if the NetSuite configuration disallows the use of a Deposit number. |
| Consolidate Deposit Fee Lines | Combines deposit fee line items into a single line when sending deposits to NetSuite.<br>This option is visible only if **Send Deposits** is enabled. |
| Timezone of NetSuite User | Select the timezone assigned to the Maxio Platform User created during setup. You can locate this setting on the User Preferences page within NetSuite. This helps ensure that the integration pulls in the correct records. |
| Send Non-Paying Customers | Determines whether non-paying Customers (not the Paying Customer) will be sent to NetSuite.<ul><li><strong>Checked (enabled)</strong> - All Customers (regardless of whether they are a Paying Customer or not) are synced to NetSuite. This is the <em>default</em> setting.</li><li><strong>Unchecked</strong> - Only Paying Customers are synced to NetSuite. For example, you may not want to send "Free Trialing" customers to NetSuite until they become Paying Customers.</li></ul> |
| Send Zero Amount Invoices | Determines whether Invoices whose line items all have an amount of zero will be sent to NetSuite.<ul><li><strong>Checked (enabled)</strong> - All Invoices are synced to NetSuite (if set to sync). This is the <em>default</em> setting.</li><li><strong>Unchecked</strong> - Only Invoices with at least one Line Item that is not 0 (zero) amount are synced to NetSuite.</li></ul> |
| Do Not Send Empty Addresses | Controls what happens when a billing or shipping address is *blank* in Maxio Platform.<ul><li><strong>Checked</strong> - The blank address is left out of the sync entirely, so any existing address already in NetSuite stays untouched.</li><li><strong>Unchecked</strong> - The blank address is still sent to NetSuite, which clears out any existing address value there. This is the <em>default</em> setting.</li></ul> |
| Continue On Error | Controls what happens if a NetSuite sync error occurs during a run.<ul><li><strong>Checked (enabled)</strong> - Logs the error, skips the record, and continues through all remaining steps instead of stopping.</li><li><strong>Unchecked</strong> - A sync error stops the current sync step and prevents any later steps in that run from executing, except when NetSuite can't list its currencies and Maxio already has stored currencies to use. This is the <em>default</em> setting.</li></ul>See <a href="https://docs.maxio.com/accounting/general-ledger-integrations/netsuite/troubleshooting/troubleshooting-and-faqs" target="_blank" rel="noopener noreferrer">Troubleshooting and FAQs</a> for more on this behavior. |

### Sync test data

From **NetSuite** > **Integration Settings** > **Update Settings**, enable the **Sync Test Data to NetSuite** option to sync Test payments from Maxio Platform to NetSuite. *Only check this box if you are **testing** the Maxio Platform to NetSuite payment/deposit sync.*

### Clear sync dates

This action clears the date of the last synchronization for *all* NetSuite sync steps.

> **WARNING:** This action cannot be undone. It also forces the next sync to become a full, unfiltered re-sync across every step instead of an incremental one, which can take significantly longer for accounts with a large volume of records.

![NetSuite integration header with a Clear Sync Dates tooltip over one of its icons](https://docs.maxio.com/content-images/accounting/general-ledger-integrations/netsuite/configuration/configure-the-netsuite-integration/29632206758285_ac_ClearSyncDates.png)
