Come collegare ShipStation a Excel - Interrogazione dei dati di spedizione con SQL

Collega ShipStation a Excel

Ottieni i dati da ShipStation in Excel

Importa i dati in tempo reale dal tuo account ShipStation in Excel e aggiornali quando vuoi. Nessun driver ODBC, nessuna esportazione, nessuna macro. La prima volta ci vogliono circa dieci minuti, ed è incluso nel piano gratuito.

Circa 10 minuti Non è necessaria alcuna programmazione. Le credenziali restano con te Eccelli ovunque, anche sul web.

Quello che otterrai alla fine

Un foglio di calcolo che mostra i risultati in tempo reale di una query SQL sul tuo account ShipStation, con un pulsante che visualizza le righe più recenti ogni volta che i dati cambiano. Ad esempio:

Vendite.xlsx — Excel

CasaInserisciDatiFlussi di query

	A	B	C	D	E
1	ID cliente	nome di battesimo	cognome	Paese	totale
2	1042	Maria	Alvarez	U.S.A.	1,284.50
3	1043	Daniel	Okafor	U.S.A.	612.00
4	1047	Priya	Nair	U.S.A.	2,090.75
5	1051	Tommaso	Berg	U.S.A.	338.20
6	1056	Lucia	Ferreira	U.S.A.	1,455.00
7	1060	Kenji	Sato	U.S.A.	874.10
8

Foglio1 In diretta da ShipStation

ShipStation protegge i tuoi dati tramite la sua API. Importarli in Excel di solito significa esportare un file CSV dalla dashboard di ShipStation ogni volta che hai bisogno di dati aggiornati. Query Streams elimina questo passaggio: un piccolo programma di supporto chiamato Agent esegue la query direttamente dove si trovano i tuoi dati e un componente aggiuntivo di Excel richiede le righe desiderate. Solo i risultati vengono trasmessi, tramite un collegamento crittografato, e il file Excel può trovarsi ovunque: sul tuo portatile a casa, sul computer di un collega dall'altra parte del paese o su Excel sul web.

Cosa ti servirà

Un account Query Streams

Il piano gratuito è sufficiente per questa guida. Registrati su my.querystreams.com.

L'agente su qualsiasi computer sempre acceso

Un piccolo programma che viene eseguito in background e richiama ShipStation quando Excel lo richiede. Richiede solo una connessione a Internet.

Le tue credenziali di accesso a ShipStation

Dovrai accedere a ShipStation una sola volta e consentire l'accesso in lettura. Non è necessario inserire password in Query Streams.

Collegalo in cinque passaggi

1. Crea il tuo account

   Vai a my.querystreams.com e iscriviti. Scegli il Gratuito Piano. Si tratta di un piano reale, non di una versione di prova, che include la connessione al tuo account ShipStation e l'esecuzione di query da Excel.

2. Installa l'agente su qualsiasi computer sempre acceso.

   Accedi, apri Scaricamentoe installa l'agente su qualsiasi computer o server sempre acceso con accesso a Internet. L'operazione richiede un minuto e da quel momento in poi si avvia automaticamente.

   Perché un piccolo programma invece di un driver? L'Agent è un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux) che funziona silenziosamente in background. Stabilisce una connessione in uscita crittografata con Query Streams, nello stesso modo di un browser, quindi non è necessario aprire porte del firewall né configurare una VPN. Le chiavi rimangono sul computer e le righe vengono inviate ovunque vi troviate, anche tramite Internet se necessario. L'unico elemento che dovete gestire è il componente aggiuntivo.

   La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che si esegue sull'agente stesso.

   Se volete, potete trovare le guide complete: Finestre, Mac, Linux.

