# Set up NetSuite with Starshipit WMS
URL: https://support.starshipit.com/articles/14700000000058-set-up-netsuite-with-starshipit-wms
Canonical: https://support.starshipit.com/articles/14700000000058-set-up-netsuite-with-starshipit-wms
Markdown: https://support.starshipit.com/articles/14700000000058-set-up-netsuite-with-starshipit-wms.md
Updated: 2026-08-21

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Link NetSuite products to Starshipit WMS and configure automatic or manual inventory reconciliation for one NetSuite location.

Connect NetSuite through Starshipit, link eligible products to Starshipit WMS, and reconcile account-wide WMS on-hand inventory to one NetSuite location.

## Before you begin

You need:

* A NetSuite integration connected and enabled in the same Starshipit account as WMS.
* Token-based authentication configured for the Starshipit NetSuite integration. User-credential authentication is not supported for WMS inventory reconciliation.
* A NetSuite role that can use REST web services, read inventory items and location quantities, and create inventory adjustments for the selected location and account.
* **Disable writeback** turned off in the Starshipit NetSuite integration settings.
* Permission to manage products and commerce settings in WMS. Client-scoped users cannot configure or run account-wide NetSuite reconciliation.
* The internal IDs for the NetSuite location, inventory adjustment account, and subsidiary when one is required.
* Unique, non-empty WMS SKUs that match the NetSuite SKU field selected in Starshipit: **Item ID** or **UPC Code**.

If NetSuite is not connected yet, [connect NetSuite to Starshipit](/articles/213384326-connect-netsuite-to-starshipit) first.

:::important
Decide whether WMS or another system owns inventory before enabling writeback. NetSuite reconciliation sets the selected location to the account-wide WMS on-hand quantity and can create an inventory adjustment in NetSuite.
:::

Batch- and serial-tracked WMS products are not supported. Use products with **Standard** as their tracking type.

## Prepare the Starshipit NetSuite integration

1. In Starshipit, go to **Settings > Integrations** and open **NetSuite**.
2. Confirm **Enable NetSuite** is turned on.
3. Select **Token-Based** as the authentication method and confirm the account ID, consumer key, consumer secret, token ID, and token secret are saved.
4. Confirm the selected item SKU field matches the values stored as WMS SKUs.
5. Turn off **Disable writeback**.
6. Select **Test to ensure it works**, then save the integration.

The NetSuite token role must also be able to create inventory adjustments. Test this permission with one controlled reconciliation before enabling automatic writeback.

## Configure NetSuite inventory in WMS

1. In WMS, go to **System > Settings > Direct Integrations**.
2. Find **NetSuite Inventory**, select **Verify connection**, and confirm the **Connected** status appears.
3. Enter the **NetSuite location ID** and a **Location name**. You can select a suggested ID when WMS finds one in the returned inventory data.
4. Enter the **Subsidiary ID** when the selected NetSuite account and location require one.
5. Enter the **Inventory adjustment account ID**.
6. Turn on **Enable integration**.
7. Leave **Automatic writeback** off while you link and test products.
8. Select **Save settings**.

| Setting | What it does |
| --- | --- |
| **NetSuite location ID** | Selects the one NetSuite location that receives inventory reconciliation for this WMS account. |
| **Location name** | Adds a display name for the mapped location in WMS. It does not change NetSuite. |
| **Subsidiary ID** | Identifies the NetSuite subsidiary used on inventory adjustments when one is required. |
| **Inventory adjustment account ID** | Identifies the NetSuite account used for inventory-adjustment transactions. |
| **Enable integration** | Allows product linking and manual reconciliation. |
| **Automatic writeback** | Queues reconciliation after supported manual adjustments and stocktake corrections. |

**Verify connection** confirms that WMS can read NetSuite products through the Starshipit integration. It does not create an inventory adjustment or confirm write permission.

## Link WMS products to NetSuite

WMS links products by exact SKU before it can reconcile their inventory.

1. In **System > Settings > Direct Integrations**, find **NetSuite Inventory**.
2. Under **Product links**, select **Find exact SKU matches**.
3. Review each WMS SKU, product name, and matching NetSuite inventory item ID.
4. Select the **Confirm links** button to save the displayed matches. The button includes the number of links that will be saved.
5. Select **Find next matches** when more eligible products remain.

A product is offered only when:

* It is visible in WMS and uses **Standard** as its tracking type.
* Its normalised SKU is unique in the WMS account.
* Exactly one NetSuite inventory item has the same SKU.
* It does not already have a NetSuite product link.

WMS saves the NetSuite inventory item ID as the product's external identity. Correct duplicate or mismatched SKUs before trying to link the product again.

## Understand NetSuite reconciliation

WMS compares the product's total on-hand quantity across the WMS account with the quantity at the mapped NetSuite location. It then creates only the inventory adjustment needed to make NetSuite match WMS. No adjustment is created when the quantities already match.

