Die Aras Kargo Shopify-Integration verbindet das Bestellverwaltungssystem Ihres Shops mit der API-Infrastruktur von Aras Kargo, erstellt automatisch Versandetiketten und übermittelt die Sendungsverfolgungsnummern sofort an den Kunden. In diesem Leitfaden erklären wir Schritt für Schritt alle Methoden, von der offiziellen App von Aras Kargo im Shopify App Store bis hin zur speziellen API-Integration.
Warum ist die Aras Kargo Shopify-Integration wichtig?
Aras Kargo ist eines der Versandunternehmen mit dem größten Vertriebsnetz in der Türkei und befördert jährlich über 500 Millionen Sendungen. Durch die Integration Ihres Shopify-Shops mit Aras Kargo reduzieren Sie den manuellen Zeitaufwand für die Etikettierung pro Bestellung von 3–5 Minuten auf null und senken die Fehlerquote von 4 % auf unter 0,2 %.
Für jeden Shop, der in der Türkei E-Commerce betreibt und monatlich mehr als 50 Bestellungen bearbeitet, ist die Integration von Aras Kargo aus betrieblicher Sicht ein unverzichtbarer Schritt. Während ein Mitarbeiter im manuellen Versandprozess täglich etwa 80 Etiketten von Hand ausdrucken und aufkleben kann, reduziert dieselbe Person nach der Integration diesen Zeitaufwand auf unter 10 Minuten und kann sich stattdessen auf den Kundenservice und das Wachstum des Unternehmens konzentrieren.
Die Shopify-Kompatibilität von Aras Kargo ist sowohl für kleine Geschäfte als auch für Unternehmen von Vorteil, da sie eine App Store-Anwendung und direkten API-Zugriff bietet.
Voraussetzungen vor der Integration
Bevor mit der Shopify-Integration von Aras Kargo begonnen werden kann, müssen drei grundlegende Voraussetzungen erfüllt sein: der Unternehmensvertrag mit Aras Kargo, die API-Zugangsdaten und die Vorbereitung des Shopify-Shops. Fehlt einer dieser Schritte, kommt es während der Integrationsphase oder bei den ersten Bestellungen zu Fehlern.
1. Aras Kargo-Unternehmensvertrag
Um auf die Aras Kargo API zugreifen zu können, müssen Sie zunächst den Unternehmensvertrag von Aras unterzeichnen. Für den Vertrag füllen Sie das Formular zur Anforderung eines Unternehmenskundenvertreters auf aras.com.tr aus. Der Vorgang dauert in der Regel 3–5 Werktage. Normale Privatkonten für den Versand einzelner Sendungen haben keinen API-Zugang.
Wenn Sie dem Vertreter im Voraus Ihr durchschnittliches monatliches Versandvolumen und Ihre Liefergebiete mitteilen, kann die Verhandlung über den vereinbarten Frachtpreis schneller abgeschlossen werden. Bei Sendungen in die westlichen Provinzen der Türkei (Istanbul, Izmir, Bursa) kann der Mengenrabatt von Aras zwischen 15 und 30 % liegen.
2. API-Zugangsdaten anfordern
Nach Unterzeichnung des Vertrags können Sie über das Unternehmensportal von Aras (b2b.araskargo.com.tr) auf Ihre API-Daten zugreifen. Die folgende Tabelle fasst die für die Integration erforderlichen API-Parameter zusammen:
⚠️ ACHTUNG: Das Aras Kargo API-Passwort kann gemäß den Sicherheitsrichtlinien alle 90 Tage erneuert werden. Vergessen Sie nicht, die API-Einstellungen in der Shopify-Anwendung zu aktualisieren, wenn das Passwort erneuert wurde, da sonst keine Versandetiketten erstellt werden können.
3. Vorbereitung des Shopify-Shops
Überprüfen Sie vor der Integration die folgenden beiden Einstellungen im Shopify-Admin-Panel: Erstens, dass die Gewichtsangaben für alle Produkte eingegeben wurden (Einstellungen > Produkte > Gewichtseinheit). Für Produkte, für die kein Gewicht angegeben wurde, verwendet die Aras-API standardmäßig 0,5 kg, was zu falschen Preisberechnungen führt. Zweitens, dass die Lieferzonen (Shipping zones) für die Türkei definiert sind.
Auswahl der Integrationsmethode
Die Aras Kargo Shopify-Integration kann auf drei verschiedene Arten eingerichtet werden. Die Wahl der richtigen Methode hängt von Ihrem monatlichen Bestellvolumen, Ihrer technischen Infrastruktur und Ihrem Budget ab. Die Wahl der falschen Methode führt zu unnötigen Kosten oder unzureichender Automatisierung.
TIPP: Wenn Sie weniger als 200 Bestellungen pro Monat bearbeiten, ist die offizielle Aras Kargo Shopify-App völlig ausreichend und kostenlos. Wenn Sie 500+ Bestellungen erreichen, planen Sie den Wechsel zu einer speziellen API-Lösung.
Schritt für Schritt zur Einrichtung von Aras Kargo Shopify (offizielle App)
Die offizielle Shopify-App von Aras Kargo bietet alle Funktionen, die für einen Standard-E-Commerce-Shop erforderlich sind: automatische Etikettierung, Sendungsverfolgungsnummer und Benachrichtigungen. Die Einrichtung kann innerhalb von 1–3 Stunden abgeschlossen werden.
Schritt 1: Laden Sie die App herunter
- Gehen Sie in Ihrem Shopify-Admin-Panel zu Apps → App Store.
- Geben Sie „Aras Kargo” in das Suchfeld ein.
- Suchen Sie die offizielle Aras Kargo-App und klicken Sie auf die Schaltfläche „Add app” (App hinzufügen).
- Bestätigen Sie auf dem App-Berechtigungsbildschirm mit „Install app”.
Schritt 2: Geben Sie die API-Informationen ein
- Der App-Einstellungsbildschirm wird geöffnet. Gehen Sie zum Abschnitt „Verbindungseinstellungen“ oder „API-Einstellungen“.
- Geben Sie Ihre Aras-Firmenkundennummer in das Feld „CustomerCode“ ein.
- Geben Sie Ihr API-Passwort (das Sie vom Unternehmensportal erhalten haben) in das Feld „Password“ ein.
- Klicken Sie auf die Schaltfläche „Verbindung testen“ – wenn eine grüne Bestätigung angezeigt wird, ist die Verbindung erfolgreich hergestellt.
⚠️ WARNUNG: Wenn Sie beim Klicken auf die Schaltfläche „Testen“ die Fehlermeldung „Verbindung fehlgeschlagen“ erhalten, löschen Sie zunächst die Leerzeichen am Anfang und am Ende des CustomerCode. Beim Kopieren und Einfügen kommt es häufig zu Problemen mit versteckten Leerzeichen.
Schritt 3: Versandregionen definieren
- Gehen Sie zu Shopify Admin → Einstellungen → Versand und Lieferung → Verwalten.
- Fügen Sie Aras Kargo als Versanddienstleister für die Region „Türkei“ hinzu.
- Konfigurieren Sie die Versandkosten: Festpreis (z. B. 49,90 TL für alle Bestellungen), gewichtsabhängiger oder bedingter kostenloser Versand (z. B. über 500 TL).
Schritt 4: Testbestellung erstellen
- Erstellen Sie im Bereich Shopify Admin → Bestellungen mit „Bestellung erstellen” eine Testbestellung.
- Nachdem die Bestellung bestätigt wurde, überprüfen Sie, ob auf dem Bildschirm „Fulfillment” die Schaltfläche „Versandetikett erstellen” angezeigt wird.
- Erstellen Sie das Etikett und überprüfen Sie im Aras-Tracking-System (kargo.aras.com.tr), ob die Tracking-Nummer funktioniert.
Häufige Probleme und Lösungen
Die vier häufigsten Probleme bei der Integration von Aras Kargo in Shopify sind API-Authentifizierungsfehler, Probleme beim Erstellen von Etiketten, falsche Gewichtsberechnungen und fehlende Sendungsverfolgungsnummern. Alle diese Probleme können innerhalb weniger Minuten behoben werden.
Problem: Fehler „Authentication Failed”
Lösung: Möglicherweise ist Ihr API-Passwort abgelaufen. Melden Sie sich beim Aras-Unternehmensportal an, erneuern Sie Ihr API-Passwort und aktualisieren Sie das Passwortfeld in der Shopify-Anwendung. Aras erneuert das Passwort bei Sicherheitsupdates automatisch und macht das alte Passwort ungültig.
Problem: Versandetikett wird nicht erstellt
Lösung: Möglicherweise fehlen die Gewichtsangaben für mindestens eines der Produkte in der Bestellung. Geben Sie die Gewichtsangaben unter „Produkte“ → [betreffendes Produkt] → „Versand“ ein. Wenn die Lieferadresse außerhalb der Türkei liegt, erstellt die Aras-API keinen Etikett. Überprüfen Sie die Einstellungen für die Versandzone.
Problem: Die Sendungsverfolgungsnummer wird in der E-Mail nicht angezeigt
Lösung: Überprüfen Sie, ob die Variable {{ fulfillment.tracking_number }} in der Vorlage „Einstellungen → Benachrichtigungen → Versandbestätigung“ vorhanden ist. In benutzerdefinierten E-Mail-Vorlagen kann diese Variable gelöscht worden sein; überprüfen Sie dies anhand der Originalvorlage von Shopify.
Problem: Falsche Versandkosten werden dem Kunden berechnet
Lösung: Im Abschnitt „Versandzonen“ können mehrere sich überschneidende Regeln vorhanden sein. Listen Sie alle Versandregeln auf und löschen Sie unnötige oder sich überschneidende Regeln. Die spezifischste Regel (z. B. Istanbul) sollte Vorrang vor der allgemeinen Regel (Türkei) haben.
Häufig gestellte Fragen
Ist die Integration von Aras Kargo in Shopify kostenlos?
Die offizielle Aras Kargo Shopify-App kann kostenlos heruntergeladen und installiert werden. Die Versandkosten werden durch den Unternehmensvertrag festgelegt, den Sie mit Aras unterzeichnet haben.
Wo erhalte ich die Aras Kargo API-Daten?
Die Aras Kargo API-Informationen erhalten Sie nach Unterzeichnung des Unternehmensvertrags über das Unternehmensportal b2b.araskargo.com.tr oder über den Ihnen zugewiesenen Unternehmenskundenbetreuer. Einzelne Absenderkonten haben keinen API-Zugriff.
Kann ich mit Aras Kargo bei Shopify eine Lieferung am selben Tag anbieten?
Aras Kargo bietet in einigen Regionen innerhalb von Istanbul einen Same-Day-Lieferservice (AYS) an. Dieser Service kann über die API aktiviert werden, indem der Parameter „ServiceType” auf „AY” gesetzt wird. Allerdings muss dieser Service in Ihrem Shop-Vertrag definiert sein und die Lieferzeiten (in der Regel bis 14:00 Uhr) müssen eingehalten werden.
Funktioniert die Aras Kargo-Integration auch nach dem Wechsel von WooCommerce?
Ja. Nach Abschluss der Umstellung auf Shopify wird die Aras Kargo-Integration von Grund auf neu eingerichtet; die alte Integration in WooCommerce wird nicht auf Shopify übertragen. Ihre Bestellhistorie bleibt während der Umstellung erhalten, aber die Versandintegration muss über den neuen Shop neu konfiguriert werden.
Wie wird die Aras Kargo Shopify-Integration durchgeführt?
Die Aras Kargo Shopify-Integration erfolgt durch das Herunterladen der offiziellen Aras Kargo-App aus dem Shopify App Store und die Eingabe der Aras-Unternehmenskundendaten (Kundennummer + API-Passwort) in die App. Dazu muss zuvor ein Unternehmensvertrag mit Aras Kargo unterzeichnet und API-Zugriff beantragt worden sein. Der gesamte Vorgang kann innerhalb von 1–3 Stunden abgeschlossen werden.
Gibt es eine Shopify-App von Aras Kargo?
Ja, Aras Kargo hat eine offizielle App im Shopify App Store veröffentlicht. Die App umfasst grundlegende Funktionen wie die Erstellung von Versandetiketten, die Integration von Sendungsverfolgungsnummern und das Versenden von Benachrichtigungen. Für großvolumige Vorgänge sollte eine spezielle API-Integration bevorzugt werden.
Warum funktioniert das Aras Kargo API-Passwort nicht?
Das Aras Kargo API-Passwort kann gemäß den Sicherheitsrichtlinien alle 90 Tage erneuert werden. Wenn das Passwort erneuert wird, wird die Verbindung zur Shopify-App unterbrochen. Um das Problem zu beheben, rufen Sie das neue API-Passwort vom Aras-Unternehmensportal ab und aktualisieren Sie die Verbindungseinstellungen der App.
Die Aras Kargo Shopify-Integration automatisiert die Logistikprozesse Ihres Shops erheblich, wenn sie richtig eingerichtet ist. Die offizielle App ist ein guter Ausgangspunkt für kleine und mittelständische Shops; mit zunehmender Größe kann problemlos auf Middleware oder spezielle API-Lösungen umgestellt werden.
Um Versandunternehmen in Shopify vergleichend zu bewerten, können Sie unseren Artikel „Shopify-Versandintegration: Der vollständige Leitfaden” lesen.
Wenn Sie von einer anderen Plattform zu Shopify wechseln, ist der Technische Leitfaden zum Wechsel zu Shopify eine unverzichtbare Ressource.
Kontaktieren Sie uns, um Ihre Aras Kargo-Integration mit Nodus Works einzurichten. Das erste Gespräch ist kostenlos.
Fordern Sie jetzt eine kostenlose Integrationsberatung an
