Passa al contenuto principale

Shopify

Gli adapter verso Shopify sono frutto dell'esperienza di numerosi anni come Shopify Partner Plus.

I benefici della nostra soluzione:

⚡ Eccellenti performance di invio dati verso Shopify.

💸 Integrare Shopify è complesso. Invece, puoi concentrarti sui dati dei prodotti con le nostre API semplificate.

✅ Le API Deprecate non saranno più un problema. Gli aggiornamenti saranno automatici e trasparenti.

💣 Semplici Json per operazioni complesse. La creazione prodotti chiama più di 20 query e mutation di Shopify.

Flussi prodotto Shopify​

Step necessari all'attivazione di un flusso di sincronizzazione prodotti

Flussi ordini Shopify​

Step necessari all'attivazione di un flusso di sincronizzazione ordini

Creazione customApp Shopify​

Gli adapter di integrazione con Shopify utilizzano le API GraphQL a massime performance per integrare i vari flussi dati.
Per poterlo fare sarà necessario creare una custom app dal pannello di amministrazione (per versione precedenti al 1° gennaio 2026) oppure tramite Dev Dashboard e riportare le configurazioni di autenticazione dell'app. Link documentazione Shopify - Custom app

I permessi da fornire alla custom app dipendono dai flussi che si vogliamo configurare.
Ad esempio se vogliamo configurare il flusso di stock sarà necessario configurare in lettura e scrittura lo stock ma anche le location in lettura

Come creare una custom app usando il Dev Dashboard (nuovo metodo)​

Per creare una nuova custom app compatibile con OAuth / Client credentials, segui questi passaggi:

  1. Accedi al Dev Dashboard — oppure, da Shopify Admin, vai su Settings > Apps and sales channels > Develop apps > Build apps in Dev Dashboard.
  2. Nella sezione “Apps” del Dev Dashboard, clicca su Create app → seleziona Start from Dev Dashboard.
  3. Assegna un nome all’app e conferma con Create.
  4. Una volta creata l’app, vai nella scheda Versions e crea una versione:
    • imposta l’URL della tua app (se non è “embedded” dentro l’admin Shopify, puoi usare l’URL di default fornito da Shopify)
    • seleziona la versione dell’API Webhooks (tipicamente l’ultima disponibile)
    • definisci gli scopes necessari — ovvero i permessi API richiesti dalla tua integrazione (stock, ordini, prodotti, location, ecc.)
    • salva e fai Release della versione creata.
  5. Installa l’app sul negozio: nella sezione “Home” dell’app nel Dev Dashboard, clicca su Install app, scegli o crea lo store su cui installarla e conferma con Install.
  6. Autentica l’app usando il Client credentials grant: recupera Client ID e Client Secret dall’app creata tramite Dev Dashboard. Queste credenziali saranno necessarie per generare un token da usare nelle chiamate API (uno “shop access token”).

Link documentazione Shopify - creazione di custom app tramite Dev Dashboard

Autenticazione​

L’integrazione supporta due modalità di autenticazione verso Shopify:

  1. Autenticazione tramite Access Token (Legacy - non più disponibile per nuove app dal 1° gennaio 2026)
  2. Autenticazione tramite OAuth (Client ID + Client Secret) — metodo consigliato e supportato per le nuove app.

È possibile scegliere liberamente quale metodo utilizzare in base alla configurazione della propria app Shopify. Se vengono forniti entrambi i metodi nella stessa richiesta, verrà data precedenza a OAuth (Client ID + Client Secret).

Nota importante: A partire dal 1° gennaio 2026, non sarà più possibile creare nuove custom app legacy (Access Token). Le app già esistenti continueranno a funzionare, ma per tutte le nuove integrazioni è obbligatorio utilizzare l’autenticazione OAuth.

1. Autenticazione tramite Access Token (Legacy)​

Se l’app utilizza un Access Token privato (ad esempio token generato nella sezione Admin > Apps > Develop apps), è sufficiente specificare l'header:

HeaderValoreDescrizione
x-shopify-access-tokenshpat_***************Access token dell’app Shopify

2. Autenticazione tramite OAuth​

Se invece si utilizza l’autenticazione OAuth, è necessario inviare nell’header della richiesta sia il Client ID che il Client Secret dell’app:

HeaderValoreDescrizione
x-shopify-client-id***************client id dell'app di integrazione
x-shopify-client-secret***************client secret dell'app di integrazione

Definizione metafields​

Censire i metafield all'interno di Shopify Admin -> Settings -> Custom Data

Inserire nel gruppo "prodotti" i metafield custom necessari.

suggerimento

Scegli con attenzione il tipo dei metafields​

I metafield influenzano sia il processo di importazione che di traduzione. Il tipo dei metafield rende possibile o meno la creazione di filtri in categoria o la presenza di HTML.

Documentazione Metafields Shopify

Destinazione​

Configurazione di una destinazione Shopify, che sarà poi utilizzata dagli altri flussi per l'interazione con l'e-commerce. Download destinazione di esempio

CampoValoreNote
destination_typehttpRequestgli adapter di integrazione lavorano in http
Base Urlhttps://adapt.flowlyze.comurl degli adapter
Headers :: x-api-key**********api key di verifica interazione endpoint
Headers :: x-shopify-graphql-urlhttps://SHOPIFYURL.myshopify.com/url dello shopify con cui connettersi
Headers :: x-shopify-access-tokenshpat_CODICEALFANUMERICOsecret della custom app creata per l'integrazione
Headers :: x-shopify-client-idIL_TUO_CLIENT_IDclient id dell'app di integrazione
Headers :: x-shopify-client-secretIL_TUO_CLIENT_SECRETclient secret dell'app di integrazione

Flussi Shopify​