Manual reconciliation can be run at any time for linked products. Automatic reconciliation is limited to manual WMS inventory adjustments and posted stocktake corrections.

Receipts, picks, packing, shipments, and internal WMS transfers do not trigger automatic NetSuite reconciliation. Shipment inventory remains managed by the existing Starshipit-to-NetSuite fulfilment and tracking-writeback flow.

Reconciliation runs in the background. The WMS stock movement is not rolled back if NetSuite rejects an update. Review the final outcome in **System > Process Logs**.

## Reconcile inventory manually

Use manual reconciliation during setup, after a stocktake, or when WMS and NetSuite inventory have drifted.

1. Go to **Inventory** in WMS.
2. Select between 1 and 50 NetSuite-linked products.
3. Select **Reconcile to NetSuite**.
4. Select **Preview reconciliation**.
5. Review the WMS quantity, NetSuite quantity, proposed change, and status for each product.
6. Select the **Queue reconciliations** button for the products marked ready. The button includes the number of updates that will be queued.
7. Go to **System > Process Logs** and confirm the queued updates completed.
8. Check the mapped NetSuite location and confirm its quantity matches the WMS on-hand quantity.

Products that are already in sync are not queued. Products that are unsupported, unlinked, or no longer available at the mapped NetSuite location must be corrected before they can be reconciled.

## Enable automatic writeback

Enable automatic writeback only after a controlled manual reconciliation succeeds.

1. Go to **System > Settings > Direct Integrations**.
2. Find **NetSuite Inventory**.
3. Turn on **Automatic writeback**.
4. Select **Save settings**.
5. Complete a small manual inventory adjustment or post a stocktake correction for a linked test product.
6. Confirm **System > Process Logs** shows a successful NetSuite reconciliation.
7. Check the mapped NetSuite location and confirm the final quantity matches WMS.

## Verify the integration

1. Choose one untracked product with a unique SKU and known quantities in WMS and NetSuite.
2. Link the product under **NetSuite Inventory**.
3. Run a manual reconciliation from **Inventory**.
4. Confirm the process log shows a successful result.
5. Confirm the mapped NetSuite location now matches the account-wide WMS on-hand quantity.
6. Enable automatic writeback only if WMS should continue reconciling manual adjustments and stocktake corrections.

## Troubleshooting

| Problem | What to check |
| --- | --- |
| **NetSuite Inventory** does not appear | Confirm NetSuite is enabled in the same Starshipit account and that you have permission to manage products and commerce settings. Client-scoped access is not supported. |
| **Verify connection** fails | Confirm the Starshipit integration uses token-based authentication and the token role can use REST web services and read inventory items. Retest the connection in Starshipit. |
| No location IDs are suggested | Confirm the token role can read item location quantities and that NetSuite inventory items have quantities at the intended location. You can enter the internal location ID manually. |
| **Enable integration** cannot be saved | Enter both the **NetSuite location ID** and **Inventory adjustment account ID**. Add a subsidiary ID when NetSuite requires one. |
| No product matches are found | Confirm the WMS SKU is unique, uses the configured NetSuite **Item ID** or **UPC Code**, and belongs to a visible, untracked WMS product. |
| A product shows as unsupported | Batch- and serial-tracked products cannot use this integration. |
| A product shows as not linked or stale | Confirm the WMS SKU still exactly matches the configured NetSuite SKU field and that the inventory item exists at the mapped location. Correct the SKU or location, then preview again. Contact support if the saved item link must be replaced. |
| Reconciliation is rejected | Confirm **Disable writeback** is off in Starshipit and the NetSuite role can create inventory adjustments using the selected location, adjustment account, and subsidiary. |
| Automatic writeback does not run | Confirm the integration and **Automatic writeback** are enabled, the product is linked, and the event was a manual inventory adjustment or posted stocktake correction. |
| A receipt, pick, shipment, or transfer does not trigger reconciliation | This is expected. These movements are excluded from automatic NetSuite reconciliation. Shipment inventory uses the existing Starshipit fulfilment flow. |
| A queued update has no final result | Check **System > Process Logs** for a completed, retrying, or rejected NetSuite inventory update. |

If the problem continues, contact [Starshipit support](https://help.starshipit.com) with the WMS account, affected SKU, NetSuite inventory item ID, mapped location ID, and approximate time of the reconciliation.

## Related articles

* [Understand WMS integrations](/articles/14700000000044-understand-wms-integrations)
* [Connect NetSuite to Starshipit](/articles/213384326-connect-netsuite-to-starshipit)
* [View inventory and stock levels](/articles/14700000000014-view-inventory-and-stock-levels)
* [Adjust stock and investigate stock movements](/articles/14700000000020-adjust-stock-and-investigate-stock-movements)
* [Run stocktakes and cycle counts](/articles/14700000000015-run-stocktakes-and-cycle-counts)