Trendyol- und HepsiJet-ZPL-Versandetiketten drucken
Veröffentlicht:
Wer über die APIs von Trendyol verkauft oder mit HepsiJet
versendet, bekommt das Versandetikett nicht als PDF zum Öffnen und
Drucken. Es kommt als ZPL — die Befehlssprache von Thermodruckern der
Zebra-Klasse. Ein Browser oder Bürodrucker druckt das als Textzeilen.
Diese Seite zeigt, welche Aufrufe ZPL liefern, wie Sie das Etikett vor
dem Druck prüfen und wie es auf einen Thermodrucker kommt.
Welche Aufrufe ZPL liefern
Gelesen am 2026-10-31 in der Entwicklerdokumentation der Anbieter;
Feldnamen ändern sich zwischen API-Versionen, prüfen Sie daher die
aktuelle Referenz, bevor Sie darauf aufbauen.
Trendyol Common Label. Das Etikett wird mit
createCommonLabel angefordert und mit
getCommonLabel abgeholt; die Antwort enthält
"format": "ZPL". Laut Trendyol ist derzeit nur das
ZPL-Format verfügbar, für TEX und Aras Kargo im bezahlten
Trendyol-Versandmodell.
HepsiJet.GET
/delivery/generateZplBarcode/{barcode}/{totalParcel} liefert das
Etikett im Feld zplBarcode, eine Zeichenkette, die mit
^XA beginnt und mit ^XZ endet. Bei Sendungen mit
mehreren Paketen ist der zweite Pfadteil die Gesamtzahl der Pakete.
Weitere türkische Versanddienstleister mit ZPL-Etikett
Gelesen am 2026-10-31 in der eigenen Webservice-Beschreibung (WSDL)
oder im Entwickler-Repository des jeweiligen Dienstleisters. Diese Dienste
werden pro Kundenkonto freigeschaltet; die Etikettenfunktion muss in Ihrem
Konto eventuell aktiviert werden:
Yurtiçi Kargo:createShipmentWithDelivery
liefert pro Paket ein docCargoZpl-Etikett.
Aras Kargo (Direktvertrag):GetBarcode
liefert ZebraZpl neben EPL- und PDF-Feldern.
UPS Türkiye: der lokale Webservice bietet
CreateShipment_Type3_ZPL, das ZplResult
liefert.
Kolay Gelsin und Sendeo: der gemeinsame Webservice
liefert BarcodeZpl, wenn als Etikettentyp ZPL gewählt
ist.
PTT Kargos etiketGetir liefert EPL, nicht ZPL; Labelixa
zeigt auch EPL in der Vorschau, gedruckt wird es aber nur auf Druckern,
die EPL verstehen. Wir nehmen einen Dienstleister erst auf, nachdem wir
seine Dokumentation gelesen haben.
Das Etikett vor dem Druck prüfen
Speichern Sie das ZPL zuerst in einer Datei und sehen Sie es sich an:
fügen Sie es in die ZPL-Vorschau ein.
Die Vorschau zeigt, ob das Etikett auf das Material passt und ob die
Barcodes lesbar sind. Am häufigsten gehen zwei Dinge schief:
Auflösung. ZPL ist in Punkten für eine Druckdichte
geschrieben. Ein Etikett für 203 dpi druckt auf einem 300-dpi-Drucker in
etwa zwei Dritteln der Größe. Der
Größen- und DPI-Analyzer sagt,
welche Dichte die Datei annimmt.
Materialgröße. Versandetiketten sind meist
100×100 mm oder 100×150 mm. Auf schmaleren Rollen wird der rechte Rand
abgeschnitten.
Ändern Sie weder Barcode noch Leitdaten des Versanddienstleisters: das
Paket muss in dessen Netz scannbar bleiben. Eigene Angaben drucken Sie
auf ein separates Etikett.
USB-Drucker, aus der Cloud. Der Labelixa
DirectPrint-Agent (Windows und macOS) nimmt einen Druckauftrag aus Ihrer
Integration entgegen und sendet das rohe ZPL an den USB- oder
Netzwerkdrucker, ohne dass ein Treiber es umwandelt — siehe
aus der
Cloud auf einen USB-Zebra-Drucker drucken.
Aus dem Browser. Ein Browser kann allein keine
Rohbefehle senden; was funktioniert, steht unter
ZPL aus dem Browser
drucken.
Welche Drucker
Zebra-Drucker lesen ZPL direkt. Viele Händler in der Türkei nutzen
günstigere Drucker wie den Xprinter XP-470B; manche dieser Modelle werben
mit ZPL- oder TSPL-Emulation. Diese Modelle haben wir nicht gemessen:
drucken Sie ein Testetikett und vergleichen Sie es mit der Vorschau,
bevor Sie sich darauf verlassen.
Labelixa ist nicht mit Trendyol oder Hepsiburada verbunden; es liest
und druckt das ZPL, das deren APIs liefern.
Häufig gestellte Fragen
Warum druckt mein Trendyol-Etikett als Text?
Das Trendyol-Common-Label ist ZPL, kein PDF. Ein Bürodrucker oder Browser druckt ZPL als Text; senden Sie es stattdessen roh an einen Thermodrucker der Zebra-Klasse.
Kann ich das Trendyol-Common-Label als PDF bekommen?
Laut Trendyol-Dokumentation ist für das Common Label derzeit nur das ZPL-Format verfügbar. Zeigen Sie es mit einem ZPL-Viewer als Bild an oder drucken Sie es auf einem Thermodrucker.
