Salesforce Commerce Cloud için Checkout

metadata.zip hazırlandıktan sonra, SFCC sanal ortamınıza aktarın:

1. Business Manager > Administration > Site Development > Site Import & Export öğesine gidin.
2. Local yükleme seçeneğini kullanarak metadata.zip yükleyin.
3. Yüklemeden sonra, arşivi listede bulun ve Import öğesine tıklayın.

Bu adım, Zonos entegrasyonu tarafından kullanılan gerekli site tercihlerini, hizmetleri, kimlik bilgilerini ve özel nesneleri oluşturur.

int_zonos kartuşunu sitenizin kartuş yoluna ekleyerek denetleyicileri, komut dosyalarını ve şablonlarını etkinleştirin:

1. Administration > Sites > Manage Sites > [Your Target Site] > Settings öğesine gidin.
2. int_zonos öğesini temel SFRA vitrini kartuşundan (app_storefront_base) önce kartuş yoluna ekleyin.

Kartuşta bulunan 2 özel İşlem Hattının Business Manager'da eklenen işlem hattı takma adları olmalıdır:

Zonos-OrderConfirmation

Bu, Zonos kasasında sipariş tamamlandıktan sonra SFCC içinde özel sipariş onayı için kullanılır. Kullanıcı buraya yönlendirilir. Örneğin, takma ad zonos-order-confirmation olabilir. Lütfen yerel SFCC/SFRA kasa işlemi sipariş onayı sayfası (COSummary-Submit) için kullandığınız takma addan farklı olan, işiniz için uygun bir takma ad seçin ve ekleyin.

Zonos-PlaceSFCCOrder

Bu, SFCC/SFRA içinde Zonos siparişini oluşturmak için kullanılan özel uç nokta için kullanılır ve takma adın zonos-placesfccorder olduğu varsayılır. Burada farklı bir takma ad kullanırsanız, hizmet kurulumuna geldiğinizde bunu not etmeniz gerekecektir. Bu herkese açık bir URL olmadığından, ilk kurulum için bu kartuşu kullanmanın kolaylığını korumak üzere zonos-placesfccorder kullanılması önerilir.

Bu iki Takma Adı yapılandırmak için Business Manager'da Merchant Tools > URL Rules > Pipeline URLs öğesine gidin.

2. adımdaki site içe aktarma işlemiyle birlikte iki SFCC hizmeti (beraberinde gelen profiller ve kimlik bilgileri) oluşturulmuştur: zonos.api.graphql ve create.order.api.sfra.

Tek site kurulumu

Kuruluşunuzun SFCC kuruluşunuzda yalnızca bir vitrin sitesi varsa, burada yapılacak ek bir işlem yoktur ve bir sonraki adıma devam edebilirsiniz.

Çoklu site kurulumu

Kuruluşunuzun SFCC kuruluşunuzda birden fazla vitrin sitesi varsa veya birden fazla vitrin sitesine sahip olmayı planlıyorsanız, SFCC hizmetlerinizde güncellemeler/eklemeler yapmanız gerekecektir. Zonos entegrasyonunu kullanacak birden fazla SFCC siteniz olduğunda, her site için bir oluşturma siparişi API hizmeti gerekecektir. Her site için aşağıdakileri yapın:

1. create.order.api.[siteID] adında yeni bir kimlik bilgisi oluşturun.
2. Kimlik bilgisi URL'sini şu şekilde atayın: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (örneğin: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. create.order.api.[siteID] adında yeni bir hizmet oluşturun ve bunu create.order.api profiline ve 1. adımda oluşturduğunuz create.order.api.[siteID] kimlik bilgisine atayın.

Tamamlandıktan sonra, sitelerinizin her biri için bir oluşturma siparişi API hizmeti olmalıdır.

