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

# Dispatch aggregato con First Delivery

> Collegare First Delivery a storekit per inviare gli ordini a DoorDash, Uber, Relay e flotta propria, con dispatch automatico e tracciamento in tempo reale.

First Delivery ([firstdelivery.com](https://firstdelivery.com/)) è un aggregatore di consegne: un singolo account inoltra i tuoi ordini sulla sua rete di provider di corrieri (come DoorDash, Uber e Relay, oltre ai corrieri della flotta propria) in base all'instradamento definito da First per la zona. L'integrazione storekit invia automaticamente gli ordini in consegna accettati a First per il dispatch e riceve indietro aggiornamenti di stato in tempo reale sulla pagina dell'ordine del cliente.

## Panoramica

* **Dispatch aggregato**: una singola connessione raggiunge l'intera rete di corrieri di First
* **Dispatch automatico**: gli ordini vengono inviati a First automaticamente quando li accetti
* **Tracciamento in tempo reale**: gli aggiornamenti di stato del corriere tornano sulla pagina dell'ordine in storekit
* **Copertura per sede**: quali corrieri può usare un locale dipende dalla sede merchant di First (il suo indirizzo e territorio), non da quello che storekit invia

> [!NOTE]
>
> First Delivery decide quale rete di corrieri esegue ciascun job in base alla sede merchant che colleghi. storekit non sceglie il corriere — inoltra l'ordine e trasmette lo stato riportato da First.

## Prima di iniziare

Ti serve:

* Un account First Delivery con una **API key** (dal tuo account First)
* Un indirizzo completo del locale in storekit (usato per abbinare o creare la tua sede merchant di First)
* La consegna abilitata sul negozio (vedi [Abilitare la consegna](/docs/it/guides/fulfillment/delivery/enabling-delivery))

## Configurazione

1. In storekit, vai su **Stores** → il tuo negozio → **Settings** → **Integrations**
2. Seleziona **First Delivery**
3. Nella pagina **First Delivery Settings**, incolla la tua chiave in **API key** e clicca **Load merchants**

   Il caricamento dei merchant valida anche la chiave — se First la rifiuta, ti verrà chiesto di controllare la chiave e riprovare.
4. Sotto **Merchant location**, scegli il merchant che corrisponde a questo locale. Se non viene trovata alcuna sede per la tua chiave, usa **Create this venue as a new First location** (vedi sotto).
5. Imposta **Integration status** su abilitato — il toggle riporta *"Enabled - dispatching orders to First Delivery"* quando è attivo.
6. Clicca **Save**.

> [!WARNING]
>
> Devi selezionare una **Merchant location** prima di salvare. Salvando senza sceglierne una compare *"Select a merchant location first"* e le impostazioni non vengono memorizzate.

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

### Creare una sede First a partire dal tuo locale

Se la tua API key non ha una sede merchant esistente per questo locale, clicca **Create this venue as a new First location** sotto **Merchant location**. storekit crea in tempo reale un record di sede in First a partire dai dettagli di questo locale e la seleziona per te.

> [!WARNING]
>
> La creazione di una sede First avviene in tempo reale e **non può essere annullata** — storekit ti chiede prima di confermare. First assegna la sede alla zona di consegna (cohort) che copre l'indirizzo del locale.

Se First non riesce a creare la sede, storekit mostra il motivo:

| Messaggio | Cosa significa |
| - | - |
| *"This venue doesn't have a usable address in storekit. Add one before creating a First location."* | Il locale non ha un indirizzo utilizzabile da First — aggiungine uno sotto **Stores** → il tuo negozio → **Settings** → **General** prima. |
| *"First has no delivery zone covering this venue. Please contact First to extend coverage."* | Il locale si trova al di fuori di ogni zona di consegna di First. First deve estendere la copertura prima che tu possa fare il provisioning qui. |
| *"First couldn't locate this venue's address. Please check the venue address and try again."* | First non è riuscito a geolocalizzare l'indirizzo — correggi l'indirizzo del locale e riprova. |

> [!NOTE]
>
> Se il merchant che scegli sembra trovarsi in un posto diverso rispetto al tuo locale, storekit avvisa che l'indirizzo del merchant selezionato non sembra corrispondere — scegliere la sede sbagliata invia i corrieri nel posto sbagliato, quindi ricontrolla prima di salvare.

### Sostituire l'API key

Una volta salvata una chiave, il campo **API key** mostra *"API key saved ●●●●"* con un pulsante **Replace key**. Clicca **Replace key** per inserire una nuova chiave, poi **Load merchants** per validarla e aggiornare l'elenco dei merchant.

## Come funziona

1. Un cliente effettua un ordine in consegna sul tuo negozio storekit
2. Quando accetti l'ordine, storekit lo inoltra a First Delivery
3. First instrada il job a un corriere della sua rete per la zona della sede merchant
4. Gli aggiornamenti di stato del corriere tornano in storekit e vengono mostrati sulla pagina dell'ordine del cliente
5. Se l'ordine viene annullato in storekit, storekit annulla anche la consegna First

### Orario di ritiro

L'orario di ritiro di First è quando il corriere preleva dal tuo locale, quindi storekit lo calcola all'indietro dall'orario di consegna stimato per il cliente sottraendo il tratto di consegna. Gli ordini programmati richiedono un ritiro a più di circa 20 minuti di distanza; qualsiasi cosa più vicina viene inoltrata come ASAP.

### Aggiornamenti di stato della consegna

storekit mappa gli stati del corriere di First sugli stati di tracciamento che vedono i clienti, tra cui:

| Stato First | Stato visibile al cliente |
| - | - |
| Runner assigned | Autista assegnato |
| En route to pickup | In viaggio verso il negozio |
| Picked up | Ritirato |
| En route to dropoff | In consegna |
| Arrived at dropoff | In arrivo |
| Completed | Consegnato |
| Cancelled | Consegna annullata |

## Correlati

* [Abilitare la consegna](/docs/it/guides/fulfillment/delivery/enabling-delivery) — attiva gli ordini in consegna per il tuo negozio
* [Panoramica delle integrazioni](/docs/it/guides/integrations/overview) — tutte le integrazioni disponibili
* [Gestire gli ordini in tempo reale](/docs/it/guides/orders/managing-live-orders) — gestisci gli ordini in consegna in arrivo


## Related topics

- [Shipday per dispatch e ottimizzazione dei percorsi](/docs/it/guides/integrations/delivery/shipday.md)
- [Integrazione Orkestro: flotta e consegna on-demand](/docs/it/guides/integrations/delivery/orkestro.md)
- [Integrazione Uber Direct per consegna white-label](/docs/it/guides/integrations/delivery/uber-direct.md)
- [Integrazione di consegna Cyclone Couriers per l'Irlanda](/docs/it/guides/integrations/delivery/cyclone.md)
- [Integrazione PedalMe per la consegna in cargo bike a Londra](/docs/it/guides/integrations/delivery/pedalme.md)


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