Yurtici Kargo — Anleitung zur Einrichtung der Shopify-Integration

Domestic Shipping Die Shopify-Integration ist eine Infrastrukturlösung, die über die offizielle App im Shopify App Store installiert werden kann und den gesamten Prozess von der Auftragsbestätigung bis zum Versandetikett automatisiert. In diesem Handbuch werden alle Schritte behandelt, die Sie zur Integration des Yurtici kargo in Ihren Shopify-Shop benötigen, technische Anforderungen und Lösungen für häufig auftretende Probleme.

Was ist die Shopify-Integration für Inlandsversand?

Inlandsversand Die Shopify-Integration ist ein API-Link, der die Bestelldaten Ihres Shops automatisch an das Yurtici kargo weiterleitet und die Prozesse für Etikett, Sendungsverfolgungsnummer und Benachrichtigungen automatisiert. Bevor die Integration eingerichtet ist, muss für jede Bestellung das Etikett manuell gedruckt, eine Adresse in das Versandsystem eingegeben und die Tracking-Nummer kopiert werden. Dies dauert 3—6 Minuten pro Bestellung.

Mit mehr als 780 Filialen in der Türkei ist Yurtiçi Kargo eine leistungsstarke Option, insbesondere wenn es darum geht, die Städte der zweiten und dritten Ebene Anatoliens zu erreichen. Die Integration von Inlandsversand, eine der am häufigsten kommentierten offiziellen Versand-Apps in der Türkei im Shopify App Store, hat eine skalierbare Struktur von 10 Bestellungen pro Monat bis 10.000 Bestellungen.

Die Hauptvorteile von Domestic im Vergleich zu konkurrierenden Reedereien sind: ein großes Filialnetz, das Fehlen von Mindestvolumenanforderungen für den Zugriff auf die API und die API-Unterstützung für das Retourenmanagement.

Shopify-Kompatibilität für inländische und andere Reedereien

Die Shopify-Integrationsfunktionen der wichtigsten Reedereien in der Türkei unterscheiden sich erheblich voneinander. Die Wahl der richtigen Reederei hängt von Ihren Lieferregionen, Ihrem Bestellvolumen und Ihren Preiserwartungen ab.

Der Inlandsversand ist eine der wenigen Reedereien, die kein Mindestvolumen für den API-Zugriff festlegen, was für neu eröffnete Shopify-Shops ein großer Vorteil ist. Aras Cargo stellt ebenfalls keine Volumenanforderungen. Die offizielle Shopify-App von Yurtiçi hat jedoch eine ausgereiftere Struktur in Bezug auf die Benutzeroberfläche.

Anforderungen vor der Installation

Es gibt vier Voraussetzungen, die erfüllt sein müssen, bevor die Shopify-Integration für Inlandsversand gestartet werden kann: Inländischer Unternehmensvertrag, API-Anmeldeinformationen, Überprüfung der Shopify-Produktdaten und Konfiguration der Lieferzone.

Eröffnung eines Firmenkontos für inländische Fracht

Füllen Sie das Anfrageformular für Kundenvertreter aus, indem Sie sich an die Firmenkundenabteilung von Yurtiçi Kargo wenden (yurticikargo.com.tr → Corporate Solutions). Nach der Ernennung des Agenten beginnt der Vertragsprozess und ist in der Regel innerhalb von 3—5 Werktagen abgeschlossen. Sobald der Vertrag unterzeichnet ist, werden die Kundennummer und das API-Zugangspasswort für Sie definiert.

Informieren Sie bei der Vertragsverhandlung im Voraus über Ihr geschätztes monatliches Sendungsvolumen und die Zielliefergebiete. Wenn Sie mehr als 200 Sendungen pro Monat versenden können, erhalten Sie einen Rabatt von 10 bis 20% auf den Einzelversand.

💡 TIPP: Fragen Sie auch Ihren Vertreter für den Inlandsversand nach dem Zugriff auf die API-Sandbox (Testumgebung). Sandbox ermöglicht es Ihnen, Integrationstests durchzuführen, ohne die eigentliche Ladung zu produzieren. So können Sie die Software problemlos debuggen, bevor sie live geht.

Shopify-Produktdatencheck

Für alle Produkte müssen vor der Integration die Gewichtsinformationen im Shopify-Adminbereich eingegeben werden. Exportieren Sie alle Produkte als CSV mit Produkten → Exportieren, überprüfen Sie die Spalte „Variant Grams“ und aktualisieren Sie die Produkte mit dem Wert 0. Für Geschäfte mit mehr als 1000 Produkten können Sie diese Batch-Aktualisierung mit der CSV-Importmethode durchführen.

