BestBuy Canada (CA) Account Integration


Overview

Sellercloud allows for a seamless Best Buy integration process for both US and CA marketplace accounts. To learn more about integrating a US marketplace, please visit this page here. For all Canadian marketplace accounts, the connection is through Mirakl and is achieved through plugins/scheduled tasks.

Learn more about channel integrations through Mirakl here.

With this CA integration, you are able to import orders, export tracking, and more.

Before you begin the integration process, please contact Sellercloud Support to ensure that the relevant plugins and mandatory backend settings exist on your server.
Refer to the accordion below for a list of the required plugins and their corresponding settings:

Check out the plugins and columns you can discuss with the Sellercloud Support team!
  • Mirakl Inventory Export Plugin: Exports inventory, price (MIRAKL_PRICE), description (Product Name), start (MIRAKL_AVAILABLE_STARTED), and end date (MIRAKL_AVAILABLE_ENDED) to Mirakl.
  • Mirakl Order Tracking Export Plugin: Exports shipping carrier and tracking number, then marks the order as shipped on Mirakl.
  • Mirakl_Integration_Name: Acceptable values are BestBuy.Ca, BestBuyCa, BestBuy Canada, Catch, and Catch.com.
  • Mirakl_API_URL
  • Mirakl_API_Key
  • Mirakl_Always_Accept_Orders (True or False): This determines if orders with pending acceptance will be accepted even if there’s not enough inventory on hand to fulfill them.
  • Mirakl_Get_Only_Recent_Orders (True or False): This determines if the plugin will only get orders modified in the past 10 days.
  • Mirakl_Shop_IDs: This generates a comma-separated list of Mirakl shop IDs. If missing, the plugin will only import orders from the first shop associated with the Mirakl user.
  • Mirakl_Order_Statuses: Only orders with comma-separated order statuses will be imported. If empty or missing, the old logic will be used.
  • Mirakl_Import_orders_with_source_BestBuy_instead_of_Website
  • Optional: Mirakl_Shipping_Method: This sets the shipping method to the imported order.
  • Optional: RunPostOrderPluginAfterOrderCreation
  • Mirakl_Integration_Name: Acceptable values are BestBuy.Ca, BestBuyCa, BestBuy Canada, Catch, and Catch.com.
  • Mirakl_API_URL
  • Mirakl_API_Key
  • Mirakl_Shop_IDs: This generates a comma-separated list of Mirakl shop IDs. If missing, the plugin will only import orders from the first shop associated with the Mirakl user.
  • Mirakl_Manufacturer_Warranty: This defaults to zero.
  • Mirakl_Warehouse_IDs: This generates a comma-separated list of warehouse IDs to export inventory from. This works with both the basic and advanced safety qty workflow
  • Mirakl_Enable_Advanced_Safety_Qty: This enables the advanced safety qty workflow (see above).
  • Mirakl_Inventory_Percent: Decimal value (ex. “80”, meaning 80%), defaults to 100%, used with the advanced safety qty workflow (see above).
  • MIRAKL_PRICE: Decimal
  • MIRAKL_AVAILABLE_STARTED: Date and Time (Offer start and end date can be in the past or empty. If they are not empty, the start date must be earlier than the end date or Mirakl will reject the update.)
  • MIRAKL_AVAILABLE_ENDED: Date and Time
  • MIRAKL_SKU: String (Product ID is used if Mirakl_SKU is missing)
  • MIRAKL_SHOP_IDS: String (Used only if the company setting Mirakl_Shop_IDs is not empty.)
  • MIRAKL_SAFETY_QTY: Integer
  • MIRAKL_MANUFACTURER_WARRANTY: Integer
  • MIRAKL_MANUFACTURER_WARRANTY_USE_DEFAULT: Defaults to false.
  • Optional: MIRAKL_DISCOUNT_PRICE: Decimal
  • Optional: MIRAKL_DISCOUNT_AVAILABLE_STARTED: Date and Time
  • Optional: MIRAKL_DISCOUNT_AVAILABLE_ENDED: Date and Time
  • Optional: MIRAKL_LOGISTIC_CLASS: String with an optional selected value
  • Optional: MIRAKL_DESCRIPTION: String with an optional selected value
  • Optional: MIRAKL_INTERNAL_DESCRIPTION: String with an optional selected value
  • Optional: MIRAKL_PRICE_ADDITIONAL_INFO: String with an optional selected value
  • MIRAKL_CHANNEL: Type string. Populated by the plugin upon order import.
  • MIRAKL_SHOP_ID: Type integer. Populates the Mirakl Shop ID.
  • Mirakl_Shop_IDs is not empty or missing.
  • MIRAKL_SKU: Type string. This can be used to add the Mirakl Product ID if it differs from the Sellercloud Product ID.
  • BBCA_QTY > Integer
  • BBCA_PRICE > Decimal
  • BBCA_AVAILABLE_STARTED > DateTime
  • BBCA_AVAILABLE_ENDED > DateTime
  • Optional: BestBuyEnabled

