Zum Hauptinhalt springen
Zu nevuto.com

Geliver mit Nevuto verbinden

Veröffentlicht am 20. Mai 20269 Min. LesezeitVor 1 Woche aktualisiert

Was ist Geliver?

Geliver ist ein türkischer Multi-Carrier-Versand-Aggregator, der sich auf schnellen, nachverfolgbaren Versand für Online-Shops konzentriert. Über eine einzige API kannst du mit Aras Kargo, Yurtiçi Kargo, MNG, PTT, Sürat Kargo, HepsiJet, Kolay Gelsin und Paket Taksi versenden. Für Nevuto-Händler, die in der Türkei verkaufen, ist Geliver eine der schnellsten Möglichkeiten, zuverlässigen Inlandsversand hinzuzufügen, ohne mit jedem Kurier einzeln zu verhandeln.

Wie Nevuto Geliver verwaltet

  • Nevuto verbindet sich über die offizielle Versand-API mit Geliver, indem du einen API-Token in deinem Geliver-Händlerportal erzeugst.
  • Bei der Abwicklung einer Bestellung wählt Geliver das günstigste Angebot aus deinen ausgewählten Carriern.
  • Für jede Nevuto-Bestellung wird mit einem Klick im Bestellbildschirm ein Geliver-Versandetikett erzeugt — als PDF druckbereit.
  • Sendungsverfolgungsnummern werden automatisch in die Bestellung zurückgeschrieben, und die Kundschaft erhält den Tracking-Link in der Versandbestätigungs-E-Mail.
  • Statusaktualisierungen (unterwegs / zugestellt) laufen automatisch über den Geliver-Webhook ein — kein manueller Eingriff nötig.

1. Voraussetzungen

  • Ein aktives Geliver-Konto. Falls du keins hast, registriere dich auf geliver.io.
  • Mindestens eine Absenderadresse, die in deinem Geliver-Konto hinterlegt ist. Füge sie im Geliver-Portal unter Adressen hinzu.
  • Mindestens ein Carrier-Vertrag muss in deinem Geliver-Konto aktiv sein. Wähle im Geliver-Marketplace die Carrier aus, die du verwenden möchtest.
  • Deine Shop-Währung muss TRY sein. Geliver liefert TL-basierte Preise; ein Import aus einem Shop in einer anderen Währung ist nicht möglich (das System blockiert es).

2. Geliver-API-Token

  1. Melde dich im Geliver-Portal an.
  2. Gehe zu Konto → API & Integrationen.
  3. Erzeuge einen neuen API-Token (oder nutze einen bestehenden).
  4. Kopiere den Token — du fügst ihn im nächsten Schritt in Nevuto ein.

⚠️ Der Token ist vertraulich, teile ihn mit niemandem. Bei Verdacht auf Leak im Geliver-Portal widerrufen und neu erzeugen.

3. Geliver in Nevuto verbinden

  1. Gehe im Nevuto-Admin-Panel zu Settings → Shipping → Shipping providers.
  2. Wähle Geliver aus der Liste.
  3. Füge den von Geliver kopierten Token in das Feld API key ein.
  4. Schalte den Toggle Enable shipping method ein.
  5. (Optional) Schalte Test mode ein, um Testsendungen an Geliver zu schicken, ohne echte Etiketten zu kaufen. Vor dem Live-Gang empfohlen.
  6. Klicke auf Submit.

Sobald der API-Key gespeichert ist, erscheint darunter eine Settings-Karte für Geliver-spezifische Einstellungen.

4. Absenderadresse

  • Auto-resolve (Standard): Verwendet automatisch die "default sender"-Adresse aus deinem Geliver-Konto.
  • Eine bestimmte Adresse wählen: Wähle aus dem Dropdown eine deiner in Geliver hinterlegten Adressen.

Wenn dein Geliver-Konto mehrere Absenderadressen enthält (z. B. Hauptlager + zweite Filiale) und du von einer bestimmten Adresse versenden möchtest, lege das hier fest.

5. Bevorzugte Carrier

In diesem Schritt legst du fest, zwischen welchen Carriern Geliver auswählt.

  1. Wähle einen oder mehrere Carrier aus dem Dropdown (Aras, Yurtiçi, MNG, PTT, Sürat, HepsiJet, Kolay Gelsin, Paket Taksi).
  2. Submit.

Verhalten:

  • Bei der Abwicklung wählt Geliver das günstigste Angebot aus deinen ausgewählten Carriern.
  • Wenn du keine auswählst, nutzt Geliver seinen eigenen Standard-Vorschlag ("cheapest").
  • Wenn keiner der ausgewählten Carrier die Route bedient, fällt es automatisch auf "cheapest" zurück (die Bestellung wird nicht blockiert).

💡 Tipp: Wähle nur Carrier aus, mit denen du einen Vertrag hast und die in deinem Geliver-Konto aktiv sind. Inaktive Carrier erscheinen nicht in der Preisreferenztabelle.

6. Carrier-Preisreferenz