Shopify-Einrichtung für Inlandsversand Schritt für Schritt

Die Shopify-Integration für Inlandsversand erfolgt in vier Hauptschritten: App-Installation, API-Verbindung, Identifizierung der Versandzone und Testverifizierung. Der gesamte Vorgang dauert durchschnittlich 2—4 Stunden.

Schritt 1: Installieren Sie die App

1. Gehe im Shopify-Adminbereich zu Apps → App Store.
2. Geben Sie „Inlandsversand“ in das Suchfeld ein.
3. Suchen Sie die offizielle Inlandsversand-App und klicken Sie auf die Schaltfläche „App hinzufügen“.
4. Bestätigen Sie die erforderlichen Berechtigungen (Bestellungen lesen, Sendungsberechtigungen schreiben).

Schritt 2: API-Verbindung herstellen

5. Gehen Sie auf dem Einstellungsbildschirm der App „Inlandsversand“ zum Abschnitt „API-Einstellungen“.
6. Geben Sie Ihre Kundennummer (die Sie über das Unternehmensportal erhalten haben) in das entsprechende Feld ein.
7. Geben Sie Ihr API-Passwort ein. Wir empfehlen Ihnen, das Passwort manuell zu schreiben, nicht durch Kopieren und Einfügen (vermeidet das Problem des versteckten Leerzeichens).
8. Geben Sie Ihre Filialleitzahl ein (für einige Regionen erforderlich; erhalten Sie sie von Ihrem Vertreter).
9. Klicken Sie auf die Schaltfläche „Verbindung überprüfen“. Bei erfolgreicher Verbindung erscheint ein grünes Häkchen.

⚠️ ACHTUNG: Wenn die API-Verbindung fehlschlägt, achten Sie bei der Kundennummer auf Groß- und Kleinschreibung. In einigen Fällen generiert die API für den Inlandsversand einen Eingabefehler in Kleinbuchstaben, während auf einen CustomerCode in Großbuchstaben gewartet wird.

Schritt 3: Cargo Zones konfigurieren

1. Gehe zu Einstellungen → Versand und Lieferung → Verwalten.
2. Klicken Sie unter dem Bereich „Türkei“ auf die Schaltfläche „Tarif hinzufügen“.
3. Wählen Sie Domestic Cargo als Transporteur aus.
4. Ermitteln Sie das Preismodell (siehe Tabelle unten).
5. Wenn Sie einen Schwellenwert für kostenlosen Versand hinzufügen möchten, legen Sie „Bedingung hinzufügen“ → „Bestellpreis“ → Mindestbetrag fest.

Schritt 4: Testen und zum Leben erwecken

1. Erstellen Sie eine Testbestellung im Shopify-Adminbereich → Bestellungen → Bestellung erstellen.
2. Verwenden Sie eine echte türkische Adresse (Sandbox-Adressen erzeugen möglicherweise keine Tags).
3. Klicken Sie auf dem Fulfillment-Bildschirm auf die Schaltfläche „Versandetikett erstellen“.
4. Die Integration ist erfolgreich, wenn das Etikett als PDF geöffnet wird und die Nummer im Domestic Tracking System läuft.
5. Überprüfen Sie, ob die Kundenbenachrichtigungs-E-Mail die Tracking-Nummer enthält.

Frachtpreisgestaltung und -optimierung

Beim Inlandsversand kannst du, wenn die Preiskonfiguration in Shopify korrekt eingerichtet ist, sowohl deine Versandkosten kontrollieren als auch den Betrag des Einkaufswagens des Kunden erhöhen. Ungefähr 68% der Geschäfte in der Türkei verwenden das Modell „kostenloser Versand ab einem bestimmten Betrag“.

Wenn Sie den Schwellenwert für kostenlosen Versand festlegen, orientieren Sie sich an Ihrem durchschnittlichen Warenkorbbetrag und legen Sie den Schwellenwert auf über 15-20% fest. Wenn Ihr durchschnittlicher Warenkorbbetrag beispielsweise 350 TL beträgt, legen Sie den Schwellenwert auf 400—420 TL fest. Diese Strategie ermutigt Kunden, zusätzliche Produkte hinzuzufügen, um den Warenkorb zu füllen.