Not: Orijinal create.order.api.sfra hizmetini sitelerinizden birine ait siparişi oluşturan hizmet olarak yeniden adlandırmadıysanız ve halen mevcutsa, silebilirsiniz. zonos.api.graphql hizmet adını olduğu gibi bırakın. Birden fazla site olsa bile, yalnızca tek bir Zonos API hizmetine ihtiyacınız vardır.

Business Manager'da Merchant Tools > Site Preferences > Custom Preferences öğesine gidin, ardından Zonos özel site tercihlerine erişmek için zonos tercih grubu öğesine tıklayın.

Siteniz için aşağıdaki site tercihlerini ayarlayın:

Zonos Modal Checkout sırasında, alışveriş yapanlar Zonos Dashboard'da tanımlanan sevkiyat yöntemlerini seçerler. Bu siparişler SFCC'ye aktarıldığında, sevkiyat yöntemleri geçerli bir SFCC sevkiyat yöntemine karşılık gelmelidir. Bunu desteklemek için:

1. Zonos'taki sevkiyat yöntemlerinizin eşlenmesi gereken bir veya daha fazla sevkiyat yöntemini SFCC'de ayarlayın.
2. Yukarıda açıklanan Zonos Ship Method Mapping özel site tercihinde bulunan, Zonos sevkiyat yöntemleriniz ile SFCC sevkiyat yöntemleriniz arasında bir veya daha fazla sevkiyat yöntemi eşlemesi kurun.

Sevkiyat Yöntemi Eşlemesi

JSON nesnesi biçiminde, sevkiyat yöntemi eşlemesi Zonos sevkiyat yöntemlerinizi SFCC sevkiyat yöntemlerinize eşler. Bu eşleme, Zonos kasasında seçilebilecek her olası Zonos sevkiyat yöntemine (hizmet seviyesi) ilişkin bir eşleme kaydı içermesi gerekir. Ayrıca, bir Zonos sevkiyat yönteminin SFCC sevkiyat yöntemine bir eşlemesi olmayan durumlarda kullanılacak bir default eşleme kaydı eklemeniz önerilir çünkü bu, SFCC siparişinde sevkiyat yönteminin eksikliğine neden olan aşağı akış başarısızlıklarını önler.

JSON nesnesi için format:

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

Örnek

Zonos Dashboard'da aşağıdaki hizmet düzeylerini etkinleştirdiğinizi varsayalım:

Nedenleriniz ne olursa olsun (ör. ofis gereksinimleri, ek bir üçüncü taraf sevkiyat hizmetinin entegrasyonu, vb.), siteniz için SFCC'de aşağıdaki sevkiyat yöntemleriyle sınırlı olabilirsiniz:

Yeni bir Zonos siparişi alındığında ve ardından SFCC'ye yerleştirildiğinde, sevkiyat yöntemi bu listeden olmalıdır.

Eşlemenizi oluşturmak için Zonos Dashboard'da oturum açın, Shipping > Manage Rates öğesine gidin ve aşağıdakine benzer bir görüntü göreceğiniz görüntülenen Etkin hizmet düzeylerinin her birine tıklayın:

Her birinde, Zonos sevkiyat hizmet düzeyi kodunu almak (veya ayarlamak) için Edit details öğesine tıklayın (aşağıya bakın).

Sevkiyat hizmet düzeyi kodu ile, o sevkiyat hizmet düzeyi (Zonos sevkiyat yöntemi) Zonos kasasında seçildiğinde SFCC siparişlerinde görünmesini istediğiniz SFCC sevkiyat yöntemine eşleyen bir eşleme kaydı oluşturun.

Etkin olan her sevkiyat hizmet düzeyi kodu için, ayrıca bir default sevkiyat yöntemi eşlemesi için bir kayıt ekledikten sonra, Zonos Ship Method Mapping JSON nesneniz buna benzer görünmelidir:

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

Not: Bu yalnızca Zonos sevkiyat yöntemlerinin SFCC sevkiyat yöntemlerine eşlemesi olduğundan, eşlemede tüm Zonos sevkiyat yöntemlerine sahip olmak önemlidir. Eşlemede SFCC sevkiyat yöntemlerinizin her birinin olması gerekmez.

