Skip to main content
First Delivery (firstdelivery.com) ist ein Lieferaggregator: Ein einziges Konto disponiert Ihre Bestellungen über sein Netzwerk von Kurierpartnern (etwa DoorDash, Uber und Relay sowie eigene Kurierflotten) gemäß Firsts Routing für das jeweilige Gebiet. Die storekit-Integration sendet angenommene Lieferbestellungen automatisch zur Disposition an First und empfängt Live-Statusaktualisierungen zurück auf die Bestellseite des Kunden.

​
Überblick

  • Aggregierte Disposition: Eine Verbindung erreicht das gesamte Kurier-Netzwerk von First
  • Automatische Disposition: Bestellungen werden automatisch an First gesendet, sobald Sie sie annehmen
  • Live-Tracking: Kurier-Statusaktualisierungen fließen zurück auf die storekit-Bestellseite
  • Abdeckung je Standort: Welche Kuriere ein Standort nutzen kann, hängt vom First-Händlerstandort (dessen Adresse und Gebiet) ab, nicht davon, was storekit sendet
First Delivery entscheidet auf Basis des von Ihnen verbundenen Händlerstandorts, welches Kurier-Netzwerk den jeweiligen Auftrag ausführt. storekit wählt den Kurier nicht aus – storekit disponiert die Bestellung und leitet den von First gemeldeten Status weiter.

​
Bevor Sie beginnen

Sie benötigen:
  • Ein First-Delivery-Konto mit einem API key (aus Ihrem First-Konto)
  • Eine vollständige Standortadresse in storekit (wird verwendet, um Ihren First-Händlerstandort zuzuordnen oder neu anzulegen)
  • Aktivierte Lieferung im Store (siehe Lieferung aktivieren)

​
Einrichtung

  1. Gehen Sie in storekit zu Stores → Ihr Store → Settings → Integrations
  2. Wählen Sie First Delivery
  3. Fügen Sie auf der Seite First Delivery Settings Ihren Schlüssel in API key ein und klicken Sie auf Load merchants Beim Laden der Händler wird der Schlüssel gleichzeitig validiert – lehnt First ihn ab, werden Sie aufgefordert, den Schlüssel zu prüfen und es erneut zu versuchen.
  4. Wählen Sie unter Merchant location den Händler aus, der zu diesem Standort passt. Wenn für Ihren Schlüssel keine Standorte gefunden werden, nutzen Sie Create this venue as a new First location (siehe unten).
  5. Setzen Sie Integration status auf aktiviert – der Schalter zeigt im eingeschalteten Zustand “Enabled - dispatching orders to First Delivery”.
  6. Klicken Sie auf Save.
Sie müssen vor dem Speichern eine Merchant location auswählen. Beim Speichern ohne Auswahl erscheint “Select a merchant location first”, und die Einstellungen werden nicht gespeichert.
Make sure your account has valid billing / payment details before you start taking delivery orders. If billing details are missing or a payment fails, can refuse to create delivery jobs even though storekit accepts and charges the order — check this in your account first if an order is paid but no delivery appears, then contact support with the order so we can look into it and, where possible, arrange the delivery manually.

​
Einen First-Standort aus Ihrem Venue anlegen

Wenn Ihr API-Schlüssel für diesen Standort noch keinen Händlerstandort hat, klicken Sie unter Merchant location auf Create this venue as a new First location. storekit legt bei First aus den Daten dieses Venues live einen Standort-Datensatz an und wählt ihn für Sie aus.
Das Anlegen eines First-Standorts erfolgt live und kann nicht rückgängig gemacht werden – storekit fordert Sie zunächst zur Bestätigung auf. First weist den Standort der Lieferzone (Cohort) zu, die die Adresse des Venues abdeckt.
Wenn First den Standort nicht anlegen kann, zeigt storekit den Grund an:
Wenn der ausgewählte Händler an einem anderen Ort zu liegen scheint als Ihr Venue, warnt storekit, dass die Adresse des gewählten Händlers nicht übereinzustimmen scheint – die falsche Auswahl schickt Kuriere an den falschen Ort, also prüfen Sie das vor dem Speichern gründlich.

​
Den API-Schlüssel ersetzen

Sobald ein Schlüssel gespeichert ist, zeigt das Feld API key den Text “API key saved ●●●●” zusammen mit einer Schaltfläche Replace key an. Klicken Sie auf Replace key, um einen neuen Schlüssel einzugeben, und dann auf Load merchants, um ihn zu validieren und die Händlerliste zu aktualisieren.

​
Funktionsweise

  1. Ein Kunde gibt eine Lieferbestellung in Ihrem storekit-Store auf
  2. Wenn Sie die Bestellung annehmen, disponiert storekit sie an First Delivery
  3. First leitet den Auftrag an einen Kurier in seinem Netzwerk für das Gebiet des Händlerstandorts weiter
  4. Kurier-Statusaktualisierungen kommen zurück in storekit an und werden auf der Bestellseite des Kunden angezeigt
  5. Wird die Bestellung in storekit storniert, storniert storekit auch die Lieferung bei First

​
Abholzeit

Firsts Abholzeit ist der Zeitpunkt, zu dem der Kurier bei Ihrem Standort abholt; storekit rechnet sie daher ausgehend von der geschätzten Lieferzeit des Kunden über die Lieferstrecke zurück. Vorbestellungen benötigen eine Abholung mehr als etwa 20 Minuten in der Zukunft; alles darunter wird als ASAP disponiert.

​
Statusaktualisierungen der Lieferung

storekit ordnet die Kurier-Status von First den Tracking-Zuständen zu, die Kunden sehen, unter anderem:

​
Verwandt