So integrieren Sie Aras Cargo Shopify (Aktueller Leitfaden 2026)

Die Shopify-Integration von Aras Cargo verbindet das Auftragsverwaltungssystem Ihres Shops mit der API-Infrastruktur von Aras Kargo, um automatisch Versandetiketten zu generieren und Tracking-Nummern sofort an den Kunden weiterzuleiten. In diesem Handbuch erklären wir Schritt für Schritt alle Methoden, von der offiziellen Anwendung von Aras Kargo im Shopify App Store bis hin zur benutzerdefinierten API-Integration.

Warum die Shopify-Integration von Aras Cargo wichtig ist

Aras Cargo ist eines der größten Frachtunternehmen in der Türkei mit dem größten Vertriebsnetz und befördert jährlich über 500 Millionen Sendungen. Die Integration Ihres Shopify-Shops in Aras Cargo reduziert den Zeitaufwand für das manuelle Etikettieren pro Bestellung von 3—5 Minuten auf Null und reduziert gleichzeitig die Fehlerquote von 4% auf weniger als 0,2%.

Die Integration von Aras Cargo ist aus betrieblicher Sicht ein obligatorischer Schritt für jedes Geschäft, das sich mit E-Commerce in der Türkei befasst und mehr als 50 Bestellungen pro Monat bearbeitet. Während beim manuellen Versand ein Mitarbeiter etwa 80 Etiketten pro Tag manuell drucken und einfügen kann, reduziert dieselbe Person diese Zeit, sobald die Integration eingerichtet ist, auf weniger als 10 Minuten und nutzt ihre Zeit, um sich auf das Wachstum des Kundendienstes zu konzentrieren.

Die Shopify-Compliance von Aras Kargo ist gegenüber konkurrierenden Reedereien insofern von Vorteil, als es sowohl die App Store-App für kleine Geschäfte als auch direkten API-Zugriff für Unternehmensanforderungen bietet.

Anforderungen vor der Integration

Drei grundlegende Anforderungen müssen erfüllt sein, bevor Aras Cargo mit der Shopify-Integration beginnen kann: Aras Cargo-Unternehmensvereinbarung, API-Zugangsinformationen und Shopify-Shop-Vorbereitung. Wenn einer dieser Schritte fehlt, gibt die Integration während der Installationsphase oder bei Erstbestellungen einen Fehler aus.

1. Unternehmensvereinbarung von Aras Cargo

Um auf die Aras Cargo API zugreifen zu können, müssen Sie zunächst den Firmenkundenvertrag von Aras unterzeichnen. Für den Vertrag wird das Antragsformular für einen Firmenkundenvertreter über aras.com.tr ausgefüllt. Der Vorgang dauert in der Regel 3—5 Arbeitstage. Gewöhnliche Einzelkonten, die einzelne Fracht versenden, sind für den API-Zugriff gesperrt.

Die Aushandlung des vereinbarten Versandpreises wird schneller abgeschlossen, wenn Sie den Agenten im Voraus über Ihr durchschnittliches monatliches Versandvolumen und Ihre Lieferregionen informieren. Bei Lieferungen in die westlichen Provinzen der Türkei (Istanbul, Izmir, Bursa) kann der Mengenrabatt von ARAS im Bereich von 15 bis 30% liegen.

2. Geben Sie API-Zugangsinformationen an

Sobald der Vertrag unterzeichnet ist, können Sie über das Aras-Unternehmensportal (b2b.araskargo.com.tr) auf Ihre API-Informationen zugreifen. In der folgenden Tabelle sind die für die Integration erforderlichen API-Parameter zusammengefasst:

⚠️ ACHTUNG: Das Aras Cargo API-Passwort kann gemäß den Sicherheitsrichtlinien alle 90 Tage erneuert werden. Denken Sie daran, die API-Einstellungen in der Shopify-App zu aktualisieren, wenn das Passwort erneuert wird. Andernfalls können keine Versandetiketten erstellt werden.

3. Vorbereitung des Shopify-Shops

Überprüfen Sie vor der Integration diese beiden Einstellungen im Shopify-Adminbereich: Stellen Sie zunächst sicher, dass für alle Produkte Gewichtsinformationen eingegeben wurden (Einstellungen > Produkte > Gewichtseinheit). Für Produkte ohne eingegebenes Gewicht verwendet die Aras-API standardmäßig 0,5 kg, was zu einer falschen Preisberechnung führt. Zweitens werden Versandzonen für die Türkei definiert.

Auswahl der Integrationsmethode

