> ## 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.

# Plugin de caisse WooCommerce

> Affichez des tarifs d'expédition en direct et laissez les clients choisir un point relais dans la caisse de votre boutique WooCommerce.

Le plugin **Zippendo for WooCommerce** ajoute des tarifs d'expédition en direct et la sélection d'un point relais à la caisse de votre boutique en ligne. Il est facultatif : les commandes arrivent dans Zippendo sans lui. Avec lui, vos clients voient les vrais tarifs des transporteurs et choisissent un point relais avant de payer.

* **Tarifs d'expédition en direct.** Les tarifs sont calculés en caisse à partir des règles d'expédition que vous avez configurées dans Zippendo, avec vos transporteurs connectés.
* **Sélection d'un point relais.** Lorsqu'un tarif livre dans un point relais, les clients en choisissent un à proximité directement en caisse.
* **Compatible avec les deux caisses.** Le plugin prend en charge la caisse classique de WooCommerce et la nouvelle Cart & Checkout à base de blocs.

<Info>
  Pour calculer un tarif, le plugin envoie seulement à Zippendo l'adresse de livraison et le contenu du panier. Il n'envoie jamais de données de paiement ni de données de compte client.
</Info>

## Prérequis

* Une [boutique en ligne WooCommerce connectée](/docs/fr/order-channels/connecting-woocommerce) dans Zippendo.
* **WooCommerce 8.0** ou plus récent, activé.
* **WordPress 6.5** ou plus récent.
* **PHP 8.1** ou plus récent.

## Installer le plugin

<Steps>
  <Step title="Télécharger le plugin">
    Dans Zippendo, cliquez sur **Canaux de vente**, ouvrez votre boutique en ligne WooCommerce dans l'onglet **Connecté**, et dans l'onglet **Commandes et caisse** trouvez la carte **Jeton de caisse**. Cliquez sur **Télécharger le plugin**.
  </Step>

  <Step title="Le téléverser dans WordPress">
    Dans votre administration WordPress, allez dans **Plugins → Add New → Upload Plugin**, choisissez le fichier zip téléchargé et cliquez sur **Install Now**.
  </Step>

  <Step title="Activer">
    Cliquez sur **Activate** une fois le téléversement terminé.
  </Step>
</Steps>

<Note>
  Si le clic sur **Télécharger le plugin** ne lance pas de téléchargement, contactez le support et demandez le fichier du plugin.
</Note>

## Connecter le plugin à Zippendo

<Steps>
  <Step title="Générer un jeton de caisse">
    De retour dans Zippendo, sur la même carte **Jeton de caisse**, cliquez sur **Générer un jeton**. Cliquez tout de suite sur **Copier**. Le jeton commence par `zck_` et ne s'affiche qu'une seule fois, car Zippendo n'en conserve pas de copie lisible.
  </Step>

  <Step title="Le coller dans WooCommerce">
    Dans WordPress, allez dans **WooCommerce → Settings → Shipping → Zippendo**, collez le jeton dans **Checkout API key** et enregistrez.
  </Step>

  <Step title="Tester la connexion">
    Cliquez sur **Test connection** sur le même écran pour vérifier que WooCommerce peut joindre Zippendo avec le jeton.
  </Step>
</Steps>

## Ajouter le mode de livraison

Le jeton seul ne produit pas de tarifs. Vous devez aussi ajouter le mode de livraison **Zippendo** aux « shipping zones » WooCommerce vers lesquelles vous expédiez.

<Steps>
  <Step title="Ouvrir une zone de livraison">
    Allez dans **WooCommerce → Settings → Shipping** et ouvrez la zone dans laquelle vous voulez proposer les tarifs Zippendo.
  </Step>

  <Step title="Ajouter le mode">
    Cliquez sur **Add shipping method**, choisissez **Zippendo** et confirmez.
  </Step>

  <Step title="Répéter pour les autres zones">
    Ajoutez le mode à chaque zone où les tarifs Zippendo doivent apparaître.
  </Step>
</Steps>

<Tip>
  Une zone sans le mode Zippendo n'affiche jamais de tarifs Zippendo en caisse, même lorsque le plugin est connecté. Ajoutez-le à une zone pour chaque pays ou région vers lesquels vous expédiez avec Zippendo.
</Tip>

## Comment fonctionnent les points relais pour les clients

Lorsque le panier d'un client correspond à une règle d'expédition dont l'offre transporteur livre dans un point relais, une liste de points relais proches apparaît en caisse, aussi bien avec la caisse classique qu'avec la caisse à base de blocs. Le client en choisit un.

Une fois la commande passée, le point relais choisi :

* S'affiche sur la commande dans votre administration WooCommerce.
* Apparaît dans la confirmation de commande et les autres e-mails de commande.
* Est transmis automatiquement à l'expédition Zippendo correspondante, vous n'avez donc pas à le saisir lorsque vous expédiez la commande.

## Tarif de secours facultatif

Si Zippendo est injoignable lorsque le panier d'un client est tarifé, aucun tarif Zippendo n'est affiché, sauf si vous activez **Fallback rate**. Il est désactivé par défaut. Activez-le sous **WooCommerce → Settings → Shipping → Zippendo** et définissez un **Fallback rate label** et un **Fallback rate cost**. Les clients voient alors ce tarif à la place, et peuvent donc quand même finaliser leur commande.

## Remplacer ou révoquer le jeton

Si vous remplacez ou révoquez le jeton sur la carte **Jeton de caisse** de Zippendo, le jeton enregistré dans le plugin cesse immédiatement de fonctionner. Après l'avoir remplacé, collez le nouveau jeton dans **WooCommerce → Settings → Shipping → Zippendo** et enregistrez. Tant que vous ne l'avez pas fait, votre caisse n'affiche aucun tarif Zippendo.

<Warning>
  Ne remplacez ou ne révoquez le jeton que si vous pouvez mettre à jour le plugin immédiatement. Tant que le nouveau jeton n'est pas enregistré dans WooCommerce, les clients ne voient aucun tarif Zippendo (ou le tarif de secours, si vous l'avez activé).
</Warning>

## Dépannage

* **Aucun tarif en caisse.** Vérifiez que le jeton est enregistré et que **Test connection** fonctionne. Vérifiez ensuite que le mode de livraison **Zippendo** est ajouté à la zone qui couvre l'adresse du client.
* **Aucune liste de points relais en caisse.** La règle d'expédition correspondante doit utiliser une offre transporteur qui livre dans un point relais, et non une offre de livraison à domicile. Vérifiez l'offre utilisée par la règle sous **Règles d'expédition** dans Zippendo.
* **Les tarifs semblent périmés.** Pour garder une caisse rapide, le plugin mémorise les tarifs pendant environ 10 minutes pour le même panier et la même adresse. Il récupère ensuite de nouveaux tarifs tout seul, ou dès que le panier ou l'adresse change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.