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.
  3. Generazione Access Token offline tramite OAuth (Client ID + Client Secret) - consente di generare un token offline senza scadenza fino alla disinstallazione dell'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

3. Generazione Access Token offline tramite OAuth​

Per le nuove app create dal Dev Dashboard, è possibile generare un token offline che non scade fino a disinstallazione dell’app. Questo token è utile per integrazioni server-to-server senza dover gestire rinnovi periodici.

Requisiti:​

  • L’app deve essere registrata tramite Dev Dashboard.
  • Devono essere forniti obbligatoriamente:
    • clientId
    • clientSecret
    • shopifyShopUrl
  • Gli scopes sono opzionali: se non forniti, vengono applicati tutti quelli disponibili configurati in Shopify.
  • Un endpoint redirect deve essere registrato nella versione dell’app (box redirectUrls).

Flusso di generazione:​

  1. Richiesta dell’URL di autorizzazione:
  • Invocare l’endpoint protetto da API Key passando clientId, clientSecret e shopifyShopUrl.
  • L’endpoint restituisce un URL di autorizzazione valido per 5 minuti, da copiare nel browser.
  • Questo URL porta al consenso Shopify (solo se necessario) o direttamente al redirect con il token.
  1. Ottenimento del token:
  • Una volta autorizzata l’app, Shopify reindirizza all’endpoint /oauth/redirect.
  • L’endpoint genera il token offline e restituisce una risposta JSON con accessToken.
  • Tutti i dati temporanei vengono rimossi subito dopo per motivi di sicurezza.

Esempio di chiamate:​

Endpoint di autorizzazione

CampoValoreNote
Endpointhttps://adapter.flowlyze.io/oauth/authorizeRestituisce l’URL di autorizzazione valido per 5 minuti
MetodoGET—
Headers :: x-api-key***************Api key per proteggere l’endpoint
Headers :: x-shopify-client-id***************Client ID dell’app di integrazione
Headers :: x-shopify-client-secret***************Client Secret dell’app di integrazione
Headers :: x-shopify-graphql-urlhttps://SHOPIFYURL.myshopify.com/URL dello shop Shopify
Headers :: x-shopify-scopees. read_products,write_productsScope che si vogliono associare al token che verrà generato (es. lettura prodotti)

Endpoint di redirect

CampoValoreNote
Endpointhttps://adapter.flowlyze.io/oauth/redirectEndpoint di callback che restituisce il token offline
MetodoGET—
Headers / Parametri—Tutti i dati temporanei vengono rimossi subito dopo il rilascio del token

Per utilizzare questo token nelle chiamate API dell'Adaptr Flowlyze, va inserito nell’header:

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

Nota: Il token offline generato rimane valido fino alla disinstallazione dell’app dal negozio Shopify.

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

Nel form di configurazione compaiono i campi seguenti.

CampoValoreNote
Destination TypeShopifyTipo destinazione nativo Shopify
Operationes. Product syncOperazione da eseguire su Shopify. Il valore dipende dal flusso ed è indicato nella pagina dedicata. Obbligatorio.
GraphQL endpoint URLhttps://SHOPIFYURL.myshopify.com/URL dell'endpoint GraphQL Admin API dello shop Shopify
Admin API access tokenshpat_CODICEALFANUMERICOAccess token della custom app (legacy) o token offline via OAuth
Client ID (API key)IL_TUO_CLIENT_IDIdentificativo pubblico dell'app Shopify (autenticazione OAuth)
Client secretIL_TUO_CLIENT_SECRETChiave riservata per l'autenticazione OAuth
Operation

Per le operazioni di egress, ogni valore selezionabile corrisponde a un percorso sotto https://adapter.flowlyze.io/api/adp/shopify/.

Deprecato — configurazione precedente​

Deprecato

La configurazione della destinazione tramite HTTP Adapter con Base Url e header nei Settings Override è deprecata.

CampoValoreNote
Destination TypeHTTP AdapterGli adapter di integrazione lavoravano via HTTP
Base Urlhttps://adapter.flowlyze.ioURL 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​