Checkout untuk Salesforce Commerce Cloud

Setelah metadata.zip disiapkan, impor ke dalam sandbox SFCC Anda:

1. Buka Business Manager > Administration > Site Development > Site Import & Export.
2. Unggah metadata.zip menggunakan opsi upload Local.
3. Setelah mengunggah, temukan arsip dalam daftar dan klik Import.

Langkah ini membuat preferensi situs yang diperlukan, layanan, kredensial, dan objek khusus yang digunakan oleh integrasi Zonos.

Tambahkan cartridge int_zonos ke jalur cartridge situs Anda untuk mengaktifkan kontroler, skrip, dan templat-nya:

1. Arahkan ke Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Sisipkan int_zonos ke dalam jalur cartridge sebelum cartridge storefront SFRA dasar (app_storefront_base).

Ada 2 Pipeline khusus yang disertakan dengan cartridge yang harus memiliki alias pipeline yang ditambahkan dalam Business Manager:

Zonos-OrderConfirmation

Ini digunakan untuk konfirmasi pesanan khusus dalam SFCC setelah pesanan selesai dalam checkout Zonos. Pengguna akan dialihkan ke sini. Misalnya, alias bisa berupa zonos-order-confirmation. Silakan pilih dan tambahkan alias yang sesuai untuk bisnis Anda yang berbeda dari alias yang Anda gunakan untuk halaman konfirmasi pesanan checkout SFCC/SFRA asli (COSummary-Submit).

Zonos-PlaceSFCCOrder

Ini digunakan untuk titik akhir khusus yang digunakan untuk membuat pesanan Zonos dalam SFCC/SFRA dan diasumsikan bahwa aliasnya adalah zonos-placesfccorder. Jika Anda menggunakan alias yang berbeda di sini, Anda akan perlu mencatat ini ketika Anda mencapai konfigurasi layanan. Ini bukan url yang menghadap publik, jadi menggunakan zonos-placesfccorder direkomendasikan untuk pengaturan awal untuk mempertahankan kemudahan penggunaan cartridge ini.

Untuk mengonfigurasi dua Alias ini, di Business Manager, arahkan ke Merchant Tools > URL Rules > Pipeline URLs.

Dengan impor situs di langkah 2, dua layanan SFCC (dengan profil dan kredensial yang menyertainya) dibuat: zonos.api.graphql dan create.order.api.sfra.

Pengaturan situs tunggal

Jika organisasi Anda memiliki situs storefront tunggal dalam organisasi SFCC Anda, tidak ada yang perlu dilakukan di sini, dan Anda dapat melanjutkan ke langkah berikutnya.

Pengaturan beberapa situs

Jika organisasi Anda memiliki beberapa situs storefront, atau berencana memiliki beberapa situs storefront, dalam organisasi SFCC Anda, Anda perlu membuat pembaruan/penambahan ke layanan SFCC Anda. Ketika Anda memiliki beberapa situs SFCC yang akan menggunakan integrasi Zonos, Anda akan memerlukan layanan API buat pesanan untuk setiap situs. Untuk setiap situs, lakukan hal berikut:

