# HSN Account Integration

## Overview

The [Home Shopping Network (HSN)](https://www.hsn.com/) is a famous American television network and e-commerce platform specializing in home shopping. The website provides a wide array of product categories, customer reviews, and detailed product information. Sellercloud helps you manage your inventory and orders on HSN, allowing you to reach a wider audience and streamline your sales process.

To have a dedicated representative complete the testing for your account and ensure that the setup is configured correctly, we recommend [Premium Support](/content/premium-support/index.html).

## Prerequisites

If you don’t have an HSN account, create one at [https://www.hsn.com/](https://www.hsn.com/).

HSN will also provide a login for their testing portal. You must complete the testing process described in the next section before going live.

Contact HSN’s support team and ask for the following details:

- **Sender ID**  
- **Receiver ID**  
- **Vendor ID**  
- **FTP Server**  
- **FTP Username and Password**

Sellercloud offers a custom invoice format designed to print HSN packing slips. Open a ticket with [Sellercloud Support](/content/support/index.html) to install the **HSN Invoice - Order PDF Invoice** plugin on your server.

## Integrate HSN

To integrate your HSN account into Sellercloud:

1. Go to your [Company Settings](https://descartessystems.aha.io/pages/7630848954242562863).
2. Click **Toolbox** and select **HSN > General Settings**.
3. Click **Edit**.
4. Enter the **Sender ID**, **Receiver ID**, **Vendor ID**, and **FTP credentials** provided by HSN.
5. Enter the **Handling Fee** you charge HSN.

6. Click **Actions** and select **Test FTP Credentials** to ensure the FTP is configured correctly.

7. Configure the rest of your account settings as needed and click **Save**.

The HSN integration works by sending and receiving data through XML files. You can check the feed by going to [Company Settings](https://descartessystems.aha.io/pages/7630848954242562863) **> Toolbox > HSN > Documents**.

## Test Stage

Before going live with HSN, you must go through a test stage that involves exchanging various XML documents and printing test packing slips and UPS shipping labels. To complete the testing stage, HSN requires you to exchange the following documents:

- **Order Import**  
- **Order Acknowledgement**  
- **Shipment Confirmation**  
- **Credit Memo**

You have two options for exchanging the test files:

- **Automatically** using the FTP provided by HSN
- **Manually** on the HSN Vendor Portal

### Automatically

To enable automatic file exchange between Sellercloud and HSN via FTP, used both for testing and production:

1. Go to your [Company Settings](https://descartessystems.aha.io/pages/7630848954242562863).
2. Click **Toolbox** and select **HSN > General Settings**.
3. Click **Edit**.
4. Check these boxes:
   1. **HSN Enabled** - Activates all enabled settings and options on this page.
   2. **Enable Order Download**- Enables automatic order download from HSN. Orders will be imported into Sellercloud approximately every 30 minutes.
   3. **Enable Order Ack. Upload** - Automatically informs HSN that an order file has been accepted and is being processed.
   4. **Enable Order Fulfillment Upload** - Enables automatic tracking upload to HSN.
   5. **Requires Third Party Shipping**- Enforce the use of a 3rd party account to ship HSN orders.

5. Click **Save**.

Now that you have enabled the automatic file exchange, you can complete the testing stage:

1. **Order Import** - First, HSN must generate a **Sample Order File** and upload it to the FTP.
2. **Order Acknowledgement** - Once Sellercloud downloads the orders from the sample file, it automatically sends the order acknowledgment file through the FTP.
3. **Shipment Confirmation** - Sellercloud sends shipping confirmation to HSN after an order is fulfilled. The information will only be sent once your HSN orders are marked as **Fully Shipped** and have a valid tracking number.
4. **Credit Memo** - When a customer returns an item, Sellercloud must transmit that information to HSN:
   1. First, [Create an RMA](https://descartessystems.aha.io/pages/7630864225398183906) for an HSN order and go to the RMA page.
   2. Click **Actions** and select **Receive Return** to mark the RMA as received.
   3. Click **Actions** and select **Export Credit Memo to HSN**.

5. Configure your [HSN Invoice Settings](https://descartessystems.aha.io/pages/7630871463456949442) to print packing slips with the plugin. Then, print 5 packing slips and send them to HSN for verification.
6. HSN will require you to use their UPS account to ship orders. Follow the steps in the [Configure UPS Prepaid Labels for HSN Orders in Shipbridge](https://help.sellercloud.com/sellercloud-knowledge-base/integrations/channels/hsn/hsn-account-integration~7630871397559367403#configure-ups-prepaid-labels-for-hsn-orders-in-shipbridge) section to set this up. Then, print 5 [Shipping Labels](https://descartessystems.aha.io/pages/7630854129237682056) and send them to HSN for verification.

### Manually

If you’re having problems with the automatic file exchange process, you can complete the testing stage manually. This requires you to generate and upload the required files yourself.

01. Sign in to [HSN's Vendor Portal](https://view.hsn.net/login.aspx).
02. Download their **Sample Order File**.
03. Go to Sellercloud and follow the steps to [Import Orders Manually](https://descartessystems.aha.io/pages/7630871463456949442).
04. Go to **Orders > Manage Orders**, find and select the HSN orders, then click the blue **Actions** icon and select **Download Func Ack File(s) (997)**. Batch all 25 orders into 1 file for upload.

05. Upload the Order Acknowledgment file to the HSN Vendor Portal.
06. Mark all 25 HSN orders as [Fully Shipped](https://descartessystems.aha.io/pages/7630844760763923604) in Sellercloud and ensure they have tracking numbers.
07. On the **Manage Orders** page, select the HSN orders, click the blue **Actions** icon, and select **Download Shipping Update File (856)**. Batch all 25 orders into 1 file for upload.

08. Upload the Shipment Confirmation file to the HSN Vendor Portal.
09. When a customer returns an item, Sellercloud must transmit that information to HSN:
    1. [Create an RMA](https://descartessystems.aha.io/pages/7630864225398183906) for a few HSN orders.
    2. On the RMA pages, click **Actions** and select **Receive Return** to mark the RMAs as received.
    3. Go to **Orders > Manage Orders**, find and select the HSN orders, then click the blue **Actions** icon and select **Download Credit Memo File (812)**. Batch all 25 orders into 1 file for upload.
    4. Upload the Return Transaction/Credit Memo file to the HSN Vendor Portal.

10. Configure your [HSN Invoice Settings](https://descartessystems.aha.io/pages/7630871463456949442) to print packing slips with the plugin. Then, print 5 packing slips and send them to HSN for verification.
11. HSN will require you to use their UPS account to ship orders. To do this:
    1. Go to [Company Settings](https://descartessystems.aha.io/pages/7630848954242562863) **> Toolbox > HSN > General Settings**.
    2. Click **Edit**, enable the **Requires Third Party Shipping** setting, and **Save**.
    3. Follow the steps in the [Configure UPS Prepaid Labels for HSN Orders in Shipbridge](https://help.sellercloud.com/sellercloud-knowledge-base/integrations/channels/hsn/hsn-account-integration~7630871397559367403#Configure_UPS_Prepaid_Labels_for_HSN_Orders_in_Shipbridge) section to complete this setup. Then, print 5 [Shipping Labels](https://descartessystems.aha.io/pages/7630854129237682056) and send them to HSN for verification.

12. With the above, your testing stage should be complete. When you’re ready to go live, go to the **HSN > General Settings** page, check **HSN Enabled,** and enable any other desired options to automate your processes.

## Configure UPS Prepaid Labels for HSN Orders in Shipbridge

To set up HSN’s UPS account in Shipbridge:

1. Open Shipbridge and go to **Menu > Options > Carriers > UPS**.
2. Click **Configure Third Party Billing.**

3. Click **Configure** next to the correct company.
4. Check the **HSN** box.
5. Enter the UPS Account number provided by HSN in the **Account #** field.
6. Fill out the required address information.
7. Check **Use account - not as 3rd party** and **Use account for all UPS Services**.
8. Click **Save**.