Skip to main content
First Delivery (firstdelivery.com) est un agrégateur de livraison : un compte unique dispatche vos commandes vers son réseau de prestataires de coursiers (comme DoorDash, Uber et Relay, ainsi que des coursiers en flotte propre) selon le routage défini par First pour la zone. L’intégration storekit envoie automatiquement les commandes de livraison acceptées à First pour dispatch et reçoit en retour les mises à jour de statut en direct sur la page de commande du client.

​
Vue d’ensemble

  • Dispatch agrégé : une seule connexion pour atteindre l’ensemble du réseau de coursiers de First
  • Dispatch automatique : les commandes sont envoyées à First automatiquement lorsque vous les acceptez
  • Suivi en direct : les mises à jour de statut du coursier remontent jusqu’à la page de commande storekit
  • Couverture par emplacement : les coursiers accessibles à un établissement dépendent de l’emplacement marchand First (son adresse et son territoire), et non de ce que storekit envoie
C’est First Delivery qui décide quel réseau de coursiers exécute chaque mission en fonction de l’emplacement marchand que vous connectez. storekit ne choisit pas le coursier — il dispatche la commande et relaie le statut communiqué par First.

​
Avant de commencer

Il vous faut :
  • Un compte First Delivery avec une API key (depuis votre compte First)
  • Une adresse complète pour l’établissement dans storekit (utilisée pour rattacher ou créer votre emplacement marchand First)
  • La livraison activée sur le magasin (voir Activer la livraison)

​
Configuration

  1. Dans storekit, allez dans Stores → votre magasin → Settings → Integrations
  2. Sélectionnez First Delivery
  3. Sur la page First Delivery Settings, collez votre clé dans API key et cliquez sur Load merchants Le chargement des marchands valide également la clé — si First la rejette, il vous sera demandé de la vérifier et de réessayer.
  4. Sous Merchant location, choisissez le marchand qui correspond à cet établissement. Si aucun emplacement n’est trouvé pour votre clé, utilisez Create this venue as a new First location (voir ci-dessous).
  5. Passez Integration status sur activé — le toggle affiche “Enabled - dispatching orders to First Delivery” lorsqu’il est actif.
  6. Cliquez sur Save.
Vous devez sélectionner un Merchant location avant d’enregistrer. Enregistrer sans en choisir un affiche “Select a merchant location first” et les paramètres ne sont pas conservés.
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.

​
Créer un emplacement First à partir de votre établissement

Si votre clé API n’a pas d’emplacement marchand existant pour cet établissement, cliquez sur Create this venue as a new First location sous Merchant location. storekit crée un enregistrement d’emplacement en direct chez First à partir des informations de cet établissement et le sélectionne pour vous.
La création d’un emplacement First se fait en direct et ne peut pas être annulée — storekit vous demande d’abord de confirmer. First attribue l’emplacement à la zone de livraison (cohort) qui couvre l’adresse de l’établissement.
Si First ne parvient pas à créer l’emplacement, storekit indique la raison :
Si le marchand que vous sélectionnez semble situé à un endroit différent de votre établissement, storekit vous avertit que l’adresse du marchand sélectionné ne paraît pas correspondre — choisir le mauvais emplacement envoie les coursiers au mauvais endroit, alors vérifiez bien avant d’enregistrer.

​
Remplacer la clé API

Une fois une clé enregistrée, le champ API key affiche “API key saved ●●●●” avec un bouton Replace key. Cliquez sur Replace key pour saisir une nouvelle clé, puis sur Load merchants pour la valider et actualiser la liste des marchands.

​
Fonctionnement

  1. Un client passe une commande en livraison sur votre magasin storekit
  2. Lorsque vous acceptez la commande, storekit la dispatche vers First Delivery
  3. First route la mission vers un coursier de son réseau pour la zone de l’emplacement marchand
  4. Les mises à jour de statut du coursier reviennent dans storekit et s’affichent sur la page de commande du client
  5. Si la commande est annulée dans storekit, storekit annule également la livraison First

​
Timing de la collecte

L’heure de collecte de First correspond au moment où le coursier prend la commande dans votre établissement ; storekit la calcule donc à rebours à partir de l’heure de livraison estimée pour le client, en soustrayant la durée du trajet de livraison. Les commandes programmées nécessitent une collecte à plus d’environ 20 minutes ; en deçà, la commande est dispatchée en ASAP.

​
Mises à jour de statut de livraison

storekit mappe les statuts coursier de First sur les états de suivi visibles par les clients, notamment :

​
Voir aussi