Checkout per Salesforce Commerce Cloud

Una volta preparato metadata.zip, lo importi nella Sua sandbox SFCC:

1. Vada a Business Manager > Administration > Site Development > Site Import & Export.
2. Carichi metadata.zip utilizzando l'opzione di caricamento Local.
3. Dopo il caricamento, individui l'archivio nell'elenco e clicchi su Import.

Questo passaggio crea le preferenze del sito, i servizi, le credenziali e gli oggetti personalizzati richiesti dall'integrazione Zonos.

Aggiunga la cartridge int_zonos al cartridge path del Suo sito per attivare i controller, gli script e i template:

1. Vada a Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Inserisca int_zonos nel cartridge path prima della cartridge storefront SFRA di base (app_storefront_base).

Ci sono 2 Pipeline personalizzate incluse con la cartridge a cui dovrebbero essere aggiunti alias pipeline all'interno di Business Manager:

Zonos-OrderConfirmation

Viene utilizzata per la conferma ordine personalizzata all'interno di SFCC una volta completato l'ordine nel checkout Zonos. L'utente verrà reindirizzato qui. Ad esempio, l'alias potrebbe essere zonos-order-confirmation. Selezioni e aggiunga un alias appropriato per la Sua attività, diverso dall'alias utilizzato per la pagina di conferma ordine checkout nativa SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Viene utilizzato per l'endpoint personalizzato utilizzato per creare l'ordine Zonos all'interno di SFCC/SFRA e si presume che l'alias sia zonos-placesfccorder. Se utilizza un alias diverso qui, dovrà annotarlo quando arriverà alla configurazione del servizio. Non è un URL pubblico, quindi si consiglia di utilizzare zonos-placesfccorder per la configurazione iniziale per mantenere la semplicità d'uso di questa cartridge.

Per configurare questi due alias, in Business Manager, vada a Merchant Tools > URL Rules > Pipeline URLs.

Con l'importazione del sito nel passaggio 2, sono stati creati due servizi SFCC (con profili e credenziali associati): zonos.api.graphql e create.order.api.sfra.

Configurazione sito singolo

Se la Sua organizzazione ha un singolo sito storefront all'interno della Sua organizzazione SFCC, non c'è nulla di aggiuntivo da fare qui e può continuare al passaggio successivo.

Configurazione siti multipli

Se la Sua organizzazione ha più siti storefront, o prevede di averne più di uno, all'interno della Sua organizzazione SFCC, dovrà apportare aggiornamenti/aggiunte ai Suoi servizi SFCC. Quando ha più siti SFCC che utilizzeranno l'integrazione Zonos, avrà bisogno di un servizio create order API per ciascun sito. Per ciascun sito, esegua quanto segue:

1. Crei una nuova credenziale con il nome create.order.api.[siteID].
2. Assegni l'URL della credenziale a: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (ad esempio: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Crei un nuovo servizio con il nome create.order.api.[siteID] e gli assegni il profilo create.order.api e la credenziale create.order.api.[siteID] creata nel passaggio 1.

Una volta completato, dovrebbe avere un servizio create order API per ciascuno dei Suoi siti.

Nota: Se non ha rinominato il servizio originale create.order.api.sfra per essere il servizio create order per uno dei Suoi siti, e esiste ancora, può eliminarlo. Lasci il nome del servizio zonos.api.graphql com'è. Anche con più siti, avrà bisogno di un solo servizio API Zonos.

In Business Manager, vada a Merchant Tools > Site Preferences > Custom Preferences, quindi clicchi sul gruppo di preferenze zonos per accedere alle preferenze del sito personalizzate Zonos.

Imposti le seguenti preferenze del sito per il/i Suo/i sito/i:

Durante il Zonos Modal Checkout, gli acquirenti selezionano metodi di spedizione definiti nel Suo Zonos Dashboard. Quando questi ordini vengono importati in SFCC, i loro metodi di spedizione devono corrispondere a un metodo di spedizione SFCC valido. Per supportare questo:

