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. If necessary, you can open a ticket with Sellercloud Support to request additional customizations or other plugins for this integration. Any such modifications will be billable.

To have a dedicated representative complete the testing for your account and ensure that the setup is configured correctly, we recommend Premium Support.

Alternatively, you can integrate Belk through Mirakl.

Prerequisites

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

We recommend creating a Company where you will set up the Custom Company Settings and automate the plugins with Scheduled Tasks.

Rithum Support

Contact Rithum Support and request:

• A Supplier Test Plan and a Supplier Guide. Prior to production deployment, the entire test plan must be completed according to the documented procedures, including submission of a test transaction for each test order.
• Test and production credentials. Once you complete all test cases outlined in the test plan document, the platform will provide you with the production SFTP details: Server Name, Username, and Password. You will need them when setting up the scheduled tasks to automate the plugins. Also, make sure to obtain Belk's ISA ID and Qualifier, and provide your Customer ISA ID.

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.

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.

ISAControlNumber, GSControlNumber, and STControlNumber can all start at 1. The tracking and inventory exports will increment these numbers accordingly as jobs are processed. If the settings already exist and have values in them, do not edit them.

On the company created for the integration:

• Belk_ISAID - Provided by Rithum.
• Belk_Qualifier - Provided by Rithum.
• Belk_CustomerISAID - Your ISA ID. Typically, this is your phone number, but it can be anything you set up with Rithum.
• Belk_CustomerQualifier - Provided by Rithum.
• (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.
• (optional) CommerceHub_LINTransactionsLimit – Type integer, defaults to 0. Controls the maximum number of products included in a single transaction. Set to 0 (or a negative value), or leave the setting undefined, to prevent products from being split across multiple transactions. When set to a positive value, the plugin sends up to the specified number of products per transaction.

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 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 Sellercloud 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 and fill out your FTP credentials.
   2. Set the FTP Directory to /outgoing/intchg.
   3. Check Use Passive and 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 requirement is mandatory for 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 Rithum 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 and fill out your FTP credentials.
   2. Set the Remote Folder path to /incoming/intchg.
   3. Check Use Secure FTP and Use Passive.
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:
   1. Set Export To to FTP, and fill out your FTP credentials.
   2. Set the Remote Folder path to /incoming/intchg.
   3. Enable Use Passive and 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.