Noest Express est un transporteur algérien doté de sa propre API autonome — ce n'est pas un locataire EcoTrack. DZBuild dispose d'une intégration Noest dédiée : deux valeurs suffisent pour la lier.

Ce qu'il vous faut

API Token
User GUID

Les deux proviennent de votre tableau de bord marchand Noest. Le GUID identifie votre boutique chez Noest ; le jeton authentifie les appels API.

Lier Noest dans DZBuild

Ouvrez /dashboard/link-shipping et trouvez la tuile Noest.
Cliquez sur Lier.
Collez votre API Token dans le premier champ et votre User GUID dans le second.
Cliquez sur Tester la connexion. DZBuild vérifie les identifiants en direct.
Cliquez sur Lier et enregistrer.

Les prix par wilaya s'éditent sur la page distincte /dashboard/shipping.

Validation automatique — à lire avant votre premier envoi

La fenêtre d'identifiants comporte un interrupteur de validation automatique propre à Noest, et il est désactivé par défaut.

Désactivé, une commande poussée par DZBuild vers Noest est créée comme un brouillon modifiable. L'équipe logistique de Noest ne la voit jamais tant que vous n'ouvrez pas le tableau de bord Noest pour la valider vous-même.

Activez l'interrupteur et DZBuild valide chaque commande juste après l'avoir créée (marquée « تم التأكيد تلقائياً »). Si cet appel de validation échoue, la commande est tout de même créée et DZBuild la marque « يحتاج تأكيد يدوي من لوحة NOEST » — validez-la vous-même depuis le tableau de bord Noest. La contrepartie : une commande validée n'est plus modifiable dans Noest.

Ce qui est synchronisé

La liste des wilayas desservies par Noest.
Les communes par wilaya, comparées à la liste de communes synchronisée depuis Noest.
Les tarifs domicile + bureau par wilaya : Synchroniser les tarifs remplit le prix domicile et le prix bureau pour chaque wilaya. Vous pouvez toujours surcharger une wilaya à la main sur /dashboard/shipping.
La liste des bureaux, avec nom, adresse, téléphone et lien carte de chaque bureau — le tout exposé par le sélecteur Stop Desk. Chaque bureau porte un code dont le nombre est la wilaya, par exemple 16A se trouve en wilaya 16.

Ce qui se passe à l'expédition d'une commande

DZBuild soumet la commande à Noest avec le nom du client, son numéro de téléphone (un seul numéro parvient à Noest — un second numéro client est stocké sur la commande DZBuild mais n'est pas transmis), l'adresse, la wilaya et la commune de destination, le résumé des produits, votre référence de commande, et :

montant — le total de la commande (produits plus livraison), pas le sous-total.
poids — le poids en kilogrammes entiers, 1 par défaut.
can_open — réglé pour que le client soit autorisé à ouvrir le colis avant de payer.
type_id — 1 pour une livraison normale, 2 pour un échange, 3 pour un ramassage. Un ramassage force le montant COD à 0, conformément à la spécification Noest.
Pour la livraison au bureau : stop_desk: 1 plus un station_code (le code de bureau Noest, par exemple 16A) résolu depuis la liste de bureaux synchronisée. commune_id est un champ distinct envoyé quand il est connu — ce n'est pas la référence du bureau.

Si aucune station n'est trouvée pour la wilaya, l'envoi est refusé avec « لا توجد نقطة استلام (Stop Desk) متاحة في ولاية … » plutôt que rétrogradé en livraison à domicile.

La résolution de la commune s'appuie d'abord sur la liste de communes Noest synchronisée, puis sur une correspondance en direct via l'API. Si aucune des deux ne correspond, l'envoi est refusé — vous obtenez une erreur en arabe nommant la commune ainsi que jusqu'à cinq communes voisines suggérées, et aucun numéro de suivi n'est créé. DZBuild préfère refuser plutôt que risquer une livraison dans la mauvaise commune.

Noest retourne un numéro de suivi. Une URL de téléchargement du bordereau existe sur l'API Noest, mais aucun bouton du tableau de bord DZBuild ne l'ouvre — Imprimer l'étiquette sur une commande Noest imprime le bordereau HTML propre à DZBuild. Imprimez l'étiquette officielle Noest depuis le tableau de bord Noest.

Noest limite le débit agressivement : les envois en masse sont donc cadencés et réessayés automatiquement quand l'API renvoie une réponse de dépassement de limite.

Erreurs fréquentes

Symptôme	Cause probable	Correction
« Échec du test de connexion »	Jeton ou GUID incorrect, ou les deux	Recopiez chaque valeur depuis le tableau de bord Noest ; les deux champs sont faciles à inverser.
« البلدية … غير موجودة في قاعدة بيانات NOEST »	Noest ne connaît pas cette orthographe de commune	Choisissez l'une des communes suggérées affichées avec l'erreur, ou cliquez sur Actualiser sur la tuile Noest pour resynchroniser la liste des communes, puis renvoyez.
« لا توجد نقطة استلام (Stop Desk) متاحة في ولاية … »	Aucun bureau Noest dans la wilaya du client	Actualisez les données du fournisseur, changez de transporteur, ou repassez la commande en livraison à domicile.
Le colis n'apparaît jamais dans la vue logistique de Noest	La validation automatique est désactivée et le brouillon n'a jamais été validé	Validez-le dans le tableau de bord Noest, ou activez la validation automatique dans la fenêtre d'identifiants.

Astuces

Tranchez la question de la validation automatique avant votre premier envoi en masse — un lot de brouillons non validés se rate facilement.
La correspondance des communes dépend de la liste de communes Noest synchronisée. Si vous vendez dans une commune que Noest vient d'ajouter, cliquez sur Actualiser sur la tuile plutôt que d'attendre le rafraîchissement quotidien automatique.
Les colis Noest ne portent ni valeur déclarée ni champ d'assurance — ceux-là sont réservés à la famille Yalidine.