Belk Account Integration through CommerceHub

Overview

Belk is a department store chain offering a wide range of products, including apparel, shoes, and accessories for men, women, and children. It also provides home goods, beauty products, and gifts. With a focus on quality and style, Belk caters to diverse customer groups both online and in its numerous store locations across the United States.

Integrating Belk into your Sellercloud account allows you to seamlessly import orders, upload tracking information, and ensure your Belk store is always up-to-date with the latest inventory data. The integration works through EDI documents, transmitting information between the two services via plugins and Scheduled Tasks. The document exchange goes through Rithum, previously known as CommerceHub.

Prerequisites

Before you can integrate Belk with Sellercloud, complete the following requirements.

Sellercloud Support

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

• BelkEDI850 OrderImport With AknEDI997 – Imports orders from Belk to Sellercloud in EDI 850 format and sends back acknowledgment in EDI 997 format.
• Belk Tracking Export EDI 856 – Exports tracking from Sellercloud to Belk in EDI 856 format.
• Belk Integration EDI846 Inventory Export– Exports available inventory count from Sellercloud to Belk in EDI 846 format.
• Belk Packing Slip – Generates a printable packing slip in a format that complies with Belk’s requirements.

If necessary, you can request additional customizations or other plugins for this integration. Any such modifications will be billable.

CommerceHub Support

Contact CommerceHub Support for the following:

• SFTP details: Server Name, Username, and Password. You will need them when setting up the scheduled tasks to automate the plugins.
• Belk’s ISA ID and Qualifier.
• Provide CommerceHub with your Customer ISA ID and Qualifier.

Custom Company Settings

Create the following Custom Company Settings:

On your Default company:

• STControlNumber – Set to 1.
• GSControlNumber – Set to 1.
• ISAControlNumber – Set to 1.
• (Optional) Belk_MarkOrdersUnpaid – When set to TRUE, all imported orders will have Payment Status: Unpaid in Sellercloud. Additionally, the order source of the orders will change from Website to Wholesale to accurately track inventory movements.
• Belk_CancelPoBoxAndPrOrders – Defaults to TRUE even if you do not create it in your Company. When this setting is enabled, all orders that are imported with a ShipTo address of a PO Box or within Puerto Rico will automatically be marked as Cancelled. Disable the setting to allow the processing of such orders.

On the company created for the integration:

• Belk_ISAID – Provided by CommerceHub.
  
• Belk_Qualifier – Provided by CommerceHub.
  
• Belk_CustomerISAID – Your ISA ID. Typically, this is your phone number, but can be anything you set up with CommerceHub.
• Belk_CustomerQualifier – Provided by CommerceHub.
• (optional) BelkReturnsUseCompanyAddress – Set to TRUE to ensure your Sellercloud Company address is printed on the packing slip. When disabled, the default Belk address will be used.
• (optional) Belk_UseWarehouseSplitLogic – Set to TRUE to send product inventory per warehouse. To use this feature, you must configure the Channel Warehouse Mapping for the channel Website on the company you created for the integration. Ensure the Channel Warehouse Codes match your setup on Belk.
• (optional) Belk_UseShadowParentInventory – Set to TRUE to ensure that the inventory of the Parent is sent to Belk when updating a Shadow Product.

Custom Product Columns

Create the following Custom Product Columns:

• BELKSKU – The product’s SKU at Belk.
• Belk_SafetyQty – This column allows you to set a Safety Quantity for Belk for each individual product.
• (optional) Belk_Enabled – This column is used to enable only specific products for Belk. Set to True for any SKUs you want to send with the Inventory Export plugin.

Order Import

The BelkEDI850 OrderImport With AknEDI997 plugin imports order data from Belk to Sellercloud in EDI 850 format and sends back Order Acknowledgment in EDI 997 format. By default, it creates the orders in Sellercloud as Fully Charged. However, you can override this by enabling the Custom Company Setting Belk_MarkOrdersUnpaid.

The plugin automatically cancels all orders set to ship to a PO Box address or Puerto Rico. To process such orders, disable the Belk_CancelPoBoxAndPrOrders Custom Company Setting to ensure they are imported with the status In Process.

When an order is imported, the plugin looks at the values in the BELKSKU Custom Column. If it is not configured, it checks the UPCs of your Selelrcloud products. In case the plugin is not able to find the item in your catalog, the order is created with an Unknown Product.

Automate Order Import

To create a Scheduled Task that imports orders:

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.
   5. Click CREATE.