Yüklemeye dahil edilen iki SFCC işi Zonos entegrasyonunu desteklemek için vardır:

CreateOrdersFromZonos

Bu iş, zonosOrders özel nesne mağazasında yeni oluşturulan Zonos sipariş referanslarını arar, Zonos'tan tam sipariş ayrıntılarını alır ve SFCC'de karşılık gelen siparişleri oluşturur.

Zamanlama: Bu işi işletme gereksinimlerinize uyacak şekilde zamanlayabilirsiniz, ancak tipik olarak bu iş aralık temelinde, nispeten sık (yani her 5-10 dakika) ve haftanın her günü çalışacak şekilde yapılandırılmalıdır.

Özel Parametreler: CreateOrdersFromZonos işi özel parametreler içermez.

CreateMissingZonosOrders

Nadir olsa da, öngörülemeyen durumlara bağlı olarak, Zonos'ta yerleştirilen siparişlerin normal süreç aracılığıyla SFCC örneğinize girmemesi mümkündür. Bu nedenle CreateMissingZonosOrders işini dahil ettik. Bu iş, eksik siparişleri belirlemek ve içe aktarmak için Zonos sipariş geçmişiniz ile SFCC arasında bir çapraz kontrol gerçekleştirir.

Zamanlama: Bu işi işletme gereksinimlerinize uyacak şekilde zamanlayabilirsiniz, ancak bu işi CreateOrdersFromZonos işinden daha az sıklıkta çalışacak şekilde zamanlamalısınız. Bu işin çalışma sıklığını zamanlarken göz önünde bulundurulması gereken bazı şeyler:

1. Tüm işlerde olduğu gibi, işlem yükü/bant genişliği ve işletme gereksinimleriniz de dahil olmak üzere tüm unsurlar göz önünde bulundurulduktan sonra, bu işi mümkün olduğunca seyrek çalışacak şekilde zamanlamalısınız.
2. Bu iş tüm siparişleri bir zaman dönemine sorguladığından, yüksek hacimli siteler bu işi daha sık çalıştırmalıdır (böylece iş çalışması başına daha az sipariş işlenir); daha düşük hacimli siteler daha az sıklıkta çalışabilir.
3. CreateMissingZonosOrders için önerilen bazal sıklığımız, çoğu site için uygun olacağını düşündüğümüz, her 90 dakikada bir çalışmaktır.

Özel Parametreler: CreateMissingZonosOrders işi adımı ile ilişkilendirilmiş iki özel parametre vardır:

1. LookBackHours: Bu, işin çalıştığı zamandan ne kadar süre geriye gitmek için Zonos'u sorguladığı saat sayısıdır. İş için planlanan frekansınıza bağlı olarak, bu değer en azından iş çalışmaları arasındaki saate eşit olmalı ve ideal olarak bir örtüşme olmalıdır. Örneğin, iş her 90 dakikada bir çalışacak şekilde zamanlanmışsa, LookBackHours öğesini 2 (saat) olarak ayarlayın. Varsayılan değer (değer ayarlanmadıysa): 2
2. OrderSize: Zonos'un iç sorgusu başına alınacak maksimum sipariş sayısı. Bunu, işin Zonos'u sorgularken kullandığı sayfa boyutu olarak düşünün. Varsayılan değer (değer ayarlanmadıysa): 20

Zonos Hello, dinamik dil seçimi, vergi/gümrük mesajlaşması ve satır içi para birimi dönüştürmesi gibi istemci tarafı yerelleştirme özellikleri sağlar. Zonos site tercihlerinde etkinleştirildikten sonra, Hello Zonos istemci komut dosyası aracılığıyla mağazanızda otomatik olarak yüklenir.

