Come POP gestisce i dati fiscali del cliente su Shopify

Obiettivo

Capire da dove POP legge i dati fiscali del cliente (tipo cliente, P.IVA, Codice Fiscale, PEC) e dove correggerli manualmente prima di fatturare.

Prerequisiti

• Accesso a Shopify Admin (ordine e/o cliente).

Passi

POP usa due meccanismi per i dati fiscali del cliente su un ordine:

1. Metafield ordine app.pop_* — campi strutturati creati automaticamente da POP (pop_customer_type, pop_vat, pop_tax_code, pop_pec), popolati da checkout (Checkout Extension su Shopify Plus, script embed su non-Plus) o dalla rilevazione automatica dai dati cliente. Se pinnati in Shopify Admin, sono visibili e modificabili direttamente dall’operatore.
2. customAttributes dell’ordine (“Additional details”) — meccanismo storico, non strutturato, usato come fallback quando i metafield non sono valorizzati.

Priorità: quando POP genera un documento, legge prima i metafield ordine app.pop_*; ricorre ai customAttributes solo se i metafield corrispondenti sono assenti.

I metafield cliente (stesso namespace/chiavi) salvano gli stessi dati sul profilo cliente per precompilare i checkout successivi.

Correggere un dato fiscale prima di fatturare

1. Apri l’ordine in Shopify Admin.
2. Modifica il metafield ordine app.pop_* interessato (deve essere pinnato per essere visibile).
3. Salva: la generazione successiva userà subito il valore aggiornato.

Se i metafield non risultano creati (es. wizard/licenza POP non completati), l’app mostra nella Home una sezione di recovery con un pulsante per ricrearli manualmente.

Verifica

• Genera un documento per un ordine con metafield app.pop_vat valorizzato diverso dal customAttribute corrispondente: il documento deve usare il valore del metafield.
• Dopo aver modificato un metafield ordine pinnato, rigenera il documento e verifica che il nuovo valore sia stato usato.

Errori comuni

• Non vedo i campi fiscali sull’ordine o sul cliente — verifica che wizard/licenza POP siano completati e che i metafield pop_* risultino creati; se mancanti, usa il pulsante di ricreazione dalla Home.
• Ho corretto il customAttribute ma la fattura non cambia — i metafield ordine hanno sempre priorità: correggi il metafield, non il customAttribute.
• Store non-Plus, POS o ordini manuali — su questi canali i dati potrebbero non essere raccolti in checkout: vanno inseriti manualmente nei metafield ordine prima della fatturazione (vedi shopify-non-plus-billing-fields per la raccolta via tema).

Configurazione correlata

Per l’indirizzo di fatturazione del cliente su un ordine specifico, vedi shopify-billing-address-override. Per l’indirizzo del venditore, vedi shopify-seller-fiscal-data.