Denken Sie an das Desi-Konto (Volumengewicht) für Geschäfte, die schwere oder sperrige Artikel verkaufen. Domestic Cargo berechnet den Gegenwert von 1 Desi = 1 kg. Allerdings wird ein Volumengewicht, das größer als das tatsächliche Gewicht ist, in Rechnung gestellt. Um dieser Situation in Shopify zu begegnen, kannst du das Produktgewicht mit dem Volumengewicht statt mit dem tatsächlichen Gewicht aktualisieren.

Häufige Fehler und Lösungen

Inlandsversand Die häufigsten Probleme bei der Shopify-Integration sind API-Verbindungsfehler, Fehler bei der Etikettenherstellung und eine falsche Anzeige der Lieferzeiten. Die überwiegende Mehrheit dieser Fehler ist auf die Konfiguration zurückzuführen und kann ohne technische Kenntnisse behoben werden.

Fehler: 'Ungültige Anmeldeinformationen'

Lösung: Kopieren Sie Ihre Kundennummer und Ihr API-Passwort erneut aus dem Domestic Enterprise-Portal. Insbesondere wenn das Passwortfeld türkische Zeichen (ş, ğ, ü, ç, ö, ı) enthält, stellen Sie sicher, dass diese Zeichen korrekt kodiert sind.

Fehler: Label erstellt kein PDF

Lösung: Prüfen Sie, ob die Angaben zu Provinz und Bezirk an der Bestelladresse mit den entsprechenden Informationen im System von Domestic übereinstimmen. Insbesondere in kleinen Siedlungen stimmen das Adressformat von Shopify und das Vorwahlsystem von Domestic möglicherweise nicht überein. In diesem Fall können Sie mithilfe des Felds „Standard-Filialleitzahl“ eine manuelle Zuordnung vornehmen.

Fehler: Die Tracking-Nummer funktioniert nicht, obwohl sie 24 Stunden vergangen ist

Lösung: Nachdem das inländische Versandetikett erstellt wurde, wird das Tracking-System erst aktualisiert, wenn das physische Paket an die Inlandsfiliale geliefert wurde. Innerhalb von 2—4 Stunden nach der Lieferung des Pakets wird die Tracking-Nummer aktiv.

Häufig gestellte Fragen

So integrieren Sie den Inlandsversand in Shopify

Installiere die offizielle Inlandsversand-App aus dem Shopify App Store und gib dann deine inländische Firmenkundennummer und dein API-Passwort in den App-Einstellungen ein. Zunächst muss ein Unternehmensvertrag mit Domestic Cargo unterzeichnet und der API-Zugriff gewährt werden. Der Vorgang kann in 2—4 Stunden abgeschlossen werden.

Wird die Shopify-App für Inlandsversand bezahlt?

Die offizielle Shopify-App für Inlandsversand ist kostenlos. Die Versandkosten, die Sie pro Sendung zahlen, richten sich nach dem Unternehmensvertragstarif, den Sie mit Yurtiçi unterzeichnet haben. Für den eigenen Tarif von Shopify müssen Sie zwischen Shopify Basic, Shopify oder Advanced wählen.

Kann ich am selben Tag wie Domestic Cargo liefern?

Domestic Cargo bietet in einigen Gebieten Istanbuls die Lieferoptionen „Schnell“ und „Am selben Tag“ an. Für diese Dienste muss der ServiceType-Parameter in der API entsprechend festgelegt werden. Dieser Dienst muss in Ihrem aktuellen Vertrag definiert sein. Es gilt nicht für die gesamte Türkei.

Kann ich Domestic Cargo mit einer anderen Reederei nutzen?

Jep. Shopify ermöglicht es Ihnen, mehrere Reedereien gleichzeitig aktiv zu halten. Du kannst verschiedene Unternehmen verschiedenen Liefergebieten zuordnen, zum Beispiel Yurtiçi für Istanbul und Ankara, Aras Cargo für andere Provinzen. Diese Konfiguration wird von den Versandzonen aus verwaltet.

‍

Inlandsversand Die Shopify-Integration automatisiert die Versandabläufe Ihres Shops um 85%, wenn sie ordnungsgemäß eingerichtet ist. Die offizielle Anwendung bietet eine leistungsstarke und kostenlose Lösung für kleine und mittlere Geschäfte, während die benutzerdefinierte API-Integration für große Geschäfte mehr Flexibilität bietet.

Richten Sie Ihren neuen Shopify-Shop von Grund auf ein Unsere Blogseite hilft Ihnen weiter du kannst untersuchen.

Als Nodus Works installieren wir technisch und operativ Shopify-Integrationen für den Inlandsversand und andere Reedereien.

Kostenloses Beratungsgespräch anfragen

‍