WooCommerce-Versandintegration in der Türkei: Volumengewicht, Etikett und Sendungsverfolgung

Berechnung des Volumengewichts (Desi), Preisregeln, Sendung und Etikett per API, Tracking-Benachrichtigung und Retourenablauf bei der WooCommerce-Versandintegration; mit den häufigsten Fehlern aus der Praxis.
Technische Zusammenfassung
Technologie
WooCommerce, Versand-API, Webhook, ZPL, HPOS
Thema
Automatisierung von Sendung, Etikett, Tracking und Retoure nach der Bestellung
Niveau
Mittel
Voraussetzungen
  • Kenntnis der Versandzonen und Bestellstatus von WooCommerce
  • Vertrag mit dem Versanddienstleister inklusive API-Zugang
In diesem Beitrag7 Abschnitte

Übersteigt die Zahl der Bestellungen einige Dutzend pro Tag, beginnt die manuelle Versanderfassung Fehler zu erzeugen: falscher Bezirk, fehlende Telefonnummer, eine Sendungsnummer, die den Kunden nie erreicht, ein Retourenpaket, bei dem unklar ist, zu welcher Bestellung es gehört. Das Problem liegt meist nicht beim Versanddienstleister, sondern darin, dass der Datenfluss zwischen WooCommerce und der Versand-API nie konzipiert wurde. Im Folgenden behandeln wir der Reihe nach jeden Schritt dieses Ablaufs, von der Desi-Berechnung bis zur Annahme von Retouren, und die Stellen, an denen er in der Praxis am häufigsten hängt. Der Beitrag bezieht sich auf Versanddienstleister in der Türkei, wo das Volumengewicht als „Desi“ abgerechnet wird.

Datenfluss bei der Versandintegration

Eine Versand-API-Integration besteht aus vier getrennten Datenaustauschen, und jeder hat einen anderen Auslöser:

Schritt Richtung Auslöser Daten
Preisberechnung Im Web oder per API Warenkorb / Zahlungsseite Adresse, Desi, Gewicht
Sendung anlegen Web → Versand Wenn die Bestellung vorbereitet ist Empfänger, Paket, Referenz
Bezeichnung Versand → Web Antwort zur Sendung Barcode, PDF oder ZPL
Statusverfolgung Versand → Web Webhook oder periodische Abfrage Bewegungs- und Zustellinformationen

Die eigentliche Entscheidung ist, wann die Sendung angelegt wird. Automatisch bei der Zahlungsbestätigung angelegte Sendungen müssen storniert werden, wenn sich im Lager eine Bestandsabweichung zeigt. Legen Sie die Sendung an, wenn die Bestellung kommissioniert und verpackt ist. Erst dann stehen tatsächliches Desi und Paketanzahl fest. In Betrieben mit ERP oder Lagerverwaltungssystem wird die Sendung meist dort angelegt, und WooCommerce erhält nur die Tracking-Informationen. Legen Sie schriftlich nach dem Eigentumsprinzip aus dem Beitrag Integrationsmuster zwischen ERP und Web fest, welches System welches Feld schreibt; Integrationen, bei denen zwei Systeme dasselbe Feld schreiben, überschreiben früher oder später gegenseitig ihre Daten.

Berechnung von Desi und Gewicht

Desi ist eine Einheit, die das Paketvolumen in ein Gewichtsäquivalent umrechnet. Im Inlandstransport in der Türkei ist die verbreitete Formel das Produkt aus Länge, Breite und Höhe in Zentimetern geteilt durch 3000. Der Divisor kann je nach Dienstleister und Serviceart variieren; maßgeblich ist der Wert in Ihrem Vertrag. Abgerechnet wird meist der größere Wert aus Desi und tatsächlichem Gewicht in Kilogramm.

Beispielrechnung: Für einen Karton mit 40 × 30 × 25 cm und 6 kg Gewicht gilt Desi = 40 × 30 × 25 / 3000 = 10. Abrechnungsgrundlage ist 10, da 10 Desi größer als 6 kg sind. Passt dasselbe Produkt in einen Karton mit 40 × 30 × 15 cm, sinkt der Desi-Wert auf 6 und entspricht dem Gewicht. Der Kartonstandard ist eine Kostenentscheidung.

