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

_Updated: 2026-09-17 · Source: https://ruit.es/it/docs/vendere-su-shopify/_

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.

> **Avviso:** Dal 2026 le app nuove **si creano solo nel Dev Dashboard**. Se entri in Impostazioni, App e canali di
> vendita, non c'è più nessun modulo: solo una scheda che ti manda lì. Le app che hai creato prima nel
> pannello continuano a funzionare, e le loro chiavi stanno nella loro scheda delle credenziali.

## 1. Apri il Dev Dashboard

Entra in [dev.shopify.com](https://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`.

_Schermata: L'elenco delle app del Dev Dashboard di Shopify, con la ricerca per nome e il pulsante per creare un'app in alto a destra_

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.

_Schermata: La schermata per creare un'app nel Dev Dashboard, con il campo del nome e il pulsante per creare_

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_publications
```

C'è 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.

_Schermata: Il campo `Scopes` del Dev Dashboard con gli otto permessi incollati come un elenco separato da virgole_

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 |

> **Avviso:** I primi sei si controllano quando ti colleghi, quindi se ne manca uno te ne accorgi subito. **I due
> delle pubblicazioni non si controllano**, e lì sta la trappola: la connessione riesce, il prodotto si
> crea, e non compare nel tuo negozio perché nessuno l'ha pubblicato nel canale di vendita. Mettili
> adesso e ti risparmi il viaggio.

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

_Schermata: La finestra che conferma la pubblicazione di una versione nuova dell'app, con i campi facoltativi del nome e del messaggio_

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.

_Schermata: La vista generale dell'app nel Dev Dashboard, con la versione attiva e il pulsante per installare l'app_

La vista generale, con la versione già pubblicata e il pulsante per installare.

_Schermata: La schermata di installazione dentro il pannello del negozio, con i permessi che l'app chiede e i pulsanti per annullare e 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.

> **Nota:** Senza questo passo le chiavi esistono ma non autorizzano niente, e RUIT rifiuta la connessione
> dicendo che l'app non è installata nel negozio.

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

> **Avviso:** RUIT vuole la coppia **`Client ID` più `Client Secret`**, e nient'altro. Non copiare la chiave di
> automazione del Dev Dashboard né, in un'app vecchia, la chiave di accesso che inizia per `shpat_`.
> Con quelle due chiavi RUIT emette i propri accessi, che scadono ogni giorno e si rinnovano da soli,
> quindi non conserviamo mai una chiave permanente del tuo negozio.

## 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](https://ruit.es/docs/importar-desde-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.

- [Vendere su WooCommerce con RUIT](https://ruit.es/docs/vender-en-woocommerce/)
- [Vendere su PrestaShop con RUIT](https://ruit.es/docs/vender-en-prestashop/)