Collegare il tuo negozio Shopify a RUIT
Tutorial per collegare Shopify: creare l'app nel Dev Dashboard, incollare gli otto permessi, installarla e copiare le sue due chiavi in RUIT.
In questo tutorial colleghi il tuo negozio Shopify a RUIT. Sono due parti: prima crei un’app dentro il tuo stesso negozio, e dopo incolli le sue due chiavi in RUIT. Ci vogliono cinque minuti e si fa una volta sola.
Ti serve essere il proprietario del negozio, oppure avere il permesso di sviluppo delle app se sei parte del team. Va bene qualsiasi negozio, anche quelli di sviluppo. RUIT non ti chiede in nessun momento la tua password di Shopify: i permessi li definisci tu e li puoi ritirare quando vuoi.
1. Apri il Dev Dashboard
Entra in dev.shopify.com con lo stesso account con cui amministri il tuo
negozio. Vedi l’elenco delle app della tua organizzazione e, in alto a destra, Create app.
L’elenco delle app. Se è la prima volta sarà vuoto e vedrai un comando da terminale: ignoralo, è per
chi programma app. Il pulsante che cerchi è Create app.
2. Crea l’app e dalle un nome
Premi Create app, scrivi un nome che riconosci e conferma. Il nome è solo per te.
Qualsiasi nome va bene. Nelle figure di questa guida si chiama RUIT.
3. Incolla gli otto permessi
Shopify ti lascia nella schermata della versione. Cerca la sezione API access e, nel campo
Scopes, incolla questo elenco così com’è:
read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_publications,write_publicationsC’è anche un pulsante per segnarli uno a uno in un elenco lunghissimo, ma incollare la lista è più rapido e non te ne lasci nessuno. Gli altri campi restano come sono.
Gli otto permessi incollati in una volta sola. Sotto il campo c’è un selettore con delle caselle che fa la stessa cosa, uno a uno.
| Permesso | Obbligatorio | A cosa serve |
|---|---|---|
read_products e write_products | Sì | Importare, pubblicare e modificare prodotti |
read_inventory e write_inventory | Sì | Tenere la giacenza sincronizzata |
read_locations | Sì | Sapere in quale magazzino scrivere quella giacenza |
read_orders | Sì | Venire a sapere delle vendite subito. Senza, la connessione viene rifiutata |
read_publications e write_publications | Molto consigliato | Che il prodotto si veda nel tuo negozio e non solo nel pannello |
4. Pubblica la versione
Premi Release, in alto a destra, e conferma nella finestra che si apre. Il nome e il messaggio
che ti chiede sono facoltativi.
Questo è il passo che si dimentica di più. Senza pubblicare la versione, le chiavi del passo 6 non esistono ancora.
5. Installa l’app nel tuo negozio
Torna alla vista generale dell’app e premi Install app. Scegli il tuo negozio e conferma nella
schermata dei permessi.
La vista generale, con la versione già pubblicata e il pulsante per installare.
Shopify avvisa che l’app non ha superato la sua revisione. È normale per un’app privata creata nella tua stessa organizzazione: nessuno oltre a te può installarla, e i permessi sono quelli che hai appena definito.
6. Copia il Client ID e il Client Secret
Nelle impostazioni dell’app, nella sezione delle credenziali, trovi i due valori. Il segreto resta nascosto finché non premi l’icona dell’occhio.
7. Collega il negozio in RUIT
Entra in Impostazioni → Account, premi Connetti Account e scegli Shopify. Ti chiede tre cose:
| Campo | Cosa incollare |
|---|---|
| URL del negozio | Il dominio che finisce in .myshopify.com |
Client ID | Quello del passo 6 |
Client Secret | Quello del passo 6 |
L’indirizzo è il dominio che finisce in .myshopify.com, non il dominio con cui vendi al pubblico.
RUIT è tollerante con il copia e incolla: accetta anche l’indirizzo del pannello di amministrazione.
Video non ancora disponibile: Collegare un negozio Shopify
Cosa hai ottenuto
Il tuo negozio Shopify è collegato a RUIT con delle chiavi che sono tue e che puoi revocare quando vuoi. Da qui in poi puoi importare i prodotti che hai già, pubblicare quelli del tuo inventario, e RUIT viene a sapere di ogni vendita appena succede.
Passo successivo: importare da un marketplace per portare dentro quello che vendi già in quel negozio.
Se qualcosa non torna
- La connessione fallisce dicendo che mancano dei permessi. L’errore dice quali. Torna al passo 3, incolla l’elenco intero in una versione nuova dell’app e pubblicala; i permessi viaggiano con la versione, quindi modificarli senza pubblicare non cambia niente.
- Il prodotto si crea ma non si vede nel negozio. Ti mancano i due permessi delle pubblicazioni. Sono quelli che non si controllano quando ti colleghi.
- La connessione fallisce dicendo che l’app non è installata. Ti sei saltato il passo 5, oppure hai installato l’app in un altro negozio.
- Avevi un’app di prima del 2026. Vale ancora. Le sue chiavi stanno nella sua scheda delle credenziali dentro il pannello del negozio, non nel Dev Dashboard.
- Si esaurisce la giacenza di un prodotto. RUIT archivia il prodotto su Shopify invece di cancellarlo, quindi lo storico e l’indirizzo del prodotto si conservano.
Questo articolo ti è stato utile?
Grazie per avercelo detto.