Integrations and onboarding.

How we launch a new 3PL operator, how operators bring each merchant on board, and every channel, carrier and API along the way.

Your launch, handled by our team.

Every new 3PL operator gets a dedicated workspace, set up end to end before the first order arrives.

  1. 01

    Your own workspace

    A private subdomain with HTTPS and a dedicated database for your company. Nothing is shared with other operators.

  2. 02

    Brand, language and region

    Your name in Arabic and English, your logo and colours, SAR currency, Riyadh time and Arabic as the default language.

  3. 03

    Warehouse and addresses

    Your first warehouse with zones, locations and carton sizes, plus the Saudi city catalogue so every address maps to a carrier.

  4. 04

    Team and devices

    Your admin account, roles and permissions for each team, handheld scanners, and the Print Agent on every pack station.

  5. 05

    Carriers

    Your carrier accounts connected, with the shipping methods your merchants can choose from.

  6. 06

    Go live

    Sign in on your own URL and start receiving orders.

Bring each merchant on board.

A new store starts as Pending integration in your dashboard and becomes Active once its channel is connected and orders start flowing. This is what happens in between.

  1. 01Pending integration

    Create the merchant and store

    Add the merchant, their store code and contacts, and invite their team to the merchant portal.

    New merchant
    Store codeST-00042
    StatusPending integration
    Portal accessInvitation sent
  2. 02Pending integration

    Connect the sales channel

    Install the app on Salla, Zid or Shopify, issue an API key, or start with an Excel upload.

    Sales channel
    API keylim_••••••••
  3. 03Pending integration

    Catalog and shipping methods

    Sync SKUs and barcodes, then choose which carriers and shipping methods serve this store.

    Catalog & shipping
    TSH-BLK-M120
    TSH-BLK-L86
    CAP-NVY-01240
  4. 04Pending integration

    First inbound

    The merchant sends an ASN, your team receives and puts the stock away, and quantities go live in their portal.

    Inbound shipment
    ASN-1042240 / 240
    1. Dock
    2. Received
    3. Put away
    4. In portal
  5. 05Active

    Orders flow automatically

    New orders arrive from the channel or the API, get picked, packed and shipped, and tracking goes back to the store.

    Order pipelineAutomatic
    1. Order
    2. Picked
    3. Packed
    4. Shipped
    5. Tracking sent

Create orders from any system.

Merchants with their own website, ERP or app send orders straight to your warehouse with one authenticated request.

Authorization
The store’s API key, issued from the dashboard.
X-Store-Code
Ties the request to one store.
Idempotency-Key
A retried request never creates a duplicate order.

Also on the same API

  • GET/orders/{reference}
  • GET/orders/{reference}/tracking
  • POST/orders/batch
  • POST/orders/{reference}/cancel
  • POST/orders/{reference}/hold
  • GET/inventory
  • GET/catalog/skus
  • POST/asns
  • HOOKwebhooks
POST /api/v1/merchant/orders 
POST https://{operator}.stg.limenos.ai/api/v1/merchant/orders
Authorization: Bearer lim_••••••••••••
X-Store-Code: ST-00042
Idempotency-Key: 6f1c2b8e-4a1d-4f7e-9b0a-2d5c7e9f1a33
Content-Type: application/json

{
    "order": {
        "order_number": "SA-100245",
        "shipping_method": "aramex",
        "payment_method": "cod",
        "cod_amount": 349,
        "currency": "SAR",
        "customer": {
            "name": "Abdullah Al-Qahtani",
            "phone": "+966501234567"
        },
        "shipping_address": {
            "country": "SA",
            "city": "Riyadh",
            "line1": "King Fahd Rd, Al Olaya",
            "short_address": "RRRD2929"
        },
        "items": [
            {
                "sku": "TSH-BLK-M",
                "name": "Cotton T-shirt · Black · M",
                "quantity": 2,
                "unit_price": 149.5
            }
        ]
    }
}

Every channel and carrier, in one place.

05

Sales channels

Orders arrive the moment they are placed. Tracking goes back the moment they ship.

  • Salla
  • Zid
  • Shopify
  • Excel (CSV / XLSX)
  • Merchant API
  • WooCommerce Coming soon
  • Easy Orders Coming soon
  • Magento Coming soon
14

Shipping carriers

Labels, rates and status updates from the carriers your merchants already use.

  • Bosta
  • Aramex
  • SMSA
  • SPL (Saudi Post)
  • Naqel
  • Fastcoo
  • Ajex
  • DHL
  • Delex
  • Artz
  • Thabit
  • Redbox
  • FedEx
  • iMile

What syncs with Salla and Zid.

Once a merchant’s store is connected, nothing on this list is done by hand.

DataDirectionWhen
New orders StoretoLimen Automatically, the moment the customer places them.
Order updates and cancellations StoretoLimen Automatically. A cancellation is refused once the order has shipped.
Products and SKUs StoretoLimen Imported from the store’s catalog when you choose.
Stock quantities LimentoStore Pushed to the store when an inbound receipt is completed, or at any time from the dashboard.
Shipping status and tracking LimentoStore Sent once, when the order is dispatched with a tracking number.

Connect Salla Connect Zid

Integration questions.

The technical side of connecting your merchants, answered plainly.

Can I connect the stores of all my merchants?

Yes. Every merchant store has its own connection, so you can connect as many Salla and Zid stores as you serve. Each store uses one sales channel, and can send orders through the API alongside it.

If a webhook fails, is the order lost?

No. Every incoming webhook is logged and retried automatically. If an order is still missing, pull orders back from the store for any period in the last 90 days.

Can the same order be created twice?

No. When a store sends an order again, Limen updates the existing order instead of creating a duplicate.

When does the store see new stock?

Quantities are pushed to the store as soon as an inbound receipt is completed. You can also push them at any time from the dashboard.

What about WooCommerce and EasyOrders?

Both are coming soon. Until then, merchants on any platform can send orders straight to your warehouse through the merchant REST API.

Can a merchant start without an online store?

Yes. A merchant with their own website, ERP or app can create orders through the API from day one.

See your warehouse in Limen Fulfillment.

Tell us about your merchants and volumes. We’ll walk you through a setup built for your floor.

  • Reply within one business day
  • A demo built around your warehouse
  • Arabic and English, right to left
Book a demo Chat on WhatsApp
Book a demo on WhatsApp