Common Errors, Their Resolution & FAQs

Common Errors & Their Resolution

Error message	Cause	Resolution
“You must enter at least one line item”	Product SKUs don’t match the NetSuite field set in inventory settings.	Fix the SKU mapping under Inventory Settings so SKUs match NetSuite item identifiers.
“Does not have the required permissions to access [list]”	The connection role lacks permissions.	Add the missing permissions (see Required User Role Permissions).
“Do not have permissions to set a value for element entityid”	Entity IDs are auto-generated in NetSuite but not flagged in the plugin.	Customer Settings → enable Is NetSuite Customer Entity ID auto generated?
“Invalid item reference key [****] for subsidiary [####]”	Item and customer are in different subsidiaries.	Assign the customer and items to the same subsidiary in NetSuite.
“Please enter value(s) for: [****]”	A mandatory NetSuite field is empty.	Populate it using Conditional Mapping.
“Cannot create transactions with Stackable Promotions when SuitePromotions disabled”	SuitePromotions is off.	Enable Setup → Company → Enable Features → Transactions → Sales → SuitePromotions.
“Promotion Codes feature not enabled”	Promotion Codes is off.	Enable Setup → Company → Enable Features → Transactions → Sales → Promotion Codes.
“PHP SOAP extension is not enabled”	Server missing SOAP.	Ask your host to enable the PHP SOAP extension.
Product/customer import does nothing	REST Web Services not enabled, or the role lacks REST permission.	Confirm REST Web Services is enabled in NetSuite and the connecting role has REST Web Services (Full); re-test the connection in General Settings.

---

Frequently Asked Questions

Does the NetSuite integration sync in real time? Orders and customers sync as they happen (in the background). Inventory, prices, products, and customer imports run on a schedule, or instantly via the manual buttons.

Will it create duplicate orders or customers in NetSuite? No. Each record is tagged with its NetSuite ID, and the plugin searches for existing customers (by email and/or company name) before creating new ones.

Can I sync WooCommerce customers to NetSuite as companies? Yes — send all customers as companies, or only those whose billing address has a company name.

Can I import products and customers from NetSuite into WooCommerce? Yes. Both run over your existing NetSuite REST Web Services connection — no RESTlet/SuiteScript deployment is required — with field mapping and a schedule.

Does it support multiple warehouses / locations? Yes — All Location, Default Location, or Selected Location.

Is it compatible with WooCommerce HPOS? Yes.

Where are my NetSuite credentials stored? Encrypted in your WordPress database — never in plain text.

What if my server doesn’t have SOAP enabled? The plugin warns you and pauses NetSuite features until SOAP is enabled; your site keeps working.

---

Still need help? Open the Help & Support tab inside the plugin or contact TechMarbles.