Die Yurtiçi Kargo Shopify-Integration ist eine Infrastruktur-Lösung, die über die offizielle App im Shopify App Store installiert werden kann und den gesamten Prozess von der Bestellbestätigung bis zum Versandetikett automatisiert. Dieser Leitfaden enthält alle Schritte, technischen Anforderungen und Lösungen für häufig auftretende Probleme, die Sie für die Integration von Yurtiçi Kargo in Ihren Shopify-Shop benötigen.
Was ist die Yurtiçi Kargo Shopify-Integration?
Die Yurtiçi Kargo Shopify-Integration ist eine API-Verbindung, die die Bestelldaten Ihres Shops automatisch an das Yurtiçi Kargo-System übermittelt und die Prozesse für Etiketten, Sendungsverfolgungsnummern und Benachrichtigungen automatisch ausführt. Vor der Integration müssen für jede Bestellung manuell Etiketten gedruckt, Adressen in das Versandsystem eingegeben und Sendungsverfolgungsnummern kopiert werden. Dieser Vorgang dauert pro Bestellung 3 bis 6 Minuten.
Mit mehr als 780 Filialen in der Türkei ist Yurtiçi Kargo eine gute Wahl, insbesondere für den Zugang zu Städten der zweiten und dritten Ebene in Anatolien. Die Yurtiçi Kargo-Integration, eine der am häufigsten bewerteten offiziellen Versand-Apps im Shopify App Store, ist skalierbar von 10 bis 10.000 Bestellungen pro Monat.
Im Vergleich zu konkurrierenden Versandunternehmen hat Yurtiçi folgende wesentliche Vorteile: ein großes Filialnetz, keine Mindestvolumenanforderungen für den API-Zugang und API-Unterstützung für die Retourenverwaltung.
Shopify-Kompatibilität von Yurtiçi und anderen Versandunternehmen
Die Shopify-Integrationsfunktionen der wichtigsten Versandunternehmen in der Türkei unterscheiden sich erheblich voneinander. Die Wahl des richtigen Versandunternehmens hängt von Ihren Lieferregionen, Ihrem Bestellvolumen und Ihren Preisvorstellungen ab.
Yurtiçi Kargo ist eines der wenigen Transportunternehmen, das keine Mindestvolumenanforderungen für den API-Zugang stellt. Diese Eigenschaft ist ein wichtiger Vorteil für neu eröffnete Shopify-Shops. Aras Kargo stellt ebenfalls keine Mindestvolumenanforderungen, jedoch verfügt die offizielle Shopify-App von Yurtiçi über eine ausgereiftere Benutzeroberfläche.
Voraussetzungen vor der Einrichtung
Bevor Sie die Integration von Yurtiçi Kargo in Shopify starten können, müssen vier Voraussetzungen erfüllt sein: Yurtiçi-Unternehmensvertrag, API-Anmeldedaten, Shopify-Produktdatenüberprüfung und Konfiguration des Liefergebiets.
Eröffnung eines Unternehmenskontos bei Yurtiçi Kargo
Füllen Sie das Kundenvertreter-Anfrageformular aus, indem Sie sich an die Unternehmensabteilung von Yurtiçi Kargo wenden (yurticikargo.com.tr → Unternehmenslösungen). Nach der Zuweisung eines Vertreters beginnt der Vertragsprozess, der in der Regel innerhalb von 3–5 Werktagen abgeschlossen ist. Nach Unterzeichnung des Vertrags erhalten Sie eine persönliche Kundennummer und ein API-Zugangspasswort.
Geben Sie bei den Vertragsverhandlungen Ihr voraussichtliches monatliches Versandvolumen und Ihre Zielregionen für die Zustellung im Voraus an. Wenn Sie mehr als 200 Sendungen pro Monat zusagen können, erhalten Sie einen Rabatt von 10–20 % auf den Stückpreis.
💡 TIPP: Bitten Sie Ihren Yurtiçi Kargo-Vertreter auch um Zugriff auf die API Sandbox (Testumgebung). Die Sandbox ermöglicht Ihnen Integrationstests ohne echte Fracht und erleichtert die Fehlerbehebung, bevor Sie live gehen.
Shopify-Produktdatenprüfung
Vor der Integration müssen die Gewichtsangaben für alle Produkte im Shopify-Admin-Panel eingegeben werden. Exportieren Sie alle Produkte mit „Produkte → Exportieren” als CSV-Datei, überprüfen Sie die Spalte „Variant Grams” und aktualisieren Sie die Produkte mit dem Wert 0. Bei Shops mit mehr als 1000 Produkten können Sie diese Massenaktualisierung mit der CSV-Importmethode durchführen.
Schritt für Schritt: Einrichtung von Yurtiçi Kargo Shopify
Die Integration von Yurtiçi Kargo in Shopify erfolgt in vier Schritten: Installation der Anwendung, API-Verbindung, Definition der Versandregion und Testüberprüfung. Der gesamte Vorgang dauert durchschnittlich 2 bis 4 Stunden.
Schritt 1: Laden Sie die Anwendung herunter
- Gehen Sie im Shopify-Admin-Panel zu Apps → App Store.
- Geben Sie „Yurtiçi Kargo” in das Suchfeld ein.
- Suchen Sie die offizielle Yurtiçi Kargo-Anwendung und klicken Sie auf die Schaltfläche „Add app” (Anwendung hinzufügen).
- Bestätigen Sie die erforderlichen Berechtigungen (Lesen von Bestellungen, Schreiben von Sendungen).
Schritt 2: API-Verbindung herstellen
- Gehen Sie im Einstellungsbildschirm der Yurtiçi Kargo-App zum Abschnitt „API-Einstellungen”.
- Geben Sie Ihre Kundennummer (die Sie über das Unternehmensportal erhalten haben) in das entsprechende Feld ein.
- Geben Sie Ihr API-Passwort ein. Wir empfehlen Ihnen, das Passwort nicht per Kopieren und Einfügen, sondern manuell einzugeben (um Probleme mit versteckten Leerzeichen zu vermeiden).
- Geben Sie Ihren Filialcode ein (für einige Regionen erforderlich; diesen erhalten Sie von Ihrem Vertreter).
- Klicken Sie auf die Schaltfläche „Verbindung bestätigen”. Bei einer erfolgreichen Verbindung wird ein grünes Häkchen angezeigt.
⚠️ ACHTUNG: Wenn die API-Verbindung fehlschlägt, überprüfen Sie die Groß-/Kleinschreibung der Kundennummer. Die Yurtiçi Kargo-API erwartet in einigen Fällen einen CustomerCode in Großbuchstaben und erzeugt bei der Eingabe in Kleinbuchstaben einen Fehler.
Schritt 3: Konfigurieren Sie die Versandregionen
- Gehen Sie zu „Einstellungen“ → „Versand und Lieferung“ → „Verwalten“.
- Klicken Sie unter der Region „Turkey“ auf die Schaltfläche „Add rate“.
- Wählen Sie Yurtiçi Kargo als Spediteur aus.
- Legen Sie das Preismodell fest (siehe Tabelle unten).
- Wenn Sie einen Schwellenwert für kostenlosen Versand hinzufügen möchten, klicken Sie auf „Add condition“ → „Order price“ → und legen Sie einen Mindestbetrag fest.
Schritt 4: Testen und Live schalten
- Erstellen Sie eine Testbestellung über Shopify Admin → Bestellungen → Bestellung erstellen.
- Verwenden Sie eine echte Adresse in der Türkei (Sandbox-Adressen können möglicherweise keine Etiketten erstellen).
- Klicken Sie auf dem Fulfillment-Bildschirm auf die Schaltfläche „Versandetikett erstellen”.
- Wenn das Etikett als PDF geöffnet wird und die Nummer im Inlandsverfolgungssystem funktioniert, ist die Integration erfolgreich.
- Überprüfen Sie, ob die Kundenbenachrichtigungs-E-Mail die Sendungsverfolgungsnummer enthält.
Versandkostenberechnung und -optimierung
Wenn die Preisgestaltung in Shopify mit Yurtiçi Kargo richtig konfiguriert ist, haben Sie sowohl Ihre Versandkosten unter Kontrolle als auch den Warenkorbwert Ihrer Kunden erhöht. Etwa 68 % der Geschäfte in der Türkei verwenden das Modell „kostenloser Versand ab einem bestimmten Betrag”.
Legen Sie bei der Festlegung der Schwelle für kostenlosen Versand Ihren durchschnittlichen Warenkorbwert zugrunde und setzen Sie die Schwelle auf 15–20 % darüber. Wenn Ihr durchschnittlicher Warenkorbwert beispielsweise 350 TL beträgt, setzen Sie die Schwelle auf 400–420 TL. Diese Strategie motiviert Kunden, zusätzliche Produkte in ihren Warenkorb zu legen.
Berücksichtigen Sie für Shops, die schwere oder voluminöse Produkte verkaufen, die Berechnung des Volumengewichts. Yurtiçi Kargo berechnet 1 Volumengewicht = 1 kg, jedoch wird das Volumengewicht in Rechnung gestellt, das größer ist als das tatsächliche Gewicht. Um dieser Situation in Shopify zu begegnen, können Sie das Produktgewicht mit dem Volumengewicht anstelle des tatsächlichen Gewichts aktualisieren.
Häufige Fehler und Lösungen
Die häufigsten Probleme bei der Integration von Yurtiçi Kargo in Shopify sind API-Verbindungsfehler, Fehler bei der Etikettenerstellung und falsche Angaben zur Lieferzeit. Die meisten dieser Fehler sind konfigurationsbedingt und können ohne technische Kenntnisse behoben werden.
Fehler: „Ungültige Anmeldedaten”
Lösung: Kopieren Sie Ihre Kundennummer und Ihr API-Passwort erneut aus dem Yurtiçi-Unternehmensportal. Achten Sie insbesondere darauf, dass Passwörter, die türkische Zeichen enthalten (ş, ğ, ü, ç, ö, ı), korrekt codiert sind.
Fehler: Das Etikett erstellt kein PDF
Lösung: Überprüfen Sie, ob die Angaben zu Stadt und Landkreis in der Bestelladresse mit den Angaben im System von Yurtiçi übereinstimmen. Insbesondere in kleinen Ortschaften kann es vorkommen, dass das Adressformat von Shopify nicht mit dem Regionalcodesystem von Yurtiçi übereinstimmt. In diesem Fall können Sie die manuelle Zuordnung über das Feld „Standard-Filialcode” vornehmen.
Fehler: Die Sendungsverfolgungsnummer funktioniert auch nach 24 Stunden nicht
Lösung: Nachdem der Yurtiçi-Versandetikett erstellt wurde, wird das Tracking-System erst aktualisiert, wenn das physische Paket bei einer Yurtiçi-Filiale abgegeben wurde. Die Sendungsverfolgungsnummer wird innerhalb von 2 bis 4 Stunden nach Abgabe des Pakets aktiviert.
Häufig gestellte Fragen
Wie wird Yurtiçi Kargo in Shopify integriert?
Laden Sie die offizielle Yurtiçi Kargo-App aus dem Shopify App Store herunter und geben Sie dann Ihre Yurtiçi-Firmenkundennummer und Ihr API-Passwort in den App-Einstellungen ein. Zuvor muss ein Unternehmensvertrag mit Yurtiçi Kargo abgeschlossen und API-Zugriff gewährt worden sein. Der Vorgang kann innerhalb von 2 bis 4 Stunden abgeschlossen werden.
Ist die Yurtiçi Kargo Shopify-App kostenpflichtig?
Die offizielle Yurtiçi Kargo Shopify-App ist kostenlos. Die Versandkosten pro Sendung richten sich nach dem Tarif des Unternehmensvertrags, den Sie mit Yurtiçi abgeschlossen haben. Für den Shopify-eigenen Tarif müssen Sie zwischen Shopify Basic, Shopify oder Advanced wählen.
Kann ich mit Yurtiçi Kargo eine Lieferung am selben Tag durchführen?
Yurtiçi Kargo bietet in einigen Regionen innerhalb Istanbuls die Lieferoptionen „Schnell” und „Am selben Tag” an. Für diese Dienste muss der Parameter „ServiceType” in der API entsprechend eingestellt sein; dieser Dienst muss in Ihrem aktuellen Vertrag definiert sein. Dies gilt nicht für ganz Türkei.
Kann ich Yurtiçi Kargo zusammen mit einem anderen Versandunternehmen nutzen?
Ja. Shopify ermöglicht es Ihnen, mehrere Versandunternehmen gleichzeitig aktiv zu halten. Sie können verschiedenen Lieferregionen unterschiedliche Unternehmen zuweisen, z. B. Yurtiçi für Istanbul und Ankara und Aras Kargo für andere Provinzen. Diese Konfiguration wird im Abschnitt „Versandzonen” verwaltet.
Die Shopify-Integration von Yurtiçi Kargo automatisiert die Versandabläufe Ihres Shops zu 85 %, wenn sie ordnungsgemäß eingerichtet ist. Die offizielle App bietet eine leistungsstarke und kostenlose Lösung für kleine und mittlere Shops, während die spezielle API-Integration für große Shops mehr Flexibilität bietet.
Wenn Sie Ihren neuen Shopify-Shop von Grund auf neu einrichten, können Sie sich auf unserer Blog-Seite informieren.
Bei Nodus Works richten wir die Shopify-Integration von Yurtiçi Kargo und anderen Versandunternehmen technisch und operativ vollständig ein.
Inhalte, die Sie interessieren könnten:
Shopify-Versandintegration – https://nodusworks.com/blog/shopify-kargo-entegrasyonu
Shopify Aras Kargo-Integration – https://nodusworks.com/blog/aras-kargo-shopify-entegrasyonu-nasil-yapilir
Mng-Kargo-Integration – https://nodusworks.com/blog/mng-kargo-shopify-entegrasyonu-kurulum-ve-yapilandirma-rehberi
Fordern Sie ein kostenloses Beratungsgespräch an