Zonos istemci komut dosyaları, aşağıdaki yer paylaşımı şablonlarının alt kısmında bulunan Zonos-ClientScriptInclude uç noktasının SFCC uzak dahil etmesi kullanılarak eklenir:

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

Projeniz bu şablonları daha yüksek öncelikli kartuşlarda geçersiz kılıyorsa, özelleştirilmiş sürümlerinize uzak dahil etmeyi eklediğinizden emin olun:

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

Zonos Hello hakkında daha fazla bilgi edinin.

Zonos Hello otomatik olarak vitrin üzerinde görüntülenen fiyat değerlerini alışveriş yapanın yerel para birimine dönüştürür. Bunun doğru şekilde çalışması için:

1. Fiyat değerleri, jQuery aracılığıyla seçilebilen sınıf adları veya kimlikler kullanan HTML öğelerine sarılmalıdır. Örneğin: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Bu seçici değerler Para Birimi Elemanı Seçici site tercihine (veya Zonos Dashboard'da) dahil edilmelidir.

Fiyat görüntü kodu değişiklikleri

Zonos kartuşu, fiyatların tüm referans mimarisi sitesi boyunca işlendiği, zonos-list-price, zonos-sales-price ve zonos-price sınıf adlarını kullanan aşağıdaki yer paylaşımı şablonlarını içerir:

• /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

Kartuş yolunda int_zonos öğesinden daha yüksek yapılandırılmış bu şablonları içeren kartuş yoksa, Zonos Hello sitenizde bu fiyat işlemelerinin para birimlerini dönüştürmek için kod değişikliği gerekmez. Kartuş yolunda int_zonos öğesinden daha yüksek bir veya daha fazla kartuşta bu şablonların özelleştirilmiş sürümleriniz varsa, yukarıda gösterildiği gibi bu özelleştirilmiş şablonlarda fiyatlarınızın etrafındaki HTML sarmalayıcılarına benzersiz bir sınıf adı eklemeniz gerekecektir.

Fiyat elemanları seçici dizesi yapılandırması

Para birimi seçici dizesi, Zonos komut dosyası tarafından para birimi dönüştürme güncellemeleri alması gereken fiyat değerlerini içeren HTML öğelerini belirlemek için kullanılan jQuery stilinde seçici dizi değeridir. Bu değer, önceki adımda açıklanan sitenizin fiyat görüntülerine atanan CSS sınıf adlarının ve/veya kimliklerinin boşlukla ayrılmış bir listesi olmalıdır; sınıf adları . ön ekiyle ve kimlikler # ön ekiyle (tırnak işareti olmadan) yapılmalıdır. Örneğin, siteniz Zonos kartuşunda bulunan fiyat görüntüsü şablonlarını kullanacaksa, seçici dizesi .zonos-list-price .zonos-sales-price .zonos-price (tırnak işareti olmadan) olacaktır.

Para birimi seçici dizesi, Zonos Dashboard'da veya Business Manager'da Zonos özel site tercihlerinin Para Birimi Elemanı Seçici'nde yapılandırılabilir.

Not: Her iki yerde de yapılandırılmışsa, Business Manager'daki değer önceliklidir.

Zonos Hello para birimi dönüştürmesi hakkında daha fazla bilgi edinin.

Kasa düğmesi seçici dizesi, Zonos komut dosyası tarafından sitenizde kasa akışınıza tıklandığında müşteri alan düğme denetimleri olarak hizmet veren HTML öğelerini belirlemek için kullanılan jQuery seçici dizi değeridir.

Alışveriş yapanlar, yapılandırılmış seçici dizenizle eşleştirilmiş bir Kasa düğmesine tıklandığında, Zonos otomatik olarak eylemi ele alır ve modal kasayı açar.

Kasa düğmesi seçici dizesi, Zonos Dashboard'da veya Business Manager'da Zonos özel site tercihlerinin Sipariş Yerleştir (Checkout) Düğmesi Seçici'nde yapılandırılabilir.

Kullanıcı Zonos tarafından barındırılan kasada bir sipariş tamamladığında, SFCC içinde sipariş onayını gösteren özel bir İşlem Hattına (Zonos-OrderConfirmation) yönlendirilir. Bu sipariş onayının birincil işleme şablonu /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml öğesidir.

Bu sipariş onayı sayfası, yerel SFCC/SFRA sipariş onayı sayfasıyla aynı stillendirme kullanır ve yerel SFCC/SFRA sipariş onayı sayfasıyla bazı .isml dosyalarını paylaşır. Bu, sitede yapılmış herhangi bir özel stil güncellemesine uyacak şekilde bazı stil güncellemelerine ihtiyaç duyabilir. Zonos sipariş onayı şablonu tarafından kullanılan temel işleme şablonları şunları içerir:

• 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

Bu özel işlem hattıyla ilgili alttaki işlem, kullanıcıya sipariş onayı görüntülemek dışında, yüklemeye dahil edilen yeni bir özel nesne türü zonosOrders ile ilgilidir. Sipariş onayı kullanıcı için görüntülendiğinde, SFCC sipariş onayı için URL'de görüntülenen Zonos sipariş kimliğini kullanır ve bu özel nesne türünün özel nesne anahtarı özniteliği olarak Zonos Sipariş Kimliğiyle karşılık gelen özel nesneyi oluşturur. Bu daha sonra CreateOrdersFromZonos işi aracılığıyla SFCC içinde siparişi yerleştirmek için kullanılır. Bu iş createdStatus = - None - olan zonosOrders türündeki tüm özel nesneler üzerinden yineleme yapacaktır. İş birkaç görevi gerçekleştirir:

1. Sipariş ayrıntıları için Zonos'u sorgulayın.
2. Bu yanıtı, yanıt içindeki öğeler, sevkiyat, fatura ve müşteri için site tercihlerinde yapılandırılan sevkiyat yöntemi ve ödeme yöntemi + ayrıntılarına bağlı olarak SFCC içinde siparişi oluşturmak için kullanın.
3. SFCC sipariş numarasıyla Zonos'u güncelleyin ve bu mutasyonu Zonos Dashboard'da Zonos sipariş numarası ile ilişkilendirin.

Yukarıdaki adımlar başarılıysa, özel nesne özniteliği createdStatus created olarak ayarlanır ve nesne gelecekteki taramanın dışında kalır. Yukarıdaki adımlar başarısız olursa, özel nesne özniteliği createdStatus failed olarak ayarlanır ve bir hata mesajı nesnenin errorResponse (Zonos) veya sfccErrorResponse (SFCC) özniteliğine not edilir.

Siparişi yeniden yerleştirmeye çalışmanız gerekiyorsa, createdStatus öğesini - None - olarak yeniden ayarlayın ve bu bir sonraki iş çalışmasında dikkate alınacaktır.

İsteğe bağlı—Aşağıdakiler gelişmiş ayarlardır. Varsayılanlar yerinde olup, hiçbir işlem gerekmez. Ayarlamalar yapmak istiyorsanız, aşağıdaki yönergeleri izleyin:

İçe aktarma sırasında fatura oluştur

Varsayılan olarak Yes olarak ayarlanmıştır. Zonos fatura içe aktarıldığında oluşturacaktır. Bu özelliği devre dışı bırakmayı seçerseniz, kendi faturanızı oluşturmanız gerekecek ve Zonos bir dolandırıcılık inceleme tutması uygulayarak durumu zonos_hold olarak ayarlayacaktır. Dolandırıcılık incelemesi kaldırıldıktan sonra, önceki duruma geri döneceğiz.

Müşteri girişi

Varsayılan olarak No olarak ayarlanmıştır. Kasa için bir hesap gerekli kılmak istiyorsanız, Yes öğesine geçin. Ayrıca Customer configuration > Login options öğesine gitmeniz ve Redirect Customer to Account Dashboard after Logging In öğesini No olarak güncellemeniz gerekecektir.

SFCC sipariş dışa aktarma

SFCC Sipariş Dışa Aktarma'yı kullanıyorsanız veya kullanmayı planlıyorsanız, SFCC sipariş dışa aktarma dosyalarına Zonos özel özniteliklerinin Sipariş ve Ürün nesnelerine atanması gerektiğinden emin olun. Merchant Tools > Site Preferences > Orders öğesinden, sipariş dışa aktarma şema sürümünü en son sürüme ayarlayın.

Hesabınızı ve uygulamanızı ayarladıktan sonra, entegrasyonunuzu test etmeye hazırsınız. Test sırasında SFCC'de Checkout ve Hello'yu etkinleştirmeniz gerekecektir. Bunu yapmak için:

1. Merchant Tools > Site Preferences > Custom Preferences > zonos öğesine gidin.
2. Zonos Etkin öğesini Yes öğesine değiştirin.

Zonos hesap bilgilerinizi sitenizin özel site tercihlerine yapılandırdıktan ve Zonos Etkin özelliği YES olarak ayarlandıktan sonra, sitenizin URL'sine aşağıdaki parametreyi ekleyerek mağazanızda Zonos özelliklerini test edebilirsiniz: zCountry=[Zonos Dashboard'da etkinleştirmiş olduğunuz bir ülkenin ülke kodu]

