WooCommerce-Bestellungen und Erstattungen, jede mit dem Besuch, aus dem sie kam.

01Was Tally liest

• Jede bezahlte Bestellung: in Bearbeitung, abgeschlossen oder erstattet, oder eine mit Zahlungsdatum, die später storniert wurde. Nachnahme zählt ab „in Bearbeitung“; ausstehende, wartende, fehlgeschlagene Bestellungen und Entwürfe sind keine Verkäufe.
• Die Bestellsumme abzüglich Steuer, mit Versand und Gebühren und bereits abgezogenen Rabatten, exakt in der Währung der Bestellung gelesen und zum Kurs der Europäischen Zentralbank ihres Tages in US-Cent umgerechnet.
• Jede Erstattung zu dem Zeitpunkt, an dem sie erfolgte, mit der zurückgegebenen Steuer: Eine Erstattung nach Positionen bringt ihre eigene mit, eine Erstattung nach Betrag gibt den Anteil der Bestellung zurück.
• Beim Verbinden die letzten 365 Tage, danach jede Bestellung binnen Sekunden über zwei Webhooks, die Tally anlegt: Bestellung erstellt und Bestellung aktualisiert.
• Alle 30 Minuten ein Abgleich, der die seit dem letzten Mal geänderten Bestellungen liest und einen abgeschalteten Webhook wieder einschaltet; so geht auch eine Zustellung, die nie ankam, nicht verloren.
• Nur, was die Zahlen brauchen: Beträge, Datumsangaben, Status, Erstattungen sowie Hashes des Bestellschlüssels und der Rechnungs-E-Mail. Namen, Adressen, Telefonnummern und Positionen werden nie gespeichert.

02Wie ein Verkauf seinen Besuch findet

• Seite „Bestellung erhalten“Ist das Snippet von Tally im Shop, verknüpft der Besuch des Käufers auf der Seite „Bestellung erhalten“ die Bestellung mit diesem Besucher: Der Bestellschlüssel in der Adresse der Seite wird nur als Hash behalten und der Bestellung zugeordnet. Hohe Sicherheit, ohne dass du WooCommerce etwas hinzufügen musst.
• Besucher-ID an der BestellungDas WordPress-Plugin von Tally speichert die Besucher-ID beim Checkout an der Bestellung, im klassischen wie im Block-Checkout, so werden auch Käufer verknüpft, die diese Seite nie erreichen; ohne das Plugin erledigen ein paar Zeilen in functions.php dasselbe. Hohe Sicherheit, im Cookie-Modus oder nach Einwilligung.
• E-MailDie Rechnungs-E-Mail, beim Eintreffen gehasht, stimmt mit einem tally('identify')-Aufruf auf deiner Website überein. Mittlere Sicherheit.
• ErstattungenEine Erstattung übernimmt die Verknüpfung der Bestellung, für die sie Geld zurückgibt.

03Was es nicht lesen kann

04Verbinden

1. Gib auf der Seite „Integrations“ deiner Website die Adresse des Shops ein und wähle „Approve in WooCommerce“, oder nutze im WordPress-Plugin von Tally die Schaltfläche „Connect WooCommerce to Tally“. Der Shop bittet einen Administrator oder Shop-Manager, Tally freizugeben, und erstellt den Schlüssel selbst.
2. Oder erstelle den Schlüssel von Hand: Öffne in WordPress „WooCommerce“, „Settings“, „Advanced“, „REST API“, wähle „Add key“, setze „Permissions“ auf „Read/Write“ und füge Consumer Key und Secret mit der Adresse des Shops ein.
3. „Read/Write“ dient nur den zwei eigenen Webhooks von Tally; eine Bestellung wird nie geändert. Der Schlüssel wird am Shop geprüft, dann kommen die letzten 365 Tage herein, Erstattungen inklusive.
4. Installiere das WordPress-Plugin von Tally und füge deine Site ID ein: Es setzt das Snippet auf jede Seite, auch auf „Bestellung erhalten“, und speichert die Besucher-ID jedes Käufers an der Bestellung. Oder füge das Snippet in den Header deines Themes ein.
5. Ohne das Plugin ergänze die functions.php-Zeilen unten für Käufer, die ein Zahlungs-Gateway nie zur Seite „Bestellung erhalten“ zurückschickt; die Seite „Coverage“ zeigt sie ebenfalls.

Was der REST-API-Schlüssel braucht

Tally verlangt einen REST-API-Schlüssel, der nur das kann, und prüft jede Berechtigung beim Einfügen mit einem echten Aufruf, sodass eine fehlende genannt wird:

So erstellst du ihn: Anleitung von WooCommerce.

Ohne das Plugin: die Besucher-ID an der Bestellung speichern (functions.php)

// Your theme's functions.php, or a code snippets plugin: saves the visitor's id on the
// order at checkout, for buyers who never reach the order-received page.
function tally_save_visitor_id( $order ) {
    $id = isset( $_COOKIE['_tally_vid'] ) ? $_COOKIE['_tally_vid'] : '';
    if ( preg_match( '/^[A-Za-z0-9_-]{8,64}$/', $id ) ) {
        $order->update_meta_data( 'tally_visitor_id', $id );
    }
}
add_action( 'woocommerce_checkout_create_order', 'tally_save_visitor_id' );
add_action( 'woocommerce_store_api_checkout_update_order_meta', 'tally_save_visitor_id' );

05Fragen

• Gibt es ein WordPress-Plugin?

  Ja, das WordPress-Plugin von Tally. Füge deine Site ID ein, und es setzt das Snippet auf jede Seite, lässt angemeldete Administratoren außen vor, speichert beim Checkout die Besucher-ID des Käufers an jeder WooCommerce-Bestellung, und seine Schaltfläche „Connect WooCommerce to Tally“ öffnet die Freigabeseite von WooCommerce. Es ersetzt die functions.php-Zeilen.

• Kann ich verbinden, ohne Schlüssel zu kopieren?

  Ja. Gib auf der Seite „Integrations“ die Adresse des Shops ein und gib Tally direkt in WooCommerce frei: Der Shop erstellt einen Read/Write-Schlüssel und übergibt ihn, du kopierst nichts. Widerrufen kannst du ihn jederzeit unter „WooCommerce“, „Settings“, „Advanced“, „REST API“.

• Was, wenn eine Webhook-Zustellung fehlschlägt?

  WooCommerce wiederholt keine Zustellung und schaltet einen Webhook nach einer Reihe von Fehlschlägen ab. Alle 30 Minuten liest Tally die Bestellungen, die sich seit dem letzten Blick geändert haben, und schaltet einen abgeschalteten Webhook wieder ein, so kommt die Bestellung trotzdem an.

• Funktioniert es mit dem Block-Checkout?

  Ja. Die Seite „Bestellung erhalten“ ist nach beiden Checkouts dieselbe, und die functions.php-Zeilen speichern die Besucher-ID im klassischen wie im Block-Checkout; beides wurde mit WooCommerce 11.2 getestet.

• Mein Hoster entfernt den Authorization-Header. Verbindet sich der Shop trotzdem?

  Ja. Antwortet ein Shop, als wäre kein Schlüssel gesendet worden, sendet Tally den Schlüssel stattdessen als Query-Parameter über HTTPS, wie WooCommerce es dokumentiert, und eine Website ohne sprechende Permalinks wird über ?rest_route= erreicht.