Skip to main content

Using Unicommerce Extension

Introduction

The Unicommerce extension facilitates real-time synchronization of inventory and order data between Fynd Platform and Unicommerce, ensuring that your stock levels are up-to-date and that all orders are tracked and fulfilled accurately, making the process of selling on marketplaces and websites seamless for sellers.

note

Once you have installed this extension, it will be available in the Extensions section on Fynd Platform.


Pre-requisites to use this extension

  1. Your entire product catalogue should be available on Fynd Platform. Proceed only if you have uploaded your catalogue. For a tutorial, watch How to Upload Product Catalogue.
  2. Add selling locations in Fynd Platform. Refer Add Selling Locations for details. For a tutorial, watch How to Add Selling Locations.

First-time Installation Setup

When you set up the Unicommerce extension for the first time, two sync operations will be performed, post which you will be able to use the extension:

  • Catalogue Sync - This operation will sync all the catalogue present in Fynd Platform to the extension.

  • Location Sync - This operation will sync all the selling locations added by you in Fynd Platform to the extension.

Once the sync is completed, you have to opt-in selling locations so that you can then proceed to use the extension to send inventory updates and accept orders via the Unicommerce panel.

Any changes made to the catalogue or locations in Fynd Platform after the initial setup will be communicated to the extension via webhook events, ensuring that the extension is always up to date.


To accept and update your inventory using Unicommerce, use below configurations.


Selling Location

Opt-in selling locations to send inventory updates and process orders via the Unicommerce panel. Use bulk action to opt-in multiple selling locations at once.

How to opt-in a selling location?

  1. Open Selling Location widget present on the homepage of this extension.

QG1

Figure 1: Selling Location

  1. Search for a particular location by entering its 'Location Code' in the searchbox.

  2. Click edit option present under Action column.

QG1

Figure 2: Edit Location

  1. Turn ON the toggle to start sending inventory and receive orders for this location (push inventory data and pull orders data).

QG1

Figure 3: Turn ON Toggle

  1. You can also set a buffer on a selling location, which will be applied to all articles mapped to that Selling Location.

QG1

Figure 4: Set Buffer

  1. Click option to save the changes.

QG1

Figure 5: Active Location

On successful opt-in, a unique username and token will be generated for that selling location, which has to be used to send inventory to Fynd Platform and receive order updates from Fynd Platform.

note

After opting out of a selling location, you must wait for at least 10 minutes before re-opting into the same selling location.

info

Click Set Buffer to set a global buffer for all selling locations. This buffer will be applied to all active and inactive selling locations.

How to opt-in selling locations in bulk?

  1. Click Bulk Action.

QG1

Figure 6: Select Bulk Action

  1. Choose the status of locations from the dropdown. Here, we have selected All Locations.

  2. Choose either EXCEL or CSV from the Download dropdown. A file will be downloaded.

QG1

Figure 7: Select Location and Download

  1. Open the file and make the following changes in the downloaded file:

QG1

Figure 8: Downloaded File

  • Opt-in selling locations by marking Status as ACTIVE
  • Opt-out of selling locations by marking Status as INACTIVE
  • Set Buffer Quantity for multiple selling locations
  • Reset inventory to 0 for any location you marked as Active/Inactive by marking the Reset Inventory column as Yes.
  • Save the file
  1. Click Choose File to upload the saved file. Please wait until its status changes to COMPLETED.

QG1

Figure 9a: Upload File

QG1

Figure 9b: Upload Complete

In this way, you can opt-in selling locations in bulk.

Note 1

If there were errors in uploading the file, there will be an error file which will be generated. Download the error file, fix the errors mentioned, and re-upload the file.

Note 2

After applying buffer to any selling location,

  1. You need to manually sync inventory for that specific location or all locations for the updated inventory (Inventory received from Unicommerce - Buffer Quantity) to be pushed to Fynd Platform. OR
  2. The updated inventory (Inventory received from Unicommerce - Buffer Quantity) will be pushed to Fynd Platform automatically upon receiving new inventory updates from Unicommerce.

Inventory

Track inventory updates, check acknowledgement logs of inventory flow from Unicommerce to Fynd Platform, manually sync inventory from extension to Fynd Platform, and trace a product.

QG1

Figure 10: Select Inventory

This tab provides a snapshot of your latest inventory updates on SKUs, with detailed information about:

  • Received Inventory - Inventory received from seller via Unicommerce.

  • Buffer Quantity - Buffer applied on Selling Location x Article on Unicommerce extension.

  • Pushed Inventory - Inventory pushed to Fynd Platform after applying buffer quantity.

  • Sellable Quantity - Live inventory in Fynd Platform.

  • Orders Committed - Orders received on Fynd Platform for an SKU.

QG1

Figure 11: Inventory Details

The date filter allows you to track inventory updates for up to a one year.

Logs

Logs can be used to track inventory flow from Unicommerce to Fynd Platform.

QG1

Figure 12: Logs

Inventory logs consist of the inventory data Fynd Platform received from Unicommerce in batches.

