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

# First Delivery-verzendaggregatie

> Koppel First Delivery aan storekit om bestellingen te versturen naar DoorDash, Uber, Relay en eigen koeriers, met automatische dispatch en live tracking.

First Delivery ([firstdelivery.com](https://firstdelivery.com/)) is een bezorgaggregator: één account verzendt je bestellingen via een netwerk van koeriersproviders (zoals DoorDash, Uber en Relay, plus eigen-vloot koeriers) volgens de routering van First voor het gebied. De storekit-integratie stuurt geaccepteerde bezorgbestellingen automatisch naar First voor verzending en ontvangt live statusupdates terug op de bestelpagina van de klant.

## Overzicht

* **Geaggregeerde verzending**: Eén koppeling bereikt het volledige koeriersnetwerk van First
* **Automatische verzending**: Bestellingen worden automatisch naar First gestuurd wanneer je ze accepteert
* **Live tracking**: Statusupdates van de koerier stromen terug naar de storekit-bestelpagina
* **Dekking per vestiging**: Welke koeriers een vestiging kan gebruiken, hangt af van de First merchant-vestiging (het adres en het gebied), niet van wat storekit stuurt

> [!NOTE]
>
> First Delivery bepaalt welk koeriersnetwerk elke klus uitvoert op basis van de merchant-vestiging die je koppelt. storekit kiest de koerier niet — het verzendt de bestelling en geeft de status door die First rapporteert.

## Voordat je begint

Je hebt nodig:

* Een First Delivery-account met een **API key** (uit je First-account)
* Een volledig vestigingsadres in storekit (gebruikt om je First merchant-vestiging te matchen of aan te maken)
* Bezorging ingeschakeld op de store (zie [Bezorging inschakelen](/docs/nl/guides/fulfillment/delivery/enabling-delivery))

## Instellen

1. Ga in storekit naar **Stores** → je store → **Settings** → **Integrations**
2. Selecteer **First Delivery**
3. Op de pagina **First Delivery Settings** plak je jouw sleutel in **API key** en klik je op **Load merchants**

   Bij het laden van merchants wordt de sleutel ook gevalideerd — als First hem afwijst, wordt je gevraagd de sleutel te controleren en opnieuw te proberen.
4. Kies onder **Merchant location** de merchant die bij deze vestiging hoort. Als er geen vestigingen worden gevonden voor je sleutel, gebruik dan **Create this venue as a new First location** (zie hieronder).
5. Zet **Integration status** op ingeschakeld — de toggle toont *"Enabled - dispatching orders to First Delivery"* wanneer aan.
6. Klik op **Save**.

> [!WARNING]
>
> Je moet een **Merchant location** selecteren voordat je opslaat. Opslaan zonder selectie toont *"Select a merchant location first"* en de instellingen worden niet opgeslagen.

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

### Een First-vestiging aanmaken vanuit je vestiging

Als je API key geen bestaande merchant-vestiging heeft voor deze vestiging, klik dan op **Create this venue as a new First location** onder **Merchant location**. storekit maakt een live vestigingsrecord aan bij First op basis van de gegevens van deze vestiging en selecteert deze voor je.

> [!WARNING]
>
> Het aanmaken van een First-vestiging is live en **kan niet ongedaan worden gemaakt** — storekit vraagt je eerst om bevestiging. First wijst de vestiging toe aan de bezorgzone (cohort) die het adres van de vestiging dekt.

Als First de vestiging niet kan aanmaken, toont storekit de reden:

| Bericht | Wat het betekent |
| - | - |
| *"This venue doesn't have a usable address in storekit. Add one before creating a First location."* | De vestiging heeft geen adres dat First kan gebruiken — voeg er eerst een toe onder **Stores** → je store → **Settings** → **General**. |
| *"First has no delivery zone covering this venue. Please contact First to extend coverage."* | De vestiging valt buiten elke bezorgzone van First. First moet de dekking uitbreiden voordat je hier kunt provisioneren. |
| *"First couldn't locate this venue's address. Please check the venue address and try again."* | First kon het adres niet geocoderen — corrigeer het vestigingsadres en probeer opnieuw. |

> [!NOTE]
>
> Als de merchant die je kiest op een andere plek lijkt te liggen dan je vestiging, waarschuwt storekit dat het adres van de geselecteerde merchant niet lijkt te kloppen — de verkeerde vestiging kiezen stuurt koeriers naar de verkeerde locatie, dus controleer dit dubbel voordat je opslaat.

### De API key vervangen

Zodra een sleutel is opgeslagen, toont het veld **API key** *"API key saved ●●●●"* met een knop **Replace key**. Klik op **Replace key** om een nieuwe sleutel in te voeren en klik daarna op **Load merchants** om deze te valideren en de merchant-lijst te vernieuwen.

## Hoe het werkt

1. Een klant plaatst een bezorgbestelling op je storekit-store
2. Wanneer je de bestelling accepteert, verzendt storekit deze naar First Delivery
3. First routeert de klus naar een koerier in zijn netwerk voor het gebied van de merchant-vestiging
4. Statusupdates van de koerier komen terug bij storekit en verschijnen op de bestelpagina van de klant
5. Als de bestelling in storekit wordt geannuleerd, annuleert storekit ook de First-bezorging

### Timing van ophalen

De ophaaltijd van First is wanneer de koerier bij je vestiging ophaalt, dus storekit rekent dit terug vanaf de geschatte bezorgtijd van de klant met de bezorgetappe. Geplande bestellingen hebben een ophaaltijd nodig die meer dan ongeveer 20 minuten in de toekomst ligt; alles korter wordt als ASAP verzonden.

### Bezorgstatusupdates

storekit mapt de koeriersstatussen van First naar de trackingstaten die klanten zien, waaronder:

| First-status | Klantstatus |
| - | - |
| Runner assigned | Chauffeur toegewezen |
| En route to pickup | Onderweg naar de winkel |
| Picked up | Opgehaald |
| En route to dropoff | Onderweg naar bezorging |
| Arrived at dropoff | Arriveert |
| Completed | Bezorgd |
| Cancelled | Bezorging geannuleerd |

## Gerelateerd

* [Bezorging inschakelen](/docs/nl/guides/fulfillment/delivery/enabling-delivery) — zet bezorgbestellingen aan voor je store
* [Overzicht integraties](/docs/nl/guides/integrations/overview) — alle beschikbare integraties
* [Live bestellingen beheren](/docs/nl/guides/orders/managing-live-orders) — inkomende bezorgbestellingen afhandelen


## Related topics

- [Cyclone Couriers-bezorgintegratie voor Ierland](/docs/nl/guides/integrations/delivery/cyclone.md)
- [Orkestro-integratie: vloot en on-demand koeriers](/docs/nl/guides/integrations/delivery/orkestro.md)
- [Shipday dispatch en routeoptimalisatie](/docs/nl/guides/integrations/delivery/shipday.md)
- [PedalMe-integratie voor bezorging per cargobike in Londen](/docs/nl/guides/integrations/delivery/pedalme.md)
- [Live-orderbord voor de pass](/docs/nl/guides/build/recipes/live-order-board.md)


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