4. The newly created Scheduled Task Details page will open automatically. Click the Edit button at the top right corner.
5. In the Details panel:
   1. Click Create Orders For Company and select the company designated for this integration.
   2. Click the Plugin menu and select BelkEDI850 OrderImport With AknEDI997.
6. In the Import Options panel:
   1. Set Import From to FTP
   2. Fill out the FTP fields.
   3. Check Use Secure FTP.
7. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
8. In the General panel:
   1. Fill in “FTP” in the Note field.
      This is a necessary requirement for the 997 transactions.
   2. Click the Enable button.
9. Click Save.

Shipping Method Mapping

The Belk Order Import plugin has default Shipping Method Mapping applied to each imported order, which determines the Shipping Carrier and Method selected upon import. You can override one or more of the code mappings by creating an Import Mapping Profile of type Orders. The Profile name must be set to Belk Shipping Mapping. Do not configure the order columns on the Mapping Profile Details page. Instead, access the Toolbox > Shipping Method Mapping > click Edit > click the + icon in the panel header. In the pop-up module, fill in:

• Method received – the shipping method codes received with the EDI 850 order import. Reach out to CommerceHub support for the list.
• Local Carrier – select the shipping carrier you will use to fulfill orders with that specific code.
• Local Service – select the shipping method.
• Rush Order – check this box if you want to mark orders with this specific shipping method as Rush.

Once you Add all the shipping code mapping you want to override, click Save. If the profile name is correct, the plugin will automatically check it first before applying the default mapping.

Tracking Export

The Belk Tracking Export EDI 856 plugin exports tracking from Sellercloud to Belk following the 856 EDI format.

This plugin supports separate tracking numbers for Split Orders. Additionally, if you split an order due to a partial cancellation, it automatically skips any child orders with statuses Cancelled and Void.

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

• Company – The company you created for the integration
• Order Status – InProcess Or Completed
• Shipping Status – FullyShipped
• Tracking Uploaded – No

Automate Tracking Export

To create a Scheduled Task that exports order tracking:

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.
   5. Click CREATE.
4. On the Scheduled Task page, click the Edit button at the top right corner.
5. In the Details panel:
   1. Click the User ID menu and select your email.
   2. Click the Saved Search menu and select the saved search you created earlier.
   3. Click the Export Via menu and select Belk Tracking Export EDI 856.
   4. Check This Is Tracking Export.
6. In the Export Options panel:
   1. Set Export To to FTP
   2. Fill out the FTP fields.
   3. Check Use Secure FTP.
7. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
8. In the General panel, click the Enable toggle button.
9. Click Save.

Inventory Export

The Belk Integration EDI846 Inventory Export plugin exports inventory from Sellercloud to Belk in EDI 846 format.

Optionally, you can enable only specific products for Belk by setting their Belk_Enabled Custom Column for Products to True:

• For one product at a time, go to the Product Details Page > click Toolbox and select Custom Columns > click Edit > update the Belk_Enabled column > Save.
• For multiple products, follow the steps to Bulk Update Products and use the Belk_Enabled column – set it to True for all products you want to enable.

Unlike core integrations, plugin integrations don’t require products to be in the company with the scheduled tasks. The export will include the products you select with your Saved Search.

Next, create a Saved Search for products filtered by Belk_Enabled – True. Optionally, you can add more filters to the search to narrow down the export further.

Automate Inventory Export

To create a Scheduled Task that exports inventory:

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.
   3. Select the Company.
   4. Select the Start Time.
   5. Click CREATE.
4. On the Scheduled Task page, click the Edit button at the top right corner.
5. In the Details panel:
   1. Click the User ID menu and select your email.
   2. Click the Saved Search menu and select the saved search you created earlier.
   3. Click the Export Via menu and select Belk Integration EDI846 Inventory Export.
6. In the Export Options panel, set Export To to FTP and fill out the FTP fields. Enable Use Secure FTP.
7. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
8. In the General panel, click the Enable toggle button.
9. Click Save.

Configure PDF Invoices

With the Belk Packing Slip plugin set up under your designated company, you can print PDF invoices with information about your Belk orders and the products they include through Sellercloud or Shipbridge.

To set up the invoice plugin:

1. Go to the Company Settings of the company you created for the integration.
2. Click Toolbox and select Invoice Settings.
3. Click Per Channel Preferences.
4. For Website, select Plugin > Belk Packing Slip.
5. Click Save.