Örneğin, Kanada'yı etkinleştirdiyseniz: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Not: Bu yalnızca Zonos Genel API Jetonu bir test kimlik bilgisi jetonu ile yapılandırıldığı üretim dışı ortamlarda test için gereklidir. Canlı/üretim API jetoni ile yapılandırıldığında, zCountry URL parametresi gerekli değildir veya beklenmez.

Henüz canlı olmaya hazır değilseniz, test tamamlandıktan sonra Zonos Etkin öğesini No olarak geri çevirmeyi unutmayın. Test tamamlandıktan sonra, yukarıdaki aynı adımları kullanarak Zonos'u etkinleştirin.

Ürün bilgileri vergi ve gümrük tutarını ve sevkiyat maliyetini etkileyebilir. Zonos'a sağladığınız ürün bilgileri ne kadar fazlaysa, döndürülen teklif o kadar kesin olacaktır. Zonos, bu bilgiler mevcut olmasa bile bir teklif oluşturabilir, ancak doğruluğu artırmak için aşağıdaki önemli ürün detaylarını sağlamanızı önerir:

• Ağırlık: Ağırlık, sevkiyat maliyetini ve bu da vergileri veya gümrüğü etkileyebilir. SFCC ürün listelerinizde ağırlıklar mevcut olduğunda Zonos tarafından otomatik olarak kullanılır.
• Boyutlar: Boyutlar sevkiyat maliyetini etkileyebilir ve bu da vergileri veya gümrüğü etkileyebilir. Zonos, SFCC'de her ürüne ayarlanan ürün boyutlarını (uzunluk, genişlik ve yükseklik) kullanabilir, ancak bunu Zonos özel site tercihlerinde eşlemeniz gerekir.
• HS kodları: HS kodları vergi oranlarını etkiler ve bazen vergileri etkileyebilir. Zonos, SFCC ürün listelerinizde ayarlanan HS kodlarını kullanabilir, ancak bunu Zonos özel site tercihlerinde HS kod alanını eşlemeniz gerekir.
• Menşei ülke: Bir ürünün menşei ülkesi vergi oranlarını etkiler ve vergileri etkileyebilir. SFCC ürün listelerinizde ayarlanan menşei ülke, mevcut olduğunda Zonos tarafından otomatik olarak kullanılır.

Not: Alternatif olarak, depolanmış bilgileri geçersiz kılmak için bilgileri Katalog'a girebilirsiniz.

Platform tarafından ürün bilgileri hakkında daha fazla bilgi edinin.