Megszűnik a Shopify automaticDiscounts lekérdezése

A Shopify 2027-01-es API-verziójából kikerül az automaticDiscounts lekérdezés. Ha a webshopodhoz készült egyedi app vagy integráció ezen keresztül olvassa be az automatikus kedvezményeket, még a verzióváltás előtt át kell állítani discountNodes használatára.

Röviden: a változás a vásárlói felületen valószínűleg nem lesz látványos, a háttérben futó egyedi fejlesztésekben viszont hibát okozhat. Az érintett appokban az automaticDiscounts helyett a discountNodes lekérdezést kell használni method:automatic szűrővel.

Egy jól működő webshopnál könnyű megfeledkezni arról, hogy a háttérben különféle appok kérdezgetik a Shopify-t. Például azt, milyen automatikus kedvezmények aktívak, mikor indul egy akció, vagy milyen típusú engedmény tartozik egy kampányhoz. Ezek közül néhány saját fejlesztés a hamarosan megszűnő automaticDiscounts lekérdezést használhatja.

A Shopify 2026. szeptember 18-án jelezte, hogy ezt a régi lekérdezést a 2027-01-es GraphQL Admin API-verzióból eltávolítja. Ha egy app az új verzióra vált, de a régi hívás benne marad, nem kedvezményadatot kap vissza, hanem validációs hibát.

Mit jelent ez egyszerűen?

Az API-t úgy képzeld el, mint egy szabályozott ügyfélszolgálati pultot a webshop és a hozzá kapcsolódó programok között. Egy app meghatározott kérdéseket tehet fel, a Shopify pedig meghatározott formában válaszol.

Az automaticDiscounts eddig külön pultként szolgált az automatikus kedvezmények lekéréséhez. A Shopify ezt bezárja, és a jövőben a közös discountNodes lekérdezésen keresztül adja vissza a kódos, illetve az automatikusan aktiválódó kedvezményeket. A method:automatic szűrő mondja meg, hogy ezek közül csak az automatikusakat kéred.

Ez első látásra apró technikai takarításnak tűnik. Egy régi lekérdezés azonban attól még működhet ma, hogy a következő API-verzióban már nem létezik. A hibát ezért még a verziófrissítés előtt érdemes elkapni.

Érinti ez a Shopify-boltodat?

Ha kizárólag a Shopify adminfelületén állítasz be automatikus kedvezményeket, és nem kapcsolódik hozzájuk saját app vagy egyedi integráció, valószínűleg nincs teendőd. A bejelentés nem az automatikus kedvezmények megszüntetéséről szól. Csak egy fejlesztői lekérdezési mód tűnik el.

Érdemes ellenőrzést kérned, ha a boltodhoz készült saját alkalmazás, külső rendszer kezeli vagy listázza a kedvezményeket, egyedi riport olvassa ki az akciókat, illetve egy ügynökség fejlesztett neked kedvezménylogikát. Ilyenkor kérdezd meg a fejlesztőtől, szerepel-e a kódban az automaticDiscounts lekérdezés.

Azoknak sincs dolguk ezzel a konkrét változással, akik már discountNodes használatával olvassák a kedvezményeket. A Shopify szerint a 2026-10-es és korábbi verziókat használó appok egyelőre változatlanul működnek, amíg az adott API-verzió támogatott. Ez átmeneti nyugalom, nem végleges megoldás: a Shopify negyedévente ad ki új API-verziót, a stabil verziókat pedig legalább 12 hónapig támogatja.

Mire kell átállítani a régi lekérdezést?

A Shopify a discountNodes lekérdezést kéri, ezzel a szűrővel:

query {
  discountNodes(first: 10, query: "method:automatic") {
    nodes {
      id
      discount {
        ... on DiscountAutomaticBxgy {
          title
          status
        }
      }
    }
  }
}

A régi megoldásban az app közvetlenül az automaticDiscounts alatt találta meg a kedvezményeket. Az új válaszban minden elem egy DiscountNode, a tényleges kedvezmény adatai pedig annak discount mezőjében vannak. Emiatt általában nem elég a lekérdezés nevét átírni: a választ feldolgozó kódot és a generált GraphQL-típusokat is hozzá kell igazítani az új szerkezethez.

Van még egy csapda. Az automaticDiscountNodes nevű lekérdezés hasonlóan hangzik, és ezt a mostani változás közvetlenül nem távolítja el. Erre átállni mégis rövid életű kerülő lenne, mert a Shopify ezt is elavultnak jelölte, és helyette ugyancsak a discountNodes használatát ajánlja.

Mit nézzen át a fejlesztő?

A Shopify migrációs javaslata alapján ezt az öt pontot érdemes végigvenni:

1. Keresse meg a projektben az automaticDiscounts minden előfordulását.
2. Ellenőrizze a generált típusokat, különösen a DiscountAutomaticConnection és DiscountAutomaticEdge hivatkozásokat.
3. Cserélje le a lekérdezést discountNodes használatára, query: "method:automatic" szűrővel.
4. Generálja újra a GraphQL-típusokat vagy a mentett sémát a 2027-01-es verzió alapján.
5. Fejlesztői boltban hasonlítsa össze az új lekérdezés eredményét azzal, amit a 2026-10-es verzió adott.

Az ellenőrzésnél a kérés sikeres lefutása mellett a lapozást, a használt kedvezménytípusokat és a szűrőket is érdemes végigpróbálni. A discountNodes többek között státusz, kedvezménytípus, létrehozási idő és kezdési idő szerint szűrhető, így a korábbi logika jellemzően átültethető.

Miért tereli egy helyre a kedvezményeket a Shopify?

A discountNodes egy közös belépési pontot ad a kódos és az automatikus kedvezményekhez. Ha egy app mindkettőt kezeli, ugyanazt a keresési nyelvet és lapozási mintát használhatja, ahelyett hogy két külön listát kérne le és utólag összefésülné őket.

Webshop-tulajdonosként ebből annyit fogsz érzékelni, hogy az integráció karbantarthatóbb lesz. Maga az átállás ettől még fejlesztői feladat. Ha van saját Shopify-appod vagy egyedi kedvezménykezelésed, add át a fejlesztődnek a Shopify hivatalos változásbejelentését és a discountNodes dokumentációját. Január előtt kényelmesebb letesztelni, mint egy verziófrissítés után keresni, miért tűntek el a kedvezményadatok.

Gyakran ismételt kérdések

Megszűnnek az automatikus kedvezmények a Shopify-ban?

Nem. Az automatikus kedvezmények továbbra is használhatók. A Shopify csak azt a régi GraphQL-lekérdezést távolítja el, amellyel egyes appok beolvassák ezeket az adatokat.

Mikortól nem működik az automaticDiscounts?

A lekérdezés a 2027-01-es API-verzióban már nem szerepel. Az ezt vagy későbbi verziót kérő appok validációs hibát kapnak, ha továbbra is automaticDiscounts hívást küldenek.

Elég az automaticDiscountNodes lekérdezésre váltani?

Hosszú távra nem jó választás. A Shopify ezt a lekérdezést is elavultnak jelöli, és a discountNodes használatát ajánlja helyette.

Mit tegyek, ha nem tudom, használja-e ezt valamelyik appom?

Kérdezd meg az app fejlesztőjét vagy a Shopify-partneredet. A kódban gyorsan megkereshető az automaticDiscounts név, de a kapcsolódó generált típusokat és teszteket is át kell nézni.