Table of Contents

Share On

Salla Integration Guide

This document explains how to integrate your Salla store with Omniful including setup, configuration, and synchronization of orders, catalogs, and inventory.

Version: v1.0
Date: November 21, 2025
Owner: Sales Channel Product Team

1. Overview

What this integration does

The Salla V2 integration connects your Salla store with Omniful so that:

Orders created through the Salla app(s) provided by your fulfilment or shipping partner automatically sync to Omniful for processing.
Inventory availability maintained in Omniful can be synced to Salla.
Shipments created in Omniful can update shipment status and tracking in Salla.
You can configure hub mapping, order status mapping, and shipping service codes directly in Omniful.

Note: If multiple fulfillment or shipping apps are installed on your Salla store, Omniful only works with the one you connect during integration.

Salla V2 — Uses your Fulfilment or Shipping Partner’s Salla App

Public App

Published on the Salla Store and available for installation by any seller.
A store may install multiple apps; however, Omniful sends updates only for orders synced via the connected app.
Orders from other apps can be created manually, but updates won’t sync automatically.
Stores connected via the primary app benefit from real-time order synchronization through webhooks.

Note: Additional apps rely on configured shipping service codes and manual order sync from the store details page.

Private App

Not published on the Salla Store; accessible only to stores authorized by the respective fulfillment or shipment partner.
Follows the same activation and connection flow as Public Apps.

Supported Integration Types

Fulfillment + Shipping: Omniful handles both fulfillment and shipping.
Shipping Only: Omniful handles shipping only, while order creation and catalog management remain in Salla.

When Omniful sends updates (e.g., shipment status or tracking) back to Salla, it uses the same app that was used during integration.

2. Prerequisites

2.1 Sales Channel Prerequisites

You will need:

An active Salla store with permission to install and manage apps.
Access to the email inbox associated with the Salla store (to receive the activation code).
At least one shipping app configured in Salla. (If your Salla plan or region restricts app access, contact Salla support to confirm eligibility.)

3. Integration Methods and Setup

3.1 Install the Fulfilment/Shipment Partner’s App on Salla

Log in to your Salla store dashboard.
Navigate to All → Tools → App Store.
Search for your Fulfilment/Shipping Partner’s Salla App and click Free Install.
Check your email for the activation code required for the next step.

3.2 Connect Salla V2 Store in Omniful

Once you have the activation code:

In Omniful, go to Settings → Sales Channels → Sales Channel Apps / Stores.
Select Seller and choose SallaV2 as the sales channel type.
Click Add Store and enter:
- Activation Code (from email)
- Type of Integration: Fulfilment + Shipping or Shipping Only
Click Integrate to complete the integration.

If you didn’t receive the code:

Click Resend Code.

Enter your Salla Store URL and email address.

Choose your integration type again and continue.

4. Omniful Configuration

Once connected, configure how data flows between Salla and Omniful.

4.1 Store-Level Settings

You can enable:

Order Sync: Automatically fetch orders from Salla to Omniful.
Catalog Sync: Import SKUs from Salla into Omniful.
Inventory Sync: Push available inventory from Omniful hubs to Salla.

Shipping Service Code Configuration

Omniful fetches available shipping service codes from Salla via the connected app.
Select one or more codes to associate with this store; only those orders will be processed through Omniful.

4.2 Hub Mapping

Map Omniful hubs to the hubs configured in SallaV2.

4.3 Order Status Mapping

Defines how Salla and Omniful statuses stay in sync.

Sales Channel Mapping:
Map incoming Salla statuses (e.g., Paid, Confirmed) to Omniful stages (e.g., New, Ready for Picking).

Note: Ensure Salla statuses are correctly mapped to avoid missing or un-synced orders.
Workspace Order Mapping:
Define which Omniful shipment/order statuses should be pushed back to Salla (e.g., Shipped, Canceled).

Use Fetch Order Status to load available Salla statuses, then map them as needed.

4.4 Configuration Log

Use the Configuration Log to track all configuration changes.

5. Data and Sync Behaviour

5.1 Orders

Only orders created via your connected Salla App are synced.
Orders from other apps are ignored.
Orders appear in Omniful based on mapped Salla statuses.

5.2 Catalog

Salla catalog SKUs are fetched automatically when Catalog Sync is enabled.
Price updates are pushed from Omniful via “Update SKU’s Selling Price.”
Omniful periodically fetches active SKUs for use in order and fulfillment processes.

5.3 Inventory

When Inventory Sync is enabled, Omniful maintains and pushes stock levels to Salla.
If multiple hubs are mapped, stock may be aggregated or limited to one hub’s quantity (available on request).

5.4 Cancellations

If Automated Order Cancellation on Sales Channel is enabled, cancellations in Omniful automatically reflect in Salla.

6. FAQs

Q: Do I need Salla partner access or just store admin? A: Store owner / admin access with permission to install apps is sufficient for Salla V2 integration.

Q: Can I use the same app for multiple stores? A: Yes. You can install the same fulfilment / shipping partner app on multiple stores. Each store will need to be connected separately in Omniful. Omniful only manages orders for stores that have been connected using that app.

Q: Why are some Salla orders not appearing in Omniful? A: Only orders created using your Fulfilment/ Shipping Partner Salla App are synced. Orders created via other public apps are not synced. Also, check that Order Sync is enabled and that Order Status Mapping includes the relevant Salla statuses.

Q: Can I control when an order is synced (e.g., only after it’s paid)? A: Yes. You can configure Sales Channel Mapping so only orders in certain Salla statuses (e.g., Paid) are treated as new order in Omniful.

Q: Who is the inventory master? A: Omniful is the inventory master. Enabling Inventory Sync pushes available stock from Omniful to Salla.

Q: When does tracking information appear in Salla? A: When a shipment is created in Omniful, configured shipment details are sent back to Salla using the same fulfilment / shipping partner app that was used to connect the store.

Q: Can I use multiple shipping services? A: Yes. Multiple Shipping Service Codes can be configured in Omniful so you can support multiple shipping services in Salla.

Q: What happens if I disable the Fulfilment/ Shipping Partner’s App in Salla? A: Updates stop, and new orders from that app will not sync to Omniful. Existing linked orders may still be processed in Omniful but will not update back to Salla until the app is re-enabled.

Q: What if I change shipping methods or add new ones in Salla? A: You may need to revisit Shipping Service Code Configuration in Omniful to ensure the new codes are selected and mapped correctly.