Die Shopify-Integration von Aras Cargo 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 falsche Methodenwahl bedeutet unnötige Kosten oder unzureichende Automatisierung.

HINWEIS: Wenn Sie weniger als 200 Bestellungen pro Monat bearbeiten, ist die offizielle Aras Kargo Shopify-App völlig ausreichend und kostenlos. Planen Sie den Übergang zur benutzerdefinierten API-Lösung, wenn Sie mehr als 500 Bestellungen erreichen.

Schritt für Schritt Aras Shipping Shopify einrichten (offizielle App)

Die offizielle Shopify-App von Aras Kargo bietet alle Funktionen, die für einen Standard-E-Commerce-Shop erforderlich sind: automatisches Etikett, Tracking-Nummer und Benachrichtigung. Die Installation kann in 1—3 Stunden abgeschlossen werden.

Schritt 1: Installieren Sie die App

1. Gehe in deinem Shopify-Adminbereich zu Apps → App Store.
2. Geben Sie 'Aras Cargo' in das Suchfeld ein.
3. Finden Sie die offizielle Aras Kargo App und klicken Sie auf die Schaltfläche „App hinzufügen“.
4. Bestätigen Sie auf dem App-Berechtigungsbildschirm mit „App installieren“.

Schritt 2: API-Informationen eingeben

5. Der Bildschirm mit den Anwendungseinstellungen wird geöffnet. Gehen Sie zu „Verbindungseinstellungen“ oder „API-Einstellungen“.
6. Geben Sie Ihre Aras-Firmenkundennummer in das Feld CustomerCode ein.
7. Geben Sie im Feld Passwort Ihr API-Passwort ein (das Passwort, das Sie vom Unternehmensportal erhalten haben).
8. Klicken Sie auf die Schaltfläche „Verbindung testen“ — erscheint die grüne Bestätigung, ist die Verbindung erfolgreich.

⚠️ WARNUNG: Wenn Sie auf der Test-Schaltfläche die Fehlermeldung „Verbindung fehlgeschlagen“ erhalten, löschen Sie zunächst die Leerzeichen am Anfang und Ende des CustomerCodes. Versteckte Leerzeichen sind ein häufiges Problem beim Kopieren und Einfügen.

Schritt 3: Frachtzonen definieren

1. Gehe zum Shopify-Adminbereich → Einstellungen → Versand und Lieferung → Verwalten.
2. Fügen Sie Aras Kargo als Frachtdienstleister für die Region „Türkei“ hinzu.
3. Konfiguriere die Versandpreise: Pauschalpreis (z. B. alle Bestellungen 49,90€), gewichtsabhängiger oder bedingter kostenloser Versand (z. B. über 500$).

Schritt 4: Testbestellung erstellen

4. Erstelle eine Testbestellung mit „Bestellung erstellen“ im Shopify-Adminbereich → Bestellungen.
5. Sobald die Bestellung bestätigt ist, überprüfen Sie, ob die Schaltfläche „Versandetikett erstellen“ auf dem Fulfillment-Bildschirm erscheint.
6. Erstellen Sie das Tag und überprüfen Sie, ob die Tracking-Nummer im Aras-Tracking-System (kargo.aras.com.tr) funktioniert.

Häufige Probleme und Lösungen

Die vier häufigsten Probleme bei der Integration von Aras Cargo Shopify sind ein Fehler bei der API-Authentifizierung, die Unfähigkeit, Tags zu erstellen, ein falsches Gewichtskonto und eine nicht fallende Tracking-Nummer. All diese Probleme können in wenigen Minuten gelöst werden.

Problem: Fehler „Authentifizierung fehlgeschlagen“

Lösung: Ihr API-Passwort ist möglicherweise abgelaufen. Rufen Sie das Aras Enterprise Portal auf, erneuern Sie Ihr API-Passwort und aktualisieren Sie das Passwort-Feld in der Shopify-App. Aras erneuert das Passwort bei Sicherheitsupdates automatisch und macht das alte Passwort ungültig.

Problem: Versandetikett wird nicht generiert

Lösung: Die Gewichtsinformationen von mindestens einem der Produkte in der Bestellung fehlen möglicherweise. Geben Sie die Gewichtsinformationen im Tab Produkte → [verwandtes Produkt] → Versand ein. Wenn die Lieferadresse zu einem Land außerhalb der Türkei gehört, generiert die Aras-API außerdem keine Etiketten; überprüfe die Einstellungen für die Versandzone.

Problem: Die Tracking-Nummer erscheint nicht in der E-Mail

