La chiave Shopify che sposta il tuo negozio

Che cos’è questa chiave e perché la crei tu

Shopify non distribuisce password che permettano a un servizio esterno di leggere il tuo negozio. Crei invece una piccola app sul tuo negozio, spunti esattamente ciò che può leggere e Shopify le consegna un token. Incolli quel token in Omniterra e noi leggiamo il tuo catalogo attraverso di esso.

Da qui discendono due cose, entrambe a tuo vantaggio:

• Decidi tu cosa vediamo. Otteniamo soltanto i permessi che spunti. Chiediamo accesso in lettura, niente che scriva nel tuo negozio Shopify.
• Puoi interrompere in qualsiasi momento. Elimina l’app in Shopify e il token smette subito di funzionare, senza che venga avvisato nessuno.

Il tuo negozio Shopify continua a funzionare per tutto il tempo. Nulla di ciò che facciamo lo modifica.

Passo 1 — aprire le impostazioni delle app

Nel pannello Shopify vai su Impostazioni → App e canali di vendita → Sviluppa app.

Se compare un pulsante Consenti lo sviluppo di app personalizzate, premilo. Shopify lo chiede una volta per negozio, e può farlo solo chi è proprietario.

Passo 2 — creare l’app

Premi Crea un’app, dalle un nome che riconoscerai più avanti — «migrazione Omniterra» va benissimo — e conferma.

A questo punto l’app è vuota. Non può ancora leggere nulla.

Passo 3 — spuntare i permessi

Apri la scheda Configurazione, poi Integrazione Admin API → Modifica.

Spunta l’accesso in lettura per tutto ciò che vuoi portare con te:

Premi Salva.

Omniterra ti mostra questo stesso elenco anche nella schermata di importazione, pronto da copiare, e ti dice quali mancano ancora se la connessione torna incompleta.

Passo 4 — installare l’app e copiare il token

Vai alla scheda Credenziali API e premi Installa app.

Shopify mostra ora il token di accesso Admin API, una stringa che inizia con `shpat_`. Copialo.

Leggi bene questo punto: Shopify mostra quel token una sola volta. Se chiudi la pagina senza averlo copiato, non potrai più rivederlo: dovrai disinstallare e reinstallare l’app per ottenerne uno nuovo. Non si perde nulla di fatto, ma sono cinque minuti fastidiosi.

Passo 5 — incollarlo in Omniterra

Nel pannello Omniterra vai su Prodotti → Importa / Esporta, scegli Shopify, scrivi l’indirizzo del tuo negozio (`il-mio-negozio.myshopify.com`) e incolla il token.

Premi Collega. Leggiamo il tuo catalogo e ti mostriamo che cosa abbiamo trovato prima di scrivere qualsiasi cosa: quanti prodotti, clienti, ordini, pagine. Non si muove nulla finché non lo dici tu.

Se dice che mancano dei permessi

Questa cosa sorprende, quindi conviene saperla prima: Shopify segnala i permessi concessi al momento dell’installazione, non quelli scritti ora nella configurazione. Se spunti altre caselle dopo aver installato, l’app conserva l’accesso precedente, più ristretto.

La soluzione è reinstallare: Configurazione → Integrazione Admin API → Modifica, spunta ciò che manca, Salva, poi Credenziali API → Reinstalla app. Il token resta lo stesso.

Se hai creato l’app nel Dev Dashboard

Alcuni negozi hanno un’app creata su `dev.shopify.com` anziché dentro il pannello del negozio. L’idea è la stessa, con due dettagli in più:

1. Modifica `access_scopes` nella configurazione dell’app e premi Salva.
2. Premi Rilascia. Senza rilascio, la tua modifica resta una versione non pubblicata e il negozio non la vede mai.
3. Reinstalla l’app sul negozio, così i nuovi permessi vengono davvero concessi.

Che cosa si sposta e che cosa non può

Prodotti con le loro varianti, immagini, collezioni, clienti, ordini, sconti, pagine, articoli del blog, menu, reindirizzamenti e file passano tutti.

Alcune cose non possono passare, e te lo diciamo prima di cominciare anziché dopo: i codici delle carte regalo (Shopify non li espone mai), i dati delle carte salvate (appartengono al tuo fornitore di pagamenti, non al tuo negozio) e le app di terze parti installate, con i dati che tengono al proprio interno.

Se arrivano meno prodotti di quanti ne aspettavi

Tre cose spiegano quasi tutti i casi, e nessuna significa che l’importazione sia fallita.

Le bozze e i prodotti archiviati restano indietro per impostazione predefinita. Shopify li tiene fuori dal catalogo attivo, e così facciamo noi. Se li vuoi, pubblicali in Shopify prima di avviare l’importazione, oppure portali qui e rimettili in bozza dopo.

I prodotti senza prezzo o senza variante vengono saltati, perché così come sono non si possono vendere. Compaiono nel rapporto finale, per nome, così vedi esattamente quali e perché.

Un permesso spuntato dopo l’installazione non vale finché non reinstalli l’app; è la stessa trappola di sopra. Reinstalla, poi premi Ricontrolla nella schermata di importazione: rileggiamo il tuo catalogo senza toccare nulla di ciò che è già arrivato.

Puoi lanciare l’importazione due volte, se serve. I prodotti vengono abbinati tramite il loro identificatore Shopify, quindi un secondo passaggio aggiorna ciò che è già qui invece di creare duplicati.

Quanto tempo richiede

Un catalogo di qualche centinaio di prodotti di solito è pronto in un paio di minuti. I negozi grandi procedono a blocchi e puoi lasciare la pagina: l’importazione va avanti e ne vedi l’avanzamento quando torni.