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

# Integrazione Nash per l'orchestrazione della consegna multi-corriere

> Collega Nash a storekit per orchestrare le consegne su più reti di corrieri. Nash instrada automaticamente ogni ordine al miglior autista disponibile nelle vicinanze.

Nash è una piattaforma di orchestrazione delle consegne che ti collega a più reti di corrieri attraverso una singola integrazione. Nash instrada automaticamente gli ordini al miglior autista disponibile tra i provider.

## Panoramica

* **Copertura**: globale
* **Multi-provider**: accesso a più reti di corrieri
* **Instradamento intelligente**: selezione automatica del provider

## Provider collegati

Nash si collega a reti di corrieri tra cui:

* DoorDash Drive
* Uber Direct
* Stuart
* Roadie
* Flotte di corrieri locali
* E altre

## Configurazione

1. Iscriviti a un account Nash su nash.io
2. Aggiungi i tuoi dettagli di fatturazione / pagamento nel tuo account Nash
3. Collega i tuoi provider di corrieri preferiti in Nash
4. Ottieni la tua chiave API di Nash
5. In storekit, vai su **Impostazioni** → **Integrazioni** → **Consegna**
6. Seleziona **Nash** e inserisci la tua chiave API
7. Configura le preferenze di instradamento
8. (Facoltativo) Imposta un numero di telefono di ritiro personalizzato se diverso dal telefono del tuo locale
9. Salva le modifiche

<Warning>
  Nash non può creare un job di consegna finché nel tuo account Nash non sono presenti dettagli di fatturazione / pagamento validi. Nash ti fattura direttamente la sua commissione di piattaforma per consegna oltre alle commissioni del provider di corrieri (vedi [Prezzi](#prezzi)) — storekit non paga il corriere per tuo conto. Se mancano i dettagli di fatturazione, sono scaduti o un pagamento fallisce, gli ordini vengono comunque accettati e pagati in storekit ma non viene creata alcuna consegna. Vedi [Nessun job di consegna è stato creato](#nessun-job-di-consegna-è-stato-creato).
</Warning>

### Numero di telefono di ritiro

Per impostazione predefinita, Nash utilizza il numero di telefono del tuo locale come contatto di ritiro. Puoi sovrascriverlo con un numero diverso nelle impostazioni dell'integrazione Nash.

Questo è utile quando:

* Il tuo coordinatore delle consegne usa un numero diverso
* Vuoi che gli autisti contattino un reparto specifico
* Il telefono del tuo locale non accetta chiamate durante gli orari di consegna

Il numero di telefono deve essere in formato E.164 (ad es. +442012345678).

## Come funziona

1. Il cliente effettua un ordine in consegna
2. storekit invia l'ordine a Nash
3. Nash valuta i provider disponibili
4. Il miglior provider viene selezionato in base alle tue regole
5. L'autista viene assegnato e tracciato
6. Il cliente vede il tracciamento in tempo reale

## Dati dell'ordine inviati

| Campo             | Descrizione                                    |
| ----------------- | ---------------------------------------------- |
| `pickupAddress`   | Indirizzo del negozio con coordinate           |
| `deliveryAddress` | Indirizzo del cliente con coordinate           |
| `customerName`    | Nome del cliente                               |
| `customerPhone`   | Telefono del cliente                           |
| `customerEmail`   | Email del cliente                              |
| `orderValue`      | Totale dell'ordine                             |
| `items`           | Dettagli degli articoli per il dimensionamento |
| `notes`           | Istruzioni speciali                            |
| `pickupTime`      | Orario di preparazione                         |
| `deliverBy`       | Orario di consegna richiesto                   |

## Regole di instradamento

Configura come Nash seleziona i provider:

### Basato sulla priorità

Imposta l'ordine di priorità dei provider:

1. Prima scelta: il più economico disponibile
2. Seconda scelta: il più veloce disponibile
3. Riserva: qualsiasi disponibile

### Ottimizzazione dei costi

Nash seleziona l'opzione più economica che soddisfa i tuoi requisiti:

* Tempo massimo di consegna
* Valutazione minima dell'autista
* Requisiti sul tipo di veicolo

### Ottimizzazione della velocità

Priorità alla consegna più rapida:

* Seleziona il provider con l'ETA più breve
* Paga un supplemento per la velocità quando necessario

### Round-robin

Distribuisci gli ordini tra i provider:

* Bilancia il volume tra i partner
* Testa le prestazioni dei provider
* Rispetta gli impegni di volume

## Esperienza del cliente

Indipendentemente dal provider che effettua la consegna, i clienti vedono:

* Un'esperienza di tracciamento coerente
* Dettagli e foto dell'autista
* Tracciamento su mappa in tempo reale
* ETA accurato
* Contatto diretto con l'autista

## Gestione del fallback

Se il provider primario non può completare:

1. Nash prova automaticamente il provider successivo
2. Il processo continua finché non viene assegnato un autista
3. Ricevi una notifica se tutti i provider falliscono
4. Sono disponibili opzioni di intervento manuale

## Dove verificare una consegna nel dashboard

Ogni consegna Nash è tracciata sul relativo ordine in storekit. Per vedere lo stato in tempo reale e i dettagli di contatto del corriere:

1. Apri l'ordine dal dashboard
2. Sull'ordine, trova il tracker della consegna (l'indicatore di passaggi che mostra **In attesa → Assegnato → In viaggio → Al punto di consegna → Consegnato**, con un **ETA di ritiro** o **ETA di consegna** in alto)
3. Seleziona **Dettagli** per aprire la modale **Dettagli della consegna**

La modale **Dettagli della consegna** mostra:

| Campo                                                     | Cosa ti indica                                                                                     |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Badge di stato                                            | Lo stato attuale della consegna (ad es. `Not Assigned Driver`, `Canceled By Provider`)             |
| Corriere                                                  | Nome del corriere, numero di telefono (tocca per chiamare), foto e veicolo                         |
| Timeline                                                  | Ogni tappa con gli orari, oltre agli ETA di ritiro e consegna e a come si confrontano con la stima |
| Flotta                                                    | La rete di corrieri a cui Nash ha instradato l'ordine                                              |
| Prezzo finale (incl. tasse) / Prezzo finale (escl. tasse) | Il prezzo di consegna addebitato per il job                                                        |
| Motivo del fallimento                                     | Perché una consegna è stata annullata, scaduta o fallita (mostrato solo quando applicabile)        |
| Provider ID                                               | Riferimento del job di Nash — cita questo quando contatti l'assistenza                             |
| Visualizza nel dashboard del provider                     | Apre il job nel dashboard del provider                                                             |
| Annulla consegna                                          | Annulla il job, mostrato solo mentre la consegna può ancora essere annullata                       |

## Risoluzione dei problemi

### Nessun job di consegna è stato creato

Se un ordine viene accettato e pagato in storekit ma non appare mai una consegna — nessun progresso nel tracker della consegna e nulla nella modale **Dettagli della consegna** — il job molto probabilmente non è mai stato creato da Nash, di solito a causa della fatturazione:

* Verifica nel tuo account Nash la presenza di dettagli di fatturazione / pagamento mancanti, scaduti o falliti. Nash ti fattura direttamente la sua commissione di piattaforma più le commissioni dei corrieri (vedi [Prezzi](#prezzi)), quindi non può inviare un corriere senza dettagli di pagamento validi
* Controlla la tua email (inclusa la spam) per messaggi da Nash su fatturazione o fallimenti di pagamento — questo avviso può arrivare giorni prima che le consegne smettano di essere create, e non c'è alcun avviso al riguardo nel dashboard storekit
* Una volta corretti i dettagli di fatturazione in Nash, i nuovi job di consegna vengono creati di nuovo automaticamente — non è necessaria alcuna modifica in storekit
* Nel frattempo, [contatta l'assistenza](/docs/it/getting-started/contact-support) con l'ordine: possiamo creare manualmente il job di consegna in sospeso in modo che l'ordine venga comunque ritirato

### Nessun autista ancora assegnato

Mentre Nash sta ancora cercando un autista, la consegna rimane sul passaggio **In attesa** e lo stato in **Dettagli della consegna** riporta `Not Assigned Driver` (lo stesso stato di "stiamo ancora cercando un autista" di un job appena `Created` o `Scheduled`).

* Nash continua a cercare e può riassegnare automaticamente il job tra le tue reti di corrieri collegate finché un autista non accetta
* Osserva il tracker della consegna e l'**ETA di ritiro** sull'ordine invece di preparare il cibo troppo presto — un autista potrebbe non arrivare per un po' dopo che l'ordine è pronto
* Se la tua cucina non ha iniziato, aspetta a cuocere finché non è assegnato un autista e l'**ETA di ritiro** sembra realistico, così il cibo caldo non rimane in attesa
* Se nessun autista viene assegnato mentre la finestra di ritiro si avvicina, [contatta l'assistenza](/docs/it/getting-started/contact-support) con il **Provider ID** dalla modale **Dettagli della consegna**

### L'autista è in ritardo al ritiro

Se un autista è stato assegnato ma il ritiro è in ritardo:

* Controlla lo stato in tempo reale sull'ordine — il passaggio del tracker della consegna, l'**ETA di ritiro** e la timeline nella modale **Dettagli della consegna** mostrano dov'è il corriere e se l'ETA è slittato
* Contatta il corriere direttamente: apri **Dettagli della consegna** e tocca il numero di telefono del corriere nella sezione **Corriere**
* Se non riesci a raggiungere il corriere o il ritardo è significativo, [contatta l'assistenza](/docs/it/getting-started/contact-support) con il **Provider ID** in modo che possiamo fare follow-up con Nash e il corriere

### Consegna annullata o fallita

Il badge di stato **Dettagli della consegna** (e il banner **Consegna annullata** sull'ordine) mostra come è terminata una consegna:

* **Annullata** (`Canceled By Provider`, `Canceled By Customer`) — la rete di corrieri, Nash o il cliente ha annullato il job. Un job che Nash riassegna a un altro provider appare anche come `Canceled By Provider` sul tentativo originale
* **Scaduta** (`Expired`) — nessun autista è stato trovato entro la finestra consentita
* **Fallita** (`Failed`) — la consegna non è stata completata
* **Restituita** (`Returned`, `Return In Progress`) — l'ordine è in corso di restituzione o è stato restituito al tuo negozio

Dove Nash lo fornisce, il motivo appare nel campo **Motivo del fallimento** della modale **Dettagli della consegna**. Se una consegna viene annullata o fallisce e hai bisogno di aiuto per risolverla, [contatta l'assistenza](/docs/it/getting-started/contact-support).

## Chi è responsabile della consegna

storekit trasmette ogni ordine in consegna a Nash; Nash seleziona quindi e gestisce la rete di corrieri che ritira e consegna l'ordine. Ciò significa che l'esito di una consegna — inclusi ritiri in ritardo, mancata assegnazione di un autista o danni durante il trasporto — è gestito dal partner di consegna che esegue la consegna, non da storekit.

Se qualcosa va storto, il supporto storekit può presentare un reclamo o una richiesta di rimborso a Nash per tuo conto. Qualsiasi rimborso o compenso è soggetto all'approvazione del partner di consegna, quindi non possiamo garantire un esito, un importo o una tempistica. Per avviare la procedura, [contatta l'assistenza](/docs/it/getting-started/contact-support) con l'ordine e il **Provider ID** dalla modale **Dettagli della consegna**.

## Prezzi

Nash addebita:

* Commissione di piattaforma per consegna
* Più le commissioni del provider di corrieri

Tu controlli:

* Costo massimo di consegna
* Addebito di consegna al cliente
* Importo della sovvenzione

## Best practice

<CardGroup cols={2}>
  <Card title="Più provider" icon="layer-group">
    Collega 2-3 provider per la ridondanza
  </Card>

  <Card title="Testa l'instradamento" icon="flask">
    Testa diverse regole di instradamento per ottimizzare costo/velocità
  </Card>

  <Card title="Imposta limiti" icon="gauge">
    Configura costi massimi per controllare la spesa
  </Card>

  <Card title="Monitora le prestazioni" icon="chart-line">
    Rivedi gli analytics per identificare i migliori provider
  </Card>
</CardGroup>


## Related topics

- [Integrazione Uber Direct per la consegna con corriere white-label](/docs/it/guides/integrations/delivery/uber-direct.md)
- [Integrazione Orkestro per la gestione della flotta e la consegna on-demand](/docs/it/guides/integrations/delivery/orkestro.md)
- [Integrazione PedalMe per la consegna in cargo bike a Londra](/docs/it/guides/integrations/delivery/pedalme.md)
- [Integrazione di consegna Cyclone Couriers per l'Irlanda](/docs/it/guides/integrations/delivery/cyclone.md)
- [Store con delivery e pickup](/docs/it/getting-started/store-types/delivery-pickup-store.md)