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 ID Client e Segreto 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;

• vai su Sviluppa app.

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

Nella Dev Dashboard:

• seleziona Crea app;

• scegli Inizia dalla Dev Dashboard;

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

• vai su Crea per confermare la creazione dell’app;

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

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

• su Accesso, nella sezione Ambiti scegli Seleziona ambiti e abilita read_orders e write_orders accanto a Orders poi vai su Fine;

• vai su Rilascia per confermare. Puoi inserire un nome per la versione e premere di nuovo Rilascia.

Vai nella home dell'app premendo in alto a destra il nome dell’app, quindi vai nella sezione Distribuzione:

• vai su Selezione metodo di distribuzione;

• seleziona Distribuzione personalizzata;

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

• conferma premendo Genera Link.

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

Per installare l’app nel negozio:

• torna alla home dell’app;

• scorri fino alla sezione Installazioni;

• seleziona Installa app;

• scegli il tuo negozio e conferma con Installa.

Per recuperare le credenziali, nella Dev Dashboard:

• vai nella sezione Impostazioni dell’app;

• copia l'ID Client;

• copia il Segreto premendo sull'icona oppure visualizzalo e copialo manualmente.

L'ID Client e il Segreto sono dati sensibili. Copiali e conservali in modo sicuro prima di proseguire.

Inserisci i dati in Scontrina

Vai sull'app Scontrina, apri Menu, su Integrazione seleziona Attiva integrazione.

Scegli Usa API e compila i campi:

• Client Key: inserisci l'ID Client copiato da Shopify;

• Client Secret: inserisci il Segreto copiato da Shopify;

• Codice integrazione: inserisci quello scelto in fase di configurazione (per esempio 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.