DOCS

WooCommerce

Zonos Checkout für WooCommerce

Integrieren Sie die Checkout-Erweiterung für WooCommerce.

Integrations-Checkliste 

Folgen Sie dieser umfassenden Checkliste, um Ihr Zonos-Dashboard-Konto einzurichten und die Zonos-Checkout-Erweiterung für WooCommerce zu integrieren.

Um zu beginnen, kontaktieren Sie bitte unser Vertriebsteam, um ein Konto zu erstellen und eine Vereinbarung zu unterzeichnen. Sobald eine Vereinbarung unterzeichnet ist, erhalten Sie zwei Mikroeinzahlungen auf Ihr Konto, die verifiziert werden müssen.

Bitte senden Sie diese Mikroeinzahlungsbeträge per E-Mail an accounting@zonos.com mit Ihrer Dashboard-Store-ID (CC an Ihren Vertriebsmitarbeiter).

Nach der Verifizierung werden Ihre Bankdaten in Dashboard -> Settings -> Billing angezeigt.

Nach der Erstellung Ihres Zonos-Kontos müssen Sie Einstellungen in Dashboard konfigurieren, um sicherzustellen, dass Checkout ordnungsgemäß mit Ihrem Shop funktioniert. Dieser Abschnitt behandelt alle wesentlichen Dashboard-Konfigurationen.

Auszahlungen einrichten 

Verbinden Sie ein Bankkonto, um zeitnahe Auszahlungen von Checkout zu erhalten. Auszahlungen werden täglich mit einer Verzögerung von 2 Tagen ab der erfassten Zahlung verarbeitet. Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie zu Dashboard -> Settings -> Checkout settings .
  2. Klicken Sie auf Add bank account.
  3. Sie werden zu einem Stripe-Portal weitergeleitet, um die Einrichtung abzuschließen und die folgenden Informationen anzugeben:
    • Bankkontoinformationen.
    • Unternehmens-EIN.
    • Sozialversicherungsnummer eines Unternehmenseigentümers mit 25 % Anteil. Weitere Details, warum dies erforderlich ist, finden Sie in der Dokumentation von Stripe.

Hinweis: Wenn Sie Ihren Auszahlungsplan aktualisieren müssen, kontaktieren Sie bitte support@zonos.com

Zulässige Domains einrichten 

Zonos Checkout erfordert aus Sicherheitsgründen eine Liste zulässiger Domains. Dies verhindert, dass nicht autorisierte Sites Checkout laden, und stellt sicher, dass es nur auf Ihren genehmigten Domains ausgeführt wird. Ohne diese Konfiguration gibt Checkout Berechtigungsfehler zurück.

So richten Sie dies ein:

  1. Navigieren Sie zu Dashboard -> Settings -> Checkout settings.
  2. Fügen Sie unter URLs Ihre vollständige Domain und alle Subdomains hinzu, auf denen Checkout verwendet wird. Wenn Ihre Domain beispielsweise example.com ist, sollten Sie example.com und test.example.com hinzufügen.

Branding-Einstellungen anpassen 

Konfigurieren Sie Ihre Branding-Einstellungen in Dashboard, damit sie zum Erscheinungsbild Ihres Shops passen.

Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie zu Dashboard -> Settings -> Checkout settings -> Branding
  2. Konfigurieren Sie die folgenden Einstellungen:
    • Logo.
    • Marken- und Akzentfarbe.
    • Theme, Style und Font.

Weitere Informationen zu Branding-Einstellungen finden Sie in unserer Dokumentation.

Einen Versand-Carrier verbinden 

Um Versand beim Checkout anzubieten, müssen Sie einen Versand-Carrier mit Ihrem Zonos-Konto verbinden. Dies ermöglicht es Ihnen, bestimmte Versandservicelevel beim Checkout zu aktivieren.

So verbinden Sie einen Versand-Carrier:

  1. Navigieren Sie zu Dashboard -> Settings -> Shipping -> Rates.
  2. Klicken Sie auf Add carrier.
  3. Folgen Sie den Anweisungen zur Carrier-Einrichtung.

