Shopify API 2026-07: taxSettings Customer nu toegankelijk via GraphQL

Het probleem: het BTW-nummer was er, maar de API gaf het niet terug

Iedereen die ooit een fiscale of boekhoudkundige integratie op Shopify heeft gebouwd, kent de frustratie: de klant vult zijn BTW-nummer in tijdens de checkout, Shopify verzamelt en valideert het, maar op het moment dat je die informatie naar een ERP of extern boekhoudsysteem wilt synchroniseren, is het gegeven niet bereikbaar via de standaard API.

Tot nu. Met versie 2026-07 van de Admin GraphQL API introduceert Shopify een structurele wijziging die precies dit probleem oplost.

Wat verandert er in API-versie 2026-07

Het veld taxSettings op het Customer object wordt publiek toegankelijk. Eerder moest je voor fiscale informatie van een klant terugvallen op handmatige omwegen, beveiligde toegangen of aangepaste logica die de complexiteit van integraties verhoogde.

Vanaf versie 2026-07 kun je, met de permissies read_customers of read_taxes actief in je app, standaard GraphQL-queries uitvoeren en direct het veld taxId ophalen. Dit veld geeft terug:

• Een string met het BTW-nummer of VAT-nummer, als de klant het gegeven tijdens de checkout heeft ingevuld
• null, als het veld niet is ingevuld

Geen extra configuratie, geen apart goedkeuringsproces: het volstaat om de doelversie van de API bij te werken en de actieve scopes te controleren.

Omvang van de wijziging: alleen lezen

Het is belangrijk om de beperkingen van deze vernieuwing meteen te verduidelijken, zodat er geen verkeerde verwachtingen ontstaan tijdens de planningsfase van integraties.

De wijziging is uitsluitend voor lezen. Het is niet mogelijk om taxId te schrijven of bij te werken via deze publieke API.

Bovendien is het veld taxIdValidation, dat de validatiestatus van het fiscale nummer bevat, niet opgenomen in de publieke toegang. Voor de validatiestatus is het nodig om toegang tot beveiligde klantgegevens aan te vragen via het afzonderlijke goedkeuringsproces van Shopify. Dit is een apart traject dat tijdig moet worden gepland als je integratie dit vereist.

Concrete gebruiksscenario's voor ontwikkelaars en merchants

Deze wijziging opent relevante praktische scenario's, vooral voor wie actief is op de Europese markt of zakelijke klanten beheert buiten de gestructureerde B2B-omgeving van Shopify.

Synchronisatie naar ERP en boekhoudsystemen

Een van de meest directe gebruiksscenario's is de automatische synchronisatie van het VAT-nummer naar systemen zoals SAP, Microsoft Dynamics, Exact Online of een ander ERP dat het fiscale nummer van de klant nodig heeft om conforme facturen te genereren. Tot nu moest dit gegeven handmatig worden opgehaald of via alternatieve oplossingen. Met taxSettings toegankelijk via de API kan de volledige workflow worden geautomatiseerd.

Fiscale compliance-logica

Voor wie in Europa verkoopt, hangt een correcte btw-behandeling bij intracommunautaire transacties af van de beschikbaarheid en geldigheid van het VAT-nummer van de klant. Programmatische toegang tot dit veld maakt het mogelijk om:

• Dynamische prijs- en belastingregels op te bouwen
• De aanwezigheid van het gegeven te controleren vóór het uitsturen van fiscale documenten
• Compliance-controles rechtstreeks in de orderflow te integreren

Aansluiting op Shopify B2B

Voor klanten die de native B2B-functionaliteiten van Shopify gebruiken, is het veld taxSettings op het CompanyLocation object beschikbaar vanaf API-versie 2025-01. De nieuwe toegankelijkheid op het Customer object in versie 2026-07 vormt een belangrijke aansluiting, waarmee hetzelfde toegangsniveau ook beschikbaar komt voor zakelijke klanten die niet als Company in Shopify zijn geconfigureerd.

Hoe je je integratie bijwerkt

Als je fiscale of ERP-integraties op Shopify Plus ontwikkelt of onderhoudt, zijn dit de stappen die je moet doorlopen:

• Werk de doel-API-versie bij naar 2026-07 in het manifest van je app of in de directe API-aanroepen
• Controleer de actieve scopes: zorg ervoor dat read_customers of read_taxes zijn opgenomen in de permissies die de app aanvraagt
• Verwerk het null-geval: implementeer logica om klanten zonder tax ID correct af te handelen, want het veld geeft null terug als het gegeven ontbreekt
• Plan de beveiligde toegang als je integratie ook het veld taxIdValidation nodig heeft: het goedkeuringsproces van Shopify vereist tijd en documentatie

Voor een volledig overzicht van de beschikbare kosten en ontwikkelopties kun je onze pagina over ontwikkelaarsplannen en tarieven raadplegen.

Conclusie

De publieke toegang tot taxSettings in Admin GraphQL API versie 2026-07 is een technisch afgebakende wijziging, maar met een aanzienlijke praktische impact voor iedereen die fiscale integraties op Shopify bouwt. Ze verwijdert een concrete belemmering die ontwikkelteams dwong tot handmatige oplossingen of fragiele workarounds, en brengt de toegang tot fiscale klantgegevens van consumentklanten op hetzelfde niveau als wat al beschikbaar was voor gestructureerde B2B-klanten. Op tijd migreren is de juiste zet.