> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lieferaggregation über First Delivery

> First Delivery mit storekit verbinden, um Bestellungen automatisch über DoorDash, Uber, Relay und eigene Kuriere zu disponieren, mit Live-Tracking.

First Delivery ([firstdelivery.com](https://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

> [!NOTE]
>
> 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](/docs/de/guides/fulfillment/delivery/enabling-delivery))

## 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**.

> [!WARNING]
>
> 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.

> [!NOTE]
>
> Make sure your {props_0.provider} account has valid billing / payment details before you start taking delivery orders. If billing details are missing or a payment fails, {props_0.provider} can refuse to create delivery jobs even though storekit accepts and charges the order — check this in your {props_0.provider} account first if an order is paid but no delivery appears, then [contact support](/docs/getting-started/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.

> [!WARNING]
>
> 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:

| Meldung | Bedeutung |
| - | - |
| *"This venue doesn't have a usable address in storekit. Add one before creating a First location."* | Der Standort hat keine für First nutzbare Adresse – fügen Sie zuerst unter **Stores** → Ihr Store → **Settings** → **General** eine hinzu. |
| *"First has no delivery zone covering this venue. Please contact First to extend coverage."* | Der Standort liegt außerhalb sämtlicher First-Lieferzonen. First muss die Abdeckung erweitern, bevor Sie hier bereitstellen können. |
| *"First couldn't locate this venue's address. Please check the venue address and try again."* | First konnte die Adresse nicht geokodieren – korrigieren Sie die Standortadresse und versuchen Sie es erneut. |

> [!NOTE]
>
> 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:

| First-Status | Kundenseitiger Zustand |
| - | - |
| Runner assigned | Fahrer zugewiesen |
| En route to pickup | Auf dem Weg zum Store |
| Picked up | Abgeholt |
| En route to dropoff | In Zustellung |
| Arrived at dropoff | Trifft ein |
| Completed | Zugestellt |
| Cancelled | Lieferung storniert |

## Verwandt

* [Lieferung aktivieren](/docs/de/guides/fulfillment/delivery/enabling-delivery) – Lieferbestellungen für Ihren Store aktivieren
* [Übersicht der Integrationen](/docs/de/guides/integrations/overview) – alle verfügbaren Integrationen
* [Live-Bestellungen verwalten](/docs/de/guides/orders/managing-live-orders) – eingehende Lieferbestellungen bearbeiten


## Related topics

- [Uber Direct – White-Label-Kurierlieferung](/docs/de/guides/integrations/delivery/uber-direct.md)
- [Delivery- & Pickup-Store](/docs/de/getting-started/store-types/delivery-pickup-store.md)
- [Bestellungen – Übersicht](/docs/de/guides/orders/overview.md)
- [Rabatte – Überblick](/docs/de/guides/discounts/overview.md)
- [Acteol](/docs/de/guides/integrations/marketing/acteol.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.