Marketplace Connector
Customer Support
Contact Support

Peoplevox <> Descartes Marketplace Connector Integration

Introduction

The procedures detailed in this article can be used to:

  • Connect your Peoplevox™ installation to Descartes® Marketplace Connector

  • Display the Peoplevox <> Descartes Marketplace Connector configuration page

  • Set up Shipping Service Types

  • Set up email alerts for application errors and warnings

  • Synchronize Catalog, Product and Order data

  • Define Catalog and Order attributes

  • Map Sites (warehouses) between Peoplevox and Shopify/Descartes Marketplace Connector

  • Set Return Reasons

  • Subscribe to Event Subscriptions.


Note: See also Peoplevox: Monitoring Errors, Warnings and Integration Activities.


Connecting Peoplevox Installation to Descartes Marketplace Connector

To connect your Peoplevox installation to Descartes Marketplace Connector:

  1. In Descartes Marketplace Connector, go to Settings > eCommerce Integrations > Create eCommerce Integrations.


  2. Enter a Name for the integration.

  3. On the Type dropdown, select Peoplevox™ to display the General page.


  4. Enter the Client ID. This is the unique identifier for Peoplevox customers (for example, SW1234). Emphasizing the region is not required.

  5. Enter the API Base Url.

  6. The Username and Password should already be filled in. The user specified must have Admin permissions. If needed, edit those fields.

  7. Click Test Connection to verify the connection.

  8. Click Save Integration.


Displaying the Configuration Page for Peoplevox <> Descartes Marketplace Connector Integration

To display the configuration page for the Peoplevox <> Descartes Marketplace Connector integration:

  1. Go to Settings > eCommerce Integrations > eCommerce Integrations.


  2. Click the Peoplevox line item (identified in the Integration Type column) to display the configuration page for Peoplevox <> Descartes Marketplace Connector.


The information in the General area was entered while Connecting the Peoplevox Installation to Descartes Marketplace Connector. This information can be modified in the General area.


Setting Shipping Service Types for Peoplevox <> Descartes Marketplace Connector Integration

Note: For easier navigation, open the Shopify and Peoplevox integrations on separate tabs. You can switch between integrations by editing the integration ID in the URL (for example, change from 1 to 2).

To set the Shipping Service Types for your Peoplevox <> Descartes Marketplace Connector integration:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Shipping Service Types area, which lists the Marketplace Connector Shipping Services.

  3. As needed, select the Peoplevox Shipping Service corresponding to each Marketplace Connector Shipping Service. If preferred, click Auto Generate Services (below the grid) to select the PeopleVox Shipping Services that correspond logically to the Marketplace Connector Shipping Services.

  4. Click Save Integration (bottom of page).


Example:

  1. Shopify tells Descartes Marketplace Connector that the shipping service is Free Delivery (Dispatched Within 2-4 Working Days).

  2. Descartes Marketplace Connector assigns TPSN as the shipping service.

  3. When Descartes Marketplace Connector passes the order to Peoplevox, it maps TPSN to Pro Carrier: Royal Mail Tracked 48 No Signature.

  4. End Result: PVX sees Royal Mail Tracked 48 No Signature.

Tip: Descartes Marketplace Connector uses internal service names to bridge the integration with Peoplevox. This functionality can help you manage the setup effectively.


Peoplevox: Setting up Email Alerts for Errors and Warnings

To set up email alerts for errors and warnings that may occur in your Peoplevox <> Descartes Marketplace Connector installation:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Alerts area.


  3. On the Level dropdown, choose to receive email alerts for Errors and Warnings, Only Errors, or Only Warnings. (To not send email alerts, select No Emails.)

  4. In Emails To, enter the email addresses to receive the email alerts. Separate each email address with a comma. Type each email address or click the Emails To field and then select each email address.

  5. Click Save Integration (bottom of screen)


Peoplevox: Synchronizing Orders and Catalog Data with Descartes Marketplace Connector

