ZR Express
ZR Express couvre les 58 wilayas avec un solide réseau de stop-desks et une appli de suivi connue. DZBuild prend en charge les deux API ZR Express :
- ZR Express (Procolis) — l'ancienne API sur
procolis.com. Choisissez-la si votre tableau de bord ZR Express est l'ancienne version. - ZR Express New Platform — la nouvelle API sur
api.zrexpress.app. Choisissez-la si votre tableau de bord est le nouveau portail avec un UUID de tenant.
Si vous hésitez, demandez au support ZR Express — votre compte est sur l'une ou l'autre.
Ce qu'il vous faut
ZR Express classique (zrexpress)
- Token
- Key
Les deux proviennent de votre compte dans l'ancien tableau de bord. La même structure Procolis fonctionne aussi pour Abex Express sous le slug abexexpress.
ZR Express nouvelle plateforme (zr-express-new)
- API Key (la clé secrète)
- Tenant ID (un UUID identifiant votre compte)
Disponibles dans le nouveau portail dans la section API/intégrations. Le Tenant ID est un UUID type xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Lier ZR Express dans DZBuild
- Ouvrez
/dashboard/shipping. - Cliquez sur Link provider et choisissez ZR Express (classique) ou ZR Express New Platform.
- Collez les identifiants du tableau correspondant.
- Cliquez sur Test API. DZBuild interroge un endpoint de vérification en direct (classique :
/token; nouvelle :/api/v1/users/profile) et affiche vert si tout est valide. - Enregistrez.
Ce qui est synchronisé
- Liste des wilayas et communes desservies.
- Tarifs domicile par wilaya.
- Tarifs stop-desk par wilaya.
- Liste des stop-desks par wilaya, utilisée par le sélecteur Stop Desk.
Ce qui se passe à l'expédition d'une commande
DZBuild envoie le colis avec les coordonnées client, le montant COD (sous-total), la wilaya / commune, et is_stopdesk + stopdesk_id pour la livraison au bureau. ZR Express retourne un numéro de suivi que DZBuild stocke sur la commande et expose au client.
Erreurs fréquentes
| Message | Cause | Correction |
|---|---|---|
Token غير صحيح (Procolis "Clé non détectée S1") | Token incorrect | Recopiez le Token depuis votre tableau de bord ZR Express. |
Key غير صحيح (Procolis "Clé non détectée S2") | Key incorrecte ou API non activée sur votre compte | Recopiez la Key ; si le message persiste, demandez à ZR Express d'activer l'API. |
الحساب معطل (Procolis "Token désactivé") | Compte désactivé | Contactez ZR Express pour le réactiver. |
| Nouvelle plateforme : "API Key و Tenant ID مطلوبان" | L'un des deux champs manque | Les deux champs sont requis sur la nouvelle plateforme — collez l'UUID en entier. |
Astuces
- Ne mélangez pas les deux API : les identifiants classiques ne fonctionnent pas sur la nouvelle plateforme et vice versa.
- Pour migrer du classique vers le nouveau, déliez d'abord l'ancien dans
/dashboard/shippingpuis liez le nouveau — DZBuild ne stocke qu'un fournisseur ZR Express à la fois par boutique. - L'API classique est encore celle de la majorité des marchands ; passez au nouveau seulement quand ZR Express vous le demande.