Unicommerce is aggregator for many e-commerce platforms that allows you to sell items through many supported marketplaces and process order via unified interface called Uniware.

BizCentric Integration with Unicommerce

BizCentric provides comprehensive two-way integration with Unicommerce through Uniware’s REST APIs. This integration encompasses the following key functionalities:

1. Synchronization of item catalogues with Unicommerce (bi-directional)
2. Inventory synchronization (one-way from BizCentric to Unicommerce)
3. Synchronization of new sales orders
4. Synchronization of sales invoices or generation of sales invoices (either option can be utilized)

App Installation 

• If your BizCentric site is hosted on the Bizcentric Cloud, you can easily install the app directly from your site Dashboard.
• if your site is hosted by Bizcentric, please submit a support ticket to have the app installed on your site.

Authentication and basic setup

After installing the app, navigate to the “Unicommerce Settings” page.

• • Select the “Enable Unicommerce” checkbox.
  • Input your Unicommerce site URL, username, and password.
  • The Client ID is automatically included, but if you’ve configured a separate one, ensure to update it here. If uncertain about your Client ID, please contact the Unicommerce support team.
  • Click “Save” to commence the authentication process with Unicommerce and configure custom fields for integration.
  • Upon completion of this setup, you’ll find access and refresh tokens in the “Authentication Details” section. This indicates successful authentication, allowing you to proceed with further setup tasks.

If authentication fails:

Please review the entered details for accuracy.

1. Your server could potentially be blocked by a firewall. Contact the Unicommerce support team to have your server’s IP address whitelisted.

Item Sync

This integration periodically checks for newly created items and transfers them to Unicommerce. To activate this functionality, follow these steps:

1. Navigate to “Unicommerce Settings” and enable the option “Upload new items to Unicommerce”.
2. Specify a Default Item Group. This serves as a fallback in case the item group is absent.
3. When creating a new item, ensure to select the “Sync with Unicommerce” checkbox to upload it to Unicommerce. This checkbox can also be activated for existing items.

Keep in mind that the Unicommerce SKU code is immutable, so refrain from altering the Item Code after creation.

For accurate synchronization of item groups with product categories, it’s essential to map all item groups to their corresponding product categories on Unicommerce.

To map and item group to product category:

1. First find product category code on Unicommerce.
2. Open related Item Group on BizCentric and update Unicommerce product category code there.

Inventory Sync 

Once Item sync is setup Inventory Sync can be enabled. The integration checks for changes in BizCentric inventory and pushes them to Unicommerce on configured interval. BizCentric inventory levels are considered source of truth by the integration and Unicommerce inventory levels are overwritten by BizCentric’s inventory values.

1. Go to “Unicommerce Settings” and scroll down to “Inventory Sync” section.
2. Check “Enable inventory Sync”
3. Configure the sync frequency. Recommended frequency is 15 to 60 minutes.
4. In Warehouse mapping table add all the facility codes you have in Unicommerce and map them with BizCentric warehouse.
5. Check “Enabled” checkbox for all facilities you want to enable.
6. Save the settings.

Note: All inventory is pushed to “DEFAULT” shelf. Unicommerce Shelves are not supported by this integration, make sure you only have one shelf on Unicommerce called “DEFAULT” to ensure correctness of inventory sync.

Note: Unicommerce, like other e-commerce integrations does not support fractional inventory.

Sales Order Processing – Workflow

Here’s the workflow for handling orders on BizCentric. Alternatively, you can opt to process orders on Unicommerce and only synchronize completed orders.

Sales Order Sync – Channel(s) Setup

Unicommerce Integration supports receiving and processing from multiple channel. To allow this, setup for Sales Order sync also has to be done in multiple stages.

Defaults for Sales Order Sync

1. Go to “Unicommerce Settings”.
2. Scroll to “Sales Order Sync” setting section.
3. Setup order sync frequency. 30 to 60 minutes is recommended frequency.
4. Setup default customer group and naming series for documents.

Channel specific Sales Order sync configurations