Lösung: Vergewissern Sie sich, dass die Variable {{fulfillment.tracking_number}} unter Einstellungen → Benachrichtigungen → Vorlage für Versandbestätigungen verfügbar ist. In benutzerdefinierten E-Mail-Vorlagen wurde diese Variable möglicherweise gelöscht. Überprüfen Sie dies, indem Sie sie mit der ursprünglichen Shopify-Vorlage vergleichen.

Problem: Der Kunde hat eine falsche Versandgebühr

Lösung: Möglicherweise gibt es im Abschnitt Versandzonen mehr als eine widersprüchliche Regel. Listet alle Versandregeln auf und löscht unnötige oder sich überschneidende Regeln. Die spezifischste Regel (z. B. Istanbul) muss Vorrang vor der allgemeinen Regel (Türkei) haben.

Häufig gestellte Fragen

Ist die Integration von Aras Cargo Shopify kostenlos?

Die offizielle Aras Cargo Shopify-App kann kostenlos heruntergeladen und installiert werden. Die Versandkosten richten sich nach der Unternehmensvereinbarung, die Sie mit Aras unterzeichnet haben.

Wo kann ich Aras Cargo API-Informationen erhalten?

Informationen zur Aras Cargo API erhalten Sie, nachdem Sie den Firmenkundenvertrag über das Unternehmensportal b2b.araskargo.com.tr oder über den Ihnen zugewiesenen Firmenkundenvertreter unterzeichnet haben. Einzelne Absenderkonten sind für den API-Zugriff gesperrt.

Kann ich als Aras Cargo auf Shopify eine Lieferung am selben Tag anbieten?

Aras Kargo bietet in einigen Gebieten Istanbuls einen Lieferservice am selben Tag (AYS) an. Dieser Dienst kann aktiviert werden, indem der ServiceType-Parameter über die API auf 'AY' gesetzt wird. Dieser Service muss jedoch im Vertrag Ihres Shops definiert sein und die Versandzeiten (normalerweise bis 14:00 Uhr) müssen eingehalten werden.

Funktioniert die Aras Cargo-Integration nach der Migration von WooCommerce?

Jep. Nach Abschluss der Migration zu Shopify wird die Aras Cargo-Integration von Grund auf neu eingerichtet. Die alte Integration in WooCommerce wird nicht zu Shopify migriert. Ihre Bestellhistorie wird während des Migrationsprozesses beibehalten, aber die Versandintegration muss über den neuen Shop neu strukturiert werden.

So integrieren Sie Aras Cargo Shopify

Die Aras Cargo Shopify-Integration erfolgt, indem die offizielle Aras Cargo-App aus dem Shopify App Store installiert und die Aras-Firmenkundeninformationen (Kundennummer+API-Passwort) in die App eingegeben werden. Dazu muss zunächst ein Unternehmensvertrag mit Aras Cargo unterzeichnet und der API-Zugriff beantragt werden. Der gesamte Vorgang kann innerhalb von 1—3 Stunden abgeschlossen werden.

Hat Aras Kargo eine Shopify-App?

Ja, Aras Kargo hat eine offizielle App im Shopify App Store veröffentlicht. Die Anwendung umfasst die grundlegende Erstellung von Versandetiketten, die Integration von Tracking-Nummern und das Senden von Benachrichtigungen. Für großvolumige Operationen sollte eine spezielle API-Integration bevorzugt werden.

Warum funktioniert das Aras Cargo API-Passwort nicht?

Das Aras Cargo API-Passwort kann gemäß den Sicherheitsrichtlinien alle 90 Tage erneuert werden. Wenn das Passwort erneuert wird, wird die Verbindung in der Shopify-App getrennt. Für die Lösung holen Sie sich das neue API-Passwort aus dem Aras Enterprise Portal und aktualisieren Sie die Verbindungseinstellungen der Anwendung.

‍

Die Shopify-Integration von Aras Cargo automatisiert die Logistikprozesse Ihres Shops erheblich, wenn sie korrekt eingerichtet sind. Die offizielle Anwendung ist ein leistungsstarker Ausgangspunkt für kleine und mittlere Geschäfte. Da sie skaliert wird, kann der Übergang zu Middleware oder benutzerdefinierten API-Lösungen problemlos erfolgen.

‍

Kontaktieren Sie uns, um Ihre Aras Cargo-Integration mit Nodus Works einzurichten. Das erste Interview ist kostenlos.

Fordern Sie jetzt eine kostenlose Integrationsberatung an

‍