Maystro Delivery est un transporteur national avec une bonne présence sur les wilayas algériennes. L'intégration est l'une des plus simples : un seul jeton API suffit.
Ce qu'il vous faut
Une seule valeur, appelée Authentication Token dans la fenêtre d'identifiants, émise depuis votre tableau de bord marchand Maystro. Maystro s'authentifie avec
Authorization: Token <value>— ce n'est pas un jeton Bearer.
Si votre compte n'expose pas l'accès API, contactez Maystro pour l'activer.
Lier Maystro dans DZBuild
Ouvrez
/dashboard/link-shippinget trouvez la tuile Maystro.Cliquez sur Lier.
Collez votre Authentication Token dans le champ d'identifiant unique.
Cliquez sur Tester la connexion. DZBuild appelle Maystro en direct et confirme que le jeton fonctionne.
Cliquez sur Lier et enregistrer.
Les prix par wilaya s'éditent sur la page distincte /dashboard/shipping.
Ce qui est synchronisé
La liste des wilayas desservies par Maystro.
Les communes par wilaya.
Les tarifs domicile + bureau par wilaya — voir ci-dessous.
La liste des stop-desks pour le sélecteur Stop Desk.
Tarifs
Les tarifs Maystro sont synchronisables. Synchroniser les tarifs lit la tarification de livraison propre à Maystro pour chaque wilaya et renseigne à la fois le prix domicile et le prix bureau.
Une réserve à connaître : Maystro tarifie par commune, pas par wilaya, DZBuild approxime donc chaque wilaya par sa commune-centre. Une wilaya dont la commune-centre ne renvoie aucun tarif reste à 0 — saisissez-la à la main sur /dashboard/shipping.
Bureaux
La liste des bureaux Maystro est découverte commune par commune, en commençant par la commune-centre de chaque wilaya. Un bureau situé dans une commune périphérique peut donc mettre un cycle de synchronisation à apparaître — cliquer sur Actualiser sur la tuile Maystro le force.
Seuls les stop-desks propres à Maystro sont listés ; les points de retrait partenaires ne sont pas pris en charge.
Ce qui se passe à l'expédition d'une commande
DZBuild poste la commande à Maystro avec le nom, le téléphone et l'adresse du client, la wilaya de destination, la commune sous forme d'identifiant numérique de commune Maystro, la liste des produits, votre numéro de commande comme external_order_id, et product_price — qui est le total de la commande, pas le sous-total.
Deux choses que Maystro ne reçoit pas :
Le poids n'est pas envoyé à Maystro du tout.
Aucun identifiant de bureau. La livraison au bureau n'est exprimée que par
delivery_type: 2(1 = domicile, 3 = point de retrait). Le bureau précis choisi par le client n'est pas transmis aujourd'hui — seulement la commune et le drapeau bureau.
L'identifiant de commune est résolu depuis les données de communes synchronisées par DZBuild puis par une recherche en direct ; s'il est introuvable, l'envoi échoue avec « لم يتم العثور على البلدية … ».
Maystro retourne un numéro de suivi (enregistré sur la commande) et une URL d'étiquette.
📝 Remarque — Imprimer l'étiquette Maystro
Aucun bouton du tableau de bord n'ouvre l'URL d'étiquette de Maystro — cliquer sur Imprimer l'étiquette sur une commande Maystro imprime le bordereau HTML propre à DZBuild. Imprimez le bordereau officiel Maystro depuis le portail Maystro.
Erreurs fréquentes
Symptôme | Cause probable | Correction |
Le test de connexion échoue immédiatement | Jeton incorrect ou expiré | Copiez un Authentication Token frais depuis Maystro et recollez-le. |
| La commune de la commande n'a pas d'identifiant de commune Maystro | Corrigez la commune sur la commande, ou cliquez sur Actualiser sur la tuile pour resynchroniser la liste de communes Maystro. |
Certaines wilayas restent à 0 après la synchronisation | Maystro n'a renvoyé aucun tarif pour la commune-centre de cette wilaya | Saisissez ces wilayas manuellement sur |
Astuces
Si votre compte Maystro n'a pas encore d'expédition, le test de connexion revient avec très peu de données. Tant que DZBuild affiche vert, le jeton est valide.
Après la synchronisation des tarifs, relisez le tableau sur
/dashboard/shipping— l'approximation par commune-centre peut se situer légèrement au-dessus ou en dessous de ce que vous payez réellement dans les communes périphériques.Maystro est un bon complément à Yalidine quand vous cherchez un transporteur de secours sur certaines zones.