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

# Agrégation de dispatch avec First Delivery

> Connecter First Delivery à storekit pour dispatcher les commandes vers DoorDash, Uber, Relay et coursiers propres, avec dispatch auto et suivi en direct.

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

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

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

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

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

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

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

| Message | Ce que cela signifie |
| - | - |
| *"This venue doesn't have a usable address in storekit. Add one before creating a First location."* | L'établissement n'a pas d'adresse exploitable par First — ajoutez-en une sous **Stores** → votre magasin → **Settings** → **General** avant tout. |
| *"First has no delivery zone covering this venue. Please contact First to extend coverage."* | L'établissement se trouve hors de toutes les zones de livraison First. First doit étendre sa couverture avant que vous ne puissiez provisionner ici. |
| *"First couldn't locate this venue's address. Please check the venue address and try again."* | First n'a pas pu géocoder l'adresse — corrigez l'adresse de l'établissement et réessayez. |

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

| Statut First | État côté client |
| - | - |
| Runner assigned | Chauffeur assigné |
| En route to pickup | En direction du magasin |
| Picked up | Récupérée |
| En route to dropoff | En cours de livraison |
| Arrived at dropoff | Arrivée imminente |
| Completed | Livrée |
| Cancelled | Livraison annulée |

## Voir aussi

* [Activer la livraison](/docs/fr/guides/fulfillment/delivery/enabling-delivery) — activez les commandes en livraison sur votre magasin
* [Vue d'ensemble des intégrations](/docs/fr/guides/integrations/overview) — toutes les intégrations disponibles
* [Gérer les commandes en direct](/docs/fr/guides/orders/managing-live-orders) — traitez les commandes de livraison entrantes


## Related topics

- [Dispatch et optimisation d'itinéraires Shipday](/docs/fr/guides/integrations/delivery/shipday.md)
- [Intégration livraison Orkestro : flotte et coursiers](/docs/fr/guides/integrations/delivery/orkestro.md)
- [Intégration de livraison en marque blanche Uber Direct](/docs/fr/guides/integrations/delivery/uber-direct.md)
- [Alertes de commande vers Slack ou votre téléphone](/docs/fr/guides/build/recipes/order-alerts.md)
- [Déplacer des commandes](/docs/fr/guides/orders/advanced/move-orders.md)


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