Unicommerce Integration

Edit Page New Page Revisions

Unicommerce Integration

With the help of Unicommerce, you may sell goods on a variety of approved marketplaces and handle orders using a single interface known as Uniware. Visit https://unicommerce.com/ to learn more about Unicommerce.

ERPNext Integration with Unicommerce

With Uniware's REST APIs, ERPNext delivers a complete two-way interface with Unicommerce. This connection is offered through the official Frappe App, which is maintained by the Frappe team. In general, this integration includes

  1. Syncing the item catalog with Unicommerce (2-way)
  2. Syncing your inventory (1-way from ERPNext to Unicommerce)
  3. Syncing of new sales orders
  4. Generating or synchronizing sales invoices (Any one option should be used)

App Installation

  • By visiting to your site's Dashboard, you may rapidly install the app if Frappe Cloud is hosting your ERPNext site. The application is offered in the Frappe Cloud Marketplace.
  • To get the app loaded on your site if Frappe is hosting it, submit a support ticket.
  • You can use the Frappe bench to install ERPNext if you're self-hosting it. To install Frappe Apps, consult the bench documentation. ecommerce integrations bench get-app —branch main

Authentication and basic setup 1. After installing the software, go to the "Unicommerce Settings" tab. 2. Choose the checkbox next to "Enable Unicommerce". 3. Input your Unicommerce site, username and password. 4. The client ID is added by default, but you must alter it if you've configured a different client ID. Please contact the Unicommerce support team if you're unclear of your client ID. 5. Click "Save" to begin the process of setting up custom fields for integration and logging into Unicommerce. 6. When the configuration is complete, access/refresh tokens will appear in the "Authentication Information" section. This suggests that the authentication process was successful, and you can now begin setting up more things.

If authentication fails:

  1. Please verify the information you typed.
  2. Your server may be added to a firewall's blocklist. Contact the Unicommerce support team to have the IP address of your server whitelisted.

Item Sync On an hourly basis, this integration checks for newly produced goods and uploads them to Unicommerce. You must set up the following in order to enable this feature:

  1. Choose "Upload new items to Unicommerce" and turn it on in the "Unicommerce Settings" window.
  2. Default item groups can be set. This is only used as fallback in case item group is lacking.
  3. To upload a new item to Unicommerce, use the "Sync with Unicommerce" checkbox while creating the item.
  4. Existing items can also have this tick enabled.

As the Unicommerce SKU code is unchangeable, you shouldn't alter an item's code after it has been created.

All item groups must be mapped to their appropriate product categories on Unicommerce in order for item groups and product categories to be correctly synced.

To relate a product category to an item group:

  1. Find the Unicommerce product category code first.

  2. Access the relevant Item Group on ERPNext and make the necessary updates to the Unicommerce product category code.

Inventory Sync Once Item sync is setup Inventory Sync can be activated. The integration monitors ERPNext inventory changes and pushes them to Unicommerce at predetermined intervals. The integration considers ERPNext inventory levels to be the source of truth, and Unicommerce inventory levels are replaced by ERPNext's inventory values.

  1. Go to "Unicommerce Settings" and select "Inventory Sync" from the list.
  2. Tick the "Enable inventory Sync" box.
  3. Set the synchronization frequency. The suggested range is 15 to 60 minutes.
  4. Add all of the Unicommerce facility codes to the Warehouse mapping table and map them to the ERPNext warehouse.
  5. Tick the "Enabled" box next to each facility you want to make available.
  6. Save the configuration.

Every inventory has been moved to the "DEFAULT" shelf. For the validity of the inventory sync, make sure you only have one shelf on Unicommerce called "DEFAULT" because Unicommerce Shelves are not supported by this integration.

Unicommerce does not handle fractional inventory, like other e-commerce integrations.

Sales Order Processing - Workflow

The process sequence for processing orders on ERPNext is shown below. As an alternative, you can use Unicommerce to process orders and then just sync finished ones.

Sales Order Sync - Channel(s) Setup Several channels can be received and processed via Unicommerce Integration. To allow this, setup for Sales Order sync also has to be done in different phases

