Overview

• The steps below will guide you through integrating your NetSuite platform account with DHL Express Commerce.
• Once completed, your orders will be imported into DHL Express Commerce, and when you print a label, the tracking information will be written back.

How it works

You will be creating web service access in NetSuite for DHL Express Commerce and then entering the authentication details in DHL Express Commerce.

1. Enabling the Token-based Authentication Feature in NetSuite

1. Go to Setup > Company > Enable Features.
2. Click the SuiteCloud subtab.
3. In the SuiteScript section, check the following boxes:
   • Client SuiteScript
   • Server SuiteScript
4. Scroll to Manage Authentication section.
5. Check TOKEN-BASED AUTHENTICATION box.
6. Click Save.

2. Setting Up Token-based Authentication Roles in NetSuite

1. Go to Setup > Users/Roles > Manage Roles > New.
2. Enter DHL Express Commerce Integration Role in Name field.
3. Check WEB SERVICES ONLY ROLE box in Authentication section.
4. Click the Permissions subtab.
   1. Add Permissions for Transactions:
      • Find Transactions (Full Level)
      • Fulfill Orders (Full Level)
      • Item Fulfillment (Full Level)
      • Sales Order (Full Level)
   2. Add Permissions for Lists:
      • Items (Full Level)
      • Currency (Full Level)
   3. Add Permissions for Setup:
      • User Access Tokens (Full Level)
      • Soap Web Services (Full Level)
5. Click Save.

3. Assigning Users to Token-based Authentication Roles in NetSuite

1. Go to Setup > Users/Roles > Manage Users.
2. Choose an Administrator user, then select Edit.
3. Click the Access subtab.
4. Add DHL Express Commerce Integration Role into the Roles
5. Click Add.
6. Click Save.

4. Creating Applications for Token-based Authentication in NetSuite

1. Go to Setup > Integration > Manage Integrations > New.
2. Enter DHL Express Commerce TBA in Name field.
3. Check the USER CREDENTIALS box on the Authentication subtab.
4. Check the TOKEN-BASED AUTHENTICATION box on the Authentication subtab.
5. Click Save.
6. The confirmation page will display the Consumer Key and Consumer Secret for this integration, so please note them down for later use.

5. Creating and Assigning a TBA Token in NetSuite

1. Go to Setup > Users/Roles > Access Tokens > New.
2. On the Access Tokens page, click New Access Token.
3. Select DHL Express Commerce TBA as the Application Name
4. Select the User that you assign DHL Express Commerce Integration Role with previously.
5. Select DHL Express Commerce Integration Role as the Role
6. Click Save.
7. The confirmation page will display the Token ID and Token Secret, so please note them down for later use.

6. Obtaining Web Service Account ID in NetSuite

1. Go to Setup > Integration > Web Services Preferences.
2. Note down ACCOUNT ID value for later use.

7. Entering NetSuite Integration Details in DHL Express Commerce

1. Log into DHL Express Commerce.
2. Go to Settings > Integrations.
3. Click Add a new integration.
4. Click NetSuite.
5. Tick Enable NetSuite.
6. Enter the Web Service Account ID.
7. Select Token-Based as the Authentication Method.
8. Enter Consumer Key.
9. Enter Consumer Secret.
10. Enter Token ID.
11. Enter Token Secret.
12. Click Save.
13. Click Test to ensure it works to check the integration connection.

Import Custom Fields

The following information can be imported from NetSuite to DHL Express Commerce when the values are stored in custom fields with designated script ids:

• Delivery Instructions - custbody_delivery_instructions (Text Custom Field)
• Authority To Leave - custbody_authority_to_leave (Boolean Custom Field)
• Signature Required - custbody_signature_required (Boolean Custom Field)

Troubleshooting

The NetSuite API limits each NetSuite user to a single API connection based on the user's login credentials. This can cause DHL Express Commerce that use a NetSuite connection to fail with the following errors if other calls are made to the NetSuite API using the same credentials:

• Only one request may be made against a session at a time
• The operation has timed out

If the error occurred while updating your NetSuite orders, then DHL Express Commerce will try to update these orders again in a scheduled fashion to ensure the orders are being updated in NetSuite.

Alternatively, you can purchase concurrent connection licenses from NetSuite which will permit simultaneous requests from the same user account.

For temporary testing purposes, you can point DHL Express Commerce to your NetSuite sandbox environment by appending the sandbox Id to to your Web Service Account Id, e.g. '1234567_SB1' (this has '_SB1' appended).