Open2b versione 7.5

Checkout

Di seguito sono documentate:

le variabili della pagina checkout-addresses.html per inserire gli indirizzi di fatturazione e spedizione
le variabili della pagina checkout-methods.html per la scelta dei metodi di pagamento e spedizione
le variabili della pagina checkout-review.html di riepilogo prima della conferma dell'ordine
le variabili della pagina checkout-confirmation.html di conferma dell'ordine concluso
le variabili della pagina checkout-quote-request.html per la compilazione e invio della richiesta di preventivo
le variabili della pagina checkout-cart.html per visualizzare il carrello durante il checkout
le variabili della pagina checkout-form.html

In aggiunta a queste si possono usare anche le variabili comuni a tutte le pagine.

checkout-addresses.html

Prima pagina del checkout dove si inseriscono gli indirizzi di fatturazione e spedizione.

var (

    // Casella da selezionare per accettare le condizioni di vendita e
    // l'informativa sulla privacy.
    acceptTerms html

    // Pulsante per proseguire con l'ordine.
    buttonContinue html

    // Pulsante per ritornare al carrello.
    buttonGoBack html

    // Carrello.
    // Presente a partire dalla versione 7.2.
    cart CheckoutCart

    // Città.
    city TextField

    // Partita Iva.
    companyCode TextField

    // REA.
    companyCode2 TextField

    // Ragione sociale.
    companyName TextField

    // Contenuto della pagina.
    content html

    // Nazione.
    country html

    // Indirizzo email.
    email TextField

    // Numero di fax.
    faxNumber TextField

    // Nome.
    firstName TextField

    // Immagine della pagina.
    image AlignedImage

    // Codice o indirizzo PEC del destinatario della fattura elettronica
    // nuova.
    invoiceRecipient TextField

    // Cognome.
    lastName TextField

    // Numero di cellulare.
    mobileNumber TextField

    // Codice fiscale.
    personalCode TextField

    // Numero di telefono.
    phoneNumber TextField

    // Codice postale.
    postalCode TextField

    // Trattamenti sulla privacy secondo la GDPR.
    processings []Processing

    // Città di spedizione.
    shipCity TextField

    // Nazione di spedizione.
    shipCountry html

    // Nome del destinatario della spedizione.
    shipName TextField

    // Codice postale di spedizione.
    shipPostalCode TextField

    // Provincia di spedizione.
    shipStateProv html

    // Via di spedizione.
    shipStreet1 TextField

    // Via di spedizione, seconda riga.
    shipStreet2 TextField

    // Casella selezionabile se si desidera spedire ad un indirizzo diverso
    // da quello di fatturazione.
    shipToAnotherAddress html

    // Provincia.
    stateProv html

    // Messaggio che informa di eventuali errori nella compilazione del
    // modulo.
    statusMessage html

    // Via.
    street1 TextField

    // Via, seconda riga.
    street2 TextField

)

checkout-methods.html

Seconda pagina del checkout dove si richiede al cliente di scegliere i metodi di pagamento e spedizione.

Per concludere subito l'ordine da questa pagina, ad esempio perché si utilizza Stripe come sistema di pagamento, allora utilizzare la variabile buttonOrder per visualizzare il pulsante per concludere l'ordine.

Per visualizzare al cliente, dopo questa pagina, una pagina di riepilogo dell'ordine, allora usare la variabile buttonContinue al posto di buttonOrder.

Le due variabili buttonOrder e buttonContinue non dovrebbero essere usate assieme nella pagina.

var (

    // Pulsante per proseguire con l'ordine andando alla pagina checkout-review.html.
    // Usare invece buttonOrder se si ha Stripe come sistema di pagamento o se non si
    // desidera far concludere subito l'ordine.
    buttonContinue html

    // Pulsante per ritornare agli indirizzi.
    buttonGoBack html

    // Pulsante per confermare ed eseguire l'ordine.
    buttonOrder html

    // Carrello.
    // Presente a partire dalla versione 7.2.
    cart CheckoutCart

    // Contenuto della pagina.
    content html

    // Immagine della pagina.
    image AlignedImage

    // Metodi di pagamento.
    payments []PaymentMethod

    // Richieste del cliente.
    requests html

    // Metodi di spedizione.
    shippings []ShippingMethod

    // Messaggio che informa di eventuali errori di compilazione.
    statusMessage html

)

checkout-review.html

Riepilogo dell'ordine dove è possibile verificare la correttezza di tutti i dati precedentemente inseriti prima di confermare l'ordine.

Questa pagina viene visualizzata qualora nella pagina checkout-methods.html è stata usata la variabile buttonContinue al posto di buttonOrder.

Variabili deprecate

Le seguenti variabili sono deprecate a partire dalla versione 7.2: discount, discounts, items, payment, paymentCost, prediscountSubtotal, shipping, shippingCost, subtotal, taxAmount, total e weight. Si possono ancora utilizzare ma si consiglia di usare al loro posto i campi della variabile cart.

