Bonton Account Integration

Bonton Account Integration

Overview

Bonton is an online retailer offering a wide range of items, including women's, men's, and kids’ apparel & accessories, furniture, jewelry, and more. Integrating Bonton into your Sellercloud account allows you to seamlessly import orders, upload tracking information, and ensure your listings are always up-to-date with the latest inventory data. This integration works through API, transmitting information between the two services via plugins and Scheduled Tasks. The communication is facilitated through DSCO, a third-party platform. If necessary, open a ticket with Sellercloud Support to request additional customizations or other plugins for this integration. Note that these customizations are billable, and you will be provided a quote.

DSCO may require testing before you can go into production. To have a dedicated representative complete the testing for your account and ensure that the setup is configured correctly, opt in for Premium Support.

Prerequisites

Before you can integrate Bonton into Sellercloud, complete the following requirements.

We recommend creating a Company where you will set up the Custom Company Settings and Scheduled Tasks for this integration.

Sellercloud imports DSCO orders as Website. Due to this, we generally do not recommend more than one plugin integration per company, as it may be difficult to differentiate orders coming in from multiple sales channels.

Alternatively, you can use the Plugin Wizard to simplify the setup of Channel Plugin Integrations through Scheduled Tasks. The wizard guides you through the required steps and helps you create:

Once configured, you can manage all integrations created through the wizard on the Manage Plugin Channels page. The workflow outlined below describes the manual configuration process, which does not create a plugin channel on the Manage Plugin Channels page.

DSCO Support

Contact DSCO Support to request your:

Send an email to support@dsco.io titled 'Create Client Credentials.' In the email, include the name and ID of the DSCO account and the user name with which the client credentials will be associated. When ready, DSCO’s support team will send the client credentials to you. Be sure to store them securely. To get a Warehouse Supplier code, you must set up a warehouse in DSCO.

  1. Contact the DSCO Integrations team and log into your DSCO account.
  2. Click CONNECTING: Step 1 and continue through the onboarding and testing processes. You choose the Warehouse Supplier Code during the onboarding process. You can create it on your Warehouse Manager page in the DSCO portal.

You will use these credentials and Warehouse Codes to populate the Custom Company Settings outlined below.

Sellercloud Support

Open a ticket with Sellercloud Support and request that the following plugins be installed on your server:

Company Settings

Create the following Custom Company Settings on the company created for the integration.

The Client Setting Enable Custom Company Settings must be enabled for this workflow. To enable the setting, navigate to Settings > Client Settings > General Client Settings > UI.

Custom Company Settings for old accounts without Stream API

Custom Company Settings for new accounts with Stream API

Optional Custom Company Settings

Custom Order Columns

Create the following Custom Order Columns:

Custom Product Columns

Create the following Custom Product Columns:

Optional Custom Product Columns

Order Import

The Order Import plugin:

As of version 1.0.1.5, the plugin supports both the Stream API and the old method to get orders. The only differences are a few custom settings and credentials. The old method will continue to be used by default, where only DSCO_Token is required, as long as the Stream API settings don't exist or aren't populated. If you need to reset the date, use the following DSCO_StreamPosition:

Automate Order Import

To create a Scheduled Task that regularly imports orders into Sellercloud:

  1. Navigate to Settings > Scheduled Tasks > Manage Scheduled Tasks.
  2. Click the green + icon: Create New Scheduled Task.
  3. Complete as follows:
    1. Click Task Type and select Import Orders.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
  4. Click Create, and the new scheduled task will load on your screen.
  5. Click the Edit button in the top right corner.
  6. In the Details panel:
    1. Under Create Orders for Company, select your DSCO company.
    2. Click the Plugin menu and select DSCO API v3 Order Import.
  7. In the Import Options panel, set Import From to None.
  8. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
  9. In the General panel, click the Enable toggle button.
  10. Click Save.

Tracking Export

This plugin sends tracking information to DSCO via API. Before you move on, create a Saved Search for orders filtered by:

Automate Tracking Export

To create a Scheduled Task that regularly exports order tracking from Sellercloud:

  1. Navigate to Settings > Scheduled Tasks > Manage Scheduled Tasks.
  2. Click the green + icon: Create New Scheduled Task.
  3. Complete as follows:
    1. Click Task Type and select Export Orders.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
  4. Click Create, and the new scheduled task will load on your screen.
  5. Click the Edit button in the top right corner.
  6. In the Details panel:
    1. Click the User ID menu and select your ID.
    2. Click the Saved Search menu and select the saved search you created earlier.
    3. Click the Export Via menu and select DSCO API v3 Tracking Order Export.
    4. Check This Is Tracking Export.
  7. In the Export Options panel, set Export To to None.
  8. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
  9. In the General panel, click the Enable toggle button.
  10. Click Save.

Invoice Export

This plugin creates an invoice on DSCO via API. It also saves the InvoiceID to a custom column.

The plugin can also process Split Orders. Make sure the Saved Search only includes the parent order and that all the child orders are Fully Shipped. Contact Sellercloud Support for assistance.

Before you move on, create a Saved Search for orders filtered by:

Automate Invoice Export

To create a Scheduled Task that regularly exports invoices from Sellercloud:

Inventory Export

This plugin exports inventory to DSCO using API. However, note:

Prices are not included in inventory export updates.

Before you move on, create a Saved Search for products filtered by:

Also, make sure to enable your products for Bonton by setting their Bonton_Enabled Custom Column for Products to True: