Stuart mette a Sua disposizione i suoi corrieri indipendenti, senza passare da una piattaforma di ordinazione: il cliente ordina nella Sua app, a Suo nome, e Stuart fornisce solo il fattorino. Lei paga ogni corsa alla tariffa Stuart, senza commissioni sulle vendite.

In XPRIO si chiama corriere partner. Lo collega una volta per la Sua azienda, poi sceglie, punto vendita per punto vendita, se consegna tutti gli ordini o solo in rinforzo ai Suoi fattorini.

Cosa sapere prima di iniziare

L'account Stuart è Suo. Lo crea presso Stuart, ed è Stuart a fatturarLe ogni corsa. XPRIO non prende nulla.
Il cliente paga le Sue spese di consegna, quelle del Suo punto vendita, incassate con l'ordine. Il costo della corsa Stuart è fatturato a parte, secondo distanza, dimensioni del pacco e orario. Se le Sue spese sono inferiori alla corsa, la differenza è a Suo carico; se sono superiori, la tiene Lei. Una volta collegato, XPRIO Le mostra il prezzo IVA inclusa di una corsa tipo.
Il pagamento online è obbligatorio. Un corriere partner non incassa nulla. Le modalità corriere partner si attivano solo se il pagamento con carta online (Stripe) è configurato nella Sua app. Configurare i suoi metodi di pagamento
Paesi coperti: Francia, Regno Unito e Polonia, nelle grandi città in cui Stuart opera (129 città nel 2025). XPRIO propone Stuart solo per i punti vendita di questi paesi, e verifica ogni indirizzo nel carrello.
Una carta bancaria deve essere registrata presso Stuart prima della prima corsa, anche sull'account di test. Senza carta, Stuart rifiuta di creare la consegna.
Nessun codice di consegna con Stuart: la prova di consegna è quella del corriere Stuart (firma o foto).
Un annullamento può essere addebitato una volta assegnato un corriere. XPRIO La avvisa prima di confermare.

Passo 1: aprire i Suoi account Stuart

Stuart fornisce due dashboard, con una registrazione separata per ciascuna:

Account di test su dashboard.sandbox.stuart.com: corse simulate, nulla fatturato, disponibile subito. È qui che farà le Sue prove.
Account reale su dashboard.stuart.com: richieda l'apertura su stuart.com (pulsante Diventa cliente o equivalente). Stuart La richiama per convalidare la Sua attività, poi Le apre l'accesso.

In entrambi i casi, una volta connesso:

Clicchi sul Suo avatar in alto a destra, poi su Il mio account.
Nel menu a sinistra, clicchi su Fatturazione e registri una carta bancaria. Sull'account di test va bene qualsiasi carta di test (tranne American Express), per esempio 4242 4242 4242 4242 con una data di scadenza futura e un codice a tre cifre. Sull'account reale, la Sua carta reale o i Suoi dati di fatturazione secondo il contratto.

Passo 2: recuperare le Sue chiavi

In Il mio account, menu a sinistra, clicchi su API.
Se la pagina mostra Nessuna credenziale API, clicchi su Genera ora.
La sezione Credenziali API mostra tre righe, ciascuna con un'icona di copia:
- ID Cliente: una lunga sequenza di caratteri (è il «Client ID»).
- Chiave segreta API: un'altra lunga sequenza (è il «Client secret»). Non la condivida con nessuno.
- ID account Stuart: un numero a sei cifre. Non Le servirà in XPRIO.

I valori mostrati sono troncati a schermo: usi sempre l'icona di copia, mai la selezione con il mouse. L'account di test e l'account reale hanno ciascuno le proprie chiavi.

Passo 3: collegare Stuart a XPRIO

In XPRIO, menu a sinistra, apra Configurazione App e poi Corrieri partner.
Sulla scheda Stuart, clicchi su Collega.
In Ambiente, scelga Test per le chiavi dell'account di test, Produzione per quelle dell'account reale.
Incolli l'ID Cliente in Client ID e la Chiave segreta API in Client secret. L'icona a forma di occhio permette di mostrare il secret per controllare.
Lasci Chiave di autenticazione dei webhook vuota per ora (passo 4).
Clicchi su Salva e testa. XPRIO si collega a Stuart, verifica che l'indirizzo del Suo punto vendita sia servito e richiede un preventivo di prova. Se la scheda passa a Collegato (test) o Collegato (produzione), è fatto. Altrimenti un messaggio rosso riporta la risposta di Stuart: chiavi incomplete, o punto vendita fuori dalle zone Stuart.

Una volta collegato, la scheda mostra «Corsa tipo dal Suo punto vendita (circa 1,5 km)» con il prezzo reale IVA inclusa restituito da Stuart.

Passo 4: attivare le notifiche in tempo reale (consigliato)

Senza questo passo, XPRIO rilegge lo stato di ogni corsa ogni 20 secondi: funziona. Con questo passo, Stuart avvisa XPRIO all'istante a ogni cambiamento (corriere assegnato, posizione, ordine ritirato, consegnato).

In XPRIO, riapra la finestra Stuart (Modifica sulla scheda). Copi l'URL di notifica da dichiarare presso il fornitore.
Sempre in questa finestra, inventi una chiave lunga (per esempio 20 caratteri senza spazi), la incolli in Chiave di autenticazione dei webhook, poi Salva e testa.
Nella dashboard Stuart, Il mio account, API: sotto la sezione Credenziali, la sezione Webhooks mostra Nessun Webhook. Clicchi su + Aggiungi un nuovo endpoint.
Incolli l'URL in URL del webhook. In Header di autenticazione, digiti esattamente Authentication-Key (senza questo nome, Stuart non invia la chiave e XPRIO rifiuta gli eventi). In Chiave di autenticazione, incolli la stessa chiave inserita in XPRIO. Selezioni tutti gli eventi V2 (job, delivery, driver). Salvi.

La scheda Stuart in XPRIO passa a «Notifiche in tempo reale attive» alla prima corsa.

Passo 5: scegliere la modalità di ogni punto vendita

In XPRIO, menu Punti vendita, apra la scheda del punto vendita (Modifica), poi la scheda Consegna e servizi.
Verifichi che il servizio Consegna sia attivo.
Nella sezione Chi consegna i Suoi ordini, scelga:
- I miei fattorini: nulla cambia.
- I miei fattorini + corriere partner di rinforzo: i Suoi fattorini restano prioritari; un pulsante Chiama un corriere partner appare su ogni ordine in consegna pagato online finché nessun fattorino è assegnato. Opzione Chiama automaticamente un corriere partner se nessun fattorino prende l'ordine, con un'attesa da 5 a 30 minuti dopo «pronto».
- Solo corriere partner: ogni ordine in consegna è affidato automaticamente al corriere Stuart, nel momento che sceglie (Quando richiedere il corriere). Il cliente vede solo il pagamento online.
Se le schede partner sono in grigio con «Pagamento online obbligatorio», attivi prima Stripe in Configurazione App, Metodi di pagamento.
Scelga Stuart in Fornitore.
In modalità «solo corriere partner», scelga le spese addebitate al cliente: Le mie spese fisse o Il prezzo del corriere (+ margine). In modalità rinforzo il cliente paga sempre le Sue spese fisse.
Se necessario, aggiunga le istruzioni di ritiro per il corriere e decida se la mancia del cliente va girata al corriere. Salvi.

Nel Live e lato cliente

Sull'ordine, il blocco Corriere partner mostra il corriere Stuart dall'assegnazione, il telefono, la fase (Corriere in arrivo, Corriere in negozio, Ritirato, Dal cliente, Consegnato) e l'orario di arrivo stimato. Prima di richiederlo, la finestra di conferma Le mostra il costo della corsa IVA inclusa.

L'ordine passa a In consegna quando il corriere lo ritira e a Consegnato alla consegna, senza intervento. Può annullare il corriere finché non ha ritirato l'ordine. In caso di annullamento da parte di Stuart o di reso dell'ordine, riceve una notifica, un suono e un messaggio nel Live, e può richiedere un nuovo corriere o assegnare un Suo fattorino.

Nella Sua app, il cliente vede una scheda contatto Corriere partner con il nome del corriere, un pulsante di chiamata, un link di tracciamento e la posizione in tempo reale sulla mappa. Su un punto vendita in modalità «solo corriere partner», il carrello mostra solo il pagamento con carta.

Domande frequenti

Posso testare senza una corsa reale? Sì, con l'account di test collegato nell'ambiente Test. Nella dashboard di test, la scheda Scenario ideale permette di far avanzare una corsa simulata passo dopo passo e di vedere il risultato nel Live.

Stuart rifiuta la corsa con un errore di pagamento? Nessuna carta è registrata in Fatturazione di quell'account, oppure è scaduta. Ne aggiunga una e riprovi.

Consegnare con un corriere Stuart