Shopify API 2026-07: taxSettings Customer ora accessibile via GraphQL

Il problema: la Partita IVA c'era, ma le API non la restituivano

Chiunque abbia costruito un'integrazione fiscale o contabile su Shopify conosce bene la frustrazione: il cliente inserisce la propria Partita IVA durante il checkout, Shopify la raccoglie e la valida, ma al momento di sincronizzare quell'informazione verso un ERP o un sistema contabile esterno, il dato non è raggiungibile tramite le API standard.

Until now. Con la versione 2026-07 dell'Admin GraphQL API, Shopify introduce una modifica strutturale che risolve esattamente questo problema.

Cosa cambia nella versione API 2026-07

Il campo taxSettings sul Customer object diventa pubblicamente accessibile. In precedenza, per ottenere informazioni fiscali associate a un cliente era necessario ricorrere a workaround manuali, accessi protetti o logiche custom che aumentavano la complessità delle integrazioni.

Dalla versione 2026-07, con i permessi read_customers o read_taxes attivi nella propria app, è possibile eseguire query GraphQL standard e ottenere direttamente il campo taxId, che restituisce:

• Una stringa con il numero di Partita IVA o VAT number, se il cliente ha fornito il dato durante il checkout
• null, se il campo non è stato compilato

Nessuna configurazione aggiuntiva, nessun processo di approvazione speciale: basta aggiornare la versione API target e verificare gli scope attivi.

Perimetro della modifica: solo lettura

È importante chiarire subito i limiti di questa novità per evitare aspettative errate durante la pianificazione delle integrazioni.

La modifica è esclusivamente in lettura. Non è possibile scrivere o aggiornare il taxId tramite questa API pubblica.

Inoltre, il campo taxIdValidation, che contiene lo stato di validazione del numero fiscale, non è incluso nell'accesso pubblico. Per ottenere il dettaglio dello stato di validazione è necessario richiedere l'accesso ai dati cliente protetti tramite il processo di approvazione separato previsto da Shopify. Si tratta di un iter distinto che va pianificato in anticipo se la propria integrazione ne ha bisogno.

Casi d'uso concreti per sviluppatori e merchant

Questa modifica apre scenari pratici rilevanti, soprattutto per chi opera nel mercato europeo o gestisce clienti business al di fuori del circuito B2B strutturato di Shopify.

Sincronizzazione verso ERP e sistemi contabili

Uno dei casi d'uso più immediati è la sincronizzazione automatica del VAT number verso sistemi come SAP, Microsoft Dynamics, Fatture in Cloud o qualsiasi altro ERP che richieda il numero fiscale del cliente per generare fatture conformi. Fino ad ora, questo dato doveva essere recuperato manualmente o tramite soluzioni alternative. Con taxSettings accessibile via API, il flusso può diventare completamente automatizzato.

Logiche di compliance fiscale

Per chi vende in Europa, la corretta gestione dell'IVA intracomunità dipende dalla disponibilità e dalla validità del VAT number del cliente. Avere accesso programmatico a questo campo permette di:

• Costruire regole di pricing e tassazione dinamiche
• Verificare la presenza del dato prima di emettere documenti fiscali
• Integrare controlli di compliance direttamente nel flusso degli ordini

Allineamento con il B2B Shopify

Per i clienti che utilizzano le funzionalità B2B native di Shopify, il campo taxSettings sul CompanyLocation object è disponibile dalla versione API 2025-01. La nuova accessibilità sul Customer object nella versione 2026-07 rappresenta un allineamento importante, portando lo stesso livello di accesso anche per i clienti business non strutturati come Company su Shopify.

Come aggiornare la propria integrazione

Se stai sviluppando o mantenendo integrazioni fiscali o ERP su Shopify Plus, i passi operativi da seguire sono i seguenti:

• Aggiorna la versione API target a 2026-07 nel manifest della tua app o nelle chiamate dirette
• Verifica gli scope attivi: accertati che read_customers o read_taxes siano inclusi tra i permessi richiesti dall'app
• Gestisci il caso null: implementa la logica per gestire correttamente i clienti privi di tax ID, poiché il campo restituirà null in assenza del dato
• Pianifica l'accesso protetto se la tua integrazione necessita anche del campo taxIdValidation: il processo di approvazione Shopify richiede tempo e documentazione

Per una panoramica completa dei costi e delle opzioni di sviluppo disponibili, puoi consultare la nostra pagina dedicata ai piani per sviluppatori Shopify.

Conclusione

L'accesso pubblico a taxSettings nella Admin GraphQL API versione 2026-07 è una modifica tecnicamente circoscritta, ma con impatto pratico significativo per chiunque costruisca integrazioni fiscali su Shopify. Rimuove un ostacolo concreto che costringeva i team di sviluppo a soluzioni manuali o workaround fragili, e allinea l'accesso ai dati fiscali dei clienti consumer con quanto già disponibile per i clienti B2B strutturati. Pianificare la migrazione per tempo è la mossa corretta.