Shopify API 2026-07: taxSettings Customer dostępne przez GraphQL

Problem: numer VAT był zbierany, ale API go nie zwracało

Każdy, kto budował integrację podatkową lub księgową na Shopify, zna dobrze tę frustrację: klient wpisuje swój numer VAT podczas checkout, Shopify go zbiera i waliduje, ale w momencie synchronizacji tej informacji z ERP lub zewnętrznym systemem księgowym dane są niedostępne przez standardowe API.

Aż do teraz. W wersji 2026-07 Admin GraphQL API Shopify wprowadza strukturalną zmianę, która rozwiązuje dokładnie ten problem.

Co zmienia się w wersji API 2026-07

Pole taxSettings na obiekcie Customer staje się publicznie dostępne. Wcześniej, aby uzyskać informacje podatkowe powiązane z klientem, konieczne było stosowanie ręcznych obejść, dostępów chronionych lub niestandardowej logiki, która zwiększała złożoność integracji.

Od wersji 2026-07, przy aktywnych uprawnieniach read_customers lub read_taxes w aplikacji, można wykonywać standardowe zapytania GraphQL i bezpośrednio odczytywać pole taxId, które zwraca:

• Ciąg znaków z numerem NIP lub VAT, jeśli klient podał dane podczas checkout
• null, jeśli pole nie zostało wypełnione

Bez dodatkowej konfiguracji, bez specjalnego procesu zatwierdzania: wystarczy zaktualizować docelową wersję API i sprawdzić aktywne uprawnienia.

Zakres zmiany: wyłącznie odczyt

Ważne jest, aby od razu wyjaśnić ograniczenia tej nowości i uniknąć błędnych oczekiwań podczas planowania integracji.

Zmiana dotyczy wyłącznie odczytu. Nie jest możliwe zapisanie ani aktualizacja taxId przez to publiczne API.

Ponadto pole taxIdValidation, zawierające status walidacji numeru podatkowego, nie jest objęte dostępem publicznym. Aby uzyskać szczegółowe informacje o statusie walidacji, konieczne jest wnioskowanie o dostęp do chronionych danych klienta w ramach odrębnego procesu zatwierdzania przewidzianego przez Shopify. To oddzielna procedura, którą należy zaplanować z wyprzedzeniem, jeśli integracja tego wymaga.

Praktyczne przypadki użycia dla deweloperów i sprzedawców

Ta zmiana otwiera istotne scenariusze praktyczne, szczególnie dla tych, którzy działają na rynku europejskim lub obsługują klientów biznesowych poza ustrukturyzowanym kanałem B2B Shopify.

Synchronizacja z ERP i systemami księgowymi

Jednym z najbardziej bezpośrednich przypadków użycia jest automatyczna synchronizacja numeru VAT z systemami takimi jak SAP, Microsoft Dynamics, czy dowolnym innym ERP wymagającym numeru podatkowego klienta do generowania zgodnych faktur. Do tej pory dane te musiały być pobierane ręcznie lub za pomocą rozwiązań alternatywnych. Dzięki dostępowi do taxSettings przez API przepływ może być w pełni zautomatyzowany.

Logika zgodności podatkowej

Dla tych, którzy sprzedają w Europie, prawidłowe zarządzanie VAT wewnątrzwspólnotowym zależy od dostępności i ważności numeru VAT klienta. Programowy dostęp do tego pola pozwala na:

• Budowanie dynamicznych reguł cenowych i podatkowych
• Weryfikację obecności danych przed wystawieniem dokumentów fiskalnych
• Integrację kontroli zgodności bezpośrednio w przepływie zamówień

Wyrównanie z Shopify B2B

Dla klientów korzystających z natywnych funkcji B2B Shopify pole taxSettings na obiekcie CompanyLocation jest dostępne od wersji API 2025-01. Nowa dostępność na obiekcie Customer w wersji 2026-07 stanowi istotne wyrównanie, rozszerzając ten sam poziom dostępu na klientów biznesowych niezarejestrowanych jako Company w Shopify.

Jak zaktualizować własną integrację

Jeśli tworzysz lub utrzymujesz integracje podatkowe lub ERP na Shopify Plus, oto kroki operacyjne do wykonania:

• Zaktualizuj docelową wersję API do 2026-07 w manifeście aplikacji lub w bezpośrednich wywołaniach
• Sprawdź aktywne uprawnienia: upewnij się, że read_customers lub read_taxes są uwzględnione wśród uprawnień żądanych przez aplikację
• Obsłuż przypadek null: zaimplementuj logikę poprawnej obsługi klientów bez tax ID, ponieważ pole zwróci null w przypadku braku danych
• Zaplanuj dostęp chroniony, jeśli integracja wymaga również pola taxIdValidation: proces zatwierdzania Shopify wymaga czasu i dokumentacji

Aby uzyskać pełny przegląd kosztów i dostępnych opcji dla programistów, zapoznaj się z naszą stroną poświęconą planom dla deweloperów Shopify.

Podsumowanie

Publiczny dostęp do taxSettings w Admin GraphQL API w wersji 2026-07 to technicznie ograniczona zmiana, ale o istotnym praktycznym wpływie na wszystkich budujących integracje podatkowe na Shopify. Usuwa konkretną przeszkodę, która zmuszała zespoły deweloperskie do rozwiązań ręcznych lub kruchych obejść, i wyrównuje dostęp do danych podatkowych klientów konsumenckich z tym, co było już dostępne dla ustrukturyzowanych klientów B2B. Zaplanowanie migracji z wyprzedzeniem to właściwy krok.