Skip to main content

ZR Express

ZR Express covers all 58 wilayas with a strong stop-desk network and a familiar tracking app. DZBuild supports both ZR Express APIs:

  • ZR Express (Procolis) — the long-standing API at procolis.com. Pick this if your ZR Express dashboard is the legacy one.
  • ZR Express New Platform — the newer API at api.zrexpress.app. Pick this if your ZR Express dashboard logs you into the new portal with a tenant UUID.

If you're not sure which one you have, ask ZR Express support — your account is on exactly one of the two.

What you need​

Legacy ZR Express (zrexpress)​

  • Token
  • Key

Both come from your ZR Express account in the legacy dashboard. The same Procolis-style credentials also work for Abex Express under the abexexpress slug.

ZR Express New Platform (zr-express-new)​

  • API Key (the secret key)
  • Tenant ID (a UUID identifying your account)

You'll find these in the new portal under the API/integrations area. The Tenant ID is a UUID like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Linking ZR Express in DZBuild​

  1. Open /dashboard/shipping.
  2. Click Link provider and pick ZR Express (legacy) or ZR Express New Platform.
  3. Paste the credentials from the matching table above.
  4. Click Test API. DZBuild calls a verification endpoint live (legacy: /token; new: /api/v1/users/profile) and shows green if the credentials are valid.
  5. Save.

What gets synced​

  • The list of wilayas and communes the courier serves.
  • Home delivery rates per wilaya.
  • Stop-desk rates per wilaya.
  • The stop-desk list per wilaya, used by the Stop Desk picker.

What happens when an order ships​

DZBuild sends the parcel with customer details, COD amount (subtotal), wilaya / commune, and is_stopdesk + stopdesk_id for desk delivery. ZR Express returns a tracking number that DZBuild stores on the order and exposes to the customer.

Common errors and fixes​

MessageCauseFix
Token غير صحيح (Procolis "Clé non détectée S1")Token wrongRe-copy the Token from your ZR Express dashboard.
Key غير صحيح (Procolis "Clé non détectée S2")Key wrong, or API not enabled on your accountRe-copy the Key; if the message persists, ask ZR Express to activate API access.
الحساب معطل (Procolis "Token désactivé")Account disabledContact ZR Express to reactivate it.
New platform: "API Key و Tenant ID مطلوبان"One of the two fields is missingBoth fields are required on the new platform — make sure the UUID is pasted in full.

Tips​

  • Don't mix the two APIs: legacy credentials don't work on the new platform and vice versa.
  • After moving from legacy to new, unlink the old one in /dashboard/shipping first, then link the new one — DZBuild stores one ZR Express provider at a time per store.
  • The legacy API is the one most ZR Express merchants are still on; only switch to the new platform when ZR Express asks you to.