In WooCommerce werden für jedes Produkt Gewicht und Abmessungen erfasst; die Einheiten werden unter WooCommerce → Einstellungen → Produkte festgelegt. Die Summe der Produkt-Desi im Warenkorb ergibt aber nicht das tatsächliche Paket-Desi; drei kleine Produkte passen in einen Karton. Zwei Ansätze werden genutzt:

  • Geschätztes Desi: Im Warenkorb wird die Summe der Produkt-Desi oder eine Logik zur Verteilung auf definierte Kartontypen verwendet; der Preis auf der Zahlungsseite ist eine Schätzung.
  • Tatsächliches Desi: Beim Anlegen der Sendung werden die im Lager gemessenen Kartonmaße eingegeben. Die Differenz zwischen dem vom Kunden erhobenen Preis und der Versandrechnung wird periodisch ausgewertet.

Das Bild, das wir in der Praxis am häufigsten sehen: Bei der Hälfte der Produkte ist das Feld für die Abmessungen leer, die Desi-Berechnung liefert null, und die Zahlungsseite zeigt für ein sperriges Produkt den niedrigsten Preis. Vervollständigen Sie die Produktdaten vor der Integration.

Modelle für Versandpreisregeln

Der dem Kunden angezeigte Versandpreis und der an den Versanddienstleister gezahlte Betrag sind nicht dasselbe. Bei der Wahl des Preismodells auf Unternehmens-E-Commerce-Websites werden Genauigkeit, Erklärbarkeit gegenüber dem Kunden und Geschwindigkeit der Zahlungsseite gemeinsam abgewogen.

Modell Vorteil Einschränkung
Pauschalpreis Einfach, schnell, verständlich Verlust bei sperrigen Produkten
Kostenlos ab einem bestimmten Betrag Erhöht den Warenkorbwert Kosten werden auf die Produktmarge umgelegt
Tabelle nach Desi/Gewicht Nah an den Kosten Produktmaße müssen vollständig sein
Nach Region Bildet Aufschläge für entfernte Regionen ab Regionsdefinitionen müssen gepflegt werden
Live-Preis per API Aktuell und exakt Zahlungsseite wird von der Versand-API abhängig

Die eingebaute Struktur von WooCommerce besteht aus Versandzonen, Methoden innerhalb der Zone (Pauschalpreis, kostenloser Versand, Abholung im Geschäft) und Versandklassen. Das Kostenfeld der Methode Pauschalpreis unterstützt einfache Ausdrücke: [qty] liefert die Produktanzahl, [cost] den Warenkorbwert; [fee percent="10" min_fee="20"] definiert eine Gebühr als Prozentsatz des Warenkorbwerts mit Untergrenze. So fügt etwa der Ausdruck 30 + ( 5 * [qty] ) einer Pauschale von 30 Einheiten 5 Einheiten pro Produkt hinzu. Eine eigene Versandklasse für sperrige Produkte mit Aufschlag nur für diese Klasse löst die meisten Probleme, ohne eine Desi-Tabelle aufzubauen.

Nutzen Sie Live-Preise per API, darf die Zahlungsseite nicht blockieren, wenn die Versand-API nicht antwortet; definieren Sie einen kurzen Timeout und eine Ersatzpauschale. Fällt ein externer Dienst aus, darf der Verkauf nicht stoppen. Berechnete Preise werden im Versand-Sitzungscache von WooCommerce gehalten; ohne Änderung von Adresse oder Warenkorb wird die API nicht erneut aufgerufen.

Sendung anlegen und Etikett drucken

Eine Sendungsanfrage enthält typischerweise Name des Empfängers, Telefon, vollständige Adresse, Provinz/Bezirk, Paketanzahl, Desi und Gewicht jedes Pakets, Zahlungsart (Absender zahlt, Empfänger zahlt, Nachnahme) und die Referenznummer auf Ihrer Seite. Verwenden Sie die Bestellnummer als Referenz; das ist der zuverlässigste Weg, den Datensatz im Versandpanel der Bestellung zuzuordnen.

