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

# WooCommerce-Checkout-Plugin

> Zeige Live-Versandpreise an und lass Kunden in deinem WooCommerce-Checkout einen Paketshop wählen.

Das Plugin **Zippendo for WooCommerce** fügt dem Checkout deines Onlineshops Live-Versandpreise und die Auswahl eines Paketshops hinzu. Es ist optional: Bestellungen kommen auch ohne das Plugin in Zippendo an. Mit dem Plugin sehen deine Kunden echte Preise der Versanddienstleister und wählen einen Paketshop, bevor sie bezahlen.

* **Live-Versandpreise.** Die Preise werden im Checkout aus den Versandregeln berechnet, die du in Zippendo eingerichtet hast, mit deinen verbundenen Versanddienstleistern.
* **Auswahl eines Paketshops.** Wenn ein Preis an einen Paketshop liefert, wählen Kunden direkt im Checkout einen in der Nähe.
* **Funktioniert mit beiden Checkouts.** Das Plugin unterstützt den klassischen WooCommerce-Checkout und den neueren blockbasierten Warenkorb und Checkout.

<Info>
  Zur Berechnung eines Preises sendet das Plugin Zippendo nur die Lieferadresse und den Inhalt des Warenkorbs. Es sendet nie Zahlungsdaten oder Kundenkontodaten.
</Info>

## Voraussetzungen

* Ein [verbundener WooCommerce-Onlineshop](/docs/de/order-channels/connecting-woocommerce) in Zippendo.
* **WooCommerce 8.0** oder neuer, aktiv.
* **WordPress 6.5** oder neuer.
* **PHP 8.1** oder neuer.

## Plugin installieren

<Steps>
  <Step title="Plugin herunterladen">
    Klicke in Zippendo auf **Verkaufskanäle**, öffne deinen WooCommerce-Onlineshop auf dem Tab **Verbunden** und suche auf dem Tab **Bestellungen & Checkout** die Karte **Checkout-Token**. Klicke auf **Plugin herunterladen**.
  </Step>

  <Step title="In WordPress hochladen">
    Gehe in deinem WordPress-Admin zu **Plugins → Installieren → Plugin hochladen**, wähle die heruntergeladene ZIP-Datei und klicke auf **Jetzt installieren**.
  </Step>

  <Step title="Aktivieren">
    Klicke auf **Aktivieren**, wenn der Upload abgeschlossen ist.
  </Step>
</Steps>

<Note>
  Wenn der Klick auf **Plugin herunterladen** keinen Download startet, wende dich an den Support und bitte um die Plugin-Datei.
</Note>

## Plugin mit Zippendo verbinden

<Steps>
  <Step title="Checkout-Token generieren">
    Klicke zurück in Zippendo auf derselben Karte **Checkout-Token** auf **Token generieren**. Klicke sofort auf **Kopieren**. Das Token beginnt mit `zck_` und wird nur einmal angezeigt, weil Zippendo keine lesbare Kopie aufbewahrt.
  </Step>

  <Step title="In WooCommerce einfügen">
    Gehe in WordPress zu **WooCommerce → Einstellungen → Versand → Zippendo**, füge das Token in **Checkout API key** ein und speichere.
  </Step>

  <Step title="Verbindung testen">
    Klicke auf demselben Bildschirm auf **Verbindung testen**, um zu prüfen, ob WooCommerce Zippendo mit dem Token erreichen kann.
  </Step>
</Steps>

## Versandart hinzufügen

Das Token allein erzeugt keine Preise. Du musst außerdem die Versandart **Zippendo** zu den WooCommerce-„Versandzonen“ hinzufügen, in die du versendest.

<Steps>
  <Step title="Versandzone öffnen">
    Gehe zu **WooCommerce → Einstellungen → Versand** und öffne die Zone, in der du Zippendo-Preise anbieten möchtest.
  </Step>

  <Step title="Versandart hinzufügen">
    Klicke auf **Versandart hinzufügen**, wähle **Zippendo** und bestätige.
  </Step>

  <Step title="Für weitere Zonen wiederholen">
    Füge die Versandart jeder Zone hinzu, in der Zippendo-Preise erscheinen sollen.
  </Step>
</Steps>

<Tip>
  Eine Zone ohne die Zippendo-Versandart zeigt im Checkout nie Zippendo-Preise, auch wenn das Plugin verbunden ist. Füge sie für jedes Land und jede Region, in die du mit Zippendo versendest, einer Zone hinzu.
</Tip>

## So funktionieren Paketshops für Kunden

Passt der Warenkorb eines Kunden zu einer Versandregel, deren Versandprodukt an einen Paketshop liefert, erscheint im Checkout eine Liste von Paketshops in der Nähe, sowohl im klassischen als auch im blockbasierten Checkout. Der Kunde wählt einen aus.

Nachdem die Bestellung aufgegeben wurde, wird der gewählte Paketshop:

* bei der Bestellung in deinem WooCommerce-Admin angezeigt.
* in der Bestellbestätigung und den anderen Bestell-E-Mails aufgeführt.
* automatisch in die passende Zippendo-Sendung übernommen, sodass du ihn beim Versenden der Bestellung nicht eingeben musst.

## Optionaler Ersatzpreis

Wenn Zippendo nicht erreichbar ist, während der Warenkorb eines Kunden bewertet wird, erscheint kein Zippendo-Preis, es sei denn, du schaltest **Fallback rate** ein. Standardmäßig ist es aus. Schalte es unter **WooCommerce → Einstellungen → Versand → Zippendo** ein und lege ein **Fallback rate label** und **Fallback rate cost** fest. Kunden sehen dann diesen Preis und können trotzdem bezahlen.

## Token ersetzen oder widerrufen

Wenn du das Token auf der Karte **Checkout-Token** in Zippendo ersetzt oder widerrufst, funktioniert das im Plugin gespeicherte Token sofort nicht mehr. Füge nach dem Ersetzen das neue Token unter **WooCommerce → Einstellungen → Versand → Zippendo** ein und speichere. Bis dahin zeigt dein Checkout keine Zippendo-Preise.

<Warning>
  Ersetze oder widerrufe das Token nur, wenn du das Plugin sofort aktualisieren kannst. Bis das neue Token in WooCommerce gespeichert ist, sehen Kunden keine Zippendo-Preise (oder den Ersatzpreis, wenn du ihn eingeschaltet hast).
</Warning>

## Fehlerbehebung

* **Keine Preise im Checkout.** Prüfe, ob das Token gespeichert ist und **Verbindung testen** funktioniert. Prüfe dann, ob die Versandart **Zippendo** zu der Zone hinzugefügt ist, die die Adresse des Kunden abdeckt.
* **Keine Liste mit Paketshops im Checkout.** Die passende Versandregel muss ein Versandprodukt nutzen, das an einen Paketshop liefert, kein Produkt für die Hauszustellung. Prüfe in Zippendo unter **Versandregeln**, welches Produkt die Regel nutzt.
* **Preise wirken veraltet.** Damit der Checkout schnell bleibt, merkt sich das Plugin Preise für denselben Warenkorb und dieselbe Adresse etwa 10 Minuten lang. Danach holt es von selbst neue Preise, oder sobald sich Warenkorb oder Adresse ändern.


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