To facilitate flexible configuration for each channel, you’ll need to generate a “Unicommerce Channel” document for every channel you wish to activate for Sales Order synchronization.

Follow these steps:

1. Access “Unicommerce Channel” either through the search bar or the Unicommerce settings page.
2. Click on “Add Unicommerce Channel”.
3. Provide the necessary details such as channel ID, default warehouse, company, accounts, and naming series.
4. If shipping for this channel is managed by the marketplace, select the “Shipping Handled by Marketplace” option, or leave it unchecked if not.
5. Once the channel is fully configured, enable it by checking the “Enabled” checkbox.

Subsequently, new Sales Orders generated in Unicommerce will initiate synchronization with BizCentric. During this process, if a new item is encountered, it will be generated in BizCentric using information from Unicommerce. Relevant details regarding the Unicommerce order will be mapped to BizCentric fields, with additional information available in the “Unicommerce Details” section on the Sales Order.

Sales Invoice Sync

Sales Invoice syncing can be handled in one of two ways. Please select the appropriate option as per your needs.

1. Processing invoice on Unicommerce (recommended)

If you opt to manage orders and invoices within Unicommerce and synchronize exclusively fully processed orders with BizCentric, activate the “Only Sync Completed Orders” option in the Unicommerce settings.

2. Processing invoice on BizCentric

If you intend to solely process orders from BizCentric, you must generate an invoice from BizCentric’s Sales Order.

To generate an invoice, navigate to the synced Unicommerce Sales Order, and click on “Unicommerce > generate invoice”. This action will generate a Sales Invoice and deduct the stock accordingly.

Shipment Manifest

If you’re managing orders on BizCentric using method #2 as outlined previously, you’ll need to generate and submit a shipping manifest to inform Unicommerce that the orders have been shipped.

To proceed, ensure you’ve set up the following document types, and you can locate the code on the Unicommerce manifest creation page:

1. Establish the Unicommerce Shipping Provider
2. Establish the Unicommerce Shipping Method

Process of creating manifest:

1. 1. When ready to dispatch packages, create a “Unicommerce Shipment Manifest” document.
   2. Access it via the search bar by typing “Unicommerce Shipping Manifest” and then clicking on “+ Add”.
   3. Select Channel ID, Shipping Method, and Shipping provider code.
   4. Utilize either the “Get Package” button to fetch open orders based on selected filters or the “Scan AWB Code” field to scan AWB of packages.
   5. After saving, remaining details will auto-populate.
   6. Verify all details are correct, then save and submit the document.
   7. Upon submission, the same manifest is created and closed on Unicommerce, marking shipments as “Dispatched”.
   8. The Unicommerce Manifest PDF is fetched and attached to the BizCentric manifest document.

Status Updates

The status of Unicommerce is regularly refreshed in BizCentric, and you can view the current status in the “Unicommerce details” section.

Order Cancellations

In the event of an order cancellation on Unicommerce, the integration mirrors this action by cancelling the corresponding order on BizCentric. Additionally, partially cancelled orders undergo synchronization, with cancelled items being removed from the BizCentric Sales Order. Both full and partial cancellations are synchronized on an hourly basis and immediately before invoice generation.

Order returns

When a return is initiated on Unicommerce, the integration mirrors this action by generating a Draft Credit Note in BizCentric.

The integration handles both return cases as follows:

1. RTO (return to origin): When a shipment is returned to the origin, the shipment status changes, and a Credit Note (with Update Stock) is created in BizCentric. The Credit Note represents a full return.
2. CIR (Customer Initiated Return): When a customer returns a shipment, this action is reflected in Unicommerce’s Sales Order section. A full or partial Credit Note is generated based on the nature of the customer-initiated return.

To review all returns, navigate to “Sales Invoice” and apply a filter where “Is Return” is set to Yes. The return tracking code is also captured on the Credit Note.

During return creation, the return warehouse is determined by the configured Return Warehouse in the Unicommerce settings. If this setting is not specified, the original warehouse will be used.