In der Praxis zu prüfende Punkte:

  • Adressnormalisierung: Provinz und Bezirk dürfen kein Freitext sein, sondern müssen aus einer Auswahlliste kommen. Versand-APIs prüfen Provinz-/Bezirksnamen oder -codes gegen eigene Listen; der Unterschied zwischen „Eyüp“ und „Eyüpsultan“ bedeutet einen Sendungsfehler.
  • Telefonformat: Da an den Empfänger eine SMS geht, sollte die Telefonnummer einheitlich gespeichert werden (z. B. 10 Stellen ohne Ländervorwahl).
  • Schutz vor Duplikaten: Nachdem die Sendungsnummer in die Bestellung geschrieben wurde, sollte die Schaltfläche deaktiviert werden; läuft die API in einen Timeout, sollte vor einer neuen Anfrage über die Referenz abgefragt werden. Sonst entstehen für dieselbe Bestellung zwei Barcodes.
  • Mehrere Pakete: Wird eine Bestellung auf mehrere Kartons aufgeteilt, erhält jedes Paket einen eigenen Barcode; die Tracking-Informationen werden auf Bestellebene als Liste gespeichert.

Etiketten kommen meist als PDF oder ZPL zurück. PDF wird am Bürodrucker gedruckt, erfordert für Klebeetiketten aber Zuschnitt. Gibt es im Lager einen Thermo-Etikettendrucker, geht die ZPL-Ausgabe direkt an den Drucker; die Etikettengröße (verbreitet 100 × 100 mm oder 100 × 150 mm) muss der Vorlage des Versanddienstleisters entsprechen. Weicht die im Drucker definierte Etikettenlänge von der Vorlage ab, wird der Barcode abgeschnitten und in der Filiale nicht gelesen. Beim Massendruck für ausgewählte Bestellungen in einem Durchgang Sendungen anzulegen und die Etiketten in einer Datei zusammenzuführen, beschleunigt das Verpacken.

Sendungsnummer und Kundenbenachrichtigung

Die Sendungsnummer sollte als Metadaten in die Bestellung geschrieben werden und sowohl in der Verwaltungsansicht als auch in den Bestelldetails im Kundenkonto erscheinen. In einem Shop mit aktivem HPOS wird statt direkter Post-Meta das Bestellobjekt verwendet:

$order = wc_get_order( $order_id );
$order->update_meta_data( '_versand_tracking_nr', $tracking_no );
$order->update_meta_data( '_versand_dienstleister', 'beispiel-versand' );
$order->save();

// Per E-Mail an den Kunden gesendete Bestellnotiz (zweiter Parameter 1 = Kundennotiz)
$order->add_order_note(
    sprintf( 'Ihre Bestellung wurde versendet. Sendungsnummer: %s', $tracking_no ),
    1
);
$order->update_status( 'completed' );

Eine als Kundennotiz hinzugefügte Notiz löst die WooCommerce-E-Mail „Kundennotiz“ aus. Wird die Bestellung gleichzeitig auf completed gesetzt, geht auch die E-Mail „Bestellung abgeschlossen“ hinaus. Der Kunde erhält zwei E-Mails. Wenn Sie das nicht möchten, übermitteln Sie die Sendungsnummer nur in einer davon (z. B. über ein in die Vorlage der Abschluss-E-Mail eingefügtes Feld). Manche Betriebe definieren einen eigenen Bestellstatus „Versendet“ und setzen die Bestellung erst nach der Zustellung auf abgeschlossen; dann muss gesondert geklärt werden, welche E-Mail-Vorlage der eigene Status hat und welcher Gruppe er in Berichten zugerechnet wird.

