Set up Peoplevox Integration

1. Add Peoplevox as an integration in DHL Express Commerce

There are some overall required settings for using DHL Express Commerce with Peoplevox.

1. In your DHL Express Commerce account, go to Settings, then select Integrations
2. Click Add a new integration, and select Peoplevox from the list
3. Enter a display name for your integration (e.g. Peoplevox)
4. Select the region where your Peoplevox instance is sited from the options presented (this will reflect in the URL used to access your Peoplevox instance, e.g. https://ap.peoplevox.net/abc1234/ ):
   • Americas (US)
   • Asia Pacific (AP)
   • Europe (WMS)

You can also choose from where DHL Express Commerce picks up the following fields when importing from Peoplevox (in most cases you set these to one of the attributes 1-5 on the sales order in Peoplevox, depending upon your particular Peoplevox setup). This applies for orders imported at both allocate stock and despatch time.

1. Company name
2. Building
3. Phone number
4. Currency code
5. Delivery instructions

2. Set up an optional subscription to receive orders at stock allocation time

Receive orders at the time of inventory allocation in Peoplevox (this is optional, but means you have an earlier chance to correct invalid addresses).

1. Enter the Client Id, Username and Password that you use to log in to Peoplevox.
2. Enter Requested Delivery Date, after which orders will import from Peoplevox (based on the stock allocation time event there)
   • This prevents historical orders from being imported, so simply set to a recent date
3. Click Save.
4. Click Test to ensure it works. You'll see Successful at the page bottom, if the connection works.
5. To enable orders to be sent over from Peoplevox when you allocate stock to them, click Subscribe.

3. Auto Generate Labels

DHL Express Commerce can auto-generate labels for orders when they are despatched in Peoplevox. The correct product code needs to be assigned to Peoplevox orders by default or using by DHL Express Commerce rules. To set this up:

1. In your DHL Express Commerce account, go to Settings, then select Couriers.
2. Click on Settings next to DHL Express.
3. Set the correct default product code.
4. (Optional) Use Rules to assign a product code based on different criteria. Settings > Rules

4. Set up 'Carrier Integration' access in Peoplevox

Receive order detail at the time of despatch in Peoplevox, so you can print labels and return them and their tracking numbers to Peoplevox.

1. Log into your Peoplevox account.
2. In the top-right of the screen, change the view to Integration.
3. In the header, select Carrier Integration.
   (Note: If this is not visible / enabled, please log a ticket with Peoplevox Technical Support to request this - additional charges may apply).
4. Click Add New (or if you already have a previous DHL Express Commerce integration, you can just change the Api key ONLY in this set of steps, as one integration is sufficient).
5. Set Name as 'DEC'.
6. Set Date time format as dd/MM/yyyy hh:mm:ss.
7. Set Timeout (ms) as 30000.
8. Copy and paste the Api key from your DHL Express Commerce account's Settings > Platforms > Peoplevox page.
   1. If you haven't used Api keys in DHL Express Commerce before, then you may not have the full Api key (i.e. 123456;), you will need the full Api key (i.e. 123456;99999a999999999a9a9a999aaa99a9a9).
   2. In this case, first go to Settings > API and click the Generate button.
   3. When you return to the Peoplevox settings page, you'll see the full Api key populated.
9. Copy and paste the Endpoint.
10. Set Tracking number format as {returns}/{outbound}.
11. Click Save.

5. Set up DespatchPackage or Returns print templates in Peoplevox

1. Log in to your Peoplevox account.
2. Change the view to Setup (via dropdown at top-right of page).
3. Select Print Templates.
4. Select Label type as DespatchPackage (for outgoing labels and outgoing commercial invoices) or Returns (for returns labels and returns commercial invoices)
5. Click Search.
6. Click on your chosen template.
7. Set Registered template name as Outgoing label, Commercial invoice, Returns label or Returns commercial invoice (leave Carrier connection).
8. Click Save.

6. Select the print templates in the carrier connection in Peoplevox

1. Go back to the previously set up carrier integration via 3.2 and 3.3, above.
2. Click on it and then Edit
3. In the Document Types section at the bottom of the pop-up, set a Name and Reference and select one of the Print Templates created under section 4, above.
   • The Name can be set to whatever you like, but you could just use the same text as the Reference (below).
   • You must set the Reference as one of the following, depending upon the Document Type to be retrieved from DHL Express Commerce:
     • Outbound label
     • Commercial invoice
     • Returns label
     • Returns commercial invoice
   • Initially, just set up the Outbound label Document Type, and test that it works, before proceeding with any further one.
4. Click Save.

7. Label generation failures

On despatch of an order in Peoplevox, if the order still has an invalid address (and hasn't yet been corrected in DHL Express Commerce), the labels and tracking numbers will not be generated in DHL Express Commerce.

Peoplevox will then output a failover label which will let you know which order has failed label generation.

In this case, correct the address in DHL Express commerce and reprint in Peoplevox, by finding the despatch, clicking Print and clicking the Print button next to the package.