var (

    // Indirizzo di fatturazione.
    billingAddress html

    // Pulsante per ritornare ai metodi di pagamento e spedizione.
    buttonGoBack html

    // Pulsante per confermare ed eseguire l'ordine.
    buttonOrder html

    // Carrello.
    // Presente a partire dalla versione 7.2.
    cart CheckoutCart

    // Partita Iva.
    companyCode string

    // REA.
    companyCode2 string

    // Contenuto della pagina.
    content html

    // Indirizzo email.
    email string

    // Numero di fax.
    faxNumber string

    // Immagine della pagina.
    image AlignedImage

    // Numero di cellulare.
    mobileNumber string

    // Codice fiscale.
    personalCode string

    // Numero di telefono.
    phoneNumber string

    // Richieste del cliente.
    requests string

    // Indirizzo di spedizione.
    shippingAddress html

)

checkout-confirmation.html

Ultima pagina del checkout dove viene data conferma dell'ordine appena eseguito. Se si deve procedere on-line al pagamento sarà visualizzato il pulsante per procedere.

Dopo il pagamento si tornerà nuovamente su questa pagina dove sarà comunicato l'esito della transazione. Con alcuni metodi di pagamento si potrà riprovare nuovamente il pagamento in caso di esito negativo.

var (

    // Pulsante per pagare on-line.
    buttonPay html

    // Contenuto della pagina.
    content html

    // Immagine della pagina.
    image AlignedImage

    // Numero dell'ordine. Ha lo stesso valore di order.Number.
    number string

    // Metodo di pagamento.
    payment string

    // Indica se il pagamento è stato eseguito ed approvato.
    paymentApproved bool

    // Indica se si è verificato un errore nel pagamento.
    paymentError bool

    // Indica se il pagamento è stato eseguito ma è fallito.
    paymentFailed bool

    // Istruzioni per eseguire il pagamento.
    paymentInstructions string

    // Indica se non si conosce lo stato del pagamento.
    paymentUnknown bool

    // Token dell'ordine. Può essere usato per leggere l'ordine con
    // Storefront API o leggerlo e modificarlo con Commerce API.
    token string

    // Totale dell'ordine. Ha lo stesso valore di order.Total.
    total Price

)

checkout-quote-request.html

Compilazione e invio della richiesta di preventivo. A questa pagina si arriva quando il carrello è su preventivo e il cliente procede con la richiesta di preventivo.

Variabili deprecate

La variabile items è deprecata a partire dalla versione 7.2. Usare al suo posto cart.Items che ha lo stesso tipo.

var (
    // Casella da selezionare per accettare le condizioni di vendita e
    // l'informativa sulla privacy.
    acceptTerms html

    // Pulsante per ritornare al carrello.
    buttonGoBack html

    // Pulsante per inviare la richiesta di preventivo.
    buttonSendQuoteRequest html

    // Carrello.
    // Presente a partire dalla versione 7.2.
    cart CheckoutCart

    // Città.
    city TextField

    // Partita Iva.
    companyCode TextField

    // REA.
    companyCode2 TextField

    // Ragione sociale.
    companyName TextField

    // Contenuto della pagina.
    content html

    // Nazione.
    country html

    // Indirizzo email.
    email TextField

    // Numero di fax.
    faxNumber TextField

    // Nome.
    firstName TextField

    // Immagine della pagina.
    image AlignedImage

    // Codice o indirizzo PEC del destinatario della fattura elettronica.
    invoiceRecipient TextField

    // Cognome.
    lastName TextField

    // Numero di cellulare.
    mobileNumber TextField

    // Codice fiscale.
    personalCode TextField

    // Numero di telefono.
    phoneNumber TextField

    // Codice postale.
    postalCode TextField

    // Trattamenti sulla privacy secondo la GDPR.
    processings []Processing

    // Richieste del cliente.
    requests html

    // Città di spedizione.
    shipCity TextField

    // Nazione di spedizione.
    shipCountry html

    // Nome del destinatario della spedizione.
    shipName TextField

    // Codice postale di spedizione.
    shipPostalCode TextField

    // Provincia di spedizione.
    shipStateProv html

    // Via di spedizione.
    shipStreet1 TextField

    // Via di spedizione, seconda riga.
    shipStreet2 TextField

    // Casella selezionabile se si desidera spedire ad un indirizzo diverso
    // da quello di fatturazione.
    shipToAnotherAddress html

    // Provincia.
    stateProv html

    // Messaggio che informa di eventuali errori di compilazione.
    statusMessage html

    // Via.
    street1 TextField

    // Via, seconda riga.
    street2 TextField

)

checkout-quote-confirmation.html

Pagina di conferma che la richiesta di preventivo è stata inviata.

var (

    // Contenuto della pagina.
    content html

    // Immagine della pagina.
    image AlignedImage

)

checkout-cart.html

