Shopify API 2026-07: taxSettings Customer accesibil via GraphQL

Problema: codul de TVA exista, dar API-urile nu îl returnau

Oricine a construit o integrare fiscală sau contabilă pe Shopify cunoaște bine frustrarea: clientul introduce codul său de TVA în timpul checkout-ului, Shopify îl colectează și îl validează, dar în momentul sincronizării acestei informații cu un ERP sau un sistem contabil extern, data nu este accesibilă prin API-urile standard.

Până acum. Cu versiunea 2026-07 a Admin GraphQL API, Shopify introduce o modificare structurală care rezolvă exact această problemă.

Ce se schimbă în versiunea API 2026-07

Câmpul taxSettings pe obiectul Customer devine accesibil public. Anterior, pentru a obține informații fiscale asociate unui client era necesar să se recurgă la soluții manuale, accesuri protejate sau logici custom care sporeau complexitatea integrărilor.

Începând cu versiunea 2026-07, cu permisiunile read_customers sau read_taxes active în aplicație, este posibil să se execute interogări GraphQL standard și să se obțină direct câmpul taxId, care returnează:

• Un șir de caractere cu numărul de TVA sau VAT number, dacă clientul a furnizat data în timpul checkout-ului
• null, dacă câmpul nu a fost completat

Nicio configurare suplimentară, niciun proces de aprobare special: este suficient să se actualizeze versiunea API țintă și să se verifice scope-urile active.

Perimetrul modificării: doar citire

Este important să se clarifice imediat limitele acestei noutăți pentru a evita așteptări eronate în planificarea integrărilor.

Modificarea este exclusiv de citire. Nu este posibil să se scrie sau să se actualizeze taxId prin acest API public.

De asemenea, câmpul taxIdValidation, care conține starea de validare a numărului fiscal, nu este inclus în accesul public. Pentru a obține detaliile stării de validare este necesar să se solicite accesul la datele protejate ale clientului prin procesul de aprobare separat prevăzut de Shopify. Acesta este un parcurs distinct care trebuie planificat în avans dacă integrarea proprie are nevoie de el.

Cazuri de utilizare concrete pentru dezvoltatori și comercianți

Această modificare deschide scenarii practice relevante, mai ales pentru cei care operează pe piața europeană sau gestionează clienți business în afara circuitului B2B structurat din Shopify.

Sincronizare cu ERP și sisteme contabile

Unul dintre cele mai imediate cazuri de utilizare este sincronizarea automată a VAT number-ului cu sisteme precum SAP, Microsoft Dynamics, sau orice alt ERP care necesită numărul fiscal al clientului pentru a genera facturi conforme. Până acum, această dată trebuia recuperată manual sau prin soluții alternative. Cu taxSettings accesibil prin API, fluxul poate deveni complet automatizat.

Logici de conformitate fiscală

Pentru cei care vând în Europa, gestionarea corectă a TVA-ului intracomunitar depinde de disponibilitatea și validitatea VAT number-ului clientului. Accesul programatic la acest câmp permite:

• Construirea de reguli dinamice de prețuri și taxare
• Verificarea prezenței datei înainte de a emite documente fiscale
• Integrarea controalelor de conformitate direct în fluxul comenzilor

Aliniere cu B2B Shopify

Pentru clienții care utilizează funcționalitățile B2B native din Shopify, câmpul taxSettings pe obiectul CompanyLocation este disponibil începând cu versiunea API 2025-01. Noua accesibilitate pe obiectul Customer în versiunea 2026-07 reprezintă o aliniere importantă, aducând același nivel de acces și pentru clienții business care nu sunt structurați ca Company în Shopify.

Cum să actualizezi integrarea proprie

Dacă dezvolți sau menții integrări fiscale sau ERP pe Shopify Plus, pașii operaționali de urmat sunt următorii:

• Actualizează versiunea API țintă la 2026-07 în manifestul aplicației sau în apelurile directe
• Verifică scope-urile active: asigură-te că read_customers sau read_taxes sunt incluse în permisiunile solicitate de aplicație
• Gestionează cazul null: implementează logica pentru a gestiona corect clienții fără tax ID, deoarece câmpul va returna null în absența datei
• Planifică accesul protejat dacă integrarea ta necesită și câmpul taxIdValidation: procesul de aprobare Shopify necesită timp și documentație

Pentru o prezentare completă a costurilor și opțiunilor de dezvoltare disponibile, poți consulta pagina noastră dedicată planurilor pentru dezvoltatori Shopify.

Concluzie

Accesul public la taxSettings în Admin GraphQL API versiunea 2026-07 este o modificare tehnic circumscrisă, dar cu impact practic semnificativ pentru oricine construiește integrări fiscale pe Shopify. Elimină un obstacol concret care forța echipele de dezvoltare la soluții manuale sau workaround-uri fragile și aliniază accesul la datele fiscale ale clienților consumer cu ceea ce era deja disponibil pentru clienții B2B structurați. Planificarea migrării din timp este decizia corectă.