OpenCart Integration

This native integration with OpenCart enables order, catalog and inventory synchronization seamless.

Version: v1.0
Date: March 6, 2026
Owner: Sales Channel Product Team

1. Overview

What this integration does
The OpenCart integration connects your OpenCart store with Omniful so that:

• Orders created on OpenCart will be automatically synced to Omniful for processing.
• Inventory availability maintained in Omniful can be synced to OpenCart.
• Shipments created in Omniful can update shipment status & tracking to OpenCart.
• You can configure hub mapping, order status mapping directly from Omniful.

Supported integration types:

• Fulfillment + Shipping – Omniful handles both fulfillment and shipping
• Shipping Only – Omniful handles only shipping, while order creation, catalog remain managed in OpenCart.

2. Prerequisites

2.1 Sales Channel prerequisites

You will be required to obtain the following details from OpenCart Store:

• Shop Domain Url
• User Name
• Secret Key

3. Integration Methods and Setup

3.1 Install Omniful extension in OpenCart store

Install ‘Omniful Integration’ App on OpenCart:

1. Go to OpenCart.com, and click on ‘Marketplace’
2. Search for the Omniful Extension, and download it.

Note: If your OpenCart’s admin directory name, differs from the default ‘admin’, For example: your admin directory name is ‘/securepanel’ then replace the default ‘/admin’ directories with ‘/securepanel’ 3. Open the OpenCart admin dashboard, and navigate to Extensions > Installer 4. Upload the Omniful Extension Downloaded Files 5. Navigate to Extensions, and select Feeds from the options 6. After installation, edit the plugin

• Set the status as Enabled
• Enter the Session Duration (e.g., 1 hour = 3600 seconds).
• Enter the Omniful Webhook URL : https://prodapi.omniful.com/sales-channel/public/v1/opencart/webhook

Click on Save. 8. Generate the API Key, by navigating to System > Users > API. 9. Create an API or use the default API. 10. Add your API Username 11. Visit the IP Addresses tab to whitelist the Omniful IP address 12. Add the Omniful IP Address 18.185.180.251 and click save.

3.2 Connect OpenCart store in Omniful

Once you have the required details:

1. In Omniful, go to: Settings → Apps & Integration → Sales Channel Apps.

2. Select Seller and choose OpenCart as the sales channel type.

3. Click Add Store Enter all required information in the corresponding input fields

• Enter your OpenCart shop domain. For eg: https://demo.examplesite.com/OpenCart_3qmyyqkuiop
• User Name: Enter your API User Name as generated in Step 3.1
• Secret Key: Enter the OpenCart API Key as generated in Step 3.1.
• Type of Integration : Fulfilment+Shipping or Shipping Only
• Click Integrate to complete the integration

4. Omniful Configuration

Once the store is connected, configure how data flows between OpenCart and Omniful.

4.1 Store-level settings

Depending on your requirements, you can enable:

• Order Sync – Automatically fetch orders from OpenCart to Omniful.
• Catalog Sync – Fetch catalog (SKUs) from OpenCart into Omniful.
• Inventory Sync – Push available inventory from Omniful hubs to OpenCart.

4.2 Hub Mapping

Configure how OpenCart orders are routed to Omniful hubs: Hub mapping ensures that orders from OpenCart are fulfilled by the correct physical location and that inventory in that hub is used for allocation.

4.3 Order status mapping

Order Status Mapping defines how OpenCart statuses and Omniful statuses stay in sync:

• Sales Channel Mapping – Map incoming OpenCart order statuses (e.g., Paid, Confirmed) to internal Omniful order lifecycle stages (e.g., New, Ready for Picking).

Note: ensure OpenCart order statuses (such as new and paid) are configured correctly—otherwise new orders may not sync to Omniful. Likewise, if the cancelled status is not mapped, cancelled orders will not sync back to OpenCart.

Use Fetch Order Status within the configuration screen to load all available OpenCart statuses and then map them to Omniful statuses per your operational requirements.

4.4 Configuration log

Use the Configuration Log to track changes to configurations.

5. Data & Sync Behaviour

5.1 Orders

• Only orders that match the mapped OpenCart order statuses will be imported into Omniful.

• After import, Omniful assigns the correct hub using the configured Hub Mapping rules.

5.2 Catalog

• Seller’s OpenCart Catalog (SKUs) with valid SKU code is fetched automatically to Omniful when Catalog Sync is enabled.

• Omniful receives new and updated information ‘Active and Live’ SKUs so you can see and use them for order & fulfillment processes in Omniful.

5.3 Inventory

• Omniful automatically pushes and maintains inventory level on the OpenCart store when Inventory Sync is enabled.

5.4 Cancellations

• Cancellations – When ‘Automated Order Cancellation On Sales Channel’ is enabled, canceling an order in Omniful triggers an automatic cancellation on OpenCart, keeping both systems aligned.

6. FAQs

Q: Why are some OpenCart orders not appearing in Omniful? A: Only orders created on OpenCart with the correct order status mapping and the correct hub mapping will sync to Omniful. Orders that do not meet these mappings will not be created. Please also ensure that Order Sync is enabled.

Q: Can I control when an order is synced to Omniful (e.g., only after it’s paid)? A: Yes. You can configure Order Status Mapping so that Omniful only creates orders when they reach specific OpenCart statuses such as Paid / Authorized / Unfulfilled.

Q: Who is the inventory master? A: Omniful is the inventory master. When Inventory Sync is enabled, Omniful sends updated available stock quantities to OpenCart.

Q: When does tracking information appear in OpenCart? A: When a shipment is created in Omniful, the assigned tracking number, carrier, and shipping status are pushed back to OpenCart via the Omniful OpenCart app.

Q: What happens if I uninstall or disable the Omniful extension in OpenCart? A: New orders will stop syncing to Omniful, and shipment updates from Omniful will not update back to OpenCart. Existing orders already imported into Omniful will still be processable internally but will not reflect back in OpenCart until the extension is reinstalled.