Durante il checkout, nella pagina checkout-methods.html, quando un cliente seleziona un metodo di pagamento o spedizione, il carrello nella pagina viene automaticamente aggiornato. Per aggiornarlo Open2b cerca un elemento con id uguale a design-checkout-cart e sostituisce il suo contenuto con quello restituito dalla pagina checkout-cart.html.

La pagina checkout-cart.html pertanto viene usata per mostrare il carrello nel checkout. Il modo usuale di farlo è aggiungere un codice come il seguente nella pagina checkout-methods.html:

<div id="design-checkout-cart">
  {{ render "/checkout-cart.html" }}
</div>

In questo modo quando la pagina checkout-methods.html viene chiamata, viene mostrato il carrello e in seguito, quando il cliente sceglie un metodo di pagamento o spedizione, della pagina viene aggiornato solo il carrello senza ricaricare l'intera pagina.

Siccome il carrello nel checkout è disponibile anche nelle pagine checkout-addresses.html, checkout-review.html e checkout-quote-request.html. con le stesse variabili presenti nella pagina checkout-cart.html, potete usare il precedente codice HTML anche in queste altre pagine oltre che in checkout-methods.html.

Nota

La pagina checkout-cart.html è disponibile a partire dalla versione 7.2.

Nella pagina checkout-cart.html sono disponibili esclusivamente le seguenti variabili:

var (

    // Carrello.
    cart CheckoutCart

    // Valute del sito.
    currencies Currencies

    // Valuta corrente.
    currency Currency

    // Identificativo del gruppo clienti del cliente o
    // del gruppo clienti principale se il cliente non è loggato.
    customerGroup int

    // Indica se il cliente ha fatto il login.
    isLoggedIn bool

    // Lingua corrente.
    language Language

    // Lingue del sito.
    languages Languages

    // Indica se nei prezzi sono escluse le tasse.
    taxesAreExcluded bool

)

checkout-form.html

var (

    // Casella da selezionare per accettare le condizioni di vendita e
    // l'informativa sulla privacy.
    acceptTerms html

    // Pulsante per ritornare al carrello.
    buttonGoBack html

    // Pulsante per confermare ed eseguire l'ordine.
    buttonOrder html

    // Città.
    city TextField

    // Partita Iva.
    companyCode TextField

    // REA.
    companyCode2 TextField

    // Ragione sociale.
    companyName TextField

    // Contenuto della pagina.
    content html

    // Nazione.
    country html

    // Coupon correntemente applicato al carrello.
    // È una stringa vuota se nessun coupon è applicato.
    currentCoupon string

    // Sconto in percentuale o fisso sull'ordine.
    discount Discount

    // Sconti applicati al costo totale del carrello.
    discounts []Discount

    // Indirizzo email.
    email TextField

    // Numero di fax.
    faxNumber TextField

    // Nome.
    firstName TextField

    // Immagine della pagina.
    image AlignedImage

    // Codice o indirizzo PEC del destinatario della fattura elettronica.
    invoiceRecipient TextField

    // Referenze di prodotto che si stanno ordinando.
    items []CartItem

    // Cognome.
    lastName TextField

    // Numero di cellulare.
    mobileNumber TextField

    // Metodo di pagamento.
    payment html

    // Metodi di pagamento.
    payments []PaymentMethod

    // Costo del pagamento, ad esempio dovuto ad una commissione o al diritto
    // di contrassegno.
    paymentCost Price

    // Codice fiscale.
    personalCode TextField

    // Numero di telefono.
    phoneNumber TextField

    // Codice postale.
    postalCode TextField

    // Costo totale prima dell'applicazione dell'eventuale sconto.
    prediscountSubtotal Price

    // Trattamenti sulla privacy secondo la GDPR.
    processings []Processing

    // Modulo che il cliente può compilare con richieste specifiche sul
    // prodotto. Presente solo se è su preventivo.
    requests html

    // Città di spedizione.
    shipCity TextField

    // Nazione di spedizione.
    shipCountry html

    // Nome del destinatario della spedizione.
    shipName TextField

    // Metodo di spedizione.
    shipping html

    // Costo della spedizione.
    shippingCost Price

    // Metodi di spedizione.
    shippings []ShippingMethod

    // Codice postale di spedizione.
    shipPostalCode TextField

    // Provincia di spedizione.
    shipStateProv html

    // Via di spedizione.
    shipStreet1 TextField

    // Via di spedizione, seconda riga.
    shipStreet2 TextField

    // Casella selezionabile se si desidera spedire ad un indirizzo diverso
    // da quello di fatturazione.
    shipToAnotherAddress html

    // Provincia.
    stateProv html

    // Messaggio che informa di eventuali errori nella compilazione del
    // modulo.
    statusMessage html

    // Via.
    street1 TextField

    // Via, seconda riga.
    street2 TextField

    // Costo totale.
    subtotal Price

    // Importo totale delle tasse.
    taxAmount Price

    // Indica se il carrello è su preventivo.
    toQuote bool

    // Totale.
    total Price

    // Peso totale delle righe.
    weight Decimal

)