Essendant Account Integration

Overview

Essendant Inc., previously operating under the name United Stationers, is recognized as a leading national wholesale distributor of office supplies. Their product range includes traditional office supplies, furniture, janitorial and breakroom essentials, and technology products. 

Integrating Essendant allows you to export your orders and import acknowledgment and tracking information. The integration works through EDI documents, transmitting information between the two services via plugins and Scheduled Tasks.

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

Prerequisites

Before you can integrate Essendant into 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.
You must Create a Vendor under the company designated for the integration and configure your Vendor SKUs. You will need the designated Vendor ID for the Essendant_VendorID custom setting.

Essendant Support

You must contact Essendant for your FTP details: Server Name, Username, and Password. You will need them when setting up the scheduled tasks to automate the plugins.

Sellercloud Support

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

  • Essendant Order Export EDI 850 – Exports orders from Sellercloud to Essendant in EDI 850 format.
  • Essendant Order Import EDI 855 – Imports order acknowledgment from Essendant in EDI 855 format.
  • Essendant Tracking Import EDI 856 – Imports tracking information from Essendant in EDI 856 format.

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

Custom Company Settings

Create the following Custom Company Settings.

On your default company:

  • STControlNumber
  • GSControlNumber
  • ISAControlNumber
ISAControlNumber, GSControlNumber, and STControlNumber can all start at 1. The order export will increment this number 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:

  • Essendant_CustomerISAID – Your ISA ID. Typically, this is your phone number but it can be anything you set up with Essendant.
  • Essendant_CustomerQualifier – Your Qualifier. Set to ZZ.
  • Essendant_ISAID – Essendant’s ISA ID. This is provided by Essendant.
  • Essendant_Qualifier – Essendant’ qualifier. Set to 01.
  • Essendant_VendorID – The ID of the Vendor you created for this integration. 
  • Essendant_BuyerStoreNumber  – Provided by Essendant.
  • Essendant_IsInProduction  – The value should be set to False during the EDI testing process. Once you have completed it, set it to True to move into Production.
  • (Optional) Essendant_UseOrderSourceOrderID – The default value is False. When set to True, the plugins will use the Order Source Order ID instead of the Sellercloud Order ID as the order identifier.

Custom Product Columns

Create the following Custom Product Columns:

  • (Optional) Essendant_Enabled – This column enables only specific products for Essendant. Set it to True for any products you want to send with the Inventory Export plugin. The data type is Boolean.
  • Essendant_SKU – If the Essendant product ID differs from the Sellercloud SKU, enter it here. The data type is String.
  • (Optional) Essendant_SafetyQty – A Safety Quantity for products on Essendant. The data type is Integer.

Custom Order Columns

Create the following Custom Order Columns:

  • BOL – This is for the Bill of Lading document issued to a shipper by the transportation company. The Tracking Import plugin will automatically fill this in for each order after processing. The Data Type should be string, and the String Length should be set to 50.

Order Export

The Essendant Order Export EDI 850 plugin exports order data to Essendant in EDI 850 format and sets the order’s Dropship Status to Requested. The plugin also creates and links a Purchase Order.

Orders will be skipped if they contain unsupported characters within the Shipping Address and Customr Name.

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

  • Company – The company designated for the integration
  • Order Status – Processing
  • Dropship Status – DropShip None
  • Payment Status – Charged
  • Exported – Not Exported

You can add other filters to narrow down the list of orders further. For example, you can create an Order Group specifically for Essendant to ensure only the correct orders are sent.

Automate Order Export

To create a Scheduled Task that exports 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 Export Orders.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
    5. Click CREATE.
  4. The Scheduled Task Details page will open automatically. Click the Edit button on the top right.
  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 Plugin menu and select Essendant Order Export EDI 850.
    4. Check Mark Orders as Exported.
  6. In the Export Options panel, set Export To to FTP and fill out the FTP fields.
  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 button.
  9. Click Save.

Order Acknowledgment

The Essendant Order Import EDI 855 plugin imports order acknowledgment to Sellercloud following the 855 EDI format and sets the order’s Dropship Status to Acknowledged.  If the order cannot be fulfilled, the Dropship Status will be set back to None, and the order will be placed On Hold.

The plugin updates the Item Cost on the order based on the information in the acknowledgment file. Additionally, the Vendor Price of the product is also updated to reflect the correct Essendant price. 

Automate Order Acknowledgment

To create a Scheduled Task that imports order acknowledgment:

  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 Scheduled Task Details page will open automatically. Click the Edit button at the top right corner.
  5. In the Details panel:
    1. Click the Import Via menu and select Essendant Order Import EDI 855.
  6. In the Import Options panel, set Import From to FTP and fill out the FTP fields.
  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.


Tracking Import

The Essendant Tracking Import EDI 856 plugin imports tracking information from Essendant to Sellercloud following the 856 EDI format. It sets the order Dropship Status to Processed and receives the linked PO. The order’s Ship Date is set to the time of import rather than the actual shipping date received in the file.

The Client Setting Do Not Mark Drop Ship PO As Received When Order Shipped must be disabled for the plugin to receive and close linked POs. If you enable it, you must process the Purchase Orders manually.

If an order was originally acknowledged but an issue during picking prevents fulfillment, the plugin will place it On Hold in Sellercloud.

The plugin supports importing multiple tracking numbers for multi-package shipping.

Automate Tracking Import

To create a Scheduled Task that imports 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 Import Orders.
      2. Set the Task Name.
      3. Select the Company.
      4. Select the Start Time.
      5. Click CREATE.
  4. The Scheduled Task Details page will open automatically. Click the Edit button at the top right corner.
  5. In the Details panel:
    1. Click the Import Via menu and select Essendant Tracking Import EDI 856.
  6. In the Import Options panel, set Import From to FTP and fill out the FTP fields.
  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.


 

Was this article helpful?

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