Für die Statusaktualisierung gibt es zwei Methoden. Bietet der Versanddienstleister einen Webhook, kommen Ereignisse wie Zustellung, in Auslieferung und Retoure sofort; der Empfänger muss die Signatur prüfen und wiederholte Ereignisse erkennen. Ohne Webhook werden offene Sendungen in festen Abständen abgefragt. Der Abfragejob sollte nur nicht zugestellte Sendungen unterhalb eines bestimmten Alters umfassen; sonst gehen bei jedem Lauf Tausende unnötige Anfragen hinaus, und Sie stoßen an das Anfragelimit des Dienstleisters. Das sichere Design eines Webhook-Empfängers behandelt gesondert der Leitfaden Webhook-Empfänger gestalten.

Checkliste für Retourenversand und Lager

Im Retourenablauf erhält der Kunde einen Retourencode und gibt das Paket mit diesem Code in der Filiale ab. Der Code sollte bei Freigabe der Retourenanfrage per API erzeugt und mit der Bestellung verknüpft werden; so ist am Barcode erkennbar, zu welcher Bestellung ein im Lager eingehendes Paket gehört. Erreicht das Paket das Lager, wird das Produkt geprüft und danach die Erstattung über den Zahlungsanbieter ausgelöst. Ohne Sichtprüfung des Produkts wird kein Geld erstattet. Die Erstattungsregeln auf Zahlungsseite stehen im Beitrag WooCommerce-Anbindung virtueller POS.

Liste für die Zeit vor dem Livegang und das Tagesgeschäft:

  • Sind bei allen Produkten Gewicht und Abmessungen ausgefüllt, sind die Einheiten korrekt?
  • Sind Standard-Kartontypen und ihre Maße definiert?
  • Stimmen Desi-Divisor und Regionsregeln aus dem Vertrag mit den Integrationseinstellungen überein?
  • Passen die Felder Provinz/Bezirk zur Liste des Versanddienstleisters?
  • Ist für die Zahlungsseite bei API-Timeout ein Ersatzpreis definiert?
  • Ist das Anlegen von Sendungen gegen Duplikate geschützt, wird eine zweite Sendung für dieselbe Bestellung verhindert?
  • Passen Etikettengröße und Druckereinstellung zur Versandvorlage?
  • Erscheint die Sendungsnummer in der Kunden-E-Mail und auf der Kontoseite?
  • Läuft der Bericht zu Sendungen ohne Bewegung und unzustellbaren Paketen?
  • Wird der Retourencode mit der Bestellung verknüpft und nach der Annahme im Lager die Zahlungserstattung ausgelöst?
  • Werden Versandrechnung und vom Kunden erhobener Versandpreis monatlich verglichen?

Um Versand-, Zahlungs- und ERP-Abläufe in einem einheitlichen Shop-Konzept zu planen, sehen Sie sich den Umfang auf der Seite WooCommerce-E-Commerce-Lösungen an.

Häufig gestellte Fragen

Welcher Divisor sollte bei der Desi-Berechnung verwendet werden?

Im Inlandsversand in der Türkei ist 3000 der verbreitete Divisor; das Produkt aus Länge, Breite und Höhe in Zentimetern wird durch 3000 geteilt. Der Divisor kann je nach Dienstleister und Serviceart variieren; verwenden Sie in der Integration den Wert aus Ihrem Versandvertrag.

Sollte die Sendung sofort nach Zahlungseingang angelegt werden?

In der Regel nicht. Die tatsächlichen Kartonmaße und die Paketanzahl sind erst beim Verpacken bekannt. Die Sendung im Verpackungsschritt anzulegen, verringert stornierte Sendungen und falsche Desi-Angaben.

Wie wird der Status verfolgt, wenn der Versanddienstleister keinen Webhook anbietet?

Nicht zugestellte Sendungen werden in festen Abständen über die Tracking-API abgefragt. Beschränken Sie den Abfrageumfang auf offene Sendungen, die jünger als ein bestimmtes Alter sind, und halten Sie die Anfragelimits des Dienstleisters ein.

Ist es möglich, mit mehreren Versanddienstleistern zu arbeiten?

Ja. Für jeden Dienstleister kann eine eigene Methode oder Zonenregel definiert werden. Speichern Sie im Sendungsdatensatz den Dienstleister zusammen mit der Sendungsnummer; der dem Kunden angezeigte Tracking-Link muss je nach Dienstleister erzeugt werden.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge