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

​
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.
Devi selezionare una Merchant location prima di salvare. Salvando senza sceglierne una compare “Select a merchant location first” e le impostazioni non vengono memorizzate.
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.

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

​
Correlati