To synchronize Order and Catalog data between Peoplevox and Descartes Marketplace Connector:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Orders area.


  3. Click Sync Orders.

  4. To schedule the automatic synchronization of Orders, select an option on the Orders Sync Frequency dropdown. To disable them, select -disabled- (top of dropdown).

  5. If the Order has a different name than the main contact's name, check the Sync Shipping Name as Contact Name checkbox. Please note this will become automatic (with no need to select a check box) in an upcoming release (January 2025) of Descartes Marketplace Connector.

  6. To synchronize a single Order, enter its Marketplace Connector Order ID into the Sync Single Order field, and then click Sync.

  7. You can choose to skip specific tagged Orders during Peoplevox <> Descartes Marketplace Connector synchronizations. Click the Ignore Order Tags field, select individual Tags or Select All, and then click Apply.

  8. If a Product is tagged, the same Product listed as an Order line item can be skipped during Peoplevox <> Descartes Marketplace Connector synchronizations. Click the Ignore Line Item Product Tags field, select the Product Tag(s) (or Select All), and then click Apply.

  9. Scroll to the Catalog area.


  10. Click Sync Products.

  11. To schedule the automatic synchronization of Products, select an option on the Products Sync Frequency dropdown. To disable them, select -disabled- (top of dropdown).

  12. To synchronize a single Product, enter its Marketplace Connector Product ID into the Sync Single Order field, and then click Sync.

  13. On the Product Name Format dropdown, select the type of Product information to be displayed in the Catalog: Only Name or Name and SKU.

  14. If needed, adjust the Product Description Length to set the maximum number characters (up to 800) in the Catalog's Product Description field.

  15. Click Save Integration (bottom of page).


Peoplevox: Setting Catalog and Order Attributes

To set Catalog and Order attributes for Peoplevox <> Descartes Marketplace Connector:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Catalog Attributes area.


  3. Configure Catalog Attributes by selecting its Type: Custom Field or Product Detail. Select its Value. Please note:

    • Any custom fields must be created.

    • The Product Details Values available for selection include various Product information, such as Cost, Product image, Country of origin, Product manufacturer, and others.

    • Up to 15 Catalog Attributes can be configured.

  4. Scroll to the Order Attributes area. Configure an Order Attribute by selecting its Type and a corresponding Value. Up to five Order Attributes can be configured.


  5. Scroll to the Order Detail Attributes area. Configure an Order Detail Attribute by selecting its Type and a corresponding Value. Up to three Order Attributes can be configured.



Mapping Sites (Warehouses) between Peoplevox and Shopify/Descartes Marketplace Connector

Warning: Avoid modifying Sites configuration without proper knowledge.

To map Sites (Warehouses) between Peoplevox and Shopify/Descartes Marketplace Connector:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Sites area. The Sites (warehouses) listed on the Marketplace Connector Warehouses dropdowns come from Shopify. To map a Peoplevox warehouse to a Marketplace Connector/Shopify warehouse, select a warehouse on the corresponding Marketplace Connector Warehouse dropdown.


  3. If the Marketplace Connector/Shopify warehouse you want to map to a Peoplevox warehouse is not on the Marketplace Connector Warehouses dropdowns, you may add it if you know the exact name of the Shopify warehouse. Click Add Warehouse, enter the Shopify Warehouse Name, and then click Submit. The new warehouse is now available on the Marketplace Connector Warehouses dropdowns.

Warning: If you have multiple stores feeding into Peoplevox, ensure there are no duplicate SKUs or duplicate barcodes across the products entered via integration. Failing to perform this check could cause other integrations to malfunction, if the data is updated to other values.


Peoplevox: Setting Return Reasons

To set Return Reasons for Peoplevox <> Descartes Marketplace Connector integration:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Return Reasons area.


  3. As needed, select the Marketplace Connector Return Reason that corresponds to each Peoplevox Return Reason. To generate Marketplace Connector Return Reasons that correspond logically to the Peoplevox Return Reasons, click Auto Generate Reasons.

  4. Click Save Integration.


Peoplevox: Subscribing to Events

To subscribe to an Event:

  1. Display the configuration page for Peoplevox <> Descartes Marketplace Connector integration.

  2. Scroll to the Event Subscriptions area.


  3. Click the plus-sign button to display the Event Description dialog.


  4. Select the Event.

  5. Select a Site Filter, and then click Subscribe.

  6. Add the Webhooks to the integration. The PS team may have to assist in setting this up. These fields are now pre-populated. Ensure they point to the correct store, warehouse, etc. Typically, the only changes needed are in the filters, unless you set up a multi-store environment.

  7. Click Save Integration (bottom of page).

Back to Top