Skip to main content

Unicommerce Integration

The Unicommerce Integration enables seamless two-way synchronization between ERPNext and Unicommerce (Uniware). It helps businesses manage products, inventory, orders, invoices, shipments, cancellations, and returns across multiple eCommerce marketplaces from a single ERP system.

Summary

  • Two-way Item Catalog synchronization.
  • One-way Inventory synchronization from ERPNext to Unicommerce.
  • Automatic Sales Order synchronization.
  • Supports Sales Invoice synchronization or invoice generation from ERPNext.
  • Handles order cancellations and returns automatically.

Install the Unicommerce Connector

The Unicommerce integration is available as a separate Frappe application.

  1. Install the ecommerce_integrations app.
  2. If using Frappe Cloud, install it directly from the Marketplace.
  3. If using a Frappe-hosted instance, request installation through Frappe Support.
  4. If self-hosting ERPNext, install the application using Frappe Bench.

Authenticate with Unicommerce

  1. Open Unicommerce Settings.
  2. Enable Enable Unicommerce.
  3. Enter:
    • Unicommerce Site URL
    • Username
    • Password
    • Client ID (if different from the default)
  4. Click Save.
  5. After successful authentication, ERPNext generates Access and Refresh Tokens automatically.
Note

If authentication fails, verify your credentials or contact the Unicommerce support team to whitelist your server IP address.

Configure Item Synchronization

ERPNext can automatically upload newly created Items to Unicommerce.

  1. Enable Upload New Items to Unicommerce.
  2. Select a Default Item Group.
  3. Enable Sync with Unicommerce on Items that should be synchronized.
  4. Map every ERPNext Item Group to its corresponding Unicommerce Product Category.

Item Field Mapping

ERPNext Field Unicommerce Field
Item Code SKU
Item Name Item Name
Description Description
Weight per Unit Weight
Shelf Life (Days) Shelf Life
HSN Code HSN Code
Image Image
Length Length
Width Width
Height Height
Disabled Enabled (Inverse)
EAN Barcode EAN
UPC Barcode UPC-A
Item Group Product Category
Important

The Unicommerce SKU is immutable. Avoid changing the ERPNext Item Code after the Item has been synchronized.

Configure Inventory Synchronization

Inventory quantities maintained in ERPNext are treated as the source of truth and are periodically pushed to Unicommerce.

  1. Enable Inventory Sync.
  2. Choose the synchronization frequency.
  3. Map ERPNext Warehouses with Unicommerce Facility Codes.
  4. Enable the required facilities.
  5. Save the configuration.
Note

  • Inventory is always pushed to the DEFAULT shelf.
  • Fractional inventory quantities are not supported.

Configure Sales Order Synchronization

Default Settings

  1. Open Unicommerce Settings.
  2. Configure the Sales Order synchronization frequency.
  3. Select the default Customer Group.
  4. Configure document naming series.

Channel Configuration

Each marketplace channel requires its own configuration.

  1. Create a new Unicommerce Channel.
  2. Enter:
    • Channel ID
    • Company
    • Warehouse
    • Accounts
    • Naming Series
  3. Enable Shipping Handled by Marketplace if applicable.
  4. Enable the channel.

New orders received through the configured channels are automatically imported as ERPNext Sales Orders. Missing Items are created automatically when required.

Sales Invoice Processing

The integration supports two invoice processing methods.

Option 1: Process Invoices in Unicommerce

Enable Only Sync Completed Orders to synchronize only completed orders from Unicommerce.

Option 2: Generate Invoices in ERPNext

  1. Open the synchronized Sales Order.
  2. Select Unicommerce → Generate Invoice.
  3. ERPNext creates the Sales Invoice and updates inventory automatically.

Shipment Manifest

If invoices are generated in ERPNext, shipment manifests can also be created from ERPNext.

  1. Create the required Shipping Provider and Shipping Method.
  2. Create a new Unicommerce Shipment Manifest.
  3. Select:
    • Channel
    • Shipping Method
    • Shipping Provider
  4. Retrieve packages or scan AWB codes.
  5. Save and submit the manifest.

After submission, ERPNext creates the corresponding shipment manifest in Unicommerce, marks shipments as dispatched, and retrieves the generated manifest PDF.

Order Status Updates

ERPNext periodically updates the latest Unicommerce order status, which can be viewed from the Unicommerce Details section of the Sales Order.

Order Cancellation Synchronization

Order cancellations are synchronized automatically between Unicommerce and ERPNext.

  • Fully cancelled orders are cancelled in ERPNext.
  • Partially cancelled orders update the Sales Order by removing cancelled items.
  • Cancellation synchronization runs periodically and before invoice generation.

Order Returns

Returns created in Unicommerce automatically generate Draft Credit Notes in ERPNext.

Supported Return Types

  • Return to Origin (RTO): Creates a full Credit Note with stock update.
  • Customer Initiated Return (CIR): Creates full or partial Credit Notes depending on returned items.

The Return Warehouse configured in Unicommerce Settings is used while processing returns. If no Return Warehouse is configured, ERPNext uses the original warehouse from the Sales Order.

Result

  • Products and inventory remain synchronized between ERPNext and Unicommerce.
  • Sales Orders are imported automatically from supported sales channels.
  • Invoices, shipment manifests, cancellations, and returns can be processed efficiently within ERPNext.
Rating: 0 / 5 (0 votes)

© 2026 | goERPNext | All rights reserved