Skip to main content
If NetSuite is where your items are created and maintained, connecting it means your passports start from the same data your business runs on.

Why connect NetSuite

  • No retyping. Item names, codes, barcodes, sizes, colours and weights come straight from your ERP.
  • Material weights from bills of materials. LUXIMA can read an item’s BOM and turn it into the weight of each material.
  • Work orders at print stations. With label printing, operators can find what to print by work order number.

What you need

  • The Enterprise plan.
  • The Owner or Admin role in LUXIMA.
  • A NetSuite administrator to do the NetSuite side.
  • In NetSuite, these features switched on under Setup > Company > Enable Features > SuiteCloud: REST Web Services, OAuth 2.0, and Client Credentials (Machine to Machine) Grant.
  • A NetSuite user and a view-only role that can read items. We recommend a dedicated integration user.
LUXIMA connects with a certificate, not a password, and only reads from NetSuite.
In the NetSuite panel, click Download setup guide (PDF) for a version of these steps to send to your NetSuite administrator.

Connect

1

Generate a certificate in LUXIMA

Go to Integrations. On the NetSuite card, click Set up NetSuite, then Generate certificate.Click Download PEM (or Copy certificate) straight away. The public certificate is shown only once.
2

Create an integration record in NetSuite

In NetSuite, go to Setup > Integration > Manage Integrations > New.
  • Set the state to Enabled.
  • Tick Client Credentials (Machine to Machine) Grant.
  • Untick Token-Based Authentication.
Save, and copy the Client ID (consumer key). NetSuite shows it only once.
3

Upload the certificate in NetSuite

Go to Setup > Integration > OAuth 2.0 Client Credentials (M2M) Setup > New.Choose the user (entity), the role and the integration record you just created, and upload the PEM file. Save, and copy the Certificate ID.
4

Enter the values in LUXIMA

Back in LUXIMA, under NetSuite setup values, fill in:Click Save setup.
5

Test the connection

Click Test connection. LUXIMA requests access and reads one item. It never writes to NetSuite.When you see “Read-only connection verified”, NetSuite is ready.
NetSuite can be used in import workflows only after the test has passed.

Import your NetSuite items

Click Import on the NetSuite row, then Import with a workflow. NetSuite is added as a source in an import workflow.

What NetSuite brings in

Item name and display name, item code, barcode (UPC), description, class, department, weight, and your account’s custom item fields. A matrix item becomes one product, and its child items become the variants. Left out to start with, though you can still tick them: services, charges, discounts, kits, non-inventory items, and components of other items.

Check the field mapping

In the NetSuite step of the workflow, click Check fields to see which NetSuite field feeds which LUXIMA field. Change one if a value lands in the wrong place, then click Use these fields. You can map NetSuite fields to: product name, SKU / item code, GTIN / barcode, size, colour, category, department, description, HS code, season, country of origin, weight and composition.

Material weights from BOMs

After you have imported NetSuite items, open Settings on the NetSuite row and find BOM material weights.
1

Fetch

Click Fetch BOM materials. LUXIMA reads the bills of materials for your imported items, 25 products at a time.
2

Review

Check the counts: products checked, components, matched materials and those that need review.
3

Import

Click Import material weights to write the matched weights into the products’ composition.

Work orders

If you use label printing, LUXIMA copies your NetSuite work orders from the last 30 days automatically, so operators at a print station can search by work order number. There is nothing to set up.

Renew the certificate

The certificate is valid for 365 days. The NetSuite row shows the date it expires.
1

Rotate

In the NetSuite panel, click Rotate certificate and download the new PEM.
2

Update NetSuite

Upload the new PEM in NetSuite’s M2M setup and copy the new Certificate ID.
3

Save and test

Enter the new Certificate ID in LUXIMA, click Save setup, then Test connection.
Rotating replaces the stored key at once. Imports from NetSuite stop working until you finish the steps in NetSuite and the test passes again.

Remove the connection

Click Forget credentials in the NetSuite panel. Products you already imported stay in your catalogue. To remove the products an import created, find that import under Recent imports and click the bin icon. This deletes the products that import created. It does not touch NetSuite.

Messages you might see