Passa al contenuto principale

Customer

L'oggetto Customer rappresenta il profilo dell'utente autenticato all'interno del tuo store. Contiene le informazioni anagrafiche di base, le preferenze di contatto e lo stato fiscale dell'utente.

Definizione Customer

ProprietàTipoDescrizione
idstring (UUID)Identificativo univoco del cliente.
emailstringIndirizzo email registrato.
displayNamestringNome e cognome dell'utente o nome visualizzato.
emailVerifiedbooleanIndica se l'indirizzo email è stato confermato.
providerstringMetodo di autenticazione utilizzato: password.
createdAtstring (ISO 8601)Data e ora di creazione del profilo.
twoFactorEnabledbooleanIndica se l'autenticazione a due fattori (2FA) è attiva.
vatExemptbooleanSe true, l'utente ha diritto all'esenzione IVA (es. acquisti intra-UE con Partita IVA valida).
vatCodestringPartita IVA o codice fiscale associato al profilo.
newsletterbooleanIndica se l'utente ha prestato il consenso alle comunicazioni di marketing.

Esempio di oggetto

{
"id": "00e72027-3672-4c12-a78f-e9ff744a0892",
"email": "[email protected]",
"displayName": "Nome Cognome",
"emailVerified": true,
"provider": "password",
"createdAt": "2025-11-24T14:16:04.670Z",
"twoFactorEnabled": true,
"vatExempt": false,
"vatCode": "IT01234567890",
"newsletter": true
}

Gestione Fiscale

La proprietà vatExempt è fondamentale durante il checkout: quando impostata su true, il motore di webround.com ricalcola automaticamente i totali del carrello escludendo le imposte. Il vatCode è fondamentale per comunicare a Stripe il codice IVA da inserire come destinatario della fattura.

L'impostazione di questi dati è possibile solo ed esclusivamente dal gestionale. Non c'è un sistema di impostazione autonoma da parte del cliente.