Weitere Details zum Verbinden von Carrier-Konten finden Sie in unserer Dokumentation.

Versandzonen einrichten 

Versandzonen ermöglichen es Ihnen, zu konfigurieren, welche Versand-Carrier und Servicelevel für verschiedene Regionen der Welt verfügbar sind.

So richten Sie Versandzonen ein:

  1. Navigieren Sie zu Dashboard -> Settings -> Shipping -> Locations.
  2. Klicken Sie auf New zone.
  3. Geben Sie einen Zonennamen ein und wählen Sie die Länder aus, in die Sie versenden möchten.
  4. Wählen Sie den Carrier und das Servicelevel, das Sie anbieten möchten.

Weitere Details zu Versandzonen finden Sie in unserer Dokumentation.

Ein Fallback-Ursprungsland und einen HS-Code einrichten 

Das Ursprungsland und der HS-Code werden verwendet, um genaue Zölle und Steuern zu berechnen.

Wenn Sie kein spezifisches Ursprungsland oder keinen HS-Code angeben, verwenden wir die in Dashboard eingerichteten Fallbacks.

So legen Sie Ihr Fallback-Ursprungsland und Ihren HS-Code fest:

  1. Navigieren Sie zu Dashboard -> Settings -> Shipping -> Catalog.
  2. Wählen Sie für das Ursprungsland das Land aus, in dem die Mehrheit Ihrer Produkte hergestellt wird.
  3. Geben Sie für den HS-Code den HS-Code Ihres häufigsten Produkts ein. Wenn Sie keinen HS-Code haben, navigieren Sie zu Classify in Dashboard und geben Sie den Namen und die Beschreibung Ihres Produkts ein, um einen genauen HS-Code zu generieren.

Folgen Sie diesen Schritten, um die Checkout-Erweiterung für WooCommerce zu installieren und zu konfigurieren.

Die Erweiterung installieren 

  1. Melden Sie sich in Ihrer WordPress-Administration an.
  2. Suchen Sie unter Plugins nach der Zonos Checkout for WooCommerce extension.
  3. Klicken Sie auf Install and activate.

Die Erweiterung mit Ihrem Zonos-Konto verbinden 

  1. Klicken Sie in Ihrer WordPress-Administration in der linken Navigation auf die Zonos Checkout-Erweiterung.

  2. Klicken Sie auf General Settings.

  3. Geben Sie Ihren Private API key und Ihre Store ID ein, um Ihre Zonos-Dashboard-Einstellungen mit Ihrer WooCommerce-Site zu verknüpfen.

    1. Suchen Sie den privaten API-Schlüssel Ihres Shops in Dashboard. Es gibt mehrere verschiedene API-Schlüssel. Wählen Sie den API-Schlüssel aus, der den Namen Ihres Shops hat, bei dem der Type Secret ist und der Token mit credential_live beginnt. Geben Sie diesen API-Schlüssel im Feld Private API Key in den General settings der Erweiterung ein.

    2. Kopieren Sie Ihre Store ID aus Dashboard und geben Sie diese in das Feld Store ID in den General settings der Erweiterung ein.

  4. Aktivieren Sie die App im Testmodus.

    1. Standardmäßig ist Test mode aktiviert. Wenn der Testmodus aktiviert ist, werden Käufer nicht zu Zonos Checkout weitergeleitet.

Ihre internationale Checkout-Schaltfläche konfigurieren 

Sie haben zwei Optionen zur Konfiguration, wie internationale Käufer auf Zonos Checkout zugreifen.

Ihre aktuelle Checkout-Schaltfläche für inländische und internationale Käufer verwenden: 

