Nomi dei campi di fatturazione aggiunti da POP al checkout

Configurazionewordpress2026-07-01

Obiettivo

Conoscere i nomi tecnici (name/meta key) dei campi che POP aggiunge al checkout WooCommerce, utili se personalizzi il tema, un plugin di checkout custom, o leggi i meta dell’ordine via codice.

Campi aggiunti

Campo	Cosa contiene
`billing_choice_type`	Scelta documento: `receipt` (ricevuta) o `invoice` (fattura). Visibile solo se la scelta è abilitata (vedi sotto).
`billing_invoice_type`	Tipo cliente: `private` (privato), `company` (azienda) o `freelance` (libero professionista) — chiavi fisse, anche se personalizzi le etichette.
`billing_sdi_type`	Un unico campo per PEC oppure codice destinatario SDI a 7 caratteri (non sono due campi separati).
`billing_vat_number`	Partita IVA.
`billing_tax_code`	Codice fiscale.

Sui campi billing_sdi_type, billing_vat_number e billing_tax_code viene applicato un controllo di formato (RegEx) oltre all’eventuale obbligatorietà, che varia in base a paese e tipo cliente.

Dove si configurano visibilità/etichette

Tutti questi comportamenti si impostano in POP → Electronic Invoice - Settings, tab Checkout:

Customer type list — personalizza le etichette di billing_invoice_type (le chiavi private, company, freelance restano fisse); formato: una riga per voce, chiave:Etichetta.
Activate the choice of receipt — mostra/nasconde il campo billing_choice_type.
Disable PEC/unique code field — nasconde billing_sdi_type (il codice destinatario viene impostato automaticamente a 0000000).
Disable Fiscal Code — nasconde billing_tax_code per aziende e liberi professionisti.
VAT number and tax code for non-EU customers — mostra/nasconde questi campi per clienti extra-UE.
Position of the fields (e-invoice) in the checkout form — posiziona il blocco campi in alto o in basso nel form.

Verifica

Ispeziona l’HTML del checkout (o i meta dell’ordine in wp-admin > Ordini) e controlla che i nomi dei campi corrispondano esattamente a quelli in tabella.

Errori comuni

Un plugin/tema personalizzato non trova il campo PEC — probabilmente cerca billing_pec: il nome corretto è billing_sdi_type (usato sia per PEC che per il codice SDI).
Cerchi billing_cf — il nome effettivo è billing_tax_code.
I meta salvati sull’ordine non coincidono con quanto scritto in checkout — se usi un plugin di checkout personalizzato, la compatibilità con questi campi non è garantita: POP non può gestire logiche di terze parti che alterano il flusso ordine.

Configurazione correlata

Per aggiungere logica custom basata su questi campi (es. tramite gli hook wc_el_inv-*) vedi custom-code-snippets.