Pour les développeurs
API publique
Connectez votre boutique en quelques minutes
Pour connecter une boutique en ligne et automatiser les envois : chaque fonctionnalité de l’espace fournisseur est disponible côté programmation, avec authentification par clé et token.
43 fonctionnalités · 8 sections
Démarrer et s’authentifier
API REST en JSON
Une API REST standard où toutes les requêtes et réponses sont en JSON (UTF-8, dates ISO 8601), simple à connecter à n’importe quelle boutique en ligne ou application.
Authentification par clé + token
Chaque appel est sécurisé par deux identifiants — une clé fixe et un token régénérable — transmis dans les en-têtes X-API-Key et X-API-Token.
Vérification des identifiants
Un appel de test confirme instantanément que vos identifiants sont valides et renvoie l’identité de votre compte fournisseur.
Régénération du token
Régénérez votre token à tout moment pour révoquer immédiatement un accès compromis, sans avoir à changer votre clé.
Quotas de débit transparents
Des limites claires et généreuses (50 requêtes par minute, 2 000 par heure, 20 000 par jour) protègent le service tout en couvrant largement un usage e-commerce.
Suivi de consommation en direct
Chaque réponse indique, via des en-têtes dédiés, le quota déjà consommé et la version de l’API pour piloter finement vos intégrations.
Collection Postman prête à l’emploi
Téléchargez une collection Postman pré-configurée (tous les endpoints, en-têtes d’authentification et exemples de corps) pour tester l’API en quelques minutes.
Historique des versions
Un changelog interrogeable par l’API vous tient informé des évolutions et de la version en cours de l’API publique.
Référentiels de livraison
Wilayas desservies
Récupérez la liste des wilayas avec, pour chacune, les modes de livraison disponibles (à domicile, en point relais).
Communes livrables
Obtenez les communes de chaque wilaya et repérez celles qui ne sont pas desservies, pour éviter d’enregistrer des commandes non livrables.
Bureaux / points relais (stopdesk)
Listez les bureaux stopdesk de chaque wilaya avec leur adresse, position Google Maps et numéro de contact, pour proposer le retrait en point relais.
Situations de colis
Accédez aux libellés officiels des situations (En cours, Livrée, Annulée, Encaissée…) pour interpréter et afficher l’état de chaque colis.
États logistiques
Suivez l’état physique du colis dans la chaîne (en préparation, au bureau, en livraison, livré…) en complément de sa situation commerciale.
Grille tarifaire
Consultez vos tarifs de livraison par wilaya (domicile et stopdesk) ainsi que vos frais de service et d’emballage, pour afficher le bon prix à vos clients.
Créer et préparer vos colis
Création par lot
Créez de 1 à 100 colis en un seul appel, chaque ligne réussissant ou échouant indépendamment avec un message d’erreur précis.
Domicile ou point relais
Choisissez pour chaque colis une livraison à domicile (par commune) ou le retrait dans un bureau stopdesk (par code de bureau).
Colis d’échange
Marquez un colis comme échange pour gérer les remplacements de produits, sans contrainte sur le montant.
Référence de commande
Attachez votre propre référence interne à chaque colis pour le réconcilier facilement avec les commandes de votre boutique.
Création déjà confirmée
Créez un colis directement en état « prêt à expédier » lorsque vous n’avez pas besoin d’une étape de préparation.
Modification avant expédition
Corrigez les informations d’un colis (destinataire, adresse, montant, mode de livraison) tant qu’il est encore en préparation.
Confirmation par lot
Faites passer un lot de colis de « en préparation » à « prêt à expédier » en un seul appel, l’équivalent du bouton de confirmation du panel.
Suppression avant expédition
Supprimez un colis créé par erreur tant qu’il n’a pas quitté l’étape de préparation.
Suivre et synchroniser
Liste paginée et filtrée
Parcourez tous vos colis avec pagination et filtres (wilaya, dates, type de date, numéros de suivi) pour retrouver exactement ce que vous cherchez.
Synchronisation incrémentale
Ne récupérez que les colis ayant bougé sur une période donnée (par date d’action ou depuis une date), idéal pour synchroniser votre boutique sans tout re-télécharger.
Détail et parcours d’un colis
Obtenez toutes les informations d’un colis accompagnées de son historique complet, étape par étape.
Statuts par lot
Interrogez le statut de jusqu’à 100 colis en une requête, par numéro de suivi et/ou par votre propre référence de commande.
Historique par lot
Récupérez en une seule requête le parcours détaillé de plusieurs colis (jusqu’à 40) pour tracer leur cheminement.
Résumé statistique
Affichez une vue d’ensemble instantanée : nombre total de colis, taux de livraison, et répartition par situation et par état logistique.
Impression des bordereaux
Bordereau prêt à imprimer
Générez l’étiquette d’un colis aux dimensions exactes (100×100 ou 100×130 mm), avec logo, code-barres et toutes les informations d’expédition.
Impression groupée
Réunissez jusqu’à 100 bordereaux dans un seul document (une page par colis) pour imprimer une tournée entière d’un coup.
Catalogue produits (comptes stock)
Catalogue de produits
Listez vos produits (référence et désignation) sur les comptes gérés en stock, où chaque colis pointe vers une référence produit.
Ajout de produit
Créez un nouveau produit avec une référence unique, directement depuis votre système, sans passer par le panel.
Mise à jour de produit
Modifiez à tout moment la référence ou la désignation d’un produit existant de votre catalogue.
Packs et bundles
Regroupez plusieurs articles sous une seule référence « pack » pour les vendre ensemble dans un même colis, au tarif d’un seul article.
Ramassage et paiements
Demande de ramassage
Programmez l’enlèvement de vos colis en précisant le nombre de colis, le type de véhicule, la commune et l’heure souhaitée.
Liste des paiements
Consultez l’historique paginé de vos versements avec, pour chacun, le montant net à récupérer et le nombre de colis livrés et annulés.
Détail d’un paiement
Ouvrez le détail d’un paiement pour voir chaque colis qui le compose et le décompte précis des frais appliqués.
Webhooks — notifications en temps réel
Abonnement aux événements
Recevez automatiquement une notification sur votre propre URL à chaque changement de situation d’un colis, sans avoir à interroger l’API en boucle.
Choix des événements
Abonnez-vous à tous les événements ou seulement à ceux qui vous intéressent (par exemple uniquement « Livrée »), via le catalogue des événements disponibles.
Événement de test
Envoyez un événement de test vers votre URL pour valider votre intégration avant la mise en production.
Signature sécurisée
Chaque notification est signée en HMAC-SHA256 avec votre secret, pour vérifier qu’elle provient bien de nous et n’a pas été altérée.
Livraison fiable
En cas d’échec, les notifications sont réessayées automatiquement selon un délai progressif, avec un identifiant unique par événement pour éviter les doublons.
Journal des notifications
Consultez l’historique de vos dernières notifications envoyées (statut, tentative, erreur) pour diagnostiquer facilement votre intégration.