Étiquettes fournies par le client : envoi par API ou téléversement à l’entrepôt

Certains clients achètent leurs propres étiquettes et envoient le PDF avec la commande. Enregistrez ce PDF comme étiquette de la commande — par API à la création, ou en le téléversant sur la page de la commande — et l’entrepôt l’imprimera et le collera tel quel, sans en acheter une autre.

Une étiquette fournie par le client ne compte comme étiquette que si le PDF arrive avec trois choses : le numéro de suivi, le transporteur et un fichier d’étiquette standard 4×6 pouces d’une seule page. Un PDF sans numéro de suivi n’est qu’un fichier — le système ne le traitera pas comme une étiquette. Une fois enregistrée, la carte d’étiquette de la commande affiche le transporteur, le service et le numéro de suivi, et l’expédition par lot (WMS → Commandes de sortie → Expédition étiquette d’abord) utilisera d’abord cette étiquette sans fret pour la commande — seule la manutention d’impression et de collage de l’entrepôt s’applique.

Option A : le client envoie l’étiquette avec la commande (API)#

1. Lors de la création de la commande via l’API des commandes, ajoutez le bloc d’étiquette : le PDF (référence de fichier ou base64), le numéro de suivi et le code du transporteur ; le code de service est facultatif. Votre équipe d’intégration trouvera les champs exacts dans la documentation de l’API de création de commande.
2. La commande est toujours créée. Si l’étiquette ne peut pas être enregistrée — mauvaise taille, plus d’une page, ou numéro de suivi déjà utilisé par une autre commande — la réponse le dit clairement dans le résultat d’étiquette, et la commande reste valide. Corrigez le fichier et enregistrez-le ensuite depuis la page de la commande (Option B), sans recréer la commande.
3. Un numéro de suivi ne peut appartenir qu’à une seule commande à la fois. Si le même numéro arrive deux fois, le second enregistrement est refusé avec un message clair — vérifiez si le fichier a été envoyé à la mauvaise commande avant de réessayer.

Option B : téléversement à l’entrepôt#

1. Ouvrez la commande (OMS → Commandes → ouvrir la commande) ou sa commande de sortie (WMS → Commandes de sortie → ouvrir la commande). Les deux pages portent la même carte « Étiquette fournie par le client » — ce que vous téléversez d’un côté se voit de l’autre.
2. Choisissez le fichier PDF, confirmez le numéro de suivi et le transporteur (la carte préremplit ce que la commande déclare déjà — comparez avec l’étiquette papier), puis téléversez. Un nouveau téléversement remplace automatiquement l’étiquette actuelle ; l’ancienne cesse d’être valide, il n’y a donc jamais de confusion sur celle qui est en vigueur.
3. Mauvais fichier ? Utilisez « Annuler » sur la carte pour libérer le numéro de suivi, puis téléversez le bon. Si le numéro de l’étiquette diffère de celui déclaré dans la commande, l’étiquette enregistrée fait foi et la commande est mise à jour avec ce numéro — le numéro de l’étiquette physique est celui que le transporteur reconnaît.

Fonctions Docklify utilisées dans cet article#

• Carte d’étiquette fournie par le client (voir, téléverser, remplacer, annuler) — OMS → Commandes → détail de la commande (/oms/orders) et WMS → Commandes de sortie → détail de la commande (/wms/orders)
• Bloc d’étiquette dans l’API de création de commande — voir la documentation de l’API de création (/api/oms/orders)
• L’expédition par lot « étiquette d’abord » utilise d’abord l’étiquette enregistrée — WMS → Commandes de sortie → Expédition étiquette d’abord (/wms/orders)