Nachdem du die bevorzugten Carrier gespeichert hast, öffnet sich darunter eine Preisreferenztabelle.

Was wird angezeigt?

  • Die von Geliver veröffentlichten desi-basierten Preise für deine ausgewählten Carrier.
  • Für feste Desi-Werte (1, 2, 3, 5, 10, 15, 20, 30) der TL-Preis pro Carrier inkl. MwSt.
  • "—" bedeutet, dass der Carrier keinen Preis für dieses Desi liefert (meist weil er nicht aktiv ist oder dieses Gewicht nicht annimmt).

Wie nutzt du es?

  1. Prüfe die Tabelle — welcher Carrier ist in welchem Desi-Tier am günstigsten?
  2. Nutze diese Preise als Referenz, wenn du deine eigenen Versandtarife baust. Schlage einen Aufschlag drauf, um den Preis festzulegen, den deine Kundschaft zahlt.
  3. Aktiviere die Checkbox am Ende jeder Zeile → beim Submit werden automatisch Versandregeln erstellt:
    • min_desi → max_desi: gestaffelte Tarife aus den ausgewählten Desi-Werten (z. B. 1, 5, 10 → 0–1, 1–5, 5–10 Desi-Tiers).
    • Preis: der höchste Preis der ausgewählten Carrier in dieser Zeile (Worst Case, damit du keinen Verlust machst).
    • Name: Carrier mit Maximalpreis + Desi (z. B. "Aras Kargo — up to 5 desi").
    • Regeln werden zur ersten Zone des default shipping profile deines Shops hinzugefügt.
  4. Du kannst diese Regeln später unter Settings → Shipping → Rates manuell bearbeiten (z. B. um einen Aufschlag hinzuzufügen).

⚠️ Diese Funktion arbeitet nur, wenn deine Shop-Währung TRY ist. In Shops mit USD/EUR usw. erscheint eine Warnung und die Checkboxen sind deaktiviert.

7. Versandpakete

Für den Versand über Geliver werden Paketmaße (Länge × Breite × Höhe + Gewicht) benötigt. Die Ermittlung erfolgt in dieser Reihenfolge:

  1. Variant LWH — direkt am Produkt-Variant eingetragen.
  2. ShippingPackage-Referenz — wenn der Variant einem Paket-Template zugewiesen ist, dessen Maße.
  3. Shop-Default-Paket — das in Settings → Shipping → Packages als "Default" markierte Paket.
  4. Letzte Instanz: 20×20×20 cm Fallback.

Schritte:

  1. Gehe zu Settings → Shipping → Packages.
  2. Add package → Name, Typ (Box/Envelope/Soft pack), L/B/H/Einheit, Gewicht.
  3. Ein "Standard package" wurde bei der Shop-Einrichtung automatisch erstellt; du musst nur die Maße aktualisieren.
  4. Set as default → markiere ein Paket als shop-weiten Fallback.

💡 Wenn du eine breite Produktpalette verkaufst: definiere mehrere Paket-Templates (Small box, Medium box, Large box) und weise sie deinen Varianten zu.

8. Variant LWH

Für den genauesten Preis empfehlen wir, an jeder Variante echte Maße einzutragen:

  1. Products → Produkt bearbeiten → Variants-Tab.
  2. Fülle Length / Width / Height / Weight in jeder Zeile aus.
  3. Wähle als Einheit cm oder in.

Sind keine Maße am Variant gesetzt, fällt es auf ShippingPackage, dann den Shop-Default und schließlich auf 20×20×20 cm zurück.

9. Fulfilment-Ablauf

Sobald die Kundschaft bezahlt hat, erscheint die Bestellung in deinem Admin mit einem "Mark as shipped"-Button und ist versandbereit.

  1. Öffne die Order-Detail-Seite.
  2. Klicke auf den Button Mark as shipped.
  3. Im sich öffnenden Modal wählst du als Provider Geliver und klickst auf Submit.
    • Für die seltenen Fälle, in denen du außerhalb von Geliver versendest, kannst du Manual wählen und die Tracking-Nummer von Hand eintragen — diese Option erzeugt keine Geliver-Sendung.
  4. Innerhalb weniger Sekunden erscheinen in der Bestellzeile die Tracking-Nummer, der Tracking-Link und der "Print label"-Button. Gleichzeitig wird die Etikettengebühr von deinem Geliver-Guthaben abgebucht.
  5. Klicke auf Print label, um das Versandschein-PDF zu öffnen, drucke es aus und klebe es auf das Paket.
  6. Übergib das Paket dem ausgewählten Carrier — alles Weitere wird automatisch verfolgt. Auf der Order-Detail-Seite siehst du den Hinweis "Shipping status is updated automatically by the carrier".

💡 Deine Kundschaft kann die Sendung über den Tracking-Link auf ihrer eigenen Bestellseite verfolgen und erhält bei jedem Statuswechsel eine E-Mail-Benachrichtigung.

10. Status-Lifecycle

Nach dem Versand laufen Statusaktualisierungen automatisch ein:

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Etikett gedruckt, Kurier hat noch nicht abgeholt
    │
    ▼   Kurier scannt das Paket
