Configurazione di Shopify in MagicStore

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 

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 "Impostazioni"
• Successivamente, cliccare su "App"
• Da questa pagina selezionare, in alto a destra, su "Sviluppa App"

• Dalla pagina che si apre cliccare su "Sviluppa app nella Dev Dashboard"

• Si apre una finestra popup da compilare in questo modo:
  • Selezionare "Create App"

• Nel campo "Start from Dev Dashboard" inserire il nome dell'app (e.s. magicstore)

• Successivamente, a sinistra, selezionare "Settings", in quel campo copiare Client ID e Secret. Questi campi vanno inseriti su Magicstore.

• Successivamente, sempre a sinistra, occorre selezionare "Versions" e successivamente "Create a version".

• All'interno della sezione, nel campo "App URL" occorrerà inserire "https://shopify.magicstore.cloud/shopify/auth/entry?tenantId={tenantId}&webChannelId={webChannelId}", nel dettaglio occorre inserire il codice cliente al posto di {tenantId} e il codice del canale web (presente nella URL appena vai nel canale web da magicstore) al posto di {webChannelId}.
  Ad esempio, una configurazione corretta sarebbe: https://shopify.magicstore.cloud/shopify/auth/entry?tenantId=xd1234&webChannelId=1

• Nel campo "Webhooks API Version" inserire la versione 2025-07.

• Successivamente, sempre nella stessa schermata, nel campo "Scopes" occorre selezionare tutti i campi. Nel campo "Redirect URLs" inserire "https://shopify.magicstore.cloud/shopify/auth/callback" e "https://shopify.magicstore.cloud/shopify/auth/callback?tenantId={tenantId}&webChannelId={webChannelId}" (stesso ragionamento per tenant e web channel). I due link devono essere divisi da una virgola.

• Ultimo procedimento da fare in questa sezione, è selezionare "relase" e confermare.
• Successivamente, occorre andare nel campo "Home" e "Select distribution metod".
  
  
• Occorre selezionare "Distribuzione personalizzata" e confermare.

• Nella schermata successiva, occorre inserire il dominio del sito Shopify (e.s. magicstore.myshopify.com).

• Infine, copiare ed incollare il link e una volta installata nella sezione "applicazioni" sarà presente l'app correttamente collegata. Da qui, occorre copiare il token ed inserirlo su magicstore nel campo "Api Password" del gestionale.

  
   

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://). 

Per verificare l'indirizzo corretto, da Shopify, andare in Impostazioni.

Successivamente, cliccare su Domini.

Copiare il dominio presente in myshopify

•  
  • Nel campo “Api Password, Client ID e Client Secret” 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". 

• Terminare la configurazione cliccando su "Salva"

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.