Skip to main content

Yalidine

Yalidine is one of the most-used national couriers in Algeria, with coverage in all 58 wilayas, a large stop-desk network, and a stable API. The same DZBuild integration also powers Yalitec, Guepex, and Easy & Speed, which share Yalidine's API structure under their own dashboards.

What you need​

You only need two values from your Yalidine merchant dashboard:

  • API ID
  • API Token

Both are issued from your Yalidine account; if you don't see them, ask Yalidine to enable API access for your account. Yalidine API access usually requires a verified business account.

Linking Yalidine in DZBuild​

  1. Open /dashboard/shipping in your dashboard.
  2. Click Link provider and pick Yalidine (or Yalitec / Guepex / Easy & Speed if that's your reseller).
  3. Paste your API ID in the first field.
  4. Paste your API Token in the second field.
  5. Click Test API. The dashboard hits Yalidine live and shows a green check if the credentials are valid.
  6. Save.

Yalidine becomes the store's default delivery provider. From the same page you can:

  • Sync rates from provider — pulls Yalidine's home + desk fees per wilaya.
  • Override any wilaya's rate manually if you want to absorb part of the shipping or charge a markup.

What gets synced​

  • Full list of wilayas and communes (with Arabic ↔ French commune-name resolution — DZBuild auto-translates Arabic commune names to the French names Yalidine expects).
  • Per-wilaya home delivery rate.
  • Per-wilaya stop-desk rate.
  • The list of stop-desks in each wilaya, used by the stop-desk picker.

What happens when an order ships​

When you confirm an order in /dashboard/orders and the store's provider is Yalidine, DZBuild calls Yalidine's /parcels/ endpoint with:

  • Customer first name, family name, phone (auto-formatted to the local 0X shape, with a second contact phone if you've collected one).
  • Address, destination wilaya, destination commune (resolved to the French name).
  • Origin wilaya (your store's wilaya — used as from_wilaya_name).
  • Product list summary.
  • COD amount (price = subtotal, the customer pays this on delivery).
  • Declared value, length, width, height, weight.
  • is_stopdesk flag, plus a valid stopdesk_id when desk delivery is selected.
  • freeshipping, do_insurance, and exchange flags when applicable.

Yalidine returns:

  • A tracking number (saved on the order).
  • A label URL (PDF) you can print directly.

DZBuild flips the order to shipped and the customer sees the tracking on their order page. As the parcel moves through Yalidine, status updates flow back into DZBuild's order timeline (processing → shipped → delivered, or returned / cancelled).

Stop desk with Yalidine​

Yalidine has the largest stop-desk network in Algeria. When the customer chooses desk delivery at checkout:

  • The Stop Desk addon shows desks for the selected wilaya with name, address and phone.
  • DZBuild stores stopdesk_id on the order — Yalidine requires this; if it's missing for a desk shipment, DZBuild raises an error before sending so the parcel never gets misrouted as home delivery.

Common errors and fixes​

MessageCauseFix
بيانات API غير صحيحة / HTTP 401Wrong API ID or API TokenRe-copy both values from Yalidine's dashboard. The two fields are easy to swap.
غير مصرح / HTTP 403Account exists but API is not enabledContact Yalidine to enable API access on your account.
تم تجاوز حد الطلبات / HTTP 429Too many requests in a short windowWait a minute and retry; Yalidine rate-limits aggressive callers.
لا يوجد مكتب استلام (Stop Desk) متاحDesk shipment without a stopdesk_idAsk the customer to re-pick a desk, or switch the order to home delivery.
Order created but no tracking returnedAddress or commune not recognizedCheck the commune spelling, then re-send. The DZBuild order log shows the raw Yalidine response.

Tips​

  • Yalidine expects communes in French. DZBuild handles the Arabic → French resolution automatically against the communes table, but uncommon spellings can fail — keep your store's commune list clean.
  • The price sent to Yalidine is the subtotal (product price), not the order total with shipping. This is what the courier collects on COD.
  • If you also have a Yalitec / Guepex / Easy & Speed account, link it under its own slug — the API shape is the same but credentials are not interchangeable.