Automate Order Import

To begin importing orders, you must first create a new company in Sellercloud. Orders will come in as website orders, so it is important to have a company dedicated to this integration.

  1. Create a new company.
  2. Go to Settings > Select your new company > Toolbox > Custom Settings > Enter your information into the fields. Sample information for Mirakl_API_URL custom setting :
    1. Setting Name: Mirakl_API_URL
    2. Setting Value for testing: https://bby-dev.mirakl.net
    3. Setting Value for production: https://marketplace.bestbuy.caCustom Settings
  3. Click Save.


Automate Tracking Export

You can automate the tracking export by creating a scheduled task.

  1. Go to SettingsScheduled Tasks > Manage Scheduled Tasks > Click the Plus icon on the bottom right corner > Create New Scheduled Task.
  2. Select Export Orders from the Task Type dropdown menu.
  3. Fill in Task Name, Company, and Start Time fields.
  4. Create.New sheduled task

Automate Inventory upload

You can automate your inventory export feeds by creating a scheduled task.

  1. Go to SettingsScheduled Tasks > Manage Scheduled Tasks > Click the Plus icon on the bottom right corner > Create New Scheduled Task.
  2. Select Export Inventory Per Parent SKU from the Task Type dropdown menu.
  3. Fill in Task Name, Company, and Start Time fields.
  4. Create.

Generate the Best Buy API Key

Best Buy will generate an API key for you. You can retrieve the key through your Best Buy marketplace account.

Please use this key for the authorization header when making API calls.
  1. Login to the Best Buy Marketplace portal.
  2. Click My User Settings icon > API key.
  3. If an API key exists already, use that key. If not, click Generate a New Key.
  4. Go to the User Management page to make sure that the User Account associated with the API key has the Store Administration role checked.

Overview

Sellercloud allows for a seamless Best Buy integration process for both US and CA marketplace accounts. To learn more about integrating a US marketplace, please visit this page here. For all Canadian marketplace accounts, the connection is through Mirakl and is achieved through plugins/scheduled tasks.

Learn more about channel integrations through Mirakl here.

With this CA integration, you are able to import orders, export tracking, and more.

Before you begin the integration process, please contact Sellercloud Support to ensure that the relevant plugins and mandatory backend settings exist on your server.
Refer to the accordion below for a list of the required plugins and their corresponding settings:

Check out the plugins and columns you can discuss with the Sellercloud Support team!
  • Mirakl Inventory Export Plugin: Exports inventory, price (MIRAKL_PRICE), description (Product Name), start (MIRAKL_AVAILABLE_STARTED) and end date (MIRAKL_AVAILABLE_ENDED) to Mirakl.
  • Mirakl Order Tracking Export Plugin: Exports shipping carrier and tracking number, then marks order as shipped on Mirakl.
  • Mirakl_Integration_Name: Acceptable values are BestBuy.Ca, BestBuyCa, BestBuy Canada, Catch, and Catch.com.
  • Mirakl_API_URL
  • Mirakl_API_Key
  • Mirakl_Always_Accept_Orders (True or False): This determines if orders with pending acceptance will be accepted even if there’s not enough inventory on hand to fulfill them.
  • Mirakl_Get_Only_Recent_Orders (True or False): This determines if the plugin will only get orders modified in the past 10 days.
  • Mirakl_Shop_IDs: This generates a comma-separated list of Mirakl shop IDs. If missing, the plugin will only import orders from the first shop associated with the Mirakl user.
  • Mirakl_Order_Statuses: Only orders with the comma-separated order statuses will be imported. If empty or missing, the old logic will be used.
  • Mirakl_Import_orders_with_source_BestBuy_instead_of_Website
  • Optional: Mirakl_Shipping_Method: This sets the shipping method to imported order.
  • Optional: RunPostOrderPluginAfterOrderCreation
  • Mirakl_Integration_Name: Acceptable values are BestBuy.Ca, BestBuyCa, BestBuy Canada, Catch, and Catch.com.
  • Mirakl_API_URL
  • Mirakl_API_Key
  • Mirakl_Shop_IDs: This generates a comma-separated list of Mirakl shop IDs. If missing, the plugin will only import orders from the first shop associated with the Mirakl user.
  • Mirakl_Manufacturer_Warranty: This defaults to zero.
  • Mirakl_Warehouse_IDs: This generates a comma-separated list of warehouse IDs to export inventory from. This works with both the basic and advanced safety qty workflow
  • Mirakl_Enable_Advanced_Safety_Qty: This enables the advanced safety qty workflow (see above).
  • Mirakl_Inventory_Percent: Decimal value (ex. “80”, meaning 80%), defaults to 100%, used with the advanced safety qty workflow (see above).
  • MIRAKL_PRICE: Decimal
  • MIRAKL_AVAILABLE_STARTED: Date and Time (Offer start and end date can be in the past or empty. If they are not empty, the start date must be earlier than end date or Mirakl will reject the update.)
  • MIRAKL_AVAILABLE_ENDED: Date and Time
  • MIRAKL_SKU: String (Product ID is used if Mirakl_SKU is missing)
  • MIRAKL_SHOP_IDS: String (Used only if the company setting Mirakl_Shop_IDs is not empty.)
  • MIRAKL_SAFETY_QTY: Integer
  • MIRAKL_MANUFACTURER_WARRANTY: Integer
  • MIRAKL_MANUFACTURER_WARRANTY_USE_DEFAULT: Defaults to false.
  • Optional: MIRAKL_DISCOUNT_PRICE: Decimal
  • Optional: MIRAKL_DISCOUNT_AVAILABLE_STARTED: Date and Time
  • Optional: MIRAKL_DISCOUNT_AVAILABLE_ENDED: Date and Time
  • Optional: MIRAKL_LOGISTIC_CLASS: String with an optional selected value
  • Optional: MIRAKL_DESCRIPTION: String with an optional selected value
  • Optional: MIRAKL_INTERNAL_DESCRIPTION: String with an optional selected value
  • Optional: MIRAKL_PRICE_ADDITIONAL_INFO: String with an optional selected value
  • MIRAKL_CHANNEL: Type string. Populated by the plugin upon order import.
  • MIRAKL_SHOP_ID: Type integer. Populates the Mirakl Shop ID if custom company setting
  • Mirakl_Shop_IDs is not empty or missing.
  • MIRAKL_SKU: Type string. This can be used to add the Mirakl Product ID if it differs from the Sellercloud Product ID.
  • BBCA_QTY > Integer
  • BBCA_PRICE > Decimal
  • BBCA_AVAILABLE_STARTED > DateTime
  • BBCA_AVAILABLE_ENDED > DateTime
  • Optional: BestBuyEnabled

Import orders

After contacting Sellercloud Support about custom columns and plugins, you can begin importing orders.

To begin importing orders, you must first create a new company in Sellercloud. Orders will come in as website orders, so it is important to have another company to differentiate which orders are Best Buy CA orders.
  1. Create a new company.
  2. Go to Settings > Select your new company > Toolbox > Custom Settings > Enter your information into the fields. Sample information for Mirakl_API_URL custom setting :
    • Setting Name: Mirakl_API_URL 
    • Setting Value for testing: https://bby-dev.mirakl.net 
    • Setting Value for production: https://marketplace.bestbuy.ca
    • API Key number sellercloud best buy canada
  3. Contact Sellercloud Support for a custom setting on an order level called MIRAKL_CHANNEL (use the string type). 
  4. Create a new import order scheduled task.
    1. Select Import Orders from the New Task Type dropdown menu > GO
    2. Choose the BestBuy Marketplace CA Order Import plugin from the Order Processor Plugin/Profile list. (This will have now been placed on the server by Sellercloud.)
    3. Set the Import From field to None.

Export tracking

After contacting Sellercloud Support about custom columns and plugins, you can begin exporting tracking.

You can exporting tracking by creating a scheduled task.

  1. Create a new export order scheduled task.
    1. Select Export Orders from the New Task Type dropdown menu > GO
    2. Choose the BestBuy Marketplace CA Order Tracking Export plugin from the Order Processor Plugin/Profile list.
    3. The following saved search filters should be applied:
      • Shipping StatusFully Shipped
      • Tracking Uploaded – set to Not Uploaded
      • Status – should be InProcess or Completed
    4. Check the box This is Tracking Export.
    5. Set the Export To field to None.

Export inventory

After contacting Sellercloud Support about custom columns and plugins, you can begin exporting inventory.

You can begin exporting inventory by creating a scheduled task.

  1. Create a new export products scheduled task.
    1. Select Export Products from the New Task Type dropdown menu > GO
    2. Set the Export To field to None.

Generate the Best Buy API key

Best Buy will generate an API key for you. You can retrieve the key through your Best Buy marketplace account.

Please use this key for the authorization header when making API calls.
  1. Login to the Best Buy Marketplace portal.
  2. Click My User Settings icon > API key.
  3. If an API key exists already, use that key. If not, click Generate a New Key.
  4. Go to the User Management page to make sure that the User Account associated with the API key has the Store Administration role checked.

 

Was this article helpful?

Related Articles

Need Support?
Can't find the answer you're looking for?
Contact Support