Belk Account Integration through Mirakl

Overview

Belk.com is an online store that offers a wide selection of apparel, shoes, accessories, home, and beauty products from both national and exclusive brands.

Through Mirakl, you can quickly connect your products to Belk.com, and track your sales performance. With Sellercloud’s Belk account integration, you’ll have access to advanced inventory and pricing management, automated order processing, and shipping.

You can integrate Sellercloud and Belk via API through plugins. 

Prerequisites 

To integrate your Belk account with Sellercloud, reach out to the Sellercloud Support team to install the following plugins on your server:

• Mirakl Order Import
• Mirakl Order Tracking Export
• Mirakl Inventory Export
• Belk Packing Slip (optional)

Custom Company Settings 

You need to create a Custom Company Setting under the designated company and grant Sellercloud API access. 

• Mirakl_API_URL – The URL used to access the API.
• Mirakl_API_Key – You can find it in your Mirakl account.
• MiraklOAuthTokenId – Used to make API calls to the Mirakl Marketplace API.
• Mirakl_Integration_Name – A unique identifier for your integration through Mirakl. Accepts different values. You need to set the value to Belk.
• Mirakl_Always_Accept_Orders – Allows orders to be automatically accepted regardless of the available inventory.
• Mirakl_Get_Only_Recent_Orders – Allows you to configure Mirakl to only retrieve orders that have been placed within a certain amount of time.
• Mirakl_Shop_IDs – Allows you to assign a unique ID to each shop in Mirakl.
• Mirakl_Order_Statuses – Allows you to manage the statuses of orders placed on Mirakl.
• Mirakl_Shipping_Method – Allows you to select a shipping method from Mirakl.
• RunPostOrderPluginAfterOrderCreation – This allows you to customize the order processing after an order is created.
• Mirakl_Manufacturer_Warranty – Allows you to set the length of time a manufacturer’s warranty is valid for their products.
• Mirakl_Warehouse_IDs – Allows you to set the ID of the warehouse used for orders placed on Mirakl.
• Mirakl_Enable_Advanced_Safety_Qty – Allows you to set the number of items that should be kept in stock in order to cover the potential demand from Mirakl orders.
• MIRAKL_UseAdvancedKitProjecting – Allows you to map your product catalogs to Mirakl.
• Mirakl_Inventory_Percent – Allows you to set a target inventory level for Mirakl orders.
• MiraklEnableExportOfferStateNew – Allows you to export offer state updates to Mirakl and keep catalogs in sync with Sellercloud.
• Mirakl_Offer_TaxCode – Allows you to set the default tax code for all Mirakl offers.
• Mirakl_UseUPC – Allows you to use your own UPC codes to map products from your Mirakl catalog to the appropriate UPCs in Sellercloud.
• MiraklDefaultReplenishableQty – Allows you to set a default replenishable quantity for Mirakl orders. 

Next, you will need to contact the Sellercloud Support team and request the following custom columns to be created on your server.

Custom Product Columns

• MIRAKL_CHANNEL – Stores the name of the specific marketplace you are integrating through Mirakl.
• MIRAKL_SHOP_ID – Stores the ID number of the specific marketplace you are integrating through Mirakl.

Custom Order Columns

• MIRAKL_PRICE – The product price for Belk
• MIRAKL_AVAILABLE_STARTED – Indicates the start and end date of the Mirakl offer.
• MIRAKL_AVAILABLE_ENDED – Tracks whether or not a Mirakl order has been marked as available or ended in Mirakl.
• MIRAKL_SKU – Identifies the product SKU used in Mirakl.
• MIRAKL_SHOP_IDS – This should be the value of the specific channel you’re integrating through Mirakl: Belk. This custom column should only have one Shop ID. The only case where you can have two values is when one of them is BestBuy. (Does not work for BestBuy Canada)
• MIRAKL_DISCOUNT_PRICE – Allows you to set a discounted price for items purchased through Mirakl.
• MIRAKL_DISCOUNT_AVAILABLE_STARTED – Start date of the Mirakl discount.
• MIRAKL_DISCOUNT_AVAILABLE_ENDED – End date of the Mirakl discount.
• MIRAKL_SAFETY_QTY – Аllows you to set a safety stock quantity for each Mirakl product.
• MIRAKL_MANUFACTURER_WARRANTY – Allows you to track any warranties offered by the manufacturer of a product that is being sold on Sellercloud.
• MIRAKL_MANUFACTURER_WARRANTY_USE_DEFAULT – Indicates if a product should use the manufacturer’s warranty as the default warranty option.
• MIRAKL_LOGISTIC_CLASS – Identify a specific logistical class for orders placed through Mirakl.
• MIRAKL_DESCRIPTION –  Store product descriptions in Mirakl.
• MIRAKL_INTERNAL_DESCRIPTION – Allows you to add additional product information for managing product inventory and pricing.
• MIRAKL_PRICE_ADDITIONAL_INFO –  Provides additional information about the price of a product like currency, supplier’s cost price, and any other additional pricing information.
• MIRAKL_OFFER_STATE – Provides a string dropdown with a default value 11(NEW), when the Mirakl_Integration_Name is missing or invalid. 
• MiraklMaxQtyEnabled – Allows you to set a maximum quantity of product availability.
• MiraklMaxQty – Allows you to set the maximum quantity of a certain product that can be purchased through Mirakl.
• MiraklMaxQtyUseDefault –  Allows you to set the default maximum quantity of a certain product that can be purchased through Mirakl.
• MIRAKL_OFFER_TAXCODE – Stores the tax code associated with a Mirakl offer. 
• MiraklReplenishableQtyToSend – Sets a default quantity of a product that can be sent to a Mirakl Marketplace seller.
• MiraklUseDefaultReplenishableQty – Sets the stock level of a product to the default replenishable quantity value in Sellercloud.
• MIRAKL_EXPORT_OFFER_STATE_NEW – Indicates whether an offer has been exported to the Mirakl marketplace platform.
• Mirakl_MinQtyAlert – Allows you to set a minimum quantity alert for the products they offer on Mirakl Marketplaces. Once set in Sellercloud, it will trigger an alert if the quantity of a product drops below the threshold that was set. 

