Shopify API 2026-07: taxSettings na Customer objektu přístupný přes GraphQL

Problém: DIČ tam bylo, ale API ho nevracelo

Kdokoli kdy budoval daňovou nebo účetní integraci na Shopify, zná tuto frustraci důvěrně: zákazník zadá své DIČ při pokladně, Shopify ho zaznamená a ověří, ale ve chvíli, kdy chcete tuto informaci synchronizovat do ERP nebo externího účetního systému, data přes standardní API prostě nejsou dostupná.

Až do teď. S verzí 2026-07 Admin GraphQL API Shopify zavádí strukturální změnu, která tento problém řeší.

Co se ve verzi API 2026-07 mění

Pole taxSettings na objektu Customer se stává veřejně přístupným. Dříve bylo pro získání daňových informací o zákazníkovi nutné uchylovat se k ručním obejitím, chráněným přístupům nebo vlastní logice, která zbytečně komplikovala integrace.

Od verze 2026-07 stačí mít v aplikaci aktivní oprávnění read_customers nebo read_taxes a spustit standardní GraphQL dotaz, který přímo vrátí pole taxId. To obsahuje:

• Řetězec s číslem DIČ nebo IČ DPH, pokud zákazník údaj při pokladně zadal
• null, pokud pole nebylo vyplněno

Žádná dodatečná konfigurace, žádný zvláštní schvalovací proces: stačí aktualizovat cílovou verzi API a ověřit aktivní scope.

Rozsah změny: pouze čtení

Je důležité hned ujasnit omezení této novinky, aby nedocházelo k chybným očekáváním při plánování integrací.

Změna je výhradně pro čtení. Pole taxId přes toto veřejné API nelze zapisovat ani aktualizovat.

Pole taxIdValidation, které obsahuje stav ověření daňového čísla, není součástí veřejného přístupu. Pro získání detailu stavu ověření je nutné požádat o přístup k chráněným zákaznickým datům prostřednictvím samostatného schvalovacího procesu Shopify. Jde o oddělený postup, který je třeba naplánovat s předstihem, pokud ho vaše integrace vyžaduje.

Konkrétní případy užití pro vývojáře a obchodníky

Tato změna otevírá prakticky relevantní scénáře, zejména pro ty, kdo působí na evropském trhu nebo spravují firemní zákazníky mimo strukturovaný B2B okruh Shopify.

Synchronizace do ERP a účetních systémů

Jedním z nejpřímějších případů užití je automatická synchronizace IČ DPH do systémů jako SAP, Microsoft Dynamics, Pohoda nebo jakéhokoli jiného ERP, které daňové číslo zákazníka potřebuje pro generování odpovídajících faktur. Dosud bylo nutné tento údaj získávat ručně nebo pomocí náhradních řešení. S dostupným polem taxSettings přes API může být celý tok plně automatizovaný.

Logika daňového souladu

Pro prodejce v Evropě závisí správné zpracování intrakomunitárního DPH na dostupnosti a platnosti IČ DPH zákazníka. Programový přístup k tomuto poli umožňuje:

• Vytvářet dynamická pravidla pro tvorbu cen a zdanění
• Ověřit přítomnost údaje před vystavením daňových dokladů
• Začlenit kontroly souladu přímo do toku zpracování objednávek

Soulad s B2B funkcionalitou Shopify

Pro zákazníky využívající nativní B2B funkce Shopify je pole taxSettings na objektu CompanyLocation dostupné od verze API 2025-01. Nová dostupnost na objektu Customer ve verzi 2026-07 představuje důležité sjednocení a přináší stejnou úroveň přístupu i pro firemní zákazníky, kteří nejsou na Shopify vedeni jako Company.

Jak aktualizovat vlastní integraci

Pokud vyvíjíte nebo udržujete daňové či ERP integrace na Shopify Plus, postupujte podle těchto kroků:

• Aktualizujte cílovou verzi API na 2026-07 v manifestu aplikace nebo v přímých voláních
• Ověřte aktivní scope: ujistěte se, že read_customers nebo read_taxes jsou zahrnuty v oprávněních požadovaných aplikací
• Ošetřete případ null: implementujte logiku pro správné zpracování zákazníků bez daňového čísla, protože pole v takovém případě vrátí null
• Naplánujte chráněný přístup pokud vaše integrace potřebuje také pole taxIdValidation: schvalovací proces Shopify vyžaduje čas a dokumentaci

Pro úplný přehled dostupných možností a nákladů na vývoj navštivte naši stránku s plány a cenami pro vývojáře Shopify.

Závěr

Verejný přístup k poli taxSettings v Admin GraphQL API verze 2026-07 je technicky ohraničená změna s výrazným praktickým dopadem pro každého, kdo na Shopify buduje daňové integrace. Odstraňuje konkrétní překážku, která nutila vývojové týmy sahat po ručních řešeních nebo křehkých obejitích, a sjednocuje přístup k daňovým údajům zákazníků s tím, co bylo již dříve dostupné pro strukturované B2B zákazníky. Migraci je správné naplánovat s dostatečným předstihem.