Shopify API 2026-07: taxSettings Customer elérhető GraphQL-en

A probléma: az adószám megvolt, de az API nem adta vissza

Aki valaha épített adóügyi vagy könyvelési integrációt Shopify-on, jól ismeri a frusztrációt: a vevő megadja az adószámát a checkout során, a Shopify összegyűjti és érvényesíti, de amikor ezt az adatot szinkronizálni kellene egy ERP-rendszerbe vagy külső könyvelési szoftverbe, a standard API-kon keresztül nem volt elérhető.

Eddig. A 2026-07-es Admin GraphQL API verzióval a Shopify egy strukturális változtatást vezet be, amely pontosan ezt a problémát oldja meg.

Mi változik a 2026-07-es API verzióban

A taxSettings mező a Customer objektumon nyilvánosan elérhetővé válik. Korábban a vevőhöz kapcsolódó adóinformációk lekéréséhez manuális megkerülő megoldásokra, védett hozzáférésre vagy egyedi logikára volt szükség, amelyek növelték az integrációk bonyolultságát.

A 2026-07-es verziótól kezdve, ha az alkalmazásban aktív a read_customers vagy a read_taxes jogosultság, standard GraphQL lekéréssel közvetlenül elérhető a taxId mező, amely a következőket adja vissza:

• Egy karakterlánc az adószámmal vagy ÁFA-azonosítóval, ha a vevő megadta a checkout során
• null, ha a mező nem volt kitöltve

Nincs szükség további konfigurációra vagy különleges jóváhagyási folyamatra: elegendő frissíteni a cél API verziót, és ellenőrizni az aktív jogosultságokat.

A változtatás hatóköre: csak olvasás

Fontos már az elején tisztázni az újdonság korlátait, hogy az integrációk tervezésekor ne legyenek félreértések.

A változtatás kizárólag olvasásra vonatkozik. A taxId mezőt ezen a nyilvános API-n keresztül nem lehet írni vagy frissíteni.

Emellett a taxIdValidation mező, amely az adószám érvényesítési állapotát tartalmazza, nem szerepel a nyilvános hozzáférésben. Az érvényesítési állapot részleteinek lekéréséhez a Shopify által előírt külön jóváhagyási folyamaton keresztül kell hozzáférést kérni a védett ügyfélAdatokhoz. Ez egy önálló eljárás, amelyet előre kell tervezni, ha az integrációnak szüksége van rá.

Konkrét felhasználási esetek fejlesztők és kereskedők számára

Ez a változtatás számos gyakorlati lehetőséget nyit meg, különösen azok számára, akik az európai piacon tevékenykednek, vagy B2B-vevőket kezelnek a Shopify strukturált B2B-rendszerén kívül.

Szinkronizálás ERP- és könyvelési rendszerekkel

Az egyik legsürgetőbb felhasználási eset az ÁFA-azonosítószám automatikus szinkronizálása olyan rendszerekbe, mint az SAP, a Microsoft Dynamics, vagy bármely más ERP, amelynek szüksége van a vevő adószámára a megfelelő számla kiállításához. Eddig ezt az adatot manuálisan vagy kerülő megoldásokkal kellett begyűjteni. A taxSettings API-n keresztüli elérhetőségével a folyamat teljesen automatizálhatóvá válik.

Adóügyi megfelelési logikák

Azok számára, akik Európában értékesítenek, a közösségen belüli ÁFA helyes kezelése a vevő ÁFA-azonosítószámának meglététől és érvényességétől függ. Az ehhez a mezőhöz való programozott hozzáférés lehetővé teszi:

• Dinamikus árazási és adózási szabályok felépítését
• Az adat meglétének ellenőrzését számviteli dokumentumok kiállítása előtt
• Megfelelési ellenőrzések beépítését közvetlenül a rendelési folyamatba

Igazodás a Shopify B2B funkciókhoz

Azok számára, akik a Shopify natív B2B funkcióit használják, a taxSettings mező a CompanyLocation objektumon a 2025-01-es API verziótól elérhető. A Customer objektumon való új elérhetőség a 2026-07-es verzióban fontos igazodást jelent, ugyanolyan szintű hozzáférést biztosítva azoknak a B2B-vevőknek is, akik nincsenek Company-ként konfigurálva a Shopify-ban.

Az integráció frissítésének lépései

Ha Shopify Plus adóügyi vagy ERP-integrációkat fejleszt vagy tart fenn, a következő operatív lépéseket érdemes követni:

• Frissítse a cél API verziót 2026-07-re az alkalmazás manifestjében vagy a közvetlen hívásokban
• Ellenőrizze az aktív jogosultságokat: győződjön meg arról, hogy a read_customers vagy a read_taxes szerepel az alkalmazás által kért engedélyek között
• Kezelje a null esetet: implementáljon logikát az adószám nélküli vevők helyes kezelésére, mivel a mező null értéket ad vissza, ha az adat hiányzik
• Tervezze meg a védett hozzáférést előre, ha az integrációnak szüksége van a taxIdValidation mezőre is: a Shopify jóváhagyási folyamata időt és dokumentációt igényel

Az elérhető fejlesztési lehetőségek és díjcsomagok teljes áttekintéséhez látogassa meg fejlesztői csomagjaink oldalát.

Összefoglalás

A taxSettings nyilvános elérhetősége az Admin GraphQL API 2026-07-es verziójában technikailag körülhatárolt változtatás, de gyakorlati hatása jelentős mindazok számára, akik adóügyi integrációkat építenek Shopify-on. Megszüntet egy konkrét akadályt, amely manuális megoldásokra vagy törékeny kerülő utakra kényszerítette a fejlesztői csapatokat, és igazítja a fogyasztói vevők adóügyi adataihoz való hozzáférést a strukturált B2B-vevők esetében már elérhető szinthez. A migráció időben való megtervezése a helyes döntés.