Order Import

Belk order import is downloaded with a plugin that connects to Mirakl API. Sellercloud automatically does that through the Import Order Scheduled Task. Once you choose the Mirakl Order Import plugin, it downloads Mirakl orders and creates them as website orders in Sellercloud.

Orders with the following status in Mirakl will be imported to Sellercloud:

• WAITING_ACCEPTANCE
• SHIPPING
• PAYMENT_COLLECTED
• SHIPPED
• RECEIVED
• CLOSED

Orders with the following status in Mirakl will be imported as completed in Sellercloud:

• SHIPPED
• RECEIVED
• CLOSED 

Orders marked as shipped and received will be marked as fully shipped, while orders with status closed will be marked as shipped only if they have a tracking number or a carrier name.

Orders with the status WAITING_ACCEPTANCE are downloaded with empty addresses. After acceptance, Mirakl sends them again with the status SHIPPING, and addresses are added to the relevant orders by the plugin.

After an order with pending acceptance is created in Sellercloud, the plugin will check the custom company setting Mirakl_Always_Accept_Orders. If the setting is set to true, the order will be automatically accepted. If it’s set to false, an acceptance is sent to Mirakl, only if there’s sufficient product inventory to fulfill the whole order. Otherwise, it will be rejected and the Sellercloud status will be changed to Canceled.

Automate Order Import

To create a Scheduled Task that regularly imports orders from Belk to 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 to Belk Order Import.
   3. Select the Company.
   4. Select the Start Time.
   5. Click Create.
4. The following message appears at the bottom of your screen: “Scheduled task created successfully. Click Here to configure the task details.” – click the link.
5. Click the Edit button on the top right.
6. In the Details section:
   1. Choose the Company you created the scheduled task for.
   2. Choose the Mirakl Order Import plugin.
7. In the General section, click the Enable button.
8. Click Save on the top right.

Tracking Export 

When you’re shipping orders, The Mirakl Order Tracking Export plugin in Sellercloud will upload the shipping details (shipping carrier and tracking number) to Mirakl and the order will be marked as shipped.

Automate Tracking Export

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

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 to Belk Tracking Export.
   3. Select the Company.
   4. Select the Start Time.
   5. Click Create.
4. The following message appears at the bottom of your screen: “Scheduled task created successfully. Click Here to configure the task details.” – click the link.
5. Click the Edit button on the top right.
6. In the Details section:
   1. Choose the Company you created the scheduled task for.
   2. Choose the Mirakl Order Tracking Export plugin.
7. In the General section, click the Enable button.
8. Click Save on the top right.

Inventory Export

Sellercloud can send regular inventory information for your products in Mirakl, matched by UPC, SKU, or Mirakl SKU, using the plugin Mirakl Inventory Export.

To initiate an inventory export, products are matched by UPCs and Mirakl SKUs, which is either Sellercloud product ID or the value in the custom column Mirakl_SKU. Make sure the exported value matches the Mirakl SKU found under Setting, not the one in the summary on top.

If the UPC is not the same as when the Mirakl offer was created, it will be rejected.

Automate Inventory Export

To create a Scheduled Task that regularly exports inventory from Sellercloud to Belk:

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 Products.
   2. Set the Task Name to Belk Inventory Export.
   3. Select the Company.
   4. Select the Start Time.
   5. Click Create.
4. The following message appears at the bottom of your screen: “Scheduled task created successfully. Click Here to configure the task details.” – click the link.
5. Click the Edit button on the top right.
6. In the Details section:
   1. Choose the Company you created the scheduled task for.
   2. Choose the Mirakl Inventory Export plugin.
7. In the General section, click the Enable button.
8. Click Save on the top right.

PDF Packing Slip 

There is a Belk Packing Slip plugin that can generate a PDF Invoice. Navigate to:

1. Settings > Companies > Manage Companies > Open a Company > Toolbox > Invoice Settings.
2. Click Per Channel Preferences.
3. Next to Website, select Belk Packing Slip plugin.
4. Click Save.