The detailed logs option consists of the inventory data broken down into more batches sent from the Unicommerce to Fynd Platform.

A request ID is assigned to each batch of inventory updates.

Manual Sync

The operation is used in case there is any mismatch in quantity or price in Fynd Platform and in Unicommerce extension. Use manual sync to synchronize the inventory to Fynd Platform and eliminate any mismatch between extension and Fynd Platform in either quantity or price.

Use this functionality after applying buffer so that inventory flows to Fynd Platform after subtracting buffer quantity.

Once the sync is completed, the changes would reflect on your opted sales channels.

You can sync Inventory manually to Fynd Platform by using:

  • Seller Identifier - This will sync the inventory for all SKUs or manually selected SKUs present across all selling locations.
    • All seller identifiers
    • Comma-separated multiple seller identifiers

QG1

Figure 13: Select Seller Identifier

  • Location Code - This will sync the inventory for all SKUs present in these selling locations.
    • All active location codes
    • Selected location codes

QG1

Figure 14: Select Location Code

Trace Product

  1. Copy the seller identifier of desired product from Inventory tab.

  2. Go to Trace Product tab.

  3. Paste the seller identifier (that we have copied in step 1) in searchbox.

  4. Click Get Logs. Here, you will get status about inventory updates of a product for up to a month.

QG1

Figure 15: Trace Product

  • Inventory Received - The total no. of inventory of products pushed into Fynd Platform by Unicommerce.
  • Inventory Consumed - The total no. of inventory of products accepted by Fynd Platform from Unicommerce after applying buffer quantity.

Also, this tab lets you know whether an article’s inventory push was successful or not. Failure reasons could be: article not available, store mapping not found, discovered duplicate batch record, SKU missing for a store, location not available, and so on.


Order Logs

This feature in the Unicommerce extension maintains a detailed record of all the order-related operations performed by the seller on Unicommerce panel.

QG1

Figure 16a: Order Logs

QG1

Figure 16b: Order Logs

This includes a wide range of activities such as polling, confirming, cancelling, packing, dispatching orders, managing invoice details, getting courier information, as well as generating label and invoice pdfs.

By using the Order Logs, the seller can quickly and easily gain an overview of recent interactions and their corresponding statuses.

To ensure accurate tracking of each activity, a unique request ID is assigned, and the panel displays all relevant request details, including the request URL, parameters, and responses.


Audit Trail

Audit Trail tracks all the actions performed by the user in the Unicommerce extension.

QG1

Figure 17: Audit Trail

It helps you pinpoint the exact source of a problem in case someone unsolicitedly does something unexpected within the extension.

QG1

Figure 18: Audit History

List of events that get captured: Extension Install, Extension Uninstall, Extension Enable, Extension Disable, Inventory Manual Sync, Catalogue Sync, Locations Sync, Location Edit, Enable Inventory Permission, Disable Inventory Permission, Enable Order Permission, and Disable Order Permission.


Settings

Manually sync your catalogue and selling locations from Fynd Platform to Unicommerce, and customise your Order and Inventory permissions as well as enable or disable this extension according to your preferences.

QG1

Figure 19: Select Settings

Activating/Deactivating Unicommerce Extension

Upon deactivating this extension, you will get a popup asking if you want to reset the inventory of all active selling locations to 0 in Fynd Platform

QG1

Figure 20: Reset Inventory

  • If you choose yes, inventory for all articles mapped to the selling locations will be reset to 0 in Fynd Platform
  • If you choose no, the current existing inventory will be retained.
  • No tabs and functionalities will be accessible. Only Settings widget will be enabled so that you can re-enable the extension.
  • Inventory flow from Unicommerce to Fynd Platform and orders syncing from Fynd Platform to Unicommerce will be stopped.

Manually Sync Catalogue and Selling Locations

Click Sync to manually sync catalogue and selling locations data present in Fynd Platform to Unicommerce extension.

QG1

Figure 21: Manual Sync

When catalogue or location sync jobs are in progress, the extension will not be usable.

Enable/Disable Inventory and Order Permissions

Both order and inventory permissions will be enabled by default if the extension is enabled.

Inventory - If you remove the permissions for inventory, the inventory flow from Unicommerce to Fynd Platform will be stopped.

QG2

Figure 22a: Disable Inventory Permission

QG2

Figure 22b: Reset Inventory

  • If you select the reset Inventory checkbox, the inventory will be reset in Fynd Platform and you will stop receiving new orders.
  • If you do not select the reset Inventory checkbox, the inventory will stay as it is in Fynd Platform and the seller will continue receiving orders.

Orders - Upon removing the permissions for orders, it will stop the flow of orders from Fynd Platform to Unicommerce.

QG2

Figure 23a: Disable Order Permission

QG2

Figure 23b: Disable Order Permission

If there is inventory present in Fynd Platform, the seller might still receive new orders but will not be able to see them in Unicommerce panel. Thus, you will have to process all these new orders using Orders section of Fynd Platform.

Older orders which had been placed before the extension was disabled will also have to be processed Orders section of Fynd Platform.