Trasformi il Suo negozio SFCC per il commercio globale con Zonos Checkout.
Zonos Checkout si integra direttamente nel Suo storefront Salesforce Commerce Cloud (SFCC), consentendo transazioni internazionali fluide con calcoli Landed Cost integrati, opzioni di pagamento localizzate e gestione automatizzata degli ordini tra Zonos e SFCC Business Manager.
Per i Suoi clienti: Checkout localizzato nella loro lingua e valuta con calcoli Landed Cost anticipati, protezione antifrode e nessuna commissione a sorpresa alla consegna.
Per il Suo team: Calcoli internazionali fluidi, gestione degli ordini in SFCC Business Manager con sincronizzazione automatica degli ordini e elaborazione sicura dei pagamenti gestita interamente da Zonos.
Se non si è ancora registrato a Zonos, completi il nostro modulo di contatto commerciale per iniziare. Un referente dedicato all'onboarding La contatterà entro 24 ore per guidarLa nel processo di integrazione una volta che il Suo accordo account sarà in vigore.
Integri Checkout nel Suo negozio Salesforce Commerce Cloud seguendo questi passaggi:
1
Creare l'archivio metadata
Prima di installare la cartridge, si assicuri di avere una sandbox funzionante con un sito basato su SFRA installato. Quindi crei un archivio metadata per l'importazione del sito:
Nella cartridge Zonos LINK estratta, rinomini la cartella /link_zonos/metadata/sites/RefArch con l'ID del Suo sito SFCC. Ad esempio, se l'ID del Suo sito è "GlobalEcom", rinomini in modo da avere /link_zonos/metadata/sites/GlobalEcom nella struttura delle cartelle.
Crei un archivio Zip della cartella /link_zonos/metadata e denomini l'archivio zip metadata.zip. Nota: Includa la cartella /metadata stessa nell'archivio zip.
2
Importare l'archivio metadata
Una volta preparato metadata.zip, lo importi nella Sua sandbox SFCC:
Vada a Business Manager > Administration > Site Development > Site Import & Export.
Carichi metadata.zip utilizzando l'opzione di caricamento Local.
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.
3
Aggiungere la cartridge al cartridge path
Aggiunga la cartridge int_zonos al cartridge path del Suo sito per attivare i controller, gli script e i template:
Vada a Administration > Sites > Manage Sites > [Your Target Site] > Settings.
Inserisca int_zonos nel cartridge path prima della cartridge storefront SFRA di base (app_storefront_base).
4
Configurare gli alias pipeline
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.
5
Configurare i servizi SFCC
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:
Crei una nuova credenziale con il nome create.order.api.[siteID].
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).
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.
6
Configurare le preferenze del sito personalizzate 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:
Preference Name↕
Description↕
Zonos Enabled
Interruttore di funzionalità utilizzato per abilitare/disabilitare l'integrazione Zonos sullo storefront. Se non impostato, viene utilizzato il valore predefinito (No).
Main Zonos Script
(Obbligatorio) URL dello script lato client (browser) per l'integrazione Zonos. Fornito da Zonos. Se non impostato, viene utilizzato il valore predefinito (https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/loadZonos.js).
Blur OnInit Script
(Facoltativo) URL dello script lato client (browser) per sfocare i valori iniziali dei prezzi quando la conversione automatica della valuta è attivata. Fornito da Zonos.
Public API Token
(Obbligatorio) Token di integrazione pubblico. Questo valore si trova nel Suo Zonos Dashboard (Settings > Integrations > API Keys: Public Credential).
Private API Token
(Obbligatorio) Token di integrazione privato. Questo valore si trova nel Suo Zonos Dashboard (Settings > Integrations > API Keys: Zonos API).
Zonos Store ID
(Obbligatorio) Store ID fornito da Zonos. Questo valore si trova nel Suo Zonos Dashboard (Settings > Integrations > App credentials: Store ID).
Currency Element Selector
(Facoltativo) Stringa selettore in stile jQuery (senza virgolette) per i valori di prezzo a cui Zonos dovrebbe applicare la conversione della valuta.
Place Order (Checkout) Button Selector
(Facoltativo) Stringa selettore in stile jQuery (senza virgolette) per i pulsanti che dovrebbero avviare il checkout modale Zonos.
Zonos Payment Method ID
ID metodo di pagamento SFCC utilizzato durante la creazione dell'ordine Zonos all'interno di SFCC. Nell'importazione dei dati è incluso un nuovo Payment Method e Payment Processor, entrambi con id ZONOS. Questo nuovo id metodo di pagamento è anche il valore predefinito per questa preferenza del sito personalizzata. Se preferisce associare un metodo di pagamento diverso agli ordini Zonos, il valore qui può essere modificato con l'ID di qualsiasi Payment Method valido configurato in Business Manager.
Zonos Ship Method Mapping
Mapping JSON degli ID metodo di spedizione dalla risposta dettagli ordine Zonos agli ID metodo di spedizione SFCC durante l'inserimento degli ordini Zonos in SFCC. Imposti un mapping predefinito in modo che, se non mappato esplicitamente, i metodi di spedizione Zonos non mappati vengano associati a un metodo di spedizione SFCC predefinito. Veda la sezione "Configurare i metodi di spedizione" di seguito per una spiegazione più dettagliata.
Place Order Password
(Obbligatorio) Questo valore viene utilizzato da SFCC per garantire che le richieste API di creazione ordine provengano da una fonte attendibile e interna (ad es. job SFCC). Questo valore può essere qualsiasi stringa di caratteri (lettere maiuscole/minuscole, numeri e caratteri speciali standard). Esempio: X$7eo$33B!z=
SFCC Storefront Password
Password storefront per il sito SFCC (se protetto).
Place Order Service Name
(Obbligatorio) Il nome del servizio API create order configurato nel passaggio 5. Nota: Questo nome deve corrispondere esattamente al nome del servizio.
Origin Shipping Address
Indirizzo di origine per il magazzino di spedizione, inviato a Zonos, formato JSON. Esempio: {"administrativeArea": "Pennsylvania", "administrativeAreaCode": "PA", "countryCode": "US", "line1": "975 S Tech Ridge Dr", "line2": "", "locality": "Harrisburg", "postalCode": "17025"}
Zonos Default HS Code
(Obbligatorio) Codice HS predefinito Zonos utilizzato se il valore del prodotto è null. Se vuoto, viene utilizzato il valore predefinito (6109.10).
7
Configurare i metodi di spedizione
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:
Configuri uno o più metodi di spedizione in SFCC a cui i Suoi metodi di spedizione in Zonos dovrebbero essere mappati.
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.
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:
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.
8
Configurare i job
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:
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.
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.
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:
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
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
9
Configurare Zonos Hello
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:
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:
Zonos Hello converte automaticamente i valori di prezzo visualizzati sullo storefront nella valuta locale dell'acquirente. Affinché funzioni correttamente:
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>
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:
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.
11
Configurare il pulsante checkout
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.
12
Comprendere la conferma ordine e gli oggetti personalizzati
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:
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à:
Interroga Zonos per i dettagli dell'ordine.
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.
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.
13
Regolare le impostazioni avanzate
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.
14
Testare la Sua integrazione
Ora che ha configurato il Suo account e la Sua app, è pronto a testare la Sua integrazione. Dovrà abilitare Checkout e Hello in SFCC durante i test. Per farlo:
Vada a Merchant Tools > Site Preferences > Custom Preferences > zonos.
Imposti Zonos Enabled su Yes.
Una volta configurate le informazioni del Suo account Zonos nelle preferenze del sito personalizzate del Suo sito e l'interruttore di funzionalità Zonos Enabled impostato su YES, può testare le funzionalità Zonos sul Suo storefront aggiungendo il seguente parametro all'URL del Suo sito: zCountry=[country code of a country you have enabled in your Zonos Dashboard]
Ad esempio, se ha abilitato il Canada: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA
Nota: Questo è necessario solo per i test in ambienti non di produzione, dove il Suo Zonos Public API Token è configurato con un token credenziale di test. Quando configurato con il Suo token API live/produzione, il parametro URL zCountry non è necessario o previsto.
Se non è ancora pronto per andare live, ricordi di reimpostare Zonos Enabled su No una volta terminati i test. Dopo aver completato i test, abiliti Zonos utilizzando gli stessi passaggi sopra.
Ha bisogno di aiuto?
Se ha domande, contatti il nostro team di supporto. Se sta attualmente lavorando con un Project Manager Professional Services per l'onboarding del Suo account, La preghiamo di contattarlo per assistenza.
I numeri di tracking aggiunti in SFCC si sincronizzano automaticamente con Zonos. Tuttavia, i numeri di tracking aggiunti in Zonos Dashboard non si sincronizzano con SFCC. Se aggiunge o aggiorna numeri di tracking in Zonos Dashboard, dovrà aggiornarli manualmente anche in SFCC Business Manager.
Scopra di più su quali integrazioni supportano la sincronizzazione dei numeri di tracking.
La disinstallazione della cartridge deve essere eseguita da uno sviluppatore SFCC esperto. Contatti il Suo team di sviluppo SFCC o il supporto Zonos per assistenza con la disinstallazione.
Quali informazioni sul prodotto dovrei fornire per il preventivo più accurato su dazi, imposte e costi di spedizione?
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.
Salesforce Commerce Cloud
Checkout per Salesforce Commerce Cloud
Trasformi il Suo negozio SFCC per il commercio globale con Zonos Checkout.
Zonos Checkout si integra direttamente nel Suo storefront Salesforce Commerce Cloud (SFCC), consentendo transazioni internazionali fluide con calcoli Landed Cost integrati, opzioni di pagamento localizzate e gestione automatizzata degli ordini tra Zonos e SFCC Business Manager.
Per i Suoi clienti: Checkout localizzato nella loro lingua e valuta con calcoli Landed Cost anticipati, protezione antifrode e nessuna commissione a sorpresa alla consegna.
Per il Suo team: Calcoli internazionali fluidi, gestione degli ordini in SFCC Business Manager con sincronizzazione automatica degli ordini e elaborazione sicura dei pagamenti gestita interamente da Zonos.
Come integrare
Se non si è ancora registrato a Zonos, completi il nostro modulo di contatto commerciale per iniziare. Un referente dedicato all'onboarding La contatterà entro 24 ore per guidarLa nel processo di integrazione una volta che il Suo accordo account sarà in vigore.
Integri Checkout nel Suo negozio Salesforce Commerce Cloud seguendo questi passaggi:
Creare l'archivio metadata
Prima di installare la cartridge, si assicuri di avere una sandbox funzionante con un sito basato su SFRA installato. Quindi crei un archivio metadata per l'importazione del sito:
/link_zonos/metadata/sites/RefArchcon l'ID del Suo sito SFCC. Ad esempio, se l'ID del Suo sito è "GlobalEcom", rinomini in modo da avere/link_zonos/metadata/sites/GlobalEcomnella struttura delle cartelle./link_zonos/metadatae denomini l'archivio zipmetadata.zip. Nota: Includa la cartella/metadatastessa nell'archivio zip.Importare l'archivio metadata
Una volta preparato
metadata.zip, lo importi nella Sua sandbox SFCC:metadata.ziputilizzando l'opzione di caricamento Local.Questo passaggio crea le preferenze del sito, i servizi, le credenziali e gli oggetti personalizzati richiesti dall'integrazione Zonos.
Aggiungere la cartridge al cartridge path
Aggiunga la cartridge
int_zonosal cartridge path del Suo sito per attivare i controller, gli script e i template:int_zonosnel cartridge path prima della cartridge storefront SFRA di base (app_storefront_base).Configurare gli alias pipeline
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 utilizzarezonos-placesfccorderper 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.
Configurare i servizi SFCC
Con l'importazione del sito nel passaggio 2, sono stati creati due servizi SFCC (con profili e credenziali associati):
zonos.api.graphqlecreate.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:
create.order.api.[siteID].https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder(ad esempio:https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).create.order.api.[siteID]e gli assegni il profilocreate.order.apie la credenzialecreate.order.api.[siteID]creata nel passaggio 1.Una volta completato, dovrebbe avere un servizio create order API per ciascuno dei Suoi siti.
Configurare le preferenze del sito personalizzate 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:
https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/loadZonos.js).ZONOS. Questo nuovo id metodo di pagamento è anche il valore predefinito per questa preferenza del sito personalizzata. Se preferisce associare un metodo di pagamento diverso agli ordini Zonos, il valore qui può essere modificato con l'ID di qualsiasi Payment Method valido configurato in Business Manager.X$7eo$33B!z={"administrativeArea": "Pennsylvania", "administrativeAreaCode": "PA", "countryCode": "US", "line1": "975 S Tech Ridge Dr", "line2": "", "locality": "Harrisburg", "postalCode": "17025"}6109.10).Configurare i metodi di spedizione
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:
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
defaultche 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" }Configurare i job
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
CreateOrdersFromZonosnon 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: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
CreateMissingZonosOrdersche dovrebbe impostare:LookBackHourssu2(ore). Valore predefinito (se non viene impostato alcun valore):220Configurare Zonos Hello
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.ismlSe 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.
Configurare la conversione della valuta
Zonos Hello converte automaticamente i valori di prezzo visualizzati sullo storefront nella valuta locale dell'acquirente. Affinché funzioni correttamente:
<p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>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-priceezonos-priceassegnati 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.ismlSe non ci sono cartridge contenenti questi template e configurate con priorità più alta di
int_zonosnel 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 diint_zonosnel 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.
Scopra di più sulla conversione valuta di Zonos Hello.
Configurare il pulsante checkout
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.
Comprendere la conferma ordine e gli oggetti personalizzati
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.ismlapp_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.ismlint_zonos\cartridge\templates\default\checkout\billing\billingSummary.ismlapp_storefront_base\cartridge\templates\default\checkout\orderProductSummary.ismlapp_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.ismlLa 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 jobCreateOrdersFromZonos. Questo job itererà attraverso tutti gli oggetti personalizzati di tipozonosOrdersconcreatedStatus = - None -. Il job eseguirà alcune attività:Se i passaggi sopra hanno successo, l'attributo oggetto personalizzato
createdStatusverrà impostato sucreatedper rimuovere l'oggetto da future considerazioni. Se i passaggi sopra non hanno successo, l'attributo oggetto personalizzatocreatedStatusverrà impostato sufailede un messaggio di errore verrà annotato all'interno dell'oggetto nell'attributoerrorResponse(Zonos) osfccErrorResponse(SFCC) a seconda del sistema che risponde con l'errore durante il processo.Se deve riprovare a inserire l'ordine, reimposti semplicemente
createdStatussu- None -e verrà preso in considerazione nella prossima esecuzione del job.Regolare le impostazioni avanzate
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.
Testare la Sua integrazione
Ora che ha configurato il Suo account e la Sua app, è pronto a testare la Sua integrazione. Dovrà abilitare Checkout e Hello in SFCC durante i test. Per farlo:
Una volta configurate le informazioni del Suo account Zonos nelle preferenze del sito personalizzate del Suo sito e l'interruttore di funzionalità Zonos Enabled impostato su YES, può testare le funzionalità Zonos sul Suo storefront aggiungendo il seguente parametro all'URL del Suo sito:
zCountry=[country code of a country you have enabled in your Zonos Dashboard]Ad esempio, se ha abilitato il Canada:
https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CASe non è ancora pronto per andare live, ricordi di reimpostare Zonos Enabled su No una volta terminati i test. Dopo aver completato i test, abiliti Zonos utilizzando gli stessi passaggi sopra.
Se ha domande, contatti il nostro team di supporto. Se sta attualmente lavorando con un Project Manager Professional Services per l'onboarding del Suo account, La preghiamo di contattarlo per assistenza.
Sincronizzazione numeri di tracking
I numeri di tracking aggiunti in SFCC si sincronizzano automaticamente con Zonos. Tuttavia, i numeri di tracking aggiunti in Zonos Dashboard non si sincronizzano con SFCC. Se aggiunge o aggiorna numeri di tracking in Zonos Dashboard, dovrà aggiornarli manualmente anche in SFCC Business Manager.
Scopra di più su quali integrazioni supportano la sincronizzazione dei numeri di tracking.
Disinstallare Checkout
La disinstallazione della cartridge deve essere eseguita da uno sviluppatore SFCC esperto. Contatti il Suo team di sviluppo SFCC o il supporto Zonos per assistenza con la disinstallazione.
Domande frequenti
Quali informazioni sul prodotto dovrei fornire per il preventivo più accurato su dazi, imposte e costi di spedizione?
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:
Scopra di più sulle informazioni prodotto per piattaforma.
Questa pagina è stata utile?