Skip to main content

Connect First Delivery to your online store

One First Delivery API token is enough: every order goes out as a parcel with its barcode and waybill, and its status is checked from the order.

To link First Delivery to Yalla Souk, open a First Delivery sender account, get your API token, then paste it in Integrations › Delivery › First Delivery. From each order you create the parcel in one click: First Delivery returns a barcode that serves as the tracking number and a link to the waybill. The driver collects the cash and First Delivery pays it out to you.

Behaviour checked in the product and First Delivery details taken from firstdeliverygroup.com on 22 October 2026.

First Delivery in Yalla Souk at a glance

Where to connect it Integrations › Delivery › First Delivery › Connect
What you enter A single field: API token. No URL, no second token.
What First Delivery returns A barcode, used as the tracking number, and a link to the waybill to print.
What you do from the order Create the parcel, print the waybill, refresh the status, create an exchange, cancel while the parcel is pending.
Cash on delivery Collected by the First Delivery driver and paid out by First Delivery under your contract.
Cost on the Yalla Souk side Included: no fee per parcel. You pay only per order received.

Who is First Delivery?

On its website First Delivery describes itself as a 100% Tunisian delivery company founded in 2018 by Marouane Ratel. It lists three services, pickup, delivery and payment, and delivery “in 24 h or the same day” across Tunisia. The addresses it gives are in La Soukra (Charguia 1 and Charguia 2).

These details come from First Delivery itself: check lead times and terms with your sales contact before signing. Its prices are not published; they are quoted.

How do I open a First Delivery sender account?

First Delivery’s website has a “Devenir expéditeur First” page with a form. It asks for your full name, company or page name, business sector, estimated parcels per day, phone, address and email. Existing senders then get an online sender space.

The website does not describe its API. Once your account is open, ask your First Delivery contact for the API token that lets a store create and track parcels.

How do I connect First Delivery to Yalla Souk?

  1. In your Yalla Souk dashboard, open Integrations and filter on Delivery.
  2. Click Connect next to First Delivery.
  3. Paste your API token. It is encrypted when saved and never shown again.
  4. Optional: enter your delivery and return fees, and the store details shared with the carrier (store name, phone, address, city, tax ID).
  5. Save: First Delivery is now offered on the Delivery card of every order.

How do I create a First Delivery parcel from an order?

  1. Open a confirmed order and click Send to carrier.
  2. Choose First Delivery and add a comment for the driver if needed.
  3. Confirm. Yalla Souk sends the customer (name, governorate, city, address, phone) and the product (amount to collect, description, number of items, comment, order number).
  4. The barcode returned by First Delivery shows as the tracking number, and the waybill prints from the order.

Good to know: the “Allow the customer to open the package before payment” box is not passed to First Delivery, because its API has no such field on the Yalla Souk side. If you allow it, write it in the driver comment.

Which First Delivery statuses show on the order?

The Refresh button asks First Delivery for the parcel by barcode and maps its state:

State at First DeliveryStatus in Yalla Souk
En attente, A vérifierPending
Au magasinAt depot
En coursOut for delivery
LivréDelivered
EchangeExchanged
Retour expéditeur, Rtn client/agence, Rtn dépôt, Retour reçu, Rtn définitifReturned
SuppriméCancelled

The status refreshes on demand, not in the background. First Delivery does not return the driver’s name in this tracking.

Can I cancel or exchange a First Delivery parcel?

  • Cancellation: possible from the order while the parcel is still pending at First Delivery. Once it has been taken over, First Delivery refuses the cancellation and Yalla Souk tells you so.
  • Exchange: “Edit shipment” creates a new exchange parcel that replaces the current one.
  • One active parcel per order, exchanges aside.
  • Tunisia only: sending is reserved for stores based in Tunisia and deliveries within Tunisia.

Frequently asked questions about First Delivery and Yalla Souk

How many First Delivery tokens do I need?

Just one. First Delivery uses a single API token to create, track and cancel parcels, unlike Navex and the other connected carriers, which ask for a creation token and a tracking token.

How do I get my First Delivery API token?

First open a sender account through the “Devenir expéditeur First” form on its website, then ask your First Delivery contact for the API token. The website does not publish API documentation.

Why can I no longer cancel my parcel?

First Delivery only accepts cancellation for a parcel that is still pending. Once it is picked up or out for delivery, cancellation is refused: contact First Delivery to arrange a return.

Can the customer open the parcel before paying?

This option is not passed to First Delivery by the integration. If you accept it, say so in the driver comment when you create the parcel.

How much does First Delivery cost?

First Delivery does not publish its rates: they are quoted. Yalla Souk adds no fee per parcel; you pay only per order received, from 0.300 to 0.090 TND by volume, after 200 free orders.