> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# PeakWMS
> Laissez votre entrepôt PeakWMS imprimer les étiquettes d'expédition Zippendo quand un colis est emballé, avec chaque paramètre PeakWMS expliqué et ce qu'il faut faire pour chaque message que vos préparateurs peuvent voir.
Si votre entrepôt utilise [PeakWMS](https://peakwms.com), vos préparateurs peuvent obtenir les étiquettes d'expédition Zippendo directement depuis PeakWMS. Ils emballent un colis, PeakWMS demande l'étiquette à Zippendo, et l'étiquette s'imprime.
Rien n'est à installer. Vous copiez quelques adresses web et un jeton d'API de Zippendo vers PeakWMS, et c'est terminé.
Vous préférez suivre avec des captures d'écran ? Le [tutoriel Connecter PeakWMS](/docs/fr/tutorials/connect-peakwms) présente la configuration étape par étape. Cette page est la référence complète, avec tous les paramètres PeakWMS et la signification de chaque message.
## Comment les éléments s'articulent
Votre boutique en ligne, PeakWMS et Zippendo ont chacun un rôle :
| Système | Son rôle |
| - | - |
| Votre boutique en ligne | Affiche les modes de livraison et les prix en caisse. Ils proviennent de Zippendo. |
| PeakWMS | Reçoit la commande et gère la préparation et l'emballage. |
| Zippendo | Envoie l'expédition au transporteur, obtient l'étiquette d'expédition et suit le suivi. |
Votre client a choisi son mode de livraison dans une liste fournie par Zippendo, Zippendo sait donc déjà quel transporteur et quelle offre transporteur la commande nécessite. C'est pourquoi il n'y a généralement rien à configurer pour cela.
Vos commandes restent dans PeakWMS. Elles ne sont **pas** copiées dans Zippendo. Vous le désactivez à l'étape 4.
## Mots utilisés sur cette page
| Mot | Signification |
| - | - |
| Jeton d'API | Le mot de passe que PeakWMS utilise pour communiquer avec Zippendo. Zippendo le crée pour vous. PeakWMS appelle ce champ **API key**. |
| Forwarder | Le nom que PeakWMS donne à la configuration d'une société de transport. Vous créez un forwarder pour Zippendo. |
| Generic | Le type de forwarder qui envoie des requêtes à des adresses web que vous renseignez, ici celles de Zippendo. |
| Host ID | Un code sur chaque mode de livraison dans PeakWMS. Il indique à Zippendo quel transporteur, quelle offre transporteur et quelle règle d'expédition utiliser. |
| Account ID | Un code facultatif que vous saisissez à la fois dans PeakWMS et dans Zippendo, pour qu'un forwarder ne puisse pas utiliser la mauvaise connexion. |
| Offre transporteur | Ce que vend le transporteur, comme « PostNord MyPack Collect ». |
| Point relais | Le commerce ou la consigne automatique où le destinataire retire le colis. |
| Étiquette d'expédition | L'autocollant que le transporteur scanne. |
## Avant de commencer
* Votre entrepôt utilise PeakWMS, et vous pouvez en modifier les paramètres.
* Votre boutique en ligne est connectée à Zippendo, de sorte que la caisse affiche déjà les modes de livraison de Zippendo.
* Vous avez au moins une [règle d'expédition](/docs/fr/settings/shipping-rules) dans Zippendo.
## 1. Créer la connexion dans Zippendo
Dans Zippendo, cliquez sur **Applications et intégrations** dans la barre latérale, puis sur l'onglet **Catalogue**. PeakWMS se trouve sous **Intégrations**.
La fenêtre **Connecter PeakWMS** s'ouvre.
Saisissez un **Nom** que vous reconnaîtrez plus tard, comme « PeakWMS entrepôt de Køge ». Si vous gérez plusieurs entrepôts, créez une connexion par entrepôt et nommez-les d'après lui.
Si vous comptez renseigner un Account ID dans PeakWMS plus tard, saisissez la même valeur sous **ID de compte (facultatif)**. Quand les deux ne correspondent pas, Zippendo refuse la requête, de sorte qu'un forwarder configuré avec les adresses web d'un autre entrepôt ne puisse pas imprimer d'étiquettes sur la mauvaise connexion. Vous pouvez le laisser vide.
Si votre organisation utilise des marques, choisissez la **Marque** pour laquelle cet entrepôt expédie.
Le message **Connexion WMS créée** s'affiche, et la page de la connexion s'ouvre avec le **Jeton d'API** et une liste d'adresses web. Gardez cette page ouverte : vous avez besoin des deux à l'étape suivante.
Le jeton d'API est affiché **une seule fois**. Copiez-le maintenant avec le bouton de copie à côté. Si vous le perdez, cliquez sur **Remplacer le jeton** sur la page de la connexion pour en obtenir un nouveau. L'ancien jeton cesse de fonctionner immédiatement, PeakWMS a donc besoin du nouveau avant que vos préparateurs puissent imprimer à nouveau.
Le jeton d'API permet uniquement à PeakWMS de créer et de lire des expéditions. Il ne peut pas voir vos comptes transporteurs, vos adresses, vos commandes ni votre facturation.
Le jeton figure aussi sous **Paramètres** → **Paramètres de l'API** (ouvrez Paramètres depuis le menu de l'organisation → **Gérer**), nommé d'après la connexion avec « (WMS) » à la fin. Le supprimer là désactive aussi la connexion : vos préparateurs cessent d'imprimer jusqu'à ce que vous cliquiez sur **Remplacer le jeton**, colliez le nouveau jeton dans PeakWMS et réactiviez **Autoriser le WMS à créer des étiquettes**.
## 2. Les saisir dans PeakWMS
Dans PeakWMS, créez un nouveau **Forwarder** et réglez **Provider** sur **Generic**. Si vous ne trouvez pas cet écran, le [centre d'aide](https://help.peakwms.com/support/solutions) de PeakWMS vous guide. La configuration est la même quelle que soit la société de transport.
Copiez maintenant chaque adresse web de la section **URL pour votre WMS** dans Zippendo vers le champ PeakWMS du même nom. Chaque adresse a son propre bouton de copie.
| Champ PeakWMS | En avez-vous besoin ? |
| - | - |
| **Créer une étiquette d'expédition** | **Oui.** C'est celui qui imprime les étiquettes. Rien ne fonctionne sans lui. |
| **Suivi** | **Recommandé.** Permet à PeakWMS d'afficher où se trouve un colis. |
| **Créer une étiquette retour** | Uniquement si vous mettez une étiquette retour dans le carton. |
| **Étiquette avec code QR** | Uniquement pour les transporteurs où le client remet un colis avec un code au lieu d'une étiquette imprimée. |
| **Expédition existante** | Facultatif. Permet à PeakWMS de demander si un colis tardif peut rejoindre une commande déjà emballée. |
| **Étiquette utilisée** | Facultatif. Permet à PeakWMS de vérifier si une étiquette a déjà été scannée avant de la réimprimer. |
| **Annuler l'expédition** | **Laissez ce champ vide.** Zippendo affiche ici « Non pris en charge. Laissez ce champ vide. » Voir ci-dessous. |
Renseignez ensuite les trois champs que PeakWMS utilise pour se connecter à Zippendo :
* **API key** : le jeton d'API que Zippendo vous a montré.
* **Auth scheme** : choisissez **Bearer** dans la liste. C'est simplement la façon dont PeakWMS transmet le jeton.
* **Account ID** : la même valeur que celle saisie dans Zippendo, si vous en avez utilisé une.
**Laissez « Annuler l'expédition » vide.** Zippendo ne peut pas encore annuler une étiquette auprès du transporteur. Si vous le renseigniez, PeakWMS indiquerait à vos préparateurs qu'une étiquette est annulée alors qu'elle est toujours active chez le transporteur. Avec le champ vide, PeakWMS ne l'annule que dans son propre système. Si vous avez besoin que l'étiquette soit annulée auprès du transporteur, contactez le transporteur.
## 3. Indiquer à PeakWMS quelle offre transporteur utiliser
Dans PeakWMS, chaque mode de livraison a un **Host ID**. C'est ainsi que PeakWMS indique à Zippendo quel transporteur, quelle offre transporteur et quelle règle d'expédition utiliser. Vous le définissez dans PeakWMS, sur le mode de livraison lui-même. La façon la plus simple de le renseigner :
Choisissez n'importe quel mode de livraison en caisse.
Il ressemble à `postnord:PNL13:rule_01HZX9K2QF` : le transporteur, l'offre transporteur et la règle d'expédition Zippendo.
C'est tout. Zippendo reconnaît le code et sait exactement quel transporteur et quelle règle d'expédition vous voulez dire, sans rien à configurer dans Zippendo.
**Si le client a choisi un point relais**, le code sur la commande comporte le point relais ajouté à la fin, après une barre (le caractère `|`). Il ressemble à `postnord:PNL13:rule_01HZX9K2QF|1234567`.
Collez uniquement la partie **avant** la barre comme Host ID. PeakWMS découpe le code à cet endroit : il associe la première partie à votre mode de livraison et transmet le point relais à Zippendo. Un seul Host ID couvre donc tous les points relais.
**Une chose peut gêner.** Certaines boutiques en ligne ajoutent à la commande un champ supplémentaire appelé `peak_shipping_code`, généralement laissé par une application d'expédition que vous utilisiez auparavant. S'il est présent, PeakWMS lit celui-ci au lieu du code que Zippendo place sur la commande.
Si le Host ID ne correspond jamais, ou si le mauvais transporteur est toujours utilisé, vérifiez donc cela en premier. La personne qui s'occupe de votre boutique en ligne peut vider ce champ pour vous.
Vous préférez vos propres codes, comme `GLS_BUSINESS_PARCEL` ? C'est possible. Dans Zippendo, ouvrez la connexion et allez dans **Correspondances de Host ID**. Cliquez sur **Ajouter une correspondance**, saisissez votre code sous **Host ID dans le WMS** et choisissez la règle correspondante sous **Règle d'expédition Zippendo**. Faites-le pour chaque mode de livraison dans PeakWMS, puis cliquez sur **Enregistrer les correspondances**. Une ligne sans règle d'expédition ne peut pas être enregistrée.
Vous avez besoin de vos propres codes quand certaines commandes ne proviennent pas d'une boutique en ligne connectée à Zippendo, par exemple des commandes saisies directement dans PeakWMS.
## 4. Empêcher Zippendo d'importer vos commandes
PeakWMS gère désormais vos commandes. Si Zippendo les importait aussi, les deux systèmes essaieraient d'expédier la même commande, et vous pourriez payer deux étiquettes pour un seul colis.
Allez dans **Canaux de vente**, ouvrez votre boutique en ligne, et sous **À quoi sert Zippendo**, désactivez **Importer les commandes de cette boutique en ligne**.
Vous trouvez cet interrupteur sur les boutiques en ligne Shopify et WooCommerce. Si votre boutique en ligne est autre chose, envoyez-nous un message et nous le désactiverons pour vous.
**Ce qui continue de fonctionner :** les prix de livraison et le choix du point relais en caisse, exactement comme avant.
**Ce qui s'arrête :** les commandes ne sont plus copiées dans Zippendo, et Zippendo ne marque plus les commandes comme expédiées dans votre boutique en ligne. **PeakWMS s'en charge**, puisqu'il détient vos commandes.
Ne le réactivez que si vous voulez que Zippendo gère de nouveau vos commandes.
## 5. Essayer, puis passer en production
Faites d'abord un essai dans votre environnement de test PeakWMS. Emballez une commande et vérifiez trois choses :
* l'étiquette s'imprime, et c'est bien le transporteur attendu
* le colis apparaît sous **Expéditions** dans Zippendo
* le suivi apparaît sur la commande dans PeakWMS
Quand les trois sont corrects, basculez les adresses web dans PeakWMS vers votre configuration de production et vous êtes opérationnel.
## Suspendre ou supprimer la connexion
Ouvrez la connexion : sur l'onglet **Connecté** sous **Applications et intégrations**, cliquez sur sa ligne sur la carte PeakWMS.
* Désactivez **Autoriser le WMS à créer des étiquettes** pour empêcher PeakWMS de créer des étiquettes sans rien supprimer. Réactivez-le quand vous êtes prêt.
* Cliquez sur **Supprimer la connexion** en bas pour supprimer définitivement la connexion et son jeton d'API. Les expéditions déjà créées restent dans Zippendo.
## Bon à savoir
Rien de grave. Si PeakWMS demande deux fois la même étiquette, par exemple parce que la connexion a expiré et qu'il a réessayé, Zippendo renvoie l'étiquette déjà créée au lieu d'en acheter une seconde. Vous n'êtes jamais facturé deux fois pour le même colis.
Très rarement, le transporteur crée l'étiquette mais elle n'arrive pas jusqu'à PeakWMS. Dans ce cas, Zippendo s'arrête et le signale à votre préparateur, plutôt que d'acheter discrètement une seconde étiquette. La première vous attend sous **Expéditions** : imprimez-la à partir de là.
Chaque colis reçoit sa propre étiquette, et ils voyagent tous ensemble comme une seule expédition chez le transporteur. Vos préparateurs impriment une étiquette par colis.
Sur l'onglet **Connecté** sous **Applications et intégrations**, chaque connexion PeakWMS indique quand PeakWMS a contacté Zippendo pour la dernière fois, ou « Pas encore utilisé ». Quand quelque chose a mal tourné, elle affiche le message exact que votre préparateur a vu, et la page de la connexion l'affiche sous **Dernière erreur**. Les expéditions apparaissent sous **Expéditions** comme n'importe quelle autre.
PeakWMS envoie l'adresse du client comme expéditeur et votre entrepôt comme destinataire, et Zippendo obtient une étiquette retour. L'adresse où le colis revient est toujours l'adresse de l'expéditeur de votre règle d'expédition Zippendo, l'étiquette est donc correcte même si PeakWMS a une autre adresse en mémoire.
Zippendo ne peut pas produire les documents que la réglementation exige pour les marchandises dangereuses, il refuse donc ces commandes plutôt que de les expédier sans. Envoyez-les via un autre forwarder dans PeakWMS.
## En cas de problème
Votre préparateur voit le message dans PeakWMS, demandez-lui donc de le lire à voix haute. Voici ce que signifie chacun :
| Le message commence par | Que faire |
| - | - |
| « No Zippendo shipping rule matches this Host ID » ou « No Zippendo shipping rule matches the Host ID » | Le Host ID dans PeakWMS n'est pas reconnu par Zippendo. Collez le code d'une commande de la boutique en ligne (étape 3), ou ajoutez une correspondance de Host ID dans Zippendo. |
| « The request carried no Host ID » | Le mode de livraison dans PeakWMS n'a pas de Host ID. Renseignez-le (étape 3). |
| « The shipping rule this Host ID resolves to is not available to this connection » | La règle d'expédition a été supprimée, ou elle appartient à une autre marque. Vérifiez la règle dans Zippendo, ou faites pointer le Host ID vers une autre règle. |
| Aucun message, mais le mauvais transporteur est utilisé | Vos commandes portent peut-être un ancien champ `peak_shipping_code` d'une application d'expédition utilisée auparavant, et PeakWMS le lit en premier. Demandez à la personne qui s'occupe de votre boutique en ligne de le vider. |
| « This WMS connection is disabled » | Quelqu'un a désactivé **Autoriser le WMS à créer des étiquettes** dans Zippendo. Ouvrez la connexion et réactivez-le. |
| « The API token for this connection was revoked » | Le jeton d'API a été supprimé sous **Paramètres** → **Paramètres de l'API**. Cliquez sur **Remplacer le jeton**, collez le nouveau jeton dans PeakWMS et réactivez **Autoriser le WMS à créer des étiquettes**. |
| « The account ID sent by the WMS does not match this Zippendo connection » | L'Account ID n'est pas le même dans PeakWMS et dans Zippendo. Si vous gérez plusieurs entrepôts, vérifiez que vous n'avez pas collé les adresses web d'un entrepôt sur le forwarder d'un autre. |
| « A label for this order is already being created » | Deux requêtes pour la même étiquette sont arrivées en même temps. Réessayez dans un instant : vous n'obtiendrez pas deux étiquettes. |
| « A previous attempt for this order already created a shipment » | Rare. Le transporteur a peut-être déjà créé l'étiquette, mais elle n'est pas arrivée jusqu'à PeakWMS. **Ne réessayez pas en boucle** : cela pourrait acheter une seconde étiquette. Ouvrez l'expédition sous **Expéditions** dans Zippendo et imprimez l'étiquette à partir de là. |
| « This shipping rule delivers to a service point, but no service point was selected » | La règle d'expédition nécessite un point relais et aucun n'a été choisi ou trouvé pour l'adresse. Utilisez une règle d'expédition pour la livraison à domicile, ou assurez-vous que la commande comporte un point relais. |
| « The carrier returned a different number of labels than there are parcels » | L'expédition existe dans Zippendo, mais les étiquettes n'ont pas pu être associées aux colis. Contactez le support avant de réessayer. |
| « Zippendo cannot yet produce ADR transport documents » | La commande contient des marchandises dangereuses. Envoyez-la via un autre forwarder dans PeakWMS. |
| « This WMS connection's settings could not be read » | Ouvrez la connexion dans Zippendo et cliquez sur **Enregistrer les correspondances** pour l'enregistrer de nouveau. |
| Un message du transporteur, comme un problème d'adresse | Le transporteur a refusé l'expédition. Corrigez l'adresse et réessayez. L'expédition attend dans Zippendo sous **Expéditions** avec une erreur. |
Toujours bloqué ? La page de la connexion dans Zippendo affiche l'échec le plus récent. Envoyez-nous un message avec le numéro de commande et nous regarderons.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.