---
updatedAt: 2026-09-14T13:39:59.000Z
agentTools:
  projectIndex: https://support.zoey.com/llms.txt
---

# Products - Import from NetSuite

# NetSuite to Zoey Product Import

<Image src="https://files.readme.io/741444e-image.png" align="center" width="80% " />

* **Import Product Data from NetSuite**<br />When set to Yes, products will be synced from NetSuite to Zoey.
* **Enable Automatic Product Import**<br />When enabled, product data will be synced from NetSuite to Zoey twice an hour.
* **NetSuite Product ID Attribute**<br />Select the Zoey Product Attribute that will contain the internal NetSuite ID for each product.
* **NetSuite Product Type Attribute**<br />Select the Zoey Product Attribute that will contain the NetSuite Product Type.
* **Import Product Status from NetSuite**<br />When set to Yes, Zoey products can be enabled or disabled based on the products data in NetSuite.
  * **NetSuite Item Status Source**<br />This is NetSuite Item field used to determine Zoey Product Status. This field must be a boolean. `isInactive (boolean)` is normally used.
  * **Zoey Product is Disabled when...**<br />Specify when the Zoey Product should be disabled based on the status source value.

## Bundled Products with NetSuite

Bundled products are synced to the NetSuite Sales Order as a single item through the parent SKU. The parent bundle product will be matched to a NetSuite item but not the individual items in the bundle.

***

# Inventory Settings

* **Import Product Inventory from NetSuite**<br />When set to Yes product inventory will be synced from NetSuite
  * **Prevent Inventory Sync Attribute**<br />Select a  Zoey Yes/No attribute to be used as a flag to prevent syncing inventory from NetSuite. When this attribute is set to Yes on a product, its inventory will not be synced from NetSuite.
* **Allow Inventory Import from Different Item**<br />When enabled, specify the attribute to use for a separate NetSuite Item ID to sync inventory. If this attribute is set on a Zoey Product it will sync inventory from the specified Item instead of the Item the Product is linked to.
  * **Different Inventory Item Attribute**<br />The Zoey product attribute that will be used to indicate to import inventory from a different Item.
* **Quantity Field for Inventory**<br />Select the NetSuite field to pull Inventory from. This let's you whether `quantityOnHand` or `quantityAvailable` is used to update the product inventory in Zoey.
* **Limit Inventory to Specific Locations**<br />Only specified Inventory Locations will be used to calculate available inventory.
  * **Locations**<br />Only the selected locations will be used for calculating product inventory.
* **Enable Location Mapping**<br />When set to Yes, you can then map NetSuite Locations to Zoey Inventory Locations.

<Callout icon="📘" theme="info">
  Don't see an option that you're expecting? Go to **Record Caching** and click on **Refresh Record Cache**.
</Callout>

***

# Price Settings

* **Import Prices**<br />When set to Yes, price information will be imported from NetSuite
  * **Import Customer Group Prices**<br />When set to Yes, Customer Group prices will be imported based on the NetSuite Price Levels, unless Use Product Pricing Groups is set to Yes.
  * **Multi-Currency Support**<br />Set to Yes if your NetSuite environment uses multiple currencies.
    <Callout icon="📘" theme="info">
      ### The NetSuite API Role used for this Integration must have Permission `Lists > Currency` with a level of View to use this feature.
    </Callout>
  * **Import Tier Prices**<br />When set to Yes, Tier Prices for order item amounts will be imported from NetSuite.
    * **Import Tier Prices for ALL GROUPS**<br />When set to Yes, Tier Price information will always be imported for All Customer Groups instead of per Customer Group Price Level.
  * **Import Product Cost from NetSuite**<br />When set to Yes, product costs will be imported from NetSuite.
  * **Price Import Logic**<br />Set the logic for importing prices from NetSuite:
    1. Highest Price Level
    2. Lowest Price Level
    3. First Price Level
    4. Specific Price Level
       <Callout icon="📘" theme="info">
         When using Specific Price Level, you can select the NetSuite Price Level to import.
       </Callout>

***

# Product Import Field Mapper

* **Zoey Field**<br />Select the Zoey field you want to sync with a field in NetSuite.
* **NetSuite Field**<br />Select the NetSuite field to map to the field you selected for the Zoey Field.
* **Additional Field** *(Button)*<br />Add as many additional Product field mappings as needed.

<Image src="https://files.readme.io/3eb6bdc-image.png" align="center" width="80% " border={true} />

### Import Product Images from NetSuite

The `storeDisplayImage (RecordRef)` field can be mapped from NetSuite to the Zoey `Base Image (image | 85)` to import the product's image into Zoey.

<Image src="https://files.readme.io/e698b55c761829280293dad5e3d8360d7962e2dd18213e5e2beb34e25b9d858b-image.png" align="center" border={true} />

<Callout icon="🚧" theme="warn">
  **Commas** and **Parentheses** in the image file's name will prevent it from being imported to Zoey.
</Callout>

***

### Bulk Actions > Sync Data From NetSuite

Bulk sync Product data from NetSuite manually.

To manually sync selected products from NetSuite, go to Products, select the products you want to update, and choose Bulk Actions > Sync Data From NetSuite.

This will update the selected Zoey products using the current NetSuite product import settings and field mappings. Existing Zoey values may be overwritten for fields configured to import from NetSuite.

<br />