Salla
Salla integration
Quick summary: Connect a Salla store, review its order settings, and control inventory or fulfillment sync.
Quick start
In the username menu, select Account Management, then select Integrations.
Select + or Add New Integration. Open Market Place Integrations and select Salla.
- Enter the full Salla store URL, such as
https://salla.sa/your-store-name. - Select Continue.
- Sign in to Salla and complete the app installation or authorization shown.
- Return to Floship and wait for the integration to appear.
- Open the integration and review the settings. Select Save after changing a setting.
Overview
Salla's OAuth app authorization documentation describes the provider flow used to connect a store. The Portal follows that flow through Salla.
The integration can receive eligible orders, send fulfillment tracking, and push inventory when enabled. Available fields depend on the integration and its Salla permissions.
What the integration does
- Salla order-created events can send eligible new orders to Floship.
- Scheduled polling checks Salla every 30 minutes in the base configuration.
- A fulfilled portal order can send its tracking number back to its Salla shipment.
- Sync Inventory can send portal stock to matching Salla product SKUs.
Only orders processed after registration are available to this connection. Ask support to assess older orders that you need in the Portal.
Before you connect
- Use a Salla store administrator who can install or authorize apps.
- Have the full Salla store URL.
- Create or confirm matching SKUs in Floship and Salla.
- Confirm that your user can access Integrations. Adding and saving require write access.
Review the permissions Salla shows before you approve them. Missing required access can block order, inventory, or fulfillment work.
Step-by-step connection
Step 1: Start the Connection
Enter the full Salla store URL in Shop URL and select Continue. If the card says the request already exists, select Continue installation.
Step 2: Log In to Salla
Salla opens its sign-in or app installation window. Use an account that can authorize the store.
Step 3: Grant Permissions
Review the requested access and complete the Salla app installation. Salla controls the wording and locale of this screen.
Step 4: Confirm
The Portal may show a waiting screen while Salla sends the completed authorization. You can close this window after the waiting message appears.
When the request completes, the Portal opens the new integration and may send an email or Portal notification. An open request lasts 24 hours .
If the request expires, select Start again when shown. Select Retry after a temporary check failure. A store already connected to another client needs support.
Integration settings
Review the settings after the connection appears. Only an integration user with write access sees Save.
Status
Active allows future Salla events and scheduled work. Inactive stops future work for this connection. Existing portal orders remain.
Change the status and select Save. Changing the toggle alone does not persist it.
Info Fields
| Field | What it shows |
|---|---|
| Shop URL | The connected Salla store address. |
| Merchant ID | The Salla merchant identifier. |
| The email returned by Salla. | |
| Last Orders Sync | A source order creation date used as the sync checkpoint. It is not the last successful import or a health signal. |
Order Settings
| Setting | What it controls |
|---|---|
| Order Statuses Slug | The Salla status used by scheduled order polling. |
| Ignore not found items | For stock orders, Yes skips unmatched lines. No can prevent import when a SKU is missing. |
| Use Checkout Currency | Uses Use original currency or converts values to USD. |
Select Save after changing an order setting.
Inventory Settings
| Setting | What it controls |
|---|---|
| Sync Inventory | Sends portal stock for matching Salla SKUs when Yes. |
| Inventory Threshold | Reserves a quantity from the stock sent for each matched SKU. |
Add Threshold can create a SKU-specific reserve that overrides the general value. Select Save after changing the general inventory setting.
The base schedule sends a full inventory sweep every 2 hours . Stock changes can also queue an earlier product update.
Inventory sync also needs Salla product write permission. If it remains idle, use Re-Authorize when shown.
Fulfillment Settings
When an eligible portal order is fulfilled with a tracking number, the Portal sends that tracking number to the Salla shipment. Missing tracking prevents the update.
The Salla card has no Mark Fulfillments toggle. Fulfillment updates follow eligible order status changes.
Pull Customs Value From selects Salla or Portal as the customs value source.
Filters
Filters appears after the integration is saved. Users with write access can select Add Filter.
Available attributes are Shipping Country, Shipping Option, and Item SKU. Available rules are Only listed values allowed, Matches the list exactly, No listed values allowed, and All listed values required.
Viewing Integration Details
Open the Salla card in Integrations to view its connection details and settings. Users with integration read access can inspect the card.
Save, Add Filter, and Add Threshold require integration write access. A read-only user can review the visible values without changing them.
Re-Authorization
Salla may require new permissions after the Portal adds a feature. A Re-Authorize button appears when the saved Salla permissions are incomplete.
Select Re-Authorize and complete the Salla prompt in the new window. Reopen the integration after Salla returns.
Do not assume that reopening the card restores access. If the button remains, contact support with the shop URL.
Workflows
Workflow: Connect a New Salla Store
Use Quick start and complete Step-by-step connection. Do not select Save before the new integration card appears.
Workflow: Enable Inventory Sync
Open the Salla integration and set Sync Inventory to Yes. Enter Inventory Threshold when you need a general reserve.
Use Add Threshold for a SKU-specific reserve when needed. Select Save and confirm that Salla permissions include product write access.
Workflow: Re-Authorize After Permission Changes
Use Re-Authorization. Complete the Salla prompt, then reopen the integration and confirm its visible status.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| The new integration remains pending | Salla has not sent the completed installation event | You can close the waiting window. Check Portal notifications and email, then return later. |
| The connection request expired | The Salla installation was not received before the request lifetime ended | Select Start again, then repeat the Salla installation. |
| Re-Authorize remains after approval | The saved permission set is still incomplete | Repeat Re-Authorize. Contact support if the button remains. |
| Orders do not import | Status is inactive, polling status excludes them, or filters exclude them | Check Status, Order Statuses Slug, and Filters. |
| An order has an unknown SKU | A Salla SKU is missing from the Portal | Add the matching SKU or use Ignore not found items for stock orders. |
| Inventory does not update | Sync Inventory is off, product permission is missing, or the SKU is unmatched | Enable it, review thresholds, and use Re-Authorize when shown. |
| Tracking does not reach Salla | The fulfilled order has no tracking number, or Salla rejected the update | Confirm tracking on the order and review its source notification error. |
For additional connection checks, see Integration Troubleshooting.