[shipping_status: SHIPPED]         ← Webhook löst aus, "Shipped"-E-Mail an Kundschaft
    │
    ▼   An Kundschaft zugestellt
[shipping_status: DELIVERED]       ← Webhook, "Delivered"-E-Mail an Kundschaft

Wie es funktioniert:

  1. Beim Speichern der Geliver-Integration registriert Nevuto automatisch einen Webhook in deinem Geliver-Konto.
  2. Wenn der Carrier das Paket scannt, benachrichtigt Geliver Nevuto.
  3. Nevuto empfängt es, findet die Bestellung über die Tracking-Nummer und aktualisiert den Status.
  4. SHIPPED → OrderShippedEvent → Bestand wird reduziert, Kundschaft erhält eine E-Mail.
  5. DELIVERED → OrderDeliveredEvent → Zustellungs-E-Mail an die Kundschaft.

Kein manueller Eingriff nötig. Ändere den Bestellstatus nicht selbst — der Webhook würde ihn überschreiben.

11. SMS-Benachrichtigungen

  • Nevuto sendet Benachrichtigungen per E-Mail (Order shipped / Order delivered).
  • Nevuto sendet keine SMS.
  • Geliver bzw. der dahinterliegende Carrier sendet SMS an die Kundschaft (Standardverhalten in der Türkei — Kuriere senden automatisch eine SMS an die Empfängernummer).
  • Prüfe gegebenenfalls die SMS-Einstellungen im Geliver-Portal.

12. Test-Modus

Teste unbedingt, bevor du live gehst:

  1. Aktiviere in den Geliver-Einstellungen Test mode und speichere.
  2. Lege im Storefront eine echte Bestellung an (in TRY, kleiner Betrag — z. B. ein 1-₺-Produkt).
  3. Schließe die Zahlung ab (Stripe-Test-Card oder ein anderes Test-Gateway).
  4. Im Admin: Mark as shipped → Geliver wählen → Submit.
  5. Ergebnis:
    • Erscheint in deinem Geliver-Portal als Test-Sendung.
    • Es wird kein echtes Etikett gekauft.
    • Eine Tracking-Nummer wird zurückgeliefert, aber es gibt keinen echten Kurier.
  6. Nach erfolgreicher Verifikation Test mode abschalten und live gehen.

13. Häufige Probleme

Fehler "Geliver API key missing" Du hast einen leeren API-Key gespeichert. Gib den Token erneut unter Settings → Shipping → Geliver → API key ein.

Geliver-Fehler "City not found / district not found" Die Stadt/Bezirk-Werte der Kundenadresse passen nicht zum erwarteten Geliver-Format. Nevuto mappt automatisch (province_code → il, city → ilçe), aber in einigen Edge Cases schlägt das fehl. Prüfe die Adresse — vor allem das Feld "ilçe" sollte eindeutig sein (vollständiger Name, keine Abkürzung).

Preisreferenztabelle ist leer

  • Keine Checkbox ausgewählt: Füge bei den bevorzugten Carriern mindestens einen Carrier hinzu und speichere.
  • Überall "—": Die ausgewählten Carrier sind in deinem Geliver-Konto nicht aktiv. Prüfe Vertrag/Aktivierungsstatus im Geliver-Portal.
  • Währungswarnung: Dein Shop ist nicht in TRY. Preise werden zwar angezeigt, aber die Checkboxen sind deaktiviert — kein Import möglich.

Bestellungen gehen automatisch an Geliver (ohne "Mark as shipped" zu klicken) Dieses Verhalten wurde am 2026-05-20 behoben. Falls es noch auftritt, wurde der PHP-Queue-Worker möglicherweise nicht neu gestartet. Workers neu starten.

Tracking-URL kommt nicht / zeigt "—" Das trackingUrl-Feld von Geliver kann leer sein, bis der Carrier das Paket abholt. Als Fallback verwendet Nevuto https://app.geliver.io/tracking/{shipmentId} — dieser Link verweist auf das Geliver-Portal.

Webhook kommt nicht an / Status wird nicht aktualisiert

  • Prüfe, ob in deinem Geliver-Konto ein Webhook registriert ist (Geliver-Portal → API → Webhooks).
  • Gehe im Nevuto-Admin zu den Geliver-Einstellungen und klicke erneut auf Submit — der Webhook wird automatisch neu registriert.

14. Nächste Schritte

  • Beobachte Produktionsbestellungen in der ersten Woche — gleiche Geliver-Portal und Nevuto auf Konsistenz ab.
  • Füge deinen Versandtarifen einen Aufschlag hinzu — die aus der Referenztabelle importierten Tarife sind Selbstkostenpreise; aktualisiere sie auf den Betrag, den du der Kundschaft berechnen möchtest.
  • In Saisonspitzen halte das Geliver-Portal offen — verfolge Verzögerungen/Rücksendungen auch dort.

Hilfe

Bei Problemen mit der Geliver-API oder der Nevuto-Integration:

Verwandte Artikel