Skip to main content
First Delivery (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
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)

​
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.
Je moet een Merchant location selecteren voordat je opslaat. Opslaan zonder selectie toont “Select a merchant location first” en de instellingen worden niet opgeslagen.
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.

​
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.
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:
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:

​
Gerelateerd