# 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[​](#ce-quil-vous-faut "Lien direct vers 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 ` — 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[​](#lier-maystro-dans-dzbuild "Lien direct vers Lier Maystro dans DZBuild") 1. Ouvrez **[`/dashboard/link-shipping`](https://dzbuild.com/dashboard/link-shipping)** et trouvez la tuile **Maystro**. 2. Cliquez sur **Lier**. 3. Collez votre **Authentication Token** dans le champ d'identifiant unique. 4. Cliquez sur **Tester la connexion**. DZBuild appelle Maystro en direct et confirme que le jeton fonctionne. 5. Cliquez sur **Lier et enregistrer**. Les prix par wilaya s'éditent sur la page distincte [`/dashboard/shipping`](https://dzbuild.com/dashboard/shipping). ## Ce qui est synchronisé[​](#ce-qui-est-synchronisé "Lien direct vers 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](https://dzbuild.com/fr/fr/docs/couriers/stop-desk.md). ### Tarifs[​](#tarifs "Lien direct vers 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`](https://dzbuild.com/dashboard/shipping). ### Bureaux[​](#bureaux "Lien direct vers Bureaux") La liste des bureaux Maystro est lue depuis la commune-centre de chaque wilaya. DZBuild ne parcourt les autres communes de la wilaya que si la commune-centre n'a aucun bureau. Un bureau situé dans une commune périphérique d'une wilaya dont la commune-centre a déjà un bureau n'est donc pas listé, et cliquer sur **Actualiser** n'y change rien. La livraison au bureau reste disponible dans toute wilaya où Maystro affiche un tarif bureau. 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[​](#ce-qui-se-passe-à-lexpédition-dune-commande "Lien direct vers 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). L'API Maystro n'a pas de champ bureau : quand le client a choisi un bureau, DZBuild envoie la commune de ce bureau avec le drapeau bureau, ce qui achemine le colis vers une commune qui a un 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. 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[​](#erreurs-fréquentes "Lien direct vers 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 [`/dashboard/shipping`](https://dzbuild.com/dashboard/shipping). | ## Astuces[​](#astuces "Lien direct vers Astuces") * Le test de connexion lit la liste des wilayas de Maystro : il fonctionne donc sur un compte sans aucune expédition. Tant que DZBuild affiche vert, le jeton est valide. * Après la synchronisation des tarifs, relisez le tableau sur [`/dashboard/shipping`](https://dzbuild.com/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.