Connect Duoplane to a BigCommerce vendor store

If you are a vendor who is also a BigCommerce merchant, you can connect your BigCommerce account with your Duoplane vendor portal to automatically receive new purchase orders into BigCommerce, send tracking back to Duoplane, and sync inventory.

Requirements for the BigCommerce vendor integration

In order for this integration to work, you (the vendor receiving orders from Duoplane) will need:

• A Duoplane vendor account: This integration is for vendors who receive orders from existing Duoplane clients.
• An active BigCommerce subscription: The vendor must have an active (paid) BigCommerce subscription.
• A way to receive payments from your retailer partner: Duoplane will not process payment through your BigCommerce store. You will need to collect payment from your retailer partners separately.
• Matching, unique SKUs: This integration works best if the SKU in your BigCommerce catalog uniquely match the "Vendor SKU" that your retailer partner sends you on purchase orders.

If your SKUs uniquely match the Vendor SKUs from your retailer, the orders that Duoplane creates will be linked to the underlying products in your BigCommerce catalog. Otherwise line items on orders will be created as custom items. Also, inventory syncing only works with matching unique SKUs.

What the BigCommerce vendor integration does

1. Creates orders in your BigCommerce store for new purchase orders. When your retailer sends you a purchase order through Duoplane, Duoplane will create an order in your BigCommerce store that mirrors the shipping address and items on that purchase order.
   • Important note about SKUs: If the SKU numbers in your BigCommerce catalog match the Vendor SKUs that are stored in the retailer’s Duoplane account, the line items on the orders in BigCommerce will be associated with an underlying product / variant in your catalog. If no matching SKU is found for a given item, or if there are multiple matching SKUs in the vendor catalog, the item will be added to the order as a custom product.
2. Transmits tracking for shipped orders from your BigCommerce store back to Duoplane. After orders are fulfilled in your BigCommerce store, Duoplane will retrieve the fulfillment information and automatically mark the associated purchase orders as fulfilled in your retailer partner’s Duoplane account.
3. Syncs inventory between your BigCommerce store and your retailer’s catalog. Inventory quantities in your BigCommerce catalog will be synced to your retailer’s catalog.

Please note the following:

• Duoplane does not process any payments or transmit funds. All orders that Duoplane creates in the vendor’s BigCommerce store are unpaid.
• The integration does not sync historical orders. Only purchase orders sent after the vendor integration is enabled will transmitted to the vendor BigCommerce store.
• Duoplane does not edit existing orders.
• Tracking for each new shipment is not transmitted immediately to your retailer partner. It can take several minutes for the purchase order in Duoplane to reflect tracking for orders that have been fulfilled recently.
• Duoplane does not sync any product information other than inventory availability.
• Inventory syncing requires that your BigCommerce SKUs match your retailer partner’s Vendor SKUs for the same items.
• Duoplane does not sync shipping costs on orders from the vendor’s BigCommerce store.

How to create the connection between Duoplane and your BigCommerce store

Step 1: Create an API user in BigCommerce

The first step is to create a BigCommerce API user with access to your store data. To do that, please see this BigCommerce support article: https://support.bigcommerce.com/articles/Public/Store-API-Accounts

The type of API account that you will create is a "V2/V3 API token".

When creating the API Account, you will be asked to specify Oauth Scopes. Oauth Scopes are the resources that Duoplane will have permission to read or modify. Please set the Oauth Scopes as follows:

• Information & Settings = read-only
• Orders = modify
• Order Transactions = modify
• Products = read-only
• Store Locations = read-only
• Store Inventory = read-only
• Fulfillment Methods = read-only
• Order Fulfillment = read-only

The remaining scopes can be left as "none".

After you save the new API user, please be sure to store the credentials that are presented to you by BigCommerce. You will need to enter them into Duoplane in the next step.

Step 2: Add the BigCommerce API credentials to Duoplane

1. Login to your Duoplane vendor portal.
2. Go to this URL: https://app.duoplane.com/vendor_integrations/bigcommerce
3. In the section called "BigCommerce API credentials", complete the fields as follows:
   • API path: This was provided by BigCommerce when you set up the API user.
   • Access token: The Access Token for the BigCommerce API user that was created earlier.

Step 3: Enable the integration

After you have configured the connection options, go to the section called “Connection status” and enable the types of syncing that you would like to turn on (order processing, inventory syncing, or both).

Deleting the integration

To remove the integration:

1. Go to https://app.duoplane.com/vendor_integrations/bigcommerce
2. Scroll to the bottom of the page and click “Delete connection”.