Shopify è una piattaforma per il commercio elettronico in grado di offrire la possibilità alla imprese di creare un proprio sito E-Commerce in modo semplice. La piattaforma si integra con MagicStore permettendo di utilizzare il sito E-Commerce Shopify come un ulteriore punto di vendita dei propri prodotti garantendo, grazie alla sincronizzazione, uno scambio diretto di informazioni con il ChannelPlace avendo la sicurezza di avere sempre allineate le proprie Giacenze di Magazzino.
Indice degli argomenti:
- Introduzione
- 1: Creazione dell'App nel CMS di Shopify
- 2: Attivazione della Licenza web in MagicStore
- 3: Configurazione del Canale Web Shopify in MagicStore
- 4: Caso particolare: più sedi sul pannello Shopify
Importante
Si avvisa che l'installazione di plugin di terze parti potrebbe influire sul corretto funzionamento dell'integrazione con MagicStore
Introduzione
L'integrazione tra MagicStore e il proprio sito Shopify avviene attraverso alcuni passaggi di configurazione iniziale che vanno effettuati una tantum sia all'interno di Shopify che nelle Configurazioni di Sistema di MagicStore.
Nel corso di questa guida verranno fornite tutte le informazioni dettagliate su come effettuare il collegamento ed iniziare a lavorare con l'integrazione.
1: Creazione dell'App nel CMS di Shopify
Per prima cosa bisogna procedere alla creazione dell'App su Shopify per ottenere i codici da inserire all'interno di MagicStore per finalizzare il collegamento tra le piattaforme.
Per creare l'App:
- Accedere al proprio CMS del sito Shopify
- Dal menu di sinistra cliccare su "App"
- Da questa pagina selezionare, in alto a destra, su "Sviluppa App"
- Dalla pagina che si apre cliccare su "Crea un'app"
- Si apre una finestra popup da compilare in questo modo:
- Nel campo "Nome app" inserire un nome per identificare l'app
- Nel campo "Sviluppatore app" inserire il proprio indirizzo e-mail
- Cliccare in basso a destra su "Crea app"
- Si atterra all'interno della pagina dell'app appena creata. Da qui cliccare in alto, dal menu posizionato immediatamente sotto il nome dell'app, su "Configurazione"
- In corrispondenza della prima sezione "Integrazione API del pannello di controllo" cliccare su "Configura"
- All'interno della sezione centrale della pagina "Ambiti di accesso API del pannello di controllo" abilitare tutte le voci in elenco cliccando sul permesso di scrittura ("write_specificadelpermesso") o di lettura, qualora il permesso di scrittura non fosse presente ("read_specificadelpermesso")
Importante
Scorrere l'elenco fino in fondo ed assicurarsi di aver selezionato tutte le voci prima di proseguire
- Dalla successiva sezione "Registrazioni ai webhook" (Posizionata in fondo al precedente elenco) selezionare, dal campo "Versione evento" il valore 2021-07
Cliccare su "Salva" in basso a destra della pagina
- Tornare alla pagina Configurazione (è possibile tornare alle configurazioni scrollando la pagina verso l'alto e cliccando sulla specifica voce dal menu)
- In corrispondenza della sezione "Integrazione API della vetrina" cliccare su "Configura"
- All'accesso alla pagina si visualizza la sezione "Ambiti di accesso API della vetrina": Da qui selezionare tutte le voci presenti nell'elenco (Check-out, Clienti, Contenuto, ecc...)
- In fondo alla pagina cliccare su "Salva"
- Scrollare la pagina fino al menu e cliccare su "Credenziali API"
- Dalla sezione "Token di accesso" cliccare sul pulsante "Installa app"
- Si apre un messaggio popup di sicurezza in cui viene chiesta conferma dell'installazione. Procedere e cliccare su "Installa".
- Una volta installato si nota che nella pagina "Credenziali API", in corrispondenza del campo "Token di accesso API del pannello di controllo" si è generato un token. Il token va copiato cliccando sullo specifico comando presente nel campo.
A questo punto spostarsi all'interno di MagicStore e seguire i passaggi descritti nei prossimi paragrafi.
2: Attivazione della Licenza web in MagicStore
- Accedere a MagicStore nell'unità "Azienda Principale"
- Dal modulo Licenze cliccare sul tab Licenza Canale Web Premium
- Verificare che sia disponibile una Licenza Canale Web Premium da legare al Canale Web Shopify.
Esistono 3 circostanze in cui ci si può imbattere; Per ciascuna vengono date indicazioni su come lavorare prima di procedere allo step successivo:
- Se si visualizza una Licenza non assegnata ad alcuna Unità Aziendale e di nessuna tipologia, basterà cliccare, in corrispondenza della Licenza, da Azioni su "Associazione Unità Aziendale" e dalla finestra popup che appare selezionare l'Unità "Entità Web". Passare, poi, allo step 3.
- Se in elenco non si visualizza alcuna Licenza disponibile, attivarne una nuova cliccando sul "+" in alto a sinistra della pagina e, dopo averla attivata, assegnarla all'Unità Aziendale "Entità Web" come visto nel punto precedente
- Se in elenco è già presente una Licenza assegnata all'Unità Aziendale "Entità Web" ma di nessuna tipologia, vorrà dire che la Licenza è già pronta per essere utilizzata per l'attivazione del Canale Web "Shopify". In questo caso passare direttamente al punto 3.
3: Configurazione del Canale Web Shopify in MagicStore
Dopo aver fatto i controllo sulla Licenza:
- Spostarsi nell'Unità "Entità Web"
- Da Configurazioni di sistema cliccare su "Canali Web"
- In alto a sinistra della pagina cliccare su + per attivare un nuovo Canale Web
- Dalla finestra popup che appare selezionare:
- Da "Canale Web" a voce "Shopify"
- Da "Codice Licenza" la Licenza disponibile e associata all'Unità "Entità Web"
- Confermare la scelta. Così facendo nell'elenco apparirà una stringa "Shopify" con stato di configurazione disattivo (come indicato dalla colorazione grigia del baloon di stato). Per attivare il canale, cliccare da "Azioni" su Modifica
- Inserire le informazioni Principali per il settaggio del Canale, e compilare la sezione Informazioni Tecniche in questo modo:
- Nel campo Site Url occorre inserire l'indirizzo del proprio Negozio online (solitamente nella forma ragionesociale.myshopify.com compreso il protocollo http:// o https://).
Nota
Può capitare che l'Url non sia reperibile direttamente dalla barra in alto della pagina del browser. In questa circostanza va cercato nel Cms al seguente percorso: Home > App > App e canali di vendita > Domini.
Attenzione
Non copiare nient'altro che appare dopo il simbolo "/" e non aggiungere "www" qualora il sito non lo prevede.
-
- Nel campo “Api Password” inserire il token generato nelle configurazioni di Shopify e precedentemente copiato.
-
"Costo Prodotto" è un menu con valori preconfigurati da cui selezionare quale tra i valori indicati MagicStore deve inviare a Shopify.
- Se si seleziona "Costo medio Ponderato", MagicStore invia al Canale Web il valore del Costo Medio Ponderato della singola variante (se presente). Il valore viene catturato e visualizzato nel campo "Costo per articolo" di Shopify.
- Se si seleziona "Ultimo Costo di Acquisto", MagicStore invia al Canale Web il valore dell' Ultimo Costo di Acquisto di ciascuna singola variante (se presente). Il valore viene catturato e visualizzato nel campo "Costo per articolo" di Shopify.
- Se, invece, si lascia invariata la selezione del valore di default "Non Inviare", MagicStore non invierà alcuna informazione a riguardo.
-
Prezzo Confronto è il campo da cui selezionare quale tra i prezzi indicati si desidera inviare a Shopify nel campo "Prezzo di confronto". In particolare:
- Selezionando "Non inviare" non viene gestito alcun valore.
- Selezionando "Prezzo Promo" viene inviato a Shopify il prezzo promo di ciascuna singola variante. In questo caso essendo il Prezzo Promo inferiore del prezzo di vendita del prodotto, su Shopify il prezzo promo viene visualizzato come "Prezzo", mentre il prezzo di vendita del prodotto sarà inserito in automatico nel campo "Prezzo di Confronto". Così facendo sulla scheda pubblica del prodotto si visualizza il prezzo di vendita barrato ad indicare uno sconto sul prezzo originale.
- Selezionando "Prezzo Consigliato" viene inviato a Shopify il Prezzo Consigliato associato a ciascuna variante in MagicStore. (Si ricorda che in MagicStore è possibile assegnare ai prodotti un prezzo consigliato per ciascuno dei listini attivi.) Quando si invia questo valore a Shopify, il prezzo di vendita resta visualizzato nel campo "Prezzo", mentre il prezzo consigliato viene inserito nel campo "Prezzo di confronto".
Importante
Se il valore di “Prezzo confronto” dovesse risultare maggiore di quello presente in “Prezzo”, nella scheda del prodotto in vetrina si visualizza un valore di prezzo barrato. Se invece il valore di “Prezzo confronto” dovesse risultare uguale o inferiore al "Prezzo", nella vetrina articolo si visualizza soltanto il valore di “Prezzo”.
- Terminare la configurazione cliccando su "Salva"
Nota
E' sempre possibile modificare i parametri di Configurazione del Canale Web anche dopo averlo attivato. Prima di farlo, però, è necessario:
- Disattivare il canale Web
- Apportare le modifiche ai parametri di configurazione
- Riattivare il canale Web. La disattivazione e successiva riattivazione non avrà alcuna conseguenza sui prodotti già pubblicati.
- Una volta effettuato il salvataggio non sarà più necessaria altra operazione (mapping). Perciò attendere che il pallino di stato canale diventi verde e poi il collegamento sarà pronto per essere utilizzato.
Attenzione
E' importante che dopo il collegamento tra MagicStore e Shopify non venga effettuata alcuna modifica di magazzino su Shopify. In questo caso l'integrazione verrà compromessa e sarà necessario l'intervento di un tecnico per ripristinare la comunicazione tra MagicStore e Shopify.
4. Caso particolare: più sedi sul pannello Shopify
Nel caso in cui si abbiano già dei prodotti pubblicati/agganciati da MagicStore, creare una o più sedi sul Cms di Shopify o cambiare la sede predefinita con una nuova provoca una mancata sincronizzazione con il gestionale in quanto esso comunica con una sola sede (quella predefinita, appunto). Ad esempio, se sul pannello di Shopify sono registrate più sedi e occorre effettuare il reso di un prodotto pubblicato/agganciato dal gestionale, il pannello chiede in quale sede restituire la merce e se, per errore o volontariamente, viene selezionata la sede che non comunica con il gestionale, avviene un disallineamento dei dati rispetto ai prodotti che sono sul gestionale.