Shopify API 2026-07: taxSettings na Customer objektu dostupan putem GraphQL

Problem: PDV broj je bio tu, ali ga API nije vraćao

Svaki tko je izgradio fiskalnu ili računovodstvenu integraciju na Shopifyju dobro poznaje tu frustraciju: kupac unese svoj PDV broj pri naplati, Shopify ga prikupi i validira, ali u trenutku sinkronizacije te informacije prema ERP-u ili vanjskom računovodstvenom sustavu, podatak nije dostupan putem standardnih API-ja.

Do sada. S verzijom 2026-07 Admin GraphQL API-ja, Shopify uvodi strukturnu izmjenu koja rješava upravo ovaj problem.

Što se mijenja u verziji API-ja 2026-07

Polje taxSettings na Customer objektu postaje javno dostupno. Ranije je za dobivanje poreznih informacija vezanih uz kupca bilo potrebno koristiti ručna zaobilazna rješenja, zaštićene pristupe ili prilagođenu logiku koja je povećavala složenost integracija.

Od verzije 2026-07, uz aktivne dozvole read_customers ili read_taxes u vlastitoj aplikaciji, moguće je izvršavati standardne GraphQL upite i izravno dohvatiti polje taxId, koje vraća:

• Niz znakova s PDV brojem ili VAT brojem, ako ga je kupac naveo pri naplati
• null, ako polje nije ispunjeno

Nikakva dodatna konfiguracija, nikakav poseban postupak odobrenja: dovoljno je ažurirati ciljnu verziju API-ja i provjeriti aktivne scopeove.

Opseg izmjene: samo čitanje

Važno je odmah razjasniti ograničenja ove novosti kako bi se izbjegla pogrešna očekivanja pri planiranju integracija.

Izmjena je isključivo za čitanje. Polje taxId nije moguće pisati ni ažurirati putem ovog javnog API-ja.

Osim toga, polje taxIdValidation, koje sadrži status validacije poreznog broja, nije uključeno u javni pristup. Za dobivanje detalja o statusu validacije potrebno je zatražiti pristup zaštićenim podacima kupca putem posebnog postupka odobrenja koji Shopify predviđa. Riječ je o odvojenom procesu koji treba planirati unaprijed ako ga vaša integracija zahtijeva.

Konkretni slučajevi upotrebe za programere i merchantove

Ova izmjena otvara praktične i relevantne scenarije, posebno za one koji posluju na europskom tržištu ili upravljaju poslovnim kupcima izvan Shopifyjevog strukturiranog B2B sustava.

Sinkronizacija prema ERP-u i računovodstvenim sustavima

Jedan od najneposrednijih slučajeva upotrebe je automatska sinkronizacija VAT broja prema sustavima poput SAP-a, Microsoft Dynamicsa, ili bilo kojeg drugog ERP-a koji zahtijeva porezni broj kupca za generiranje usklađenih računa. Do sada je taj podatak trebalo dohvaćati ručno ili alternativnim rješenjima. S pristupom taxSettings putem API-ja, tijek može postati potpuno automatiziran.

Logike porezne usklađenosti

Za one koji prodaju u Europi, ispravno upravljanje intrakomunalnim PDV-om ovisi o dostupnosti i valjanosti VAT broja kupca. Programski pristup ovom polju omogućuje:

• Izgradnju dinamičnih pravila cijena i oporezivanja
• Provjeru prisutnosti podatka prije izdavanja poreznih dokumenata
• Ugradnju provjera usklađenosti izravno u tijek narudžbi

Usklađivanje sa Shopify B2B

Za kupce koji koriste Shopifyjeve native B2B funkcionalnosti, polje taxSettings na CompanyLocation objektu dostupno je od verzije API-ja 2025-01. Nova dostupnost na Customer objektu u verziji 2026-07 predstavlja važno usklađivanje, donoseći isti razinu pristupa i za poslovne kupce koji nisu strukturirani kao Company na Shopifyju.

Kako ažurirati vlastitu integraciju

Ako razvijate ili održavate fiskalne ili ERP integracije na Shopify Plusu, evo operativnih koraka koje treba slijediti:

• Ažurirajte ciljnu verziju API-ja na 2026-07 u manifestu aplikacije ili izravnim pozivima
• Provjerite aktivne scopeove: uvjerite se da su read_customers ili read_taxes uključeni među dozvolama koje aplikacija zahtijeva
• Obradite slučaj null: implementirajte logiku za ispravno upravljanje kupcima bez tax ID-a, budući da će polje vraćati null bez prisutnog podatka
• Planirajte zaštićeni pristup ako vaša integracija treba i polje taxIdValidation: postupak Shopify odobrenja zahtijeva vrijeme i dokumentaciju

Za potpuni pregled dostupnih opcija i troškova razvoja, pogledajte našu stranicu s planovima i cijenama za Shopify developere.

Zaključak

Javni pristup polju taxSettings u Admin GraphQL API verziji 2026-07 tehnički je usko ograničena izmjena, ali s praktičnim utjecajem koji je značajan za sve koji grade fiskalne integracije na Shopifyju. Uklanja konkretnu prepreku koja je razvojne timove prisiljavala na ručna rješenja ili krhka zaobilazna rješenja, te usklađuje pristup poreznim podacima potrošačkih kupaca s onim što je već dostupno za strukturirane B2B kupce. Planirati migraciju na vrijeme ispravan je potez.