Defaults for Sales Order Sync 1. Visit "Unicommerce Settings" first. 2. Go to the "Sales Order Sync" configuration section by scrolling. 3. Order sync frequency setup. Regular intervals of 30 to 60 minutes are advised. 4. Create a default customer group and document naming scheme.

Channel specific Sales Order sync configurations

To allow for customizable configuration for each channel you need to create "Unicommerce Channel" document for each channel you wish to enable for Sales Order sync.

  1. Navigate to "Unicommerce Channel" from searchbar or from Unicommerce settings page.
  2. To add a Unicommerce channel, click it.
  3. Enter necessary information, such as the channel ID, default warehouse, company, accounts, and naming series.
  4. If the marketplace handles shipping for this channel, either check the box next to it or uncheck it.
  5. Click the "Enabled" checkbox once the channel has been fully configured.

Now, newly created Unicommerce sales orders will begin to sync with ERPNext. If a new item is discovered throughout this process, ERPNext creates it using data from Unicommerce. ERPNext fields have been assigned to the relevant Unicommerce order data, and the Sales ORder "Unicommerce Details" section contains additional data.

Sales Invoice Sync

Sales Invoice synchronization can be handled in one of two ways. Please choose the best choice based on your requirements.

Enable "Only Sync Finished Orders" in Unicommerce settings if you want to process orders and invoices on Unicommerce and only sync fully processed orders in ERPNext.

2. Processing invoice on ERPNext

You must create an invoice from an ERPNext sales order if you only wish to process orders through ERPNext.

Go to the synchronized Unicommerce Sales Order and select "Unicommerce > produce invoice" to generate an invoice. In addition to creating a sales invoice, this will also deduct stock.

Shipment Manifest To notify Unicommerce that you have shipped the orders, if you are processing orders on ERPNext using method #2 as explained above, you must produce and submit a shipping manifest.

Setting up the following doctypes is a prerequisite; you can find the necessary code on the Unicommerce manifest creation page. establishing a Unicommerce shipping provider 2. Develop a shipping method for Unicommerce

Process of creating manifest:

  1. Create a "Unicommerce Shipping Manifest" document when you're ready to send the packages to the shipping company. Enter "Unicommerce Shipping Manifest" in the search window and click "+ Add
  2. Choose a shipping method, a shipping provider code, and a channel ID.
  3. Now, you may either use the "Get Package" button to get open orders using the filters you've chosen, or you can scan the AWB of packages using the "Scan AWB Code" field. After save, both will automatically fill in the remaining fields.
  4. When you are certain that all of the information is accurate, save and submit the document.
  5. The identical manifest is prepared, closed, and marked as "Dispatched" on Unicommerce after the manifest is submitted, and shipments are recorded as such. Unicommerce Manifest PDF is also collected and added to ERPNext manifest document

Status Updates The "Unicommerce information" area of ERPNext displays the most recent status updates for Unicommerce.

Order Cancellations Order cancellations made on Unicommerce are synced with cancellations made on ERPNext using the integration. Partially cancelled orders are also synced and cancelled goods are removed from the ERPNext Sales Order. Every hour, just before producing bills, full and partial cancellations are synced.

Order returns

When return is established on Unicommerce, the integration syncs this activity and writes a Draft Credit Note in ERPNext.

Both return cases are handled by integration:

  • RTO (return to origin) (return to origin) When a cargo is returned to its place of origin, the shipment status is changed, and ERPNext creates a credit note (with updated stock). Credit Note will be returned in full.
  • CIR (Customer Initiated Return) (Customer Initiated Return) The Sales Order section of Unicommerce updates when a customer returns a shipment. Depending on the type of customer-initiated return, either a full or partial credit note is produced.

By selecting "Sales Invoice" and setting the "Is Return" filter to Yes, you can see all returns. On the credit note, the return tracking code is also recorded.

The return warehouse is chosen when creating returns depending on the Return Warehouse settings in Unicommerce. Original warehouse will be used if it is not predetermined.

Previous Page

Left

Next Page

Right