1. Configuri uno o più metodi di spedizione in SFCC a cui i Suoi metodi di spedizione in Zonos dovrebbero essere mappati.
2. Nella preferenza del sito personalizzata Zonos Ship Method Mapping descritta sopra, stabilisca uno o più mapping dei metodi di spedizione tra i Suoi metodi di spedizione Zonos e i Suoi metodi di spedizione SFCC.

Ship Method Mapping

Sotto forma di oggetto JSON, il ship method mapping mappa i Suoi metodi di spedizione Zonos ai Suoi metodi di spedizione SFCC. Questo mapping deve avere un record di mapping per ogni potenziale metodo di spedizione Zonos (service level) che potrebbe essere selezionato nel Suo checkout Zonos. Si consiglia vivamente di includere anche un record di mapping default che verrà utilizzato nei casi in cui un ordine Zonos viene effettuato con un metodo di spedizione per il quale non esiste un mapping a un metodo di spedizione SFCC, prevenendo così errori a valle causati dalla mancanza di un metodo di spedizione nell'ordine SFCC.

Il formato per l'oggetto JSON è:

{
  "[Zonos Shipping Service Level Code]": "[SFCC Shipping Method ID]",
  ...
  "default": "[Default SFCC Shipping Method ID]"
}

Esempio

Supponiamo che abbia abilitato i seguenti service level nel Suo Zonos Dashboard:

