Connect Navex to your online store

To link Navex to Yalla Souk you need a Navex sender account and two API tokens (create and track) supplied by Navex. Paste them in Integrations › Delivery › Navex: from then on, from each order, you send the parcel to Navex in one click, follow its status, exchange it or cancel it. Navex collects the cash on delivery and pays it out to you.

Behaviour checked in the product and Navex details taken from navex.tn on 22 October 2026.

Navex in Yalla Souk at a glance

What does the Navex integration actually do?

Without an integration, every order is copied by hand into the Navex sender space: name, phone, governorate, city, address, amount to collect. It is slow, and it is where wrong numbers and wrong amounts come from. With the integration, Yalla Souk sends that information straight to the Navex API when you click Send to carrier.

The data sent for each parcel comes from the order: customer name and phone, delivery governorate, city and address, item description, number of items, total amount to collect and the order number as reference. Navex returns a tracking number, saved on the order.

How do I connect Navex to Yalla Souk?

1. Open a Navex sender account if you do not have one: its website offers a “Devenir client” form or a phone call, then an advisor contacts you to open the account and arrange the first pickups.
2. Ask your Navex advisor for your two API tokens: one to create parcels, one to track them. Navex does not publish API documentation on its website, so the tokens come from your contact.
3. In your Yalla Souk dashboard, open Integrations, filter on Delivery and click Connect next to Navex.
4. Paste the API token (create parcels) and the API token (tracking). They are encrypted when saved and never shown in clear again.
5. Optional: enter your Navex delivery and return fees, and the store details shared with the carrier (store name, phone, address, city, tax ID).
6. Save. Navex shows as connected and is offered on every order.

How do I send an order to Navex?

Once the order is confirmed (by phone, WhatsApp or automatically, depending on your setting), open it: the Delivery card shows the amount to collect on delivery.

1. Click Send to carrier and choose Navex.
2. Add a comment for the driver if needed (hours, landmark, floor).
3. Tick Allow the customer to open the package before payment if you accept that the customer checks the item before paying.
4. Confirm: the parcel is created at Navex, the tracking number shows on the order and the waybill can be printed when Navex returns one.

The parcel is not created automatically on confirmation: you stay in control to batch parcels, check stock or pick another carrier for a given order.

Which Navex statuses show up in Yalla Souk?

The Refresh button on the Delivery card asks Navex for the parcel status and maps it to Yalla Souk’s wording. When Navex provides them, the driver’s name and phone are shown too.

The status is not updated in the background: it refreshes when you click Refresh. Shipping and delivery dates are recorded at the first matching status.

Exchange, cancellation: what can I do after sending?

• Exchange: “Edit shipment” creates a new exchange parcel at Navex to replace the current one.
• Cancellation: you cancel the parcel from the order; Yalla Souk sends the deletion to Navex and marks the parcel as cancelled.
• One active parcel per order: to create a second one, use the exchange. A cancelled or returned parcel frees the order.

What are the limits?

• The connected carriers are Tunisian: sending is reserved for stores based in Tunisia and orders delivered in Tunisia. An order going abroad is handled outside the integration.
• Yalla Souk does not negotiate your Navex rates and has no part in paying out the cash: both are part of your contract with Navex.
• If your tokens change at Navex, paste them again in Yalla Souk; a field left empty keeps the saved value.

Frequently asked questions about Navex and Yalla Souk