Logs, Common Errors and Troubleshooting, FAQs

Logs

Open Logs. Three tabs let you review every sync:

• Customer & Order Sync — e.g. Order add, Customer update with Object ID.
• Product Sync — bulk operation steps (process to JSONL, upload to Shopify, bulk mutation) with Bulk Operation ID.
• Inventory Sync — quantity and price sync steps with Bulk Operation ID.

Each row shows Log ID, Created Date, Operation, Status (Success / Failed / In Progress), and Message. Filter by All / Success / Failed, search, Refresh, or Clear Logs. An Active Webhooks panel shows the live webhooks driving real-time sync.

Example failed message: “Order is either fulfilled or cancelled on NetSuite” — the order can no longer be updated from Shopify.

---

Common Errors & Troubleshooting

Message / symptom	Cause	Resolution
“Order is either fulfilled or cancelled on NetSuite”	The order is locked in NetSuite.	No action needed; the order can’t be updated once fulfilled/cancelled in NetSuite.
“A bulk mutation operation for this app and shop is already in progress”	A previous Shopify bulk operation hasn’t finished.	Wait for the running bulk job to complete, then retry; avoid overlapping manual syncs.
Products/inventory not updating	Product sync disabled, wrong checkbox field, or SKU/field mismatch.	Confirm Enable Product Sync, the NetSuite checkbox field, and your field mappings; run Test Sync.
Prices wrong for a region	Market/catalog price mapping missing.	Map the Shop Market / Company Catalog to the correct NetSuite currency and price level.
Duplicate customers in NetSuite	Existing record not matched.	Enable phone-based search and email/email-domain matching.
Connection shows disconnected	Token/permission issue.	Re-authenticate under Configurations → NetSuite API Connection; verify the role’s web-services permissions.

---

Frequently Asked Questions

Does the Shopify NetSuite integration sync both ways? Yes. Orders, customers, and refunds flow to NetSuite; inventory, prices, products, customers, refunds, and fulfillment flow back to Shopify.

Does it support Shopify Markets and B2B? Yes. You can map Shopify Markets and B2B Company Catalogs to NetSuite currencies and price levels, and sync customers as companies.

Can it sync Shopify POS orders? Yes — POS orders can be created in NetSuite as Sales Orders or Invoices.

Can orders become Purchase Orders in NetSuite? Yes — globally, or only for customers with a specific tag or metafield (great for drop-ship/B2B).

How does it handle large catalogs? Product and inventory sync use Shopify bulk operations for high-volume performance; orders and customers sync via webhooks in near real time.

Can I prevent overselling? Yes — set an inventory quantity buffer to hold back reserve stock.

How do I connect to NetSuite? Through the in-app Configurations flow using NetSuite Token-Based Authentication.

Is there support if I need help? Yes — TechMarbles provides hands-on onboarding and support, including help videos and the option to schedule a meeting.

---

Need help? Use More Actions → Help Video in the app, check this documentation, or contact TechMarbles to schedule a meeting.