Per qualsiasi motivo (ad es. requisiti backoffice, un'integrazione aggiuntiva con un servizio di spedizione di terze parti, ecc.), potrebbe essere limitato ai seguenti metodi di spedizione in SFCC per il Suo sito:

Quando viene ricevuto un nuovo ordine Zonos e poi inserito in SFCC, il metodo di spedizione deve provenire da questo elenco.

Per costruire il Suo mapping, acceda al Suo Zonos Dashboard, vada a Shipping > Manage Rates, quindi clicchi su ciascuno degli Enabled service levels visualizzati, dove vedrà una visualizzazione simile alla seguente:

In ciascuno, clicchi su Edit details per ottenere (o impostare) il codice service level di spedizione Zonos (vedi sotto).

Con il codice service level di spedizione, crei un record di mapping che lo associa al metodo di spedizione SFCC che desidera visualizzare sui Suoi ordini SFCC quando quel service level (metodo di spedizione Zonos) viene scelto nel checkout Zonos.

Una volta aggiunto un record per ciascun codice service level abilitato, nonché un mapping del metodo di spedizione default, il Suo oggetto JSON Zonos Ship Method Mapping dovrebbe essere simile a questo:

{
  "ups.worldwide_saver": "004",
  "ups.standard": "002",
  "ups.worldwide_expedited": "012",
  "ups.worldwide_express": "012",
  "default": "001"
}

Nota: Poiché si tratta solo di un mapping dei metodi di spedizione Zonos ai metodi di spedizione SFCC, è importante includere nel mapping tutti i metodi di spedizione Zonos. Non è necessario includere nel mapping ciascuno dei Suoi metodi di spedizione SFCC.

Nell'installazione sono inclusi due job SFCC per supportare l'integrazione Zonos:

CreateOrdersFromZonos

Questo job cerca nuovi riferimenti ordine Zonos creati nello store di oggetti personalizzati zonosOrders, recupera i dettagli completi dell'ordine da Zonos e crea ordini corrispondenti in SFCC.

Schedule: Può pianificare questo job in base alle esigenze della Sua attività, ma in genere dovrebbe essere configurato per essere eseguito a intervalli, relativamente frequentemente (ad es. ogni 5-10 minuti), ogni giorno della settimana.

Custom Parameters: Il job CreateOrdersFromZonos non include parametri personalizzati.

CreateMissingZonosOrders

Sebbene dovrebbe essere raro, è possibile che, a causa di circostanze impreviste, ci siano ordini effettuati in Zonos che non arrivano nella Sua istanza SFCC tramite il processo normale. Per questo motivo, abbiamo incluso il job CreateMissingZonosOrders. Questo job esegue un controllo incrociato tra la cronologia ordini Zonos e SFCC per identificare e importare eventuali ordini mancanti.

Schedule: Può pianificare questo job in base alle esigenze della Sua attività, ma dovrebbe pianificarlo per essere eseguito meno frequentemente del job CreateOrdersFromZonos. Alcuni aspetti da considerare quando pianifica la frequenza di esecuzione di questo job:

1. Come per tutti i job, dopo aver considerato tutti gli aspetti, inclusi carico di elaborazione/larghezza di banda e le esigenze della Sua attività, dovrebbe pianificare questo job per essere eseguito il meno frequentemente possibile.
2. Poiché questo job interrogherà tutti gli ordini in un periodo di tempo, i siti ad alto volume dovrebbero eseguire questo job più frequentemente (così meno ordini elaborati per esecuzione del job), mentre i siti a basso volume possono permettersi una frequenza minore.
3. La nostra frequenza di base suggerita per CreateMissingZonosOrders, che riteniamo funzionerà per la maggior parte dei siti, è una volta ogni 90 minuti.

Custom Parameters: Ci sono due parametri personalizzati associati al passo del job CreateMissingZonosOrders che dovrebbe impostare:

1. LookBackHours: È il numero di ore (dal momento in cui viene eseguito il job) indietro nel tempo per cui il job dovrebbe interrogare Zonos alla ricerca di ordini mancanti. In base alla frequenza pianificata del job, questo valore dovrebbe essere almeno uguale al tempo tra le esecuzioni del job e idealmente dovrebbe avere una sovrapposizione. Ad esempio, se il job è pianificato per essere eseguito ogni 90 minuti, imposti LookBackHours su 2 (ore). Valore predefinito (se non viene impostato alcun valore): 2
2. OrderSize: Numero massimo di ordini da recuperare per ogni query interna a Zonos. Lo consideri come la dimensione della pagina che il job utilizza quando interroga Zonos per gli ordini. Valore predefinito (se non viene impostato alcun valore): 20

Zonos Hello fornisce capacità di localizzazione lato client come selezione dinamica della lingua, messaggistica su dazi/imposte e conversione inline della valuta. Una volta che Zonos è abilitato nelle preferenze del sito, Hello viene caricato automaticamente sul Suo storefront tramite lo script client Zonos.

Gli script client Zonos vengono aggiunti utilizzando un remote include SFCC dell'endpoint Zonos-ClientScriptInclude, situato in fondo ai seguenti template overlay:

• /cartridge/templates/default/common/layout/page.isml
• /cartridge/templates/default/common/layout/checkout.isml

Se il Suo progetto sovrascrive questi template in cartridge con priorità più alta, si assicuri che il remote include sia aggiunto alle Sue versioni personalizzate:

<isinclude url="${URLUtils.url('Zonos-ClientScriptInclude', 'pageType', pdict.action)}"/>

Scopra di più su Zonos Hello.

Zonos Hello converte automaticamente i valori di prezzo visualizzati sullo storefront nella valuta locale dell'acquirente. Affinché funzioni correttamente:

1. I valori di prezzo devono essere racchiusi in elementi HTML utilizzando nomi di classe o ID selezionabili tramite jQuery. Ad esempio: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Questi valori selettore devono essere inclusi nella preferenza del sito Currency Element Selector (o nel Suo Zonos Dashboard).

Modifiche al codice di visualizzazione dei prezzi

La cartridge Zonos include i seguenti template overlay per i punti in cui i prezzi vengono renderizzati in tutto il sito dell'architettura di riferimento, utilizzando i nomi di classe zonos-list-price, zonos-sales-price e zonos-price assegnati agli elementi HTML che contengono quei vari prezzi:

• /cartridge/templates/default/cart/productCard/cartCouponDisplay.isml
• /cartridge/templates/default/cart/cartTotals.isml
• /cartridge/templates/default/checkout/billing/billingSummary.isml
• /cartridge/templates/default/checkout/cart/miniCart.isml
• /cartridge/templates/default/chackout/productCard/productCardProductTotalPrice.isml
• /cartridge/templates/default/product/components/pricing.isml
• /cartridge/templates/default/product/components/setPrice.isml

Se non ci sono cartridge contenenti questi template e configurate con priorità più alta di int_zonos nel cartridge path, non sono necessarie modifiche al codice affinché Zonos Hello converta le valute di queste visualizzazioni dei prezzi sul Suo sito. Se ha versioni personalizzate di questi template in una o più cartridge con priorità più alta di int_zonos nel cartridge path, dovrà includere un nome di classe univoco nei wrapper HTML attorno ai Suoi prezzi (come illustrato sopra) in quei template personalizzati.

Configurazione della stringa selettore degli elementi prezzo

La stringa selettore valuta è un valore stringa selettore in stile jQuery utilizzato dallo script Zonos per identificare gli elementi HTML contenenti valori di prezzo che dovrebbero ricevere aggiornamenti di conversione della valuta. Questo valore dovrebbe essere un elenco delimitato da spazi dei nomi di classe CSS e/o ID assegnati agli elementi HTML che racchiudono le visualizzazioni dei prezzi del Suo sito descritte nel passaggio precedente, dove i nomi di classe sono preceduti da . e gli ID sono preceduti da # (senza virgolette). Ad esempio, se il Suo sito utilizzerà i template per la visualizzazione dei prezzi inclusi nella cartridge Zonos, la stringa selettore sarà .zonos-list-price .zonos-sales-price .zonos-price (senza virgolette).

La stringa selettore valuta può essere configurata tramite il Suo Zonos Dashboard o nella preferenza del sito Currency Element Selector delle preferenze del sito personalizzate Zonos in Business Manager.

Nota: Se configurata in entrambi i posti, il valore in Business Manager avrà la precedenza.

Scopra di più sulla conversione valuta di Zonos Hello.

La stringa selettore del pulsante checkout è un valore stringa selettore jQuery utilizzato dallo script Zonos per identificare gli elementi HTML sul Suo sito che fungono da controlli pulsante che, quando cliccati, portano il cliente nel flusso checkout del Suo sito.

Quando gli acquirenti cliccano un pulsante Checkout corrispondente alla stringa selettore configurata, Zonos intercetta automaticamente l'azione e apre il checkout modale.

La stringa selettore del pulsante checkout può essere configurata tramite il Suo Zonos Dashboard o nella preferenza del sito Place Order (Checkout) Button Selector delle preferenze del sito personalizzate Zonos in Business Manager.

Quando l'utente completa un ordine all'interno del checkout ospitato Zonos, viene reindirizzato a una Pipeline personalizzata che visualizza una conferma ordine all'interno di SFCC (Zonos-OrderConfirmation). Il template di rendering principale per questa conferma ordine è /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Questa pagina di conferma ordine utilizza lo stesso stile della pagina di conferma ordine nativa SFCC/SFRA e condivide alcuni file .isml con la pagina di conferma ordine nativa SFCC/SFRA. Potrebbero essere necessari alcuni aggiornamenti di stile per corrispondere a eventuali aggiornamenti di stile personalizzati già apportati al sito. I template di rendering di base utilizzati dal template di conferma ordine Zonos includono:

• app_storefront_base\cartridge\templates\default\checkout\confirmation\confirmationDetails.isml
• app_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.isml
• int_zonos\cartridge\templates\default\checkout\billing\billingSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderProductSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.isml

La funzione sottostante relativa a questa pipeline personalizzata, al di fuori della visualizzazione di una conferma ordine all'utente, riguarda un nuovo tipo di oggetto personalizzato incluso nell'importazione dei dati, zonosOrders. Quando la conferma ordine viene visualizzata per l'utente, SFCC utilizza l'id ordine Zonos visualizzato nell'url per la conferma ordine e crea un oggetto personalizzato corrispondente con l'ID ordine Zonos come Key Attribute per l'oggetto personalizzato. Questo viene quindi utilizzato per inserire l'ordine all'interno di SFCC tramite il job CreateOrdersFromZonos. Questo job itererà attraverso tutti gli oggetti personalizzati di tipo zonosOrders con createdStatus = - None -. Il job eseguirà alcune attività:

1. Interroga Zonos per i dettagli dell'ordine.
2. Utilizza questa risposta per creare l'ordine all'interno di SFCC in base alle impostazioni configurate nelle preferenze del sito per metodo di spedizione e metodo di pagamento + dettagli per articoli, spedizione, fatturazione e cliente nella risposta.
3. Aggiorna Zonos con il numero ordine SFCC tramite una mutation per associarlo al numero ordine Zonos all'interno del Zonos Dashboard.

Se i passaggi sopra hanno successo, l'attributo oggetto personalizzato createdStatus verrà impostato su created per rimuovere l'oggetto da future considerazioni. Se i passaggi sopra non hanno successo, l'attributo oggetto personalizzato createdStatus verrà impostato su failed e un messaggio di errore verrà annotato all'interno dell'oggetto nell'attributo errorResponse (Zonos) o sfccErrorResponse (SFCC) a seconda del sistema che risponde con l'errore durante il processo.

Se deve riprovare a inserire l'ordine, reimposti semplicemente createdStatus su - None - e verrà preso in considerazione nella prossima esecuzione del job.

Facoltativo—Le seguenti impostazioni sono impostazioni avanzate. Sono in vigore valori predefiniti, quindi non è necessaria alcuna azione. Se desidera apportare modifiche, segua queste linee guida:

Create invoice on import

Impostato su Yes per impostazione predefinita. Zonos creerà una fattura al momento dell'importazione dell'ordine. Se sceglie di disabilitare questa funzionalità, dovrà creare la Sua fattura e Zonos imposterà un hold di revisione antifrode su uno stato zonos_hold. Una volta rimossa la frode, torneremo allo stato precedente.

Customer login

Impostato su No per impostazione predefinita. Se desidera richiedere un account per il checkout, passi a Yes. Dovrà anche andare a Customer configuration > Login options e aggiornare Redirect Customer to Account Dashboard after Logging In su No.

SFCC order export

Se utilizza, o prevede di utilizzare, l'SFCC Order Export, si assicuri che gli attributi personalizzati Zonos assegnati agli oggetti Order e Product siano inclusi nei Suoi file di export ordini SFCC. Da Merchant Tools > Site Preferences > Orders, imposti la versione dello schema di export ordini all'ultima versione.

Le informazioni sul prodotto possono influenzare l'importo dei dazi e delle imposte dovute e il costo di spedizione. Più informazioni sul prodotto fornisce a Zonos, più preciso sarà il preventivo restituito. Zonos può generare un preventivo anche quando queste informazioni non sono disponibili, ma consiglia di fornire i seguenti dettagli chiave del prodotto per migliorare l'accuratezza:

• Weight: Il peso influisce sul costo di spedizione, che può influenzare dazi o imposte. I pesi nelle Sue inserzioni prodotto SFCC vengono utilizzati automaticamente da Zonos quando presenti.
• Dimensions: Le dimensioni possono influenzare il costo di spedizione, che può influenzare dazi o imposte. Zonos può utilizzare le dimensioni del prodotto (lunghezza, larghezza e altezza) impostate su ciascun prodotto in SFCC, ma deve mapparle nelle preferenze del sito personalizzate Zonos per una corretta integrazione.
• HS codes: I codici HS influenzano le aliquote dei dazi e a volte possono influenzare le imposte. Zonos può utilizzare i codici HS impostati nelle Sue inserzioni prodotto in SFCC, ma deve mappare il campo codice HS nelle preferenze del sito personalizzate Zonos.
• Country of origin: Il paese di origine di un prodotto influisce sulle aliquote dei dazi e può influenzare le imposte. Il paese di origine impostato nelle Sue inserzioni prodotto SFCC viene utilizzato automaticamente da Zonos quando presente.

Nota: In alternativa, può inserire le informazioni in Catalog, sovrascrivendo le informazioni memorizzate e trasmesse da SFCC.

Scopra di più sulle informazioni prodotto per piattaforma.