1. Buat kredensial baru dengan nama create.order.api.[siteID].
2. Tetapkan URL kredensial menjadi: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (misalnya: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Buat layanan baru dengan nama create.order.api.[siteID] dan tetapkan ke profil create.order.api, dan kredensial create.order.api.[siteID] yang Anda buat di langkah 1.

Setelah selesai, Anda harus memiliki layanan API buat pesanan untuk setiap situs Anda.

Catatan: Jika Anda tidak mengganti nama layanan create.order.api.sfra asli untuk menjadi layanan pesanan buat untuk salah satu situs Anda, dan masih ada, Anda dapat menghapusnya. Biarkan nama layanan zonos.api.graphql tetap seperti apa adanya. Bahkan dengan beberapa situs, Anda hanya akan memerlukan layanan API Zonos tunggal.

Di Business Manager, arahkan ke Merchant Tools > Site Preferences > Custom Preferences, kemudian klik pada grup preferensi zonos untuk mengakses preferensi situs khusus Zonos.

Atur preferensi situs berikut untuk situs Anda:

Selama Checkout Modal Zonos, pembeli memilih metode pengiriman yang ditentukan di Dashboard Zonos Anda. Ketika pesanan ini diimpor ke SFCC, metode pengiriman mereka harus sesuai dengan metode pengiriman SFCC yang valid. Untuk mendukung ini:

1. Atur satu atau lebih metode pengiriman di SFCC yang metode pengiriman Zonos Anda harus dipetakan.
2. Dalam preferensi situs khusus Zonos Ship Method Mapping yang dijelaskan di atas, buat satu atau lebih pemetaan metode pengiriman antara metode pengiriman Zonos Anda dan metode pengiriman SFCC Anda.

Pemetaan Metode Pengiriman

Dalam bentuk objek JSON, pemetaan metode pengiriman memetakan metode pengiriman Zonos Anda ke metode pengiriman SFCC Anda. Pemetaan ini harus memiliki catatan pemetaan untuk setiap metode pengiriman Zonos potensial (tingkat layanan) yang dapat dipilih dalam checkout Zonos Anda. Sangat disarankan bahwa Anda juga menyertakan catatan pemetaan default yang akan digunakan dalam kasus di mana pesanan Zonos ditempatkan dengan metode pengiriman yang tidak memiliki pemetaan ke metode pengiriman SFCC, sehingga mencegah kegagalan hilir yang disebabkan oleh kurangnya metode pengiriman dalam pesanan SFCC.

Format untuk objek JSON adalah:

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

Contoh

Asumsikan Anda telah mengaktifkan tingkat layanan berikut di Dashboard Zonos Anda:

Untuk alasan apa pun (mis. persyaratan backoffice, integrasi layanan pengiriman pihak ketiga tambahan, dll.), Anda mungkin terbatas pada metode pengiriman berikut di SFCC untuk situs Anda:

Ketika pesanan Zonos baru diterima dan kemudian ditempatkan di SFCC, metode pengiriman harus berasal dari daftar ini.

Untuk membangun pemetaan Anda, masuk ke Dashboard Zonos Anda, buka Shipping > Manage Rates, dan kemudian klik ke setiap Tingkat layanan yang Diaktifkan, tempat Anda akan melihat tampilan serupa dengan yang berikut:

Di masing-masing, klik pada Edit details untuk mendapatkan (atau mengatur) kode tingkat layanan pengiriman Zonos (lihat di bawah).

Dengan kode tingkat layanan pengiriman, buat catatan pemetaan yang memetakannya ke metode pengiriman SFCC yang ingin Anda tampilkan di pesanan SFCC Anda ketika tingkat layanan pengiriman itu (metode pengiriman Zonos) dipilih dalam checkout Zonos.

Setelah Anda telah menambahkan catatan untuk setiap kode tingkat layanan pengiriman yang diaktifkan, serta pemetaan metode pengiriman default, objek JSON Zonos Ship Method Mapping Anda harus terlihat serupa dengan ini:

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

Catatan: Karena ini hanya merupakan pemetaan metode pengiriman Zonos ke metode pengiriman SFCC, penting hanya untuk memiliki semua metode pengiriman Zonos yang disertakan dalam pemetaan. Tidak perlu memiliki setiap metode pengiriman SFCC Anda yang disertakan dalam pemetaan.

Disertakan dalam instalasi adalah dua pekerjaan SFCC untuk mendukung integrasi Zonos:

CreateOrdersFromZonos

Pekerjaan ini mencari referensi pesanan Zonos yang baru dibuat dalam penyimpanan objek khusus zonosOrders, mengambil detail pesanan lengkap dari Zonos, dan membuat pesanan yang sesuai di SFCC.

Jadwal: Anda dapat menjadwalkan pekerjaan ini untuk mengakomodasi kebutuhan bisnis Anda, tetapi biasanya, pekerjaan ini harus dikonfigurasi untuk berjalan secara berkala, dengan cukup sering (mis. setiap 5-10 menit), dan setiap hari dalam seminggu.

Parameter Khusus: Pekerjaan CreateOrdersFromZonos tidak menyertakan parameter khusus apa pun.

CreateMissingZonosOrders

Meskipun jarang, dimungkinkan bahwa, karena keadaan yang tidak terduga, mungkin ada pesanan yang ditempatkan di Zonos yang tidak masuk ke dalam instansi SFCC Anda melalui proses normal. Untuk alasan ini, kami telah menyertakan pekerjaan CreateMissingZonosOrders. Pekerjaan ini melakukan pemeriksaan silang antara riwayat pesanan Zonos Anda dan SFCC untuk mengidentifikasi dan mengimpor pesanan yang hilang.

Jadwal: Anda dapat menjadwalkan pekerjaan ini untuk mengakomodasi kebutuhan bisnis Anda, tetapi Anda harus menjadwalkan pekerjaan ini untuk dijalankan lebih jarang daripada pekerjaan CreateOrdersFromZonos. Beberapa hal yang perlu dipertimbangkan saat menjadwalkan frekuensi pekerjaan ini untuk dijalankan:

1. Seperti halnya semua pekerjaan, setelah semua hal dipertimbangkan—termasuk beban pemrosesan/bandwidth dan kebutuhan bisnis Anda—Anda harus menjadwalkan pekerjaan ini untuk dijalankan sesedikit mungkin.
2. Karena pekerjaan ini akan menanyakan semua pesanan selama jangka waktu, situs volume tinggi harus menjalankan pekerjaan ini lebih sering (sehingga lebih sedikit pesanan diproses per run pekerjaan), sedangkan situs volume rendah dapat mengatasinya dengan frekuensi yang lebih rendah.
3. Frekuensi garis besar yang disarankan kami untuk CreateMissingZonosOrders, yang menurut kami akan berfungsi untuk sebagian besar situs, adalah sekali setiap 90 menit.

Parameter Khusus: Ada dua parameter khusus yang terkait dengan langkah pekerjaan CreateMissingZonosOrders yang harus Anda atur:

1. LookBackHours: Ini adalah jumlah jam (dari waktu pekerjaan berjalan) kembali dalam waktu yang harus ditanyakan pekerjaan untuk mencari pesanan yang hilang. Berdasarkan frekuensi terjadwal untuk pekerjaan, nilai ini harus setidaknya sama dengan waktu antara run pekerjaan, dan idealnya harus memiliki tumpang tindih. Misalnya, jika pekerjaan dijadwalkan untuk dijalankan setiap 90 menit, atur LookBackHours menjadi 2 (jam). Nilai default (jika tidak ada nilai yang ditetapkan): 2
2. OrderSize: Jumlah maksimal pesanan untuk diambil per kueri internal Zonos. Anggap ini sebagai ukuran halaman yang digunakan pekerjaan saat menanyakan Zonos untuk pesanan. Nilai default (jika tidak ada nilai yang ditetapkan): 20

Zonos Hello menyediakan kemampuan lokalisasi sisi klien seperti pemilihan bahasa dinamis, pesan tugas/pajak, dan konversi mata uang sebaris. Setelah Zonos diaktifkan dalam preferensi situs, Hello dimuat secara otomatis di storefront Anda melalui skrip klien Zonos.

Skrip klien Zonos ditambahkan menggunakan penyertaan jarak jauh SFCC dari titik akhir Zonos-ClientScriptInclude, yang terletak di bagian bawah template overlay berikut:

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

Jika proyek Anda menimpa template ini di cartridge dengan prioritas lebih tinggi, pastikan penyertaan jarak jauh ditambahkan ke versi yang dikustomisasi:

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

Pelajari lebih lanjut tentang Zonos Hello.

Zonos Hello secara otomatis mengonversi nilai harga yang ditampilkan di storefront ke mata uang lokal pembeli. Agar ini berfungsi dengan benar:

1. Nilai harga harus dibungkus dalam elemen HTML menggunakan nama kelas atau ID yang dapat dipilih melalui jQuery. Misalnya: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Nilai pemilih ini harus disertakan dalam preferensi situs Currency Element Selector (atau di Dashboard Zonos Anda).

Perubahan kode tampilan harga

Cartridge Zonos menyertakan template overlay berikut untuk tempat harga dirender di seluruh situs arsitektur referensi, menggunakan nama kelas zonos-list-price, zonos-sales-price, dan zonos-price yang ditugaskan ke elemen HTML yang berisi berbagai harga tersebut:

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

Jika tidak ada cartridge yang berisi template ini dan dikonfigurasi lebih tinggi daripada int_zonos di jalur cartridge, perubahan kode tidak diperlukan untuk Zonos Hello untuk mengonversi mata uang dari rendering harga ini di situs Anda. Jika Anda memiliki versi kustomisasi dari template ini di satu atau lebih cartridge lebih tinggi dari int_zonos di jalur cartridge, Anda harus menyertakan nama kelas unik ke pembungkus HTML di sekitar harga Anda (seperti yang diilustrasikan di atas) dalam template kustomisasi tersebut.

Mengonfigurasi string pemilih elemen harga

String pemilih mata uang adalah nilai string pemilih gaya jQuery yang digunakan skrip Zonos untuk mengidentifikasi elemen HTML yang berisi nilai harga yang harus menerima pembaruan konversi mata uang. Nilai ini harus berupa daftar nama kelas CSS dan/atau ID yang ditugaskan ke elemen HTML yang membungkus tampilan harga situs Anda yang dijelaskan di langkah sebelumnya, di mana nama kelas diawali dengan . dan ID diawali dengan # (tanpa tanda kutip). Misalnya, jika situs Anda akan menggunakan template untuk tampilan harga yang disertakan dalam cartridge Zonos, string pemilih akan menjadi .zonos-list-price .zonos-sales-price .zonos-price (tanpa tanda kutip).

String pemilih mata uang dapat dikonfigurasi baik melalui Dashboard Zonos Anda, atau dalam preferensi situs Currency Element Selector dari preferensi situs khusus Zonos Anda di Business Manager.

Catatan: Jika dikonfigurasi di kedua tempat, nilai dalam Business Manager akan memiliki prioritas.

Pelajari lebih lanjut tentang konversi mata uang Zonos Hello.

String pemilih tombol checkout adalah nilai string pemilih jQuery yang digunakan skrip Zonos untuk mengidentifikasi elemen HTML di situs Anda yang berfungsi sebagai kontrol tombol yang mana ketika diklik, membawa pelanggan ke alur checkout situs Anda.

Ketika pembeli mengklik tombol Checkout yang cocok dengan string pemilih yang dikonfigurasi, Zonos secara otomatis mengintersepsi tindakan dan membuka checkout modal.

String pemilih tombol checkout dapat dikonfigurasi baik melalui Dashboard Zonos Anda, atau dalam preferensi situs Place Order (Checkout) Button Selector dari preferensi situs khusus Zonos Anda di Business Manager.

Ketika pengguna menyelesaikan pesanan dalam checkout yang dihosting Zonos, mereka dialihkan ke Pipeline khusus yang menampilkan konfirmasi pesanan dalam SFCC (Zonos-OrderConfirmation). Template rendering utama untuk konfirmasi pesanan ini adalah /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Halaman konfirmasi pesanan ini menggunakan gaya yang sama dengan halaman konfirmasi pesanan SFCC/SFRA asli dan berbagi beberapa file .isml dengan halaman konfirmasi pesanan SFCC/SFRA asli. Ini mungkin perlu beberapa pembaruan gaya untuk mencocokkan pembaruan gaya khusus apa pun yang telah dibuat ke situs. Template rendering dasar yang digunakan oleh template konfirmasi pesanan Zonos meliputi:

• 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

Fungsi yang mendasari terkait dengan pipeline khusus ini di luar menampilkan konfirmasi pesanan kepada pengguna terkait dengan jenis objek khusus baru yang disertakan dalam impor data, zonosOrders. Ketika konfirmasi pesanan ditampilkan untuk pengguna, SFCC menggunakan ID pesanan Zonos yang ditampilkan di url untuk konfirmasi pesanan dan membuat objek khusus yang sesuai dengan ID Pesanan Zonos sebagai Atribut Kunci untuk objek khusus. Ini kemudian digunakan untuk menempatkan pesanan dalam SFCC melalui pekerjaan CreateOrdersFromZonos. Pekerjaan ini akan mengulangi semua objek khusus dari jenis zonosOrders dengan createdStatus = - None -. Pekerjaan akan melakukan beberapa tugas:

1. Tanyakan Zonos untuk detail pesanan.
2. Gunakan respons ini untuk membuat pesanan dalam SFCC berdasarkan pengaturan yang dikonfigurasi dalam preferensi situs untuk metode pengiriman dan metode pembayaran + detail untuk item, pengiriman, penagihan dan pelanggan dalam respons.
3. Perbarui Zonos dengan nomor pesanan SFCC melalui mutasi untuk mengasosiasikan ini dengan nomor pesanan Zonos dalam Dashboard Zonos.

Jika langkah-langkah di atas berhasil, atribut objek khusus createdStatus akan diatur ke created untuk menghilangkan objek dari pertimbangan masa depan. Jika langkah-langkah di atas tidak berhasil, atribut objek khusus createdStatus akan diatur ke failed dan pesan kesalahan akan dicatat dalam objek dalam atribut errorResponse (Zonos) atau sfccErrorResponse (SFCC) tergantung pada sistem yang merespons dengan kesalahan selama proses.

Jika Anda perlu mencoba lagi untuk menempatkan pesanan, cukup atur ulang createdStatus menjadi - None - dan ini akan dipertimbangkan dalam run pekerjaan berikutnya.

Opsional—Pengaturan berikut adalah pengaturan lanjutan. Default ada di tempat, jadi tidak ada tindakan yang diperlukan. Jika Anda ingin membuat penyesuaian, ikuti panduan ini:

Buat faktur saat impor

Diatur ke Yes secara default. Zonos akan membuat faktur setelah impor pesanan. Jika Anda memilih untuk menonaktifkan fitur ini, Anda perlu membuat faktur Anda sendiri, dan Zonos akan menetapkan status tahan review penipuan ke zonos_hold. Setelah status tahan tersebut dicabut, kami akan mengembalikan ke status sebelumnya.

Login pelanggan

Diatur ke No secara default. Jika Anda ingin memerlukan akun untuk checkout, alihkan ke Yes. Anda juga perlu membuka Customer configuration > Login options dan perbarui Redirect Customer to Account Dashboard after Logging In menjadi No.

Ekspor pesanan SFCC

Jika Anda menggunakan, atau berencana menggunakan, Ekspor Pesanan SFCC, pastikan atribut khusus Zonos yang ditugaskan ke objek Pesanan dan Produk disertakan dalam file ekspor pesanan SFCC Anda. Dari Merchant Tools > Site Preferences > Orders, atur versi skema ekspor pesanan ke versi terbaru.

Sekarang setelah Anda menyiapkan akun dan aplikasi Anda, Anda siap untuk menguji integrasi Anda. Anda perlu mengaktifkan Checkout dan Hello di SFCC saat pengujian. Untuk melakukannya:

1. Buka Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Alihkan Zonos Enabled ke Yes.

Setelah Anda memiliki informasi akun Zonos yang dikonfigurasi dalam preferensi situs khusus situs Anda, dan sakelar fitur Zonos Enabled ditetapkan ke YES, Anda dapat menguji fitur Zonos di storefront Anda dengan menambahkan parameter berikut ke URL situs Anda: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Misalnya, jika Anda telah mengaktifkan Kanada: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Catatan: Ini hanya diperlukan untuk pengujian di lingkungan non-produksi, di mana Token API Publik Zonos Anda dikonfigurasi dengan token kredensial tes. Ketika dikonfigurasi dengan token API live/production Anda, parameter URL zCountry tidak diperlukan atau diharapkan.

Jika Anda belum siap untuk go live, ingat untuk alihkan Zonos Enabled kembali ke No setelah Anda selesai pengujian. Setelah menyelesaikan pengujian, aktifkan Zonos menggunakan langkah yang sama di atas.

Informasi produk dapat mempengaruhi jumlah bea dan pajak yang harus dibayar serta biaya pengiriman. Semakin banyak informasi produk yang Anda berikan kepada Zonos, semakin tepat penawaran yang dikembalikan. Zonos dapat menghasilkan penawaran bahkan ketika informasi ini tidak tersedia, tetapi merekomendasikan untuk memberikan detail produk utama berikut untuk meningkatkan akurasi:

• Berat: Berat mempengaruhi biaya pengiriman Anda, yang dapat mempengaruhi bea atau pajak. Bobot dalam daftar produk SFCC Anda secara otomatis digunakan oleh Zonos saat ada.
• Dimensi: Dimensi mungkin mempengaruhi biaya pengiriman Anda, yang dapat mempengaruhi bea atau pajak. Zonos dapat menggunakan dimensi produk (panjang, lebar, dan tinggi) yang ditetapkan pada setiap produk di SFCC, tetapi Anda harus memetakannya dalam preferensi situs khusus Zonos untuk integrasi yang tepat.
• Kode HS: Kode HS mempengaruhi tarif bea dan kadang-kadang dapat mempengaruhi pajak. Zonos dapat menggunakan kode HS yang ditetapkan dalam daftar produk Anda di SFCC, tetapi Anda harus memetakan bidang kode HS dalam preferensi situs khusus Zonos.
• Negara asal: Negara asal produk mempengaruhi tarif bea dan dapat mempengaruhi pajak. Negara asal yang ditetapkan dalam daftar produk SFCC Anda secara otomatis digunakan oleh Zonos saat ada.

Catatan: Sebagai alternatif, Anda dapat memasukkan informasi ke dalam Katalog, menimpa informasi yang disimpan dan dilewatkan dari SFCC.

Pelajari lebih lanjut tentang informasi produk menurut platform.