3. Puntalo al tuo account ShipStation

   Torna al tuo browser, apri Agenti dati (Sotto Dati nel menu in alto). Il tuo agente è elencato lì. Fai clic Aggiungi connettore e scegliere ShipStationHai bisogno prima delle tue credenziali ShipStation? Apri la guida, quindi inserisci i dati richiesti:

   Crea le tue credenziali ShipStation (circa 5 minuti)

   Continuate così con ShipStation aperto in un'altra scheda. Query Streams conserva i dati creati qui, in modo che il vostro agente possa utilizzarli, e legge esclusivamente da ShipStation.

   Chi può farlo?

   Titolare dell'account (ShipStation consente solo al titolare dell'account di generare chiavi API)

   Raccomandato

   Chiave API ShipStation V2 (Chiave di produzione)

   Prima di iniziare

   • Un piano ShipStation con accesso API: Standard, Accelerate, Premium o superiore. I piani Gratuito e Starter non includono l'accesso API.
   • Le credenziali di accesso ShipStation del titolare dell'account e l'accesso alla sua casella di posta elettronica (la prima volta, ShipStation invia un link di verifica via email prima di creare la chiave).
   • Se la tua azienda utilizza ShipStation API (il prodotto per sviluppatori precedentemente chiamato ShipEngine) anziché l'app web di ShipStation, la tua chiave si trova nella dashboard di ShipStation API all'indirizzo https://api-portal.shipstation.com/: passa all'ambiente di produzione e copia una chiave di produzione, quindi vai direttamente alla procedura guidata. Le chiavi che iniziano con TEST_ sono chiavi di test (sandbox).
   • La procedura guidata Query Streams si apre in un'altra scheda: Agenti dati → Aggiungi connettore → ShipStation.

   Passaggi

   1. Accedi a ShipStation come titolare dell'account.

      Apri ShipStation in una nuova scheda ed effettua l'accesso con le credenziali del titolare dell'account. Solo il titolare dell'account può generare le chiavi API e ShipStation mostra una nuova chiave una sola volta, esclusivamente alla persona che l'ha generata.

      Non sei il proprietario? Chiedi al proprietario di eseguire i passaggi da 1 a 11 e di incollare la chiave nella procedura guidata Query Streams, oppure di inviartela tramite un gestore di password. Se non sai chi è il proprietario, l'assistenza di ShipStation ([email protected]) può fornirti queste informazioni.

   2. Apri le impostazioni

      Fai clic sull'icona a forma di ingranaggio (Impostazioni) nella barra degli strumenti scura in alto a destra dello schermo, tra l'icona della stampante e l'icona del punto interrogativo.

      Alcuni account sono accessibili dalla stessa area delle impostazioni tramite l'icona della persona → Il mio profilo.

   3. Impostazioni API aperte

      Nella barra laterale sinistra, espandi Account (se è compressa) e fai clic su Impostazioni API. Il titolo della pagina è Impostazioni API, con una casella Chiavi API sottostante. Una volta effettuato l'accesso, il link aprirà direttamente questa pagina.

      Se la pagina indica che il tuo piano non supporta l'accesso alle API, significa che l'account è di tipo Gratuito o Starter. Effettua prima l'upgrade a un piano Standard o superiore in Account → Pagamenti e abbonamenti.

   4. Scegli l'API V2

      Nel menu a tendina Seleziona versione API, scegli API V2.

      Il menu a tendina può aprirsi sull'API V1. Query Streams utilizza l'API V2 di ShipStation. Una chiave V1 è composta da una chiave API e una chiave segreta e il test di connessione fallisce con una chiave API non valida.

   5. Verifica se esiste già una chiave V2

      Se nella finestra viene visualizzato un pulsante "Genera chiave API", passare al passaggio 6. Se invece viene visualizzata una riga "Chiave di produzione" con una chiave nascosta, un'icona di copia e un'icona del cestino, l'account dispone già della sua chiave V2 consentita.

      Se la chiave esistente è salvata in un luogo sicuro (un gestore di password o la configurazione di un altro strumento da cui è possibile copiarla), utilizzala e procedi direttamente alla procedura guidata. In caso contrario, fai clic sull'icona del cestino, quindi su Elimina chiave nella finestra di dialogo Elimina chiave API. L'eliminazione è irreversibile e qualsiasi altro strumento che utilizza la vecchia chiave smetterà di funzionare finché non gli fornirai quella nuova.

   6. Fai clic su Genera chiave API

      Fai clic su Genera chiave API a destra della casella. Se si apre una finestra popup intitolata Genera chiave API, passa al passaggio 9. Se invece compare un avviso blu ("Verifica dell'email richiesta. Fai clic sul link di verifica che ti abbiamo inviato al tuo indirizzo email utente e riprova."), esegui i passaggi 7 e 8.

      ShipStation richiede la verifica dell'indirizzo email prima di generare la prima chiave di accesso per l'account. I nuovi account devono verificare il proprio indirizzo email prima di poter generare le chiavi.

   7. Fai clic sul link di verifica nella tua email

      Apri l'email che ShipStation ha inviato all'indirizzo del titolare dell'account e fai clic sul link di verifica in essa contenuto.

      Non hai ricevuto l'email dopo qualche minuto? Controlla le cartelle spam e promozioni.

   8. Fai di nuovo clic su Genera chiave API

      Torna alla scheda Impostazioni API, verifica che Seleziona versione API mostri ancora API V2 e fai di nuovo clic su Genera chiave API.

      Il pulsante si resetta una volta verificata l'email. Se l'avviso blu è ancora presente, ricarica la pagina e seleziona nuovamente l'API V2.

   9. Seleziona una data di scadenza e fai clic su Genera

      Nella finestra a comparsa Genera chiave API, in Imposta scadenza chiave, scegli 12 mesi, 6 mesi o 3 mesi, quindi fai clic su Genera.

      La chiave smetterà di funzionare a partire da quella data e la sincronizzazione con ShipStation si interromperà di conseguenza. Seleziona 12 mesi e imposta un promemoria sul calendario; ShipStation ti invierà anche un'email di promemoria prima della scadenza della chiave.

   10. Copia la chiave API

       Si aprirà una finestra a comparsa intitolata "Chiave API creata" con un avviso che indica che la chiave sarà visibile solo in questa occasione. Fai clic sull'icona di copia (due quadrati sovrapposti) a destra di "Chiave API".

       Incollalo direttamente nella procedura guidata di Query Streams (o in un gestore di password), non in un'e-mail o in una chat. Se nel popup viene visualizzata anche una riga Chiave segreta, significa che hai creato una chiave V1: fai clic su Fine, torna al passaggio 4 e scegli API V2.

   11. Fai clic su Fine.

       Fai clic su Fine. Tornando alle Impostazioni API, la chiave ora risulta nascosta. ShipStation non la mostrerà più; se la perdi, puoi eliminarla e generarne una nuova.

   Autorizzazioni a concedere

   Risorsa	Accesso	Utilizzato per
   Chiave API V2 (Seleziona la versione API → API V2)	Accesso completo all'account. ShipStation non prevede chiavi di sola lettura o con accesso limitato.	Ogni tabella shipstation.*: spedizioni, etichette e evasioni (attive per impostazione predefinita), oltre a corrieri, servizi di trasporto, magazzini, prodotti, lotti, manifesti, ritiri, tag, utenti e webhook. Query Streams invia solo richieste di lettura.
   Piano: Standard, Accelerate, Premium o superiore	Necessario	Senza di esso, ShipStation restituisce un errore 402 e non sincronizza le tabelle. I piani Free e Starter non hanno accesso all'API.
   API dell'inventario (Impostazioni → Componenti aggiuntivi)	Incluso nei piani Standard e superiori; un'opzione aggiuntiva nei piani inferiori.	tabelle inventory e inventory_locations. Una chiave che ha solo il componente aggiuntivo (piano inferiore a Standard) non supera comunque il test di connessione, perché il test legge le spedizioni.
   Titolare dell'account	Necessario per generare la chiave	Nessuna tabella. ShipStation consente solo al proprietario dell'account di creare chiavi API.

   Incolla nei flussi di query

   Chiave API di ShipStation

   La chiave API che hai copiato al passaggio 10: un unico valore, nessun segreto. Una chiave che inizia con TEST_ è una chiave sandbox e mostra solo i dati di test. Query Streams memorizza la chiave per il tuo agente e la utilizza esclusivamente per le letture.

   Problemi comuni

   Il test di connessione mostra un risultato in rosso: Chiave API non valida.

   Perché: È stata incollata una chiave V1 o la sua chiave segreta, il valore ha acquisito spazi aggiuntivi oppure la chiave è stata eliminata o è scaduta.

   Aggiustare: Genera una chiave V2 (passaggi da 4 a 11) e incolla solo il valore della chiave API. Fai clic su "Verifica connessione" finché non viene visualizzato il messaggio "Connesso".

   Il test di connessione mostra un errore API: PaymentRequired.

   Perché: ShipStation ha risposto 402: l'account ha un piano inferiore a Standard (Gratuito o Starter) oppure dispone solo del componente aggiuntivo Inventory API.

   Aggiustare: Passa al piano Standard o superiore in Account → Pagamenti e abbonamenti, quindi fai clic nuovamente su Test utilizzando lo stesso tasto.

   Impossibile generare una chiave: la generazione della chiave API continua a mostrare "Verifica dell'indirizzo email richiesta" oppure "La persona che effettua la configurazione non è autorizzata a creare chiavi".

   Perché: Solo il titolare dell'account può generare le chiavi, e solo dopo aver verificato il proprio indirizzo email.

   Aggiustare: Accedi come titolare dell'account, fai clic sul link nell'email di verifica di ShipStation, quindi fai nuovamente clic su Genera chiave API.

   La connessione ha funzionato per mesi, poi le sincronizzazioni di ShipStation si sono interrotte e il test di connessione ha segnalato "Chiave API non valida".

   Perché: La chiave ha raggiunto la scadenza di 3, 6 o 12 mesi, oppure qualcuno l'ha eliminata per crearne una nuova per un altro strumento (l'account può contenere una sola chiave V2).

   Aggiustare: Genera una nuova chiave V2, quindi in Data Agents modifica la connessione ShipStation, incolla la nuova chiave nel campo Chiave API di ShipStation e fai clic su Verifica connessione. Fornisci la stessa nuova chiave a qualsiasi altro strumento che utilizzava la vecchia chiave.

   Le tabelle sono vuote o mostrano solo spedizioni di prova e le sincronizzazioni sono lente.

   Perché: È stata utilizzata una chiave sandbox (che inizia con TEST_) dalla dashboard API di ShipStation. I dati della sandbox sono separati dalle spedizioni reali e le chiavi sandbox sono limitate a 20 richieste al minuto.

   Aggiustare: Incolla una chiave di produzione (senza il prefisso TEST_) e fai clic su Verifica connessione.

   Alcune tabelle di ShipStation sono in ritardo e il registro dell'agente mostra TooManyRequests.

   Perché: ShipStation consente 200 richieste al minuto per account, condivise da tutte le app ad esso connesse. Un'altra integrazione sta utilizzando gran parte di questo budget.

   Aggiustare: Non è necessario modificare nulla in Query Streams: la tabella tenterà di nuovo alla successiva sincronizzazione programmata. Se ciò si verifica ogni giorno, richiedi a ShipStation un limite più alto scrivendo a [email protected].

   Limiti da conoscere

   • 200 richieste al minuto per account ShipStation per impostazione predefinita, condivise da ogni app e integrazione che utilizza l'account; oltre tale limite ShipStation risponde con un errore 429 Too Many Requests. L'agente gestisce automaticamente una piccola parte di questo limite. Per limiti più elevati: inviare un'e-mail a [email protected].
   • Chiavi sandbox (prefisso TEST_, solo per i clienti dell'API ShipStation): 20 richieste al minuto, solo dati sandbox. Gli account dell'app web ShipStation (piattaforma) non dispongono di sandbox, quindi ogni chiave legge i dati reali.
   • Le chiavi API scadono dopo 3, 6 o 12 mesi, a seconda della scelta effettuata al momento della generazione. ShipStation invia un'email di promemoria prima della scadenza.
   • È consentita una sola chiave V2 per account; la stessa chiave può essere utilizzata da diverse applicazioni.
   • Nessun accesso API nei piani Free e Starter. Al di sotto del piano Standard, le chiavi V2 restituiscono un errore 402, ad eccezione degli endpoint di inventario del componente aggiuntivo Inventory API.
   • L'API V1 (obsoleta e deprecata) utilizza una coppia di chiavi API e chiave segreta a un indirizzo diverso, con un limite di 40 richieste al minuto per coppia. Query Streams non utilizza la versione V1.

   Passaggi verificati l'8 ottobre 2026. Fonti: help.shipstation.com/hc/en-us/articles/360025856212-ShipS…, docs.shipstation.com/autenticazione, docs.shipstation.com/getting-started, docs.shipstation.com/rate-limits, docs.shipstation.com/sandbox, docs.shipstation.com/products-and-plans, docs.shipstation.com/plans/shipstation-free-starter, docs.shipstation.com/plans/shipstation-standard-premium, docs.shipstation.com/apis/shipengine/docs/guides/auth, docs.shipstation.com/apis/shipengine/docs/guides/rate-limits, docs.shipstation.com/apis/shipstation-v1/docs/start-here/…, nango.dev/docs/integrations/all/shipstation-v2/connect.

   Nome della società

   Un nome che riconoscerai in seguito, come ad esempio "Database delle vendite".

   Chiave API di ShipStation

   La tua chiave API di ShipStation, che trovi in ShipStation in Impostazioni, Account, Impostazioni API.

   Cliccare Verifica la connessioneQuando legge Collegato, clicca RisparmiareLa connessione raggiunge il tuo agente in pochi secondi.

   Agenti di dati aperti

   Test fallito? Solitamente manca un permesso o una credenziale dall'account ShipStation sbagliato. La procedura guidata sopra elenca problemi comuni e le relative soluzioni.

4. See your data in Query Builder Opzionale

   You can look at your ShipStation account before Excel is involved at all. Open Generatore di query in the portal and pick the connection you just made. The Schema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Correre and the rows appear under Risultati. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Aggiungere flussi di query a Excel

   In Excel, vai a Inserisci → Ottieni componenti aggiuntivi, cerca Flussi di querye clicca AggiungiOppure aprilo direttamente da Query Streams su Microsoft AppSourceSul ripiano multifunzione compare il pulsante Query Streams. Accedi con lo stesso account.

   Funziona con Excel per Microsoft 365 su Windows e Mac, e con Excel sul web.

6. Porta il tuo primo tavolo

   Fai clic sul pulsante Query Streams, scegli Trasmetti una querye seleziona la connessione appena stabilita.

   Digita la query che vuoi eseguire. Questa estrae alcune colonne da un stazione di spedizione spedizioni tavolo:

   Esempio · SQL

   SELECT shipment_id, shipment_status, ship_date, carrier_id FROM shipstation.shipments ORDER BY created_at DESC LIMIT 100;

   Sotto Scheda di destinazione scegliere Crea un nuovo foglioQuindi premi il pulsante di riproduzione (la freccia ▶). Le righe vengono importate in Excel in uno o due secondi. Premilo di nuovo ogni volta che i dati cambiano e il foglio si aggiornerà automaticamente.

   Non conosci SQL? Build it in Generatore di query first and paste it here, or pick it from Saved Queries if you saved it.

Buone mosse successive

• Salva la query nel portale, così puoi eseguirlo di nuovo con un solo clic, da Excel o Fogli Google.
• Aggiungi un filtro come ad esempio un intervallo di date, in modo che la stessa query possa rispondere "questo mese" senza modifiche.
• Condividi i risultati con un collega. Loro vedono le righe, non le tue credenziali.

Domande che le persone si pongono

Guide correlate

• Da ShipStation a Fogli Google
• Da Stripe a Microsoft Excel
• Da HubSpot a Microsoft Excel
• Da Shopify a Microsoft Excel
• Esecuzione di query SQL in Excel
• Tutte le guide