Configuring your Unicommerce account with Eshopbox

Configuring your Unicommerce account with Eshopbox

This article will outline the tasks you need to complete to integrate Unicommerce with Eshopbox.

Before you start, ensure you have a Unicommerce account with an online store.

Setting up Unicommerce with Eshopbox

Follow the below steps to integrate Unicommerce with Eshopbox:

Step 1: Install the Unicommerce app

Follow the below-given steps to install the Unicommerce app in Eshopbox.

  • From the sidebar of the Eshopbox workspace, navigate to Apps

  • Click on the Unicommerce app icon.

  • Once installed, you will see ‘Success’ mentioned in green on the box's top right corner.

Step 2: Connect your Unicommerce account

  • Enter your Unicommerce account name. Learn here how to find your Unicommerce account name.

  • Enter your username and password that was used to create the Unicommerce account.

    Note: Eshopbox recommends you create a user in your Unicommerce account to be used only for Eshopbox integration. This way, any activity in your Unicommerce account performed by the user can be attributed to being done using integration.

    Also, ensure this user has Admin access to the facility for which Eshopbox will fulfil the orders, access to process orders and update inventory. Also, whenever you change this user account's password, you need to immediately reconnect the Unicommerce app in the Eshopbox workspace using the new credential.

  • Click on Connect.

Note: You will be redirected to the next step if the connection is established successfully.

If the username, password, or tenant name is entered incorrectly, an error for invalid credentials will be displayed on the workspace. Therefore, you must cross-check the credentials and fill in the same again.

Step 3: Configure your fulfillment locations

You need to toggle on the Locations you wish to connect with Unicommerce. Then, for every Fulfilment center, you need to create a Unicommerce facility. Learn here how to create a new facility on Unicommerce.

Once the facility is created, enter the facility code for the chosen location. You can find the facility code in Unicommerce by navigating to Settings > Facilities > {Search or Select the facility from the list}.

In the list, the facility code is shown in italics before the warehouse display name.

Note: If you are connecting multiple Eshopbox locations with a shopping cart platform using Unicommerce, you also need to set the facility allocation rules in Unicommerce. Also, you need to contact Eshopbox to get this configured.

Step 4: Make your product available on Unicommerce

You must make your products available on Unicommerce to fulfill orders placed on various sales channels. Learn here how to manage product availability.

You cannot run inventory sync for the fulfilment locations where you do not want to manage inventory.

Step 5: Configure automation

Automation will help you easily streamline repetitive tasks and processes you want to automate for Unicommerce. For example, Eshopbox allows you to sync inventory, orders, and order updates automatically in Unicommerce.

5.1 Sync Inventory levels

Toggle this button 'on' to update Unicommerce inventory quantities for inventory level changes in Eshopbox. Whenever there is a change in inventory levels in Eshopbox, the corresponding inventory quantities in Unicommerce will be updated. In case of a stockout, inventory will be updated instantly.

Note: Eshopbox always updates the inventory on the default shelf. Therefore, make sure the Unicommerce facility has a shelf named DEFAULT. If you choose to toggle the button off, then Eshopbox will not update inventory levels to Unicommerce. In this case, you need to manage inventory levels manually in your Unicommerce admin.

If you have turned the automation 'on', then turning 'off' the automation will stop any further updates to Unicommerce stock. If you want to deactivate your listings from Unicommerce, you will have to make your stock zero for those products from your Unicommerce account.

5.2 Import orders

Toggle the button 'on' to Import orders in Eshopbox. If a new shipment is created on Unicommerce, then an order for the same will be created on Eshopbox.

This automation allows you to configure a specific start date from which to import Unicommerce orders. This is helpful if you were using the same unicommerce facility to process orders for some other location or for some testing purpose and want to avoid earlier orders being imported in Eshopbox.

Note:

  • Once unicommerce imports an order from a sales channel, it will assign inventory and the facility for the order to be fulfilled. The marketplace mainly governs the facility assignment. For shopping carts, facility allocation rules have to be configured in Unicommerce. Contact Eshopbox for help on this.

  • Once the facility is assigned, Unicommerce will create a shipment. Unicommerce may create multiple shipments for an order if all the items in an order are unavailable in one facility. A new order will be created in Eshopbox for every Unicommerce shipment.

  • The order may only be fulfilled in Unicommerce if there is sufficient inventory to fulfil the order. No Unicommerce shipment will be created for such orders, and no new orders will be created in Eshopbox. Learn here how to troubleshoot unfulfillable orders on Unicommerce.

  • Similarly, an order may be in failed status in Unicommerce if there are issues with the SKU or the address in the order. No unicommerce shipment is created for such failed orders, and new orders will not be created in Eshopbox. Learn here how to troubleshoot failed orders on Unicommerce.

5.3 Create returns

Toggle the button 'on' to mark the order as returning when the reverse pickup is created on Unicommerce.

Select the date for which you wish to mark the order as returning. Return created after the selected create returns date will be imported from Unicommerce.

You need to sync the returns created on Unicommerce with Eshopbox. In addition, the status of the returns received at Eshopbox needs to be updated on Unicommerce.

If the item received in return is marked as sellable in QC, the inventory will be marked as Good on Unicommerce.

If the item received in return is marked as non-sellable in QC, the inventory will be marked as Bad inventory on Unicommerce.

Eshopbox Status

Unicommerce Reverse Pickup Status

Unicommerce Sale Order Status

Unicommerce Inventory type

Restocked

Complete

Canceled

Good

Lost in Processing

Complete

Canceled

Bad

Quarantined

Complete

Canceled

Bad

For Reverse pickup of a return, the shipment status will be as follows.

UC Reverse Pickup status

Eshopbox return status

Created

Return on the Way / Return in Processing

Courier Allocated

Return on the Way / Return in Processing

5.4 Cancel orders

Turn the toggle ON to cancel orders in Eshopbox automatically. This means if an order is cancelled on Unicommerce, it will also be cancelled on Eshopbox. Additionally, if an order is cancelled in Eshopbox (including via the customer portal for Eshopbox-fulfilled orders), it will also be cancelled in Unicommerce automatically.

When any order items are cancelled, the shipment is marked as 'Cancelled' on Unicommerce. If a shipment is cancelled on Unicommerce, the corresponding Eshopbox order is also cancelled.


If the shipment is not marked as cancelled on Unicommerce, then the order will not get cancelled automatically on Eshopbox.

Below are the reasons for the cancellation of an order on Unicommerce:

  • One or more of the ordered items in the shipment are cancelled.

  • The shipment was split into multiple shipments

  • The facility for an item in the shipment was switched

If you turn the toggle OFF, then cancellations made on either platform will not sync automatically. You will need to manually cancel orders in Eshopbox or Unicommerce based on where the original action was taken.

Step 6: Click on Save to save the automation set.