Konfigurieren Sie Ihre aktuelle Checkout-Schaltfläche so, dass internationale Käufer automatisch zu Zonos Checkout weitergeleitet werden, während inländische Käufer auf Ihrem Standard-Checkout-Ablauf bleiben. Gehen Sie dazu wie folgt vor:

  1. Geben Sie in den General settings der Erweiterung den CSS-Selektor Ihrer Checkout-Schaltfläche ein (z. B. #checkout-button oder .woocommerce-checkout-button).
  2. Klicken Sie auf Save general settings.

Um Ihren CSS-Selektor zu finden, klicken Sie mit der rechten Maustaste auf Ihre Checkout-Schaltfläche, wählen Sie „Inspect“ und suchen Sie nach dem id- oder class-Attribut im HTML. Wenn Sie mehrere Checkout-Schaltflächen haben, fügen Sie entweder den CSS-Selektor jeder Schaltfläche hinzu oder konfigurieren Sie alle Schaltflächen so, dass sie zur Warenkorbseite weiterleiten, und verwenden Sie den Checkout-Schaltflächen-Selektor der Warenkorbseite.

Eine dedizierte internationale Checkout-Schaltfläche hinzufügen 

Erstellen Sie eine dedizierte internationale Checkout-Schaltfläche, was ideal ist, wenn Sie viele VPN-Benutzer oder US-basierte Käufer haben, die an eine internationale Adresse versenden müssen.

So erstellen Sie eine separate Schaltfläche für internationale Käufer:

  1. Geben Sie in den General settings der Erweiterung den CSS-Selektor Ihrer Checkout-Schaltfläche ein (z. B. #checkout-button oder .woocommerce-checkout-button).

  2. Schalten Sie International checkout button nach rechts um.

  3. Konfigurieren Sie das Erscheinungsbild der Schaltfläche:

    • Geben Sie den Schaltflächentext ein (z. B. „International Checkout“ oder „Global Checkout“).
    • (Optional) Fügen Sie benutzerdefiniertes CSS hinzu, um es an das Design Ihres Shops anzupassen, wie im Beispiel unten gezeigt. Wenn kein benutzerdefiniertes CSS bereitgestellt wird, verwendet die Schaltfläche standardmäßig das primäre Farbschema Ihres Shops. Wir empfehlen, das Erscheinungsbild der Schaltfläche sowohl auf Desktop- als auch auf Mobilgeräten zu testen.
  4. Klicken Sie auf Save general settings.

US in Versandzonen aktivieren: Wenn aktiviert, erscheint die dedizierte internationale Checkout-Schaltfläche für alle Käufer. Um US-basierten Käufern die Nutzung des internationalen Checkouts zu ermöglichen (z. B. bei Verwendung eines VPN oder Versand an eine internationale Adresse), müssen Sie die USA in den Versandzonen in Dashboard aktivieren. Ohne diese Einstellung werden US-Käufer nicht zu Zonos Checkout weitergeleitet.

Passen Sie Zonos an, um nahtlos mit Ihrem WooCommerce-Shop zu integrieren und genaue Zoll-, Steuer- und Versandberechnungen sicherzustellen. Verwenden Sie die Registerkarte Mapping settings, um Produktdetails und Attribute mit Ihrer E-Commerce-Einrichtung abzugleichen. Während Standardwerte bereitgestellt werden, können Sie diese Einstellungen an die individuellen Anforderungen Ihres Shops anpassen.

Produktdetails, benutzerdefinierte Details, Gewicht und Abmessungen 

Diese Felder werden Standardwerten zugeordnet. Mit einem Sternchen (*) markierte Werte sind erforderlich. Wenn Sie eine Drittanbieter-App verwenden, die (*)-Felder überschreibt, stellen Sie sicher, dass diese (*)-Felder korrekt den Werten zugeordnet sind, die die Drittanbieter-App verwendet.

Produktinformationen mit Catalog verwalten

Sie können Ihre Produktinformationen auch mit Catalog in Dashboard verwalten.

Wenn Sie Gewicht, Abmessungen, HS-Code(s) oder Ursprungsland zu Catalog hinzufügen, verwendet Checkout diese Felder immer. Wenn Informationen sowohl in Ihrer E-Commerce-Plattform als auch in Catalog vorhanden sind, überschreiben die Informationen in Catalog die von der E-Commerce-Plattform gesendeten Informationen bei unseren Berechnungen. Angenommen, das Gewicht eines Produkts ist sowohl in WooCommerce als auch in Catalog vorhanden. In diesem Fall verwendet Zonos das Gewicht in Catalog zur Versandberechnung.

Produktattribute 

Wenn Ihre Produkte einzigartige Attribute wie Farbe oder Größe auf Varianten angewendet haben, müssen Sie diese Attribute in der Zonos-Erweiterung zuordnen. Dies stellt sicher, dass bei der Auftragsabwicklung Ihr WooCommerce-Shop und Ihr Inventar mit dem korrekten versendeten Produkt aktualisiert werden. Um Attribute zuzuordnen, folgen Sie den Schritten in unserer Dokumentation zum Zuordnen von WooCommerce-Produktattributen.

Hinweis: Wenn Sie Fragen haben oder Hilfe beim Zuordnen von Produktvarianten benötigen, kontaktieren Sie bitte support@zonos.com.

Nachdem Sie Ihr Konto und Ihre App eingerichtet haben, sind Sie bereit, Ihre Integration zu testen.

So geben Sie eine Testbestellung beim Checkout auf:

  1. Fügen Sie ?zonosTestMode=1 zu der URL Ihres Shops hinzu, um zu Zonos Checkout weitergeleitet zu werden.
  2. Ändern Sie Zonos Hello auf das Land, das Sie testen möchten, indem Sie auf die Hello-Flagge klicken und das gewünschte Land auswählen. Dies ist erforderlich, da Sie sonst nicht zu Zonos Checkout weitergeleitet werden, wenn Sie eine einzelne Checkout-Schaltfläche verwenden. Sie können Hello aktualisieren, indem Sie zCountry= in der URL auf das gewünschte Land ändern. Wenn Sie beispielsweise Kanada testen möchten, geben Sie CA in zCountry=CA ein.
  3. Durchlaufen Sie den Checkout-Prozess und geben Sie eine Bestellung auf. Weitere Details finden Sie in unserer allgemeinen Testdokumentation.
  4. Nach Abschluss der Tests aktivieren Sie Zonos, indem Sie Test mode auf off schalten. Dadurch wird Ihre Integration live geschaltet und internationale Käufer können Zonos Checkout nutzen.

Einige Dinge, die Sie beachten sollten:

  • De minimis—Wenn die Warenkorb-Zwischensumme Ihrer Bestellung unter dem De-minimis-Wert des Versandlandes liegt, fallen möglicherweise keine Zölle oder Steuern an. Dies spiegelt sich in unseren Berechnungen wider.
  • Rückerstattungen und Stornierungen—Wir erfassen die Zahlung, daher müssen Sie Rückerstattungen oder Stornierungen in Dashboard verarbeiten.
  • Etiketten—Drucken Sie Etiketten für alle internationalen Bestellungen in Dashboard, es sei denn, Sie wurden zertifiziert, Etiketten außerhalb von Dashboard zu drucken. Dies ist erforderlich, damit Zonos die Zölle und Steuern in Ihrem Namen bezahlen kann.

Nach der Integration 

Ihre Zonos-Erweiterung importiert Bestellungen automatisch von Zonos nach WooCommerce. Es kann jedoch selten vorkommen, dass eine Bestellung nicht importiert wird oder ein Bestellstatus in WooCommerce nicht mit Dashboard synchronisiert ist. Sie können die folgenden Funktionen in der Erweiterung verwenden, um Bestellungen zu importieren, Bestellstatus manuell zu synchronisieren und erweiterte Einstellungen zur Fehlerbehebung zu aktivieren.

Wenn eine Zonos-Bestellung nicht in WooCommerce importiert wurde, können Sie die Registerkarte Order import verwenden, um Bestellungen manuell in WooCommerce zu importieren:

  1. Melden Sie sich bei Dashboard an.
  2. Navigieren Sie zu Orders.
  3. Klicken Sie in die Bestellung, die importiert werden muss, und kopieren Sie die Zonos order number.
  4. Navigieren Sie in der WordPress-Administration zur Registerkarte Order import in der Zonos-Erweiterung und geben Sie die Zonos-Bestellnummer in das Feld Zonos order number ein.
  5. Klicken Sie auf Import order. Wenn die Bestellung erfolgreich importiert wurde, wird die Bestellung in WooCommerce angezeigt und Sie sehen das Banner „Order imported successfully“ oben auf der Seite. Wenn der Import fehlgeschlagen ist, sehen Sie ein Banner mit den Fehlermeldungsdetails.

Wenn ein Bestellstatus in WooCommerce nicht mit dem Status in Zonos übereinstimmt, können Sie die Bestellung manuell synchronisieren.

  1. Melden Sie sich bei Dashboard an.
  2. Navigieren Sie zu Orders.
  3. Klicken Sie in die Bestellung, die importiert werden muss, und kopieren Sie die Zonos order number.
  4. Navigieren Sie in der WordPress-Administration zur Registerkarte Order sync in der Zonos-Erweiterung und geben Sie die Zonos-Bestellnummer in das Feld Zonos order number ein.
  5. Klicken Sie auf Sync order. Der Bestellstatus in WooCommerce sollte nun mit dem Bestellstatus in Dashboard übereinstimmen.

Debug-Modus 

Schalten Sie Debug mode ein, um Zonos detaillierte Protokolle zu senden, die Ihnen bei der Diagnose von Problemen helfen und die Leistung Ihrer Integration verbessern.

Rate limit 

Maximale Anzahl von Webhook-Anfragen pro IP-Adresse pro Minute. Der Standardwert ist 30, um vor potenziellem Missbrauch zu schützen.

Wenn Sie eine Caching-App wie WP Rockett verwenden, müssen Sie Ihren Cache leeren, wenn Sie Änderungen an Ihrer Zonos-Erweiterung vornehmen.

Welche Produktinformationen sollte ich für das genaueste Angebot zu Zöllen, Steuern und Versandkosten angeben? 

Produktinformationen können die Höhe der fälligen Zölle und Steuern sowie die gesamten Versandkosten beeinflussen. Je mehr Produktinformationen Sie Zonos bereitstellen, desto präziser wird das zurückgegebene Angebot sein. Zonos kann ein Angebot auch dann generieren, wenn diese Informationen nicht verfügbar sind, empfiehlt jedoch die folgenden wichtigen Produktdetails zur Verbesserung der Genauigkeit:

  • Gewicht: Das Gewicht beeinflusst Ihre Versandkosten, was Zölle oder Steuern beeinflussen kann. Gewichte in Ihren WooCommerce-Produktlisten werden von Zonos automatisch verwendet, wenn sie zugeordnet sind. Sie können auch Gewicht zu Catalog in Dashboard hinzufügen, um genaue Versandberechnungen sicherzustellen.
  • Abmessungen: Abmessungen werden zur Berechnung des Volumengewichts verwendet. Carrier berechnen das Gewicht, das zwischen physischem Gewicht und Volumengewicht größer ist. Zonos kann Produktabmessungen (Länge, Breite und Höhe), die für jedes Produkt in WooCommerce festgelegt sind, nutzen, um das Volumengewicht zu berechnen und sicherzustellen, dass Sie den korrekten Versandbetrag von Ihren Kunden erheben. Sie können auch Abmessungen zu Catalog in Dashboard hinzufügen, um genaue Versandberechnungen sicherzustellen.
  • HS-Codes: HS-Codes beeinflussen Zollsätze und können manchmal Steuern beeinflussen. Sie können HS-Code-Werte in WooCommerce zuordnen oder Catalog in Dashboard verwenden.
  • Ursprungsland: Das Ursprungsland eines Produkts beeinflusst Zollsätze und kann Steuern beeinflussen. Sie können Ursprungsland-Werte in WooCommerce zuordnen oder Catalog in Dashboard verwenden.

War diese Seite hilfreich?