Quando usare questa procedura

Segui questa procedura se devi creare una nuova integrazione tra Scontrina e Shopify con la modalità Dev Dashboard. La guida descrive il flusso che prevede la creazione di una nuova app, la scelta di Custom distribution, l’installazione dell’app nel negozio e il recupero di Client ID e Client Secret da inserire in Scontrina.

Questa guida riguarda la procedura con Dev Dashboard. Se il tuo store mostra ancora il percorso Sviluppa app, Crea un’app, usa la guida dedicata alla procedura precedente al 2026.

Crea l’app in Shopify

Accedi alla dashboard di Shopify:

• vai su Impostazioni;

• seleziona App e canali di vendita;

• vai su Sviluppa app.

Seleziona Crea app nella Dev Dashboard per essere reindirizzato alla nuova Dev Dashboard di Shopify.

Nella Dev Dashboard:

• seleziona Create app;

• scegli Start from Dev Dashboard;

• inserisci un nome per l’app, per esempio Scontrina;

• vai su Create per confermare la creazione dell’app.

Nella sezione Distribution:

• vai su Choose distribution;

• seleziona Custom distribution;

• inserisci il dominio del tuo negozio, per esempio ilmionegozio.myshopify.com

• conferma.

Dopo la selezione, il metodo di distribuzione non può essere cambiato. Assicurati di scegliere Custom distribution prima di confermare.

Apri la scheda Versions dell’app e completa la configurazione:

• nel campo App URL, inserisci https://shopify.dev/apps/default-app-home;

• in Webhooks API version, seleziona la versione più recente disponibile, ad esempio 2026-01;

• in Access scopes, abilita read_orders e write_orders;

• seleziona Release per confermare.

Per installare l’app nel negozio:

• torna alla home dell’app;

• scorri fino alla sezione Installs;

• seleziona Install app;

• scegli il tuo negozio e conferma con Install.

Per recuperare le credenziali:

• vai nella sezione Settings dell’app;

• copia il Client ID;

• visualizza premendo show il Client Secret e copialo.

Client ID e Client Secret sono dati sensibili. Copiali e conservali in modo sicuro prima di proseguire.

Inserisci i dati in Scontrina

Vai su Scontrina, apri Menu, Integrazione e seleziona Attiva integrazione.

Compila i campi in questo modo:

• Client Key: inserisci il Client ID copiato da Shopify;

• Client Secret: inserisci il Client Secret copiato da Shopify;

• Codice integrazione: inserisci shopify_2026-01;

• URL: inserisci l’indirizzo del negozio senza https:// e usando il dominio Shopify, come ilmionegozio.myshopify.com;

• Titolo: inserisci il nome che vuoi visualizzare nel pulsante della schermata principale di Scontrina.

• Conferma per salvare i dati.

Al termine, nella pagina principale di Scontrina sarà mostrato un nuovo pulsante con il titolo scelto, da usare per visualizzare gli ordini del tuo e-commerce.

Allinea le aliquote IVA

Per completare correttamente l’integrazione, verifica che le aliquote IVA configurate su Shopify siano allineate ai reparti presenti in Scontrina.

Per ogni aliquota IVA usata nei prodotti Shopify, in Scontrina deve essere presente almeno un reparto con la stessa aliquota. Questo controllo serve ad applicare l’aliquota corretta quando emetti lo scontrino.

Se non hai ancora configurato correttamente le imposte nel tuo store, segui la guida ufficiale Shopify dedicata alla configurazione delle imposte UE.

Se la configurazione è corretta, l’integrazione è pronta e puoi usare Scontrina per gestire gli ordini provenienti da Shopify.