Rimozione automaticDiscounts in Shopify API 2027-01

Cosa cambia con l'API version 2027-01

Aggiornare la versione dell'API Shopify senza controllare le query deprecate è uno degli errori più comuni e più costosi per chi gestisce integrazioni custom sugli sconti. Con il rilascio della API version 2027-01, la query automaticDiscounts non esiste più nel GraphQL Admin API di Shopify.

Il comportamento non è quello di un semplice campo vuoto: la chiamata restituisce un errore di validazione. Questo significa che qualsiasi integrazione che dipende da questa query smette di funzionare immediatamente dopo l'upgrade, senza margine di tolleranza.

Tipi rimossi insieme alla query

Oltre alla query, vengono rimossi anche i tipi:

• DiscountAutomaticConnection
• DiscountAutomaticEdge

Se il progetto rigenera i tipi GraphQL contro la versione 2027-01 senza aver prima migrato il codice, il build si rompe. Questo impatta sia le integrazioni server-side sia eventuali generatori di tipi TypeScript basati sullo schema Admin API.

Perché saltare automaticDiscountNodes

Un punto spesso frainteso in questa migrazione riguarda automaticDiscountNodes. Anche questa query è già deprecata, quindi migrare verso di essa significherebbe affrontare un secondo ciclo di migrazione a breve termine.

La scelta corretta è saltare direttamente a discountNodes, applicando il filtro query: "method:automatic". Questo approccio chiude il cerchio in un solo passaggio, evitando lavoro duplicato quando anche automaticDiscountNodes verrà rimossa in una versione futura.

Il vantaggio di discountNodes

discountNodes unifica la lettura degli sconti automatici e di quelli basati su codice in un'unica query, con una sintassi di filtro coerente. Questo semplifica il codice client, riduce la duplicazione di logica di fetch e allinea l'integrazione al modello dati più recente esposto dall'Admin API.

Checklist di migrazione prima di passare a 2027-01

Prima di effettuare l'upgrade, è opportuno seguire alcuni passaggi operativi:

• Cercare automaticDiscounts in tutto il codebase, inclusi i tipi generati automaticamente e ogni riferimento a DiscountAutomaticConnection o DiscountAutomaticEdge
• Sostituire le chiamate con discountNodes(first: 10, query: "method:automatic")
• Spostare gli inline fragment un livello più in profondità, applicandoli sul campo discount di DiscountNode
• Rigenerare i tipi GraphQL contro la versione 2027-01
• Testare su uno store di sviluppo, confrontando i risultati ottenuti con quelli prodotti dalla versione 2026-10

Questo processo di verifica incrociata tra versioni è essenziale per garantire che la logica di business che dipende dagli sconti automatici continui a comportarsi in modo identico dopo la migrazione.

Cosa succede se non si migra subito

Le versioni 2026-10 e precedenti continuano a funzionare regolarmente finché restano supportate secondo il ciclo di rilascio Shopify. Se non è possibile completare la migrazione immediatamente, la soluzione più sicura è bloccare la versione API utilizzata dall'integrazione e pianificare il lavoro di migrazione in un secondo momento, evitando aggiornamenti automatici o accidentali verso 2027-01.

Un controllo da fare ora

Chi gestisce custom integration sugli sconti Shopify dovrebbe verificare subito la presenza di automaticDiscounts nel proprio codice, anche in progetti considerati stabili o poco modificati di recente. Un audit tempestivo evita interruzioni in produzione nel momento dell'upgrade obbligato.

Per chi sviluppa o mantiene integrazioni Shopify e vuole valutare il costo di un intervento di migrazione mirato, è possibile consultare il listino tariffario per sviluppatori Shopify per stimare tempi e budget necessari.