Maystro Delivery
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
- API token (un jeton bearer unique émis depuis votre tableau de bord marchand Maystro).
Si votre compte n'expose pas l'accès API, contactez Maystro pour l'activer.
Lier Maystro dans DZBuild
- Ouvrez
/dashboard/shipping. - Cliquez sur Link provider et choisissez Maystro.
- Collez votre API token dans le champ unique.
- Cliquez sur Test API. DZBuild appelle l'endpoint des commandes Maystro en direct et confirme la validité du jeton.
- Enregistrez.
Ce qui est synchronisé
- Liste des wilayas desservies par Maystro (Maystro n'expose pas d'endpoint wilayas, DZBuild fournit donc la liste standard des 58 wilayas en utilisant le mapping Maystro).
- Communes par wilaya.
- Liste des stop-desks par wilaya pour le sélecteur Stop Desk.
Les tarifs par wilaya ne sont pas synchronisés automatiquement chez Maystro — vous les définissez à la main dans /dashboard/shipping. Appliquez une médiane par défaut depuis le tableau de bord ou surchargez par wilaya.
Ce qui se passe à l'expédition d'une commande
DZBuild envoie la commande vers l'endpoint des commandes Maystro avec le nom, le téléphone, l'adresse, le montant COD (sous-total), le code wilaya, la commune et le poids. Pour la livraison au bureau, DZBuild transmet aussi is_stopdesk (avec les variantes stopdesk / stopdesk_id que Maystro accepte).
Maystro retourne :
- Un numéro de suivi (enregistré sur la commande).
- Une URL d'étiquette sur
https://backend.maystro-delivery.com/api/stores/orders_store/{tracking}/label/pour imprimer le bordereau.
Erreurs fréquentes
| Symptôme | Cause probable | Correction |
|---|---|---|
| "Test API" échoue immédiatement | Jeton incorrect ou expiré | Recopiez un jeton frais depuis Maystro. |
| Commande rejetée pour erreur de wilaya | Mauvais code wilaya | Vérifiez que la wilaya du client est l'un des 58 codes standards — Maystro attend le code en chaîne. |
| Pas d'étiquette générée | Le suivi est enregistré mais l'endpoint étiquette n'est pas encore prêt | Patientez une minute et recliquez "Print label" — Maystro produit les étiquettes en asynchrone. |
Astuces
- Le Test API de Maystro interroge la liste des commandes ; si votre compte n'a pas encore d'expédition, la réponse est minimaliste. Tant que DZBuild affiche vert, le jeton est valide.
- Définissez vos tarifs domicile + bureau manuellement dans
/dashboard/shipping, par wilaya — reprenez-les directement de votre dernière facture Maystro pour démarrer juste. - Maystro est un bon complément à Yalidine quand vous cherchez un transporteur de secours sur certaines zones.