API
Intégration API Boxtal : connectez vos commandes et vos expéditions
Dawap relie Boxtal à votre boutique, votre ERP ou vos outils logistiques. Nous automatisons la création des expéditions, le rattachement des étiquettes et le retour du suivi, avec des contrôles adaptés à vos règles de livraison.
APIs, données et infrastructures que nos projets savent connecter
Conception, intégration et maintenance
01
Contrat
versionné
02
Sécurité
explicite
03
Reprise
testée
04
Supervision
avec alertes
Réponse immédiate
Retrouvez l’expédition et son suivi dans le dossier de commande.
Le connecteur prépare les données du colis, utilise l’offre de transport retenue et rattache la commande d’expédition Boxtal à votre commande client. Il récupère les documents et les événements de suivi pour alimenter vos logiciels. Si une réponse se perd, il vérifie l’état de l’expédition avant toute nouvelle création.
- Utiliser les interfaces adaptées à chaque échange : API v3 JSON pour les expéditions ; API v1 XML pour la demande de devis, selon la documentation actuelle.
- Séparer la demande de devis, la création d’expédition, les documents et les événements de suivi.
- Conserver les identifiants commande, colis, offre, shipping order, document et tracking sous une corrélation commune.
- Relire l’état Boxtal avant toute recréation lorsque la réponse ou la livraison du document reste ambiguë.
Choix du transport · exemple fictif
Choisir le transport qui respecte vos règles de livraison.
La commande, les offres, montants, transporteurs et identifiants ci-dessous sont fictifs. Cet exemple relie le choix du service, l’expédition, son étiquette et le suivi au même dossier de commande.
01 · Comparaison
Offres comparées pour le colis
AX
Transporteur fictifAtlas Standard
- Coût
- 13,90 €
- Promesse
- J+3
- Mode
- Domicile
NV
Transporteur fictifNova Priority
- Coût
- 15,40 €
- Promesse
- J+2
- Mode
- Domicile
RL
Transporteur fictifRelais Local
- Coût
- 10,80 €
- Promesse
- J+4
- Mode
- Relais
Règle fictive v9
Domicile obligatoire · promesse ≤ J+2 · coût ≤ 18 € · collecte Lyon · solution de remplacement validée par la logistique.
02 · Passeport
L’ordre conserve son offre et son colis
SHIPPING ORDER FICTIFSO-74…K9
DOCUMENT REÇU- Référence métier
- CMD-8041 / P-01
- shippingOfferCode
- OFR…NV42
- Document
- LBL…8C1 · PDF
- trackingId
- TRK…392
VerdictUn ordre · un document · une corrélation
- 09:41:11Devis reçu3 offres comparées
- +18 msRègle v9Nova retenue · règle v9
- +640 msExpédition acceptéeSO-74…K9 consigné
- +2 minDocument liéévénement DOCUMENT
- J+1Suivi actualiséétat client réconcilié
Premier lot recommandé
Un canal, un entrepôt, un type de colis et trois offres.
Apportez le colis qui reçoit deux labels, perd son suivi ou change silencieusement de service. Le cadrage rend éligibilité, choix, ordre, document et reprise lisibles avant d’ouvrir d’autres pays.
Quand le tarif paraît suffire
Les erreurs de livraison commencent souvent entre deux logiciels.
Le service choisi doit respecter vos règles. Une réponse perdue ne doit pas créer une seconde expédition, et un événement de suivi doit retrouver la bonne commande. Ces situations font partie de la recette du connecteur.
01
Éligibilité
Une offre remonte, mais ne respecte pas la promesse client
Coût, délai, mode, origine, destination, dimensions, assurance et règles du canal sont vérifiés avant de retenir le service de transport.
02
Unicité
Un timeout déclenche une seconde commande d’expédition
Le connecteur conserve commande, colis, offre, tentative et état relu. Il ne recrée pas un label tant que le premier effet reste ambigu.
03
Chronologie
Le document et le tracking arrivent après la réponse initiale
Shipping order, document et événement de suivi sont des étapes séparées. Le support voit ce qui manque et quelle reprise est autorisée.
Échanges avec Boxtal
Contrôler les données, l’expédition et le suivi à chaque étape.
L’agrégateur expose des offres et des opérations shipping. La responsabilité de la donnée colis, de la règle de choix et de la preuve client reste partagée entre vos outils.
Adresse et colis sont qualifiés avant le devis
Pays, code postal, poids, dimensions, contenu, origine et contraintes douanières sont normalisés avec un refus explicite lorsqu’une donnée critique manque.
Le choix respecte vos critères de livraison
Coût complet, délai, mode, promesse, valeur, canal, entrepôt et disponibilité produisent une décision versionnée avec fallback autorisé.
L’offre retenue reste liée au shipping order
La corrélation conserve shippingOfferCode, commande, colis, tentative et résultat afin de retrouver un effet ambigu avant toute nouvelle création.
Le label possède son propre état de réception
Le système distingue ordre accepté, document disponible, téléchargement, archivage et réimpression ; une absence momentanée ne vaut pas échec définitif.
Le suivi conserve le statut reçu du transporteur
Tracking et événements conservent valeur fournisseur, horodatage et corrélation avant de produire l’état client, l’action support ou l’alerte.
Annulation et reprise vérifient l’état courant
Avant une annulation ou une reprise, le connecteur vérifie l’état courant, conserve le résultat et alerte le responsable si une décision est nécessaire.
Méthode offre–colis–preuve
Définir vos règles de livraison avec la logistique, le commerce et la DSI.
Dawap part du colis qui coûte trop cher, reçoit deux labels ou disparaît du suivi. Logistique, e-commerce, support et IT nomment les données d’entrée, les offres admissibles, le fallback, l’identité du colis, les états asynchrones et la preuve de clôture avant d’ouvrir le flux.
Expliquer l’offre
Retrouver les critères, la version de règle et le service qui ont produit le choix.
Retrouver l’ordre
Relire l’état d’un shipping order ambigu avant toute nouvelle création.
Rattacher le document
Conserver label, colis, format et événement sous la même corrélation.
Reprendre le suivi
Réordonner ou compenser les événements sans perdre le statut brut.
Premier lot Boxtal
Valider un premier parcours de commande jusqu’au suivi du colis.
On choisit un canal, un entrepôt, un type de colis et trois offres représentatives. Le lot est accepté lorsque le service retenu peut être expliqué, que le même shipping order est retrouvé après timeout et que document comme tracking reviennent au bon dossier.
1 canal
1 entrepôt
1 type de colis
3 offres
5 contre-tests
Sorties attendues
Carte e-commerce–OMS–WMS–ERP–Boxtal–support avec source de vérité et droit d’écriture pour chaque état.
Contrat adresse, colis, contenu, service, option, coût, délai, offre, shipping order, document et tracking.
Règles de choix du transport : critères bloquants, coût, délai, solution de remplacement et responsable de la validation.
Cinq contre-tests : adresse invalide, offre devenue indisponible, timeout après création, document retardé et tracking désordonné.
Journal expurgé reliant commande, parcel ref, shippingOfferCode, shipping order, document, trackingId, tentative et verdict.
Recette logistique–service client–IT, balance attendu–créé–documenté–suivi, alertes et runbook de reprise.
Recette Boxtal–SI
Tester les incidents qui peuvent bloquer une expédition.
Ces scénarios et leurs valeurs sont illustratifs. Ils doivent être rejoués sur votre compte, vos transporteurs, services, pays et règles. Aucun projet public ci-dessous n’est présenté comme une intégration Boxtal livrée.
Le service choisi au checkout n’est plus admissible à la préparation.
- Scénario terrain
- Le poids final ou l’adresse corrigée sort le colis des limites de l’offre conservée. Commander malgré tout créerait un refus tardif ou un service différent.
- Architecture
- Snapshot des données de devis, matrice d’éligibilité versionnée, revalidation avant order et fallback explicitement autorisé.
- Livrable
- Test avec données modifiées, offre retenue, écart identifié et décision de l’équipe logistique.
- Décision
- Recalculer et demander confirmation, ou bloquer le colis ; ne pas choisir silencieusement l’offre suivante.
- Résultat vérifiable
- Le service commandé respecte la décision actuelle et tout changement de promesse reste visible.
Le client ne sait pas si le shipping order a été créé.
- Scénario terrain
- La réponse se perd après l’envoi. Un retry immédiat pourrait générer un second ordre ou un second label pour le même colis.
- Architecture
- Clé métier colis–commande, journal de tentative, recherche d’état Boxtal, verrou par effet et file d’ambiguïté.
- Livrable
- Simulation d’une réponse perdue, vérification du nombre d’expéditions créées et test de reprise sur la même commande.
- Décision
- Retrouver ou faire arbitrer l’ordre existant avant d’autoriser toute recréation.
- Résultat vérifiable
- Un colis conserve un seul ordre accepté et une raison documentée si une nouvelle création devient nécessaire.
Un événement plus ancien arrive après une étape récente.
- Scénario terrain
- Le webhook contient un statut valide mais son horodatage précède l’état déjà publié au support. L’appliquer ferait régresser la chronologie client.
- Architecture
- Inbox dédupliquée, statut brut, date fournisseur séparée de la réception, règle de transition et réconciliation périodique.
- Livrable
- Séquence permutée, mapping des statuts, preuve de non-régression, métrique de retard et runbook.
- Décision
- Conserver l’événement dans l’audit sans remplacer l’état métier plus récent.
- Résultat vérifiable
- Le client conserve le statut le plus récent et le support peut consulter tous les événements reçus.
Boxtal, WMS/OMS ou transporteur direct ?
Définir ce qui doit être connecté autour de Boxtal.
Votre besoin peut porter sur le raccordement de Boxtal, sur la préparation en entrepôt ou sur plusieurs transporteurs. Nous précisons ce périmètre avant de choisir les interfaces et les règles à développer.
Le besoin part des offres, shipping orders, documents ou événements Boxtal
Nous développons le raccordement Boxtal, le traitement des erreurs et les écrans de suivi nécessaires à vos équipes.
Le problème principal est la commande à préparer ou l’état de stock
Nous relions vos outils de commande et d’entrepôt pour transmettre les quantités à préparer et récupérer leurs états.
La décision compare agrégateur, transporteurs directs et architecture cible
Nous comparons les fonctions disponibles et la maintenance d’une plateforme de transport avec celles des connexions directes.
Intégrations complémentaires
Raccorder l’expédition au reste de votre système d’information.
Boxtal possède l’expédition agrégée. L’OMS/WMS garde la préparation, l’e-commerce la promesse de vente et l’ERP les coûts et documents de gestion.
Pour Art’Sacs, activité reprise depuis par France Appro, Dawap a relié Aster et PrestaShop afin de transformer le catalogue fournisseur, synchroniser les quantités, enrichir les fiches et préparer les commandes dropshipping. Les tâches, états et erreurs donnent aux équipes un flux pilotable plutôt qu’une synchronisation opaque.
Questions fréquentes
Questions fréquentes avant une intégration Boxtal API
Réponses sur API v3, devis, shipping orders, labels, tracking, choix transporteur et premier lot.
01Une extension Boxtal existante peut-elle suffire ?
Oui, si elle couvre votre boutique et les opérations attendues. Nous vérifions cette couverture avant de proposer un développement. Le sur-mesure devient utile pour relier un ERP ou un WMS, appliquer des règles spécifiques ou reprendre un échange qui ne passe pas par l’extension.
02Comment estimez-vous le budget et le délai ?
Nous examinons vos logiciels, les accès Boxtal, les données des colis et les opérations à automatiser. Le cadrage distingue le premier parcours à livrer, les cas d’erreur à tester et les extensions éventuelles. Il permet de chiffrer le développement et la maintenance sur un périmètre précis.
03Qui suit l’intégration après sa mise en service ?
Dawap peut assurer la supervision et la maintenance du connecteur, ou organiser le transfert vers votre équipe technique. Nous définissons les alertes, les responsabilités, la procédure de reprise et les conditions d’intervention avant la mise en production.
04Quelle version de l’API Boxtal faut-il utiliser ?
Le choix dépend de l’opération. L’API v3 JSON gère les expéditions, leurs documents et le suivi. Selon la documentation Boxtal actuelle, la demande de devis utilise encore l’API v1 XML. Nous vérifions les accès et la couverture de chaque fonction avant de définir le connecteur.
05Que peut automatiser une intégration Boxtal API ?
Elle peut relier la qualification du colis, les offres, la règle de choix, le shipping order, les documents d’expédition, le tracking et les exceptions à votre e-commerce, OMS, WMS, ERP, marketplace ou support.
06Comment choisir une offre Boxtal sans regarder seulement le tarif ?
On formalise coût complet, délai, mode, origine, destination, poids, dimensions, valeur, canal, promesse et fallback. La version de cette règle et le shippingOfferCode retenu restent attachés au colis.
07Comment éviter deux labels après un timeout ?
Le connecteur conserve une clé métier stable, la tentative et les identifiants connus, puis relit l’état Boxtal avant toute recréation. Un résultat ambigu part en reprise contrôlée au lieu d’un retry aveugle.
08Comment synchroniser le tracking Boxtal ?
Les événements sont dédupliqués, conservés avec leur statut brut et leur horodatage, puis traduits vers une chronologie métier. Un événement ancien n’écrase pas automatiquement un état client plus récent.
Boxtal API · Devis · Expédition · Tracking
Quelles opérations souhaitez-vous automatiser avec Boxtal ?
Partons de vos logiciels et d’une expédition représentative. Nous définirons les données à échanger, les contrôles et le suivi nécessaires pour mettre en service une intégration que vos équipes peuvent exploiter.
Cadrer mon intégration Boxtal
