SHOPLINE and Cin7 Omni Integration Guide – SHOPLINE Help Center

The SHOPLINE Cin7 Omni app syncs product, order, inventory, customer, and shipping data between your SHOPLINE store and Cin7 Omni. It connects your store with your inventory and warehouse system to automate workflows, improve fulfillment efficiency, and reduce errors.

This guide covers installation, basic setup, and data sync rules for connecting SHOPLINE with Cin7 Omni.

Connecting SHOPLINE and Cin7 Omni

To connect Cin7 Omni with SHOPLINE, follow these steps:

Go to the SHOPLINE App Store, search for and install Cin7 Omni for your store. Once authorized, the app will be able to access your store data.
Enter your Cin7 Omni username and password, then click Save to confirm data access.
Enable or disable the following data synchronization modules as needed:
- Sync customers
- Sync products
- Inventory sync
- Order sync
- Shipment sync
Enable email notifications to ensure added recipients receive error details every 30 minutes if synchronization fails.

Data Synchronization Scope and Description

The Cin7 Omni app supports initial full and subsequent incremental synchronization. The synchronization rules for different data types are as follows:

Data Type	Sync Direction	Sync Scope	Sync Time
Customer Data	SHOPLINE → Cin7 Omni	Customer Name Email Phone Number Customer Update Information	Real-time sync after a customer is added or updated
Product Data	Cin7 Omni → SHOPLINE	Product Name SKU / Variant Product Price Product Images Product Options Product Dimensions (L/W/H / Volume)	Initial enablement triggers full sync Subsequent sync: After product addition/update Incremental update hourly Products newly added to SHOPLINE from Cin7 Omni are unlisted by default One Cin7 Omni product can be mapped to multiple SHOPLINE products and share the same inventory. For more information, see "Product Mapping" below
Order Data	SHOPLINE → Cin7 Omni	Order Details Recipient Information Product SKU / Variant Price / Discount Shipping Fee and Total Order Amount	Real-time sync after successful payment Only syncs "Paid" orders
Inventory Data	Cin7 Omni → SHOPLINE	SKU Stock Quantity Inventory for Each Branch Available Stock (After deducting Safety Stock)	Automatically syncs every 10 minutes Inventory is based on Cin7 Omni Supports "Safety Stock Mechanism" (to prevent overselling) If product or warehouse mapping is not configured, synchronization will be paused, and an error will be displayed Negative inventory is currently not supported. For example, if the inventory of a Cin7 Omni product is -10, the sync to SHOPLINE will fail
Shipment Data	Cin7 Omni → SHOPLINE	Shipping Status (Dispatched) Carrier Name Tracking Number	Real-time write-back to SHOPLINE after marking as dispatched in Cin7 Omni

Notes:

Before enabling order synchronization, complete Product and Inventory Mapping initialization. An incomplete SKU or mapping prevents successful order sync.
Failed sync data is not lost and enters a retry or suspended queue.

Managing Mappings and Synchronization

Product Mapping

The Product Mapping page allows you to view the Cin7 Omni product name and ID, as well as the SHOPLINE product name and ID they are mapped to, and the inventory information for that product. You can also click the Primary product unmapped tab to manually map SHOPLINE products.

Mapping One Cin7 Omni Product to Multiple SHOPLINE Products

If you duplicate the same product in SHOPLINE for different purposes, such as different marketing campaigns or landing pages, you can map all the duplicated products to the same Cin7 Omni product. They will share the same inventory, so you do not need to maintain separate inventory in Cin7 Omni.

For example, you have Product A in Cin7 Omni with 90 units of inventory. In SHOPLINE, you duplicate this product into three products: B (original product), B1, and B2, which are used on different marketing pages.

You can map Product A to B, B1, and B2. All three SHOPLINE products will share 90 units of inventory from Product A. The inventory is distributed evenly among the mapped products. In this example, each product will have 30 units of inventory. If there is any remainder, it will be allocated to the products that appear first in the list.

Note: One SHOPLINE product variant (SKU) can only be mapped to one Cin7 Omni product variant (SKU). However, one Cin7 Omni product variant can be mapped to multiple SHOPLINE product variants.

Setting the Primary Product

When one Cin7 Omni product is mapped to multiple SHOPLINE products, you need to select one of them as the Primary product.

Primary product: When the product title, description, images, price, or other product information is updated in Cin7 Omni, only the primary product will be updated in SHOPLINE.
Other mapped products: Only inventory will be synced. Product information, such as the title, description, and images, will not be updated automatically.

Using the example above, if you set Product B as the primary product, when the information of Product A in Cin7 Omni changes, only Product B will be updated. B1 and B2 will remain unchanged, while all three products will continue to share the same inventory.

To set the primary product:

In the Product mapping list, find the row containing the Cin7 Omni product.
Click Set primary product.
Select one of the products with an existing SKU mapping as the primary product. You can also select No primary product to stop product information updates. Inventory will continue to sync normally.

Notes:

Changing or removing the primary product does not affect existing SKU mappings or shared inventory.
The system will not automatically set or change the primary product. You need to set it manually.

Removing a Product Mapping

If you no longer want a SHOPLINE product to be linked to a Cin7 Omni product, you can remove the mapping manually:

In the Product mapping list, find the SHOPLINE SKU mapping you want to remove and click the Remove mapping icon.
Check the Cin7 SKU and SHOPLINE SKU information in the confirmation window, then click Confirm.
After the mapping is removed, the SHOPLINE SKU will stop sharing inventory with the Cin7 SKU, and its inventory will be automatically set to zero. The product itself will not be deleted, and you can create the mapping again later. To remove multiple mappings at once, select multiple Cin7 SKUs and click Remove mappings.

Note: When you uninstall the Cin7 Omni app, all product mappings for the store will be automatically removed. If you reinstall the app, you need to create the product mappings again. Previous mappings will not be restored automatically.

Retrying Failed Product Syncs

If a product fails to sync because of missing information or an incorrect format, you can retry the sync after correcting the product information in Cin7 Omni. You do not need to create the mapping again.

Go to the Sync product list and find the product that failed to sync.
Click Re-sync.
The system will retrieve the latest product information from Cin7 Omni and try to sync it again.

Note: Products that are being synced will appear grayed out to prevent duplicate submissions. You can also select multiple failed products and click Bulk re-sync to sync them again at once.

Syncing Product Updates

In addition to the initial product sync, you can choose whether to automatically sync product updates from Cin7 Omni to the corresponding SHOPLINE Primary Product.

Go to the app homepage and find the Product update settings.
Before turning on the switch, check the fields selected under Edit fields to make sure they meet your needs. Once enabled, the system will start syncing based on your settings.
Under Update field, select the product information you want to sync automatically, such as the product title, description, images, selling price, and weight.

Notes:

Only products with a primary product set will be updated automatically. Products with SKU mappings but without a primary product will not have their product information updated automatically.
If you often update selling prices directly in the SHOPLINE Admin, we recommend turning off Product Variant Price to prevent the price from being overwritten by Cin7 Omni data.
If you turn this setting off and enable it again later, previously unsynced product information will not be synced automatically. You need to go to Sync products and sync the products manually.

Location Mapping

The Location mapping page allows you to set the corresponding SHOPLINE warehouse for Cin7 Omni.

Order Sync

The Order sync page allows you to view the status of SHOPLINE orders synced to Cin7 Omni. You can also click the Sync failed and Shipping sync failed tabs to view the reasons for failure.