Checkout cho Salesforce Commerce Cloud

Khi metadata.zip được chuẩn bị, hãy nhập nó vào sandbox SFCC của bạn:

1. Chuyển đến Business Manager > Administration > Site Development > Site Import & Export.
2. Tải lên metadata.zip bằng tùy chọn tải lên Local.
3. Sau khi tải lên, hãy tìm kiếm kho lưu trữ trong danh sách và nhấp vào Import.

Bước này tạo các tùy chọn trang web, dịch vụ, thông tin xác thực và các đối tượng tùy chỉnh được yêu cầu bởi tích hợp Zonos.

Thêm cartridge int_zonos vào đường dẫn cartridge của trang web của bạn để kích hoạt các bộ điều khiển, tập lệnh và mẫu của nó:

1. Chuyển đến Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Chèn int_zonos vào đường dẫn cartridge trước cartridge giao diện cửa hàng SFRA (app_storefront_base).

Có 2 Pipeline tùy chỉnh được đưa vào cùng với cartridge mà nên có các bí danh quy trình được thêm vào trong Business Manager:

Zonos-OrderConfirmation

Điều này được sử dụng để xác nhận đơn hàng tùy chỉnh trong SFCC sau khi đơn hàng được hoàn thành trong thanh toán Zonos. Người dùng sẽ được chuyển hướng ở đây. Ví dụ: bí danh có thể là zonos-order-confirmation. Vui lòng chọn và thêm một bí danh thích hợp cho doanh nghiệp của bạn khác với bí danh bạn sử dụng cho trang xác nhận đơn hàng thanh toán SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Điều này được sử dụng cho điểm cuối tùy chỉnh được sử dụng để tạo đơn hàng Zonos trong SFCC/SFRA và người ta cho rằng bí danh là zonos-placesfccorder. Nếu bạn sử dụng một bí danh khác ở đây, bạn sẽ cần ghi chú điều này khi bạn đến thiết lập dịch vụ. Đây không phải là một url công khai, vì vậy sử dụng zonos-placesfccorder được khuyến khích cho thiết lập ban đầu để duy trì dễ dàng sử dụng cartridge này.

Để định cấu hình hai bí danh này, trong Business Manager, hãy chuyển đến Merchant Tools > URL Rules > Pipeline URLs.

Với dự nhập trang web ở bước 2, hai dịch vụ SFCC (với các hồ sơ và thông tin xác thực đi kèm) được tạo: zonos.api.graphql và create.order.api.sfra.

Thiết lập một trang web duy nhất

Nếu tổ chức của bạn có một trang web giao diện cửa hàng duy nhất trong tổ chức SFCC của bạn, không có gì khác để làm ở đây, và bạn có thể tiếp tục bước tiếp theo.

Thiết lập nhiều trang web

Nếu tổ chức của bạn có nhiều trang web giao diện cửa hàng hoặc có kế hoạch có nhiều trang web giao diện cửa hàng trong tổ chức SFCC của bạn, bạn sẽ cần thực hiện các cập nhật/bổ sung cho các dịch vụ SFCC của bạn. Khi bạn có nhiều trang web SFCC sẽ sử dụng tích hợp Zonos, bạn sẽ cần một dịch vụ API tạo đơn hàng cho mỗi trang web. Đối với mỗi trang web, hãy thực hiện như sau:

1. Tạo thông tin xác thực mới với tên create.order.api.[siteID].
2. Gán URL thông tin xác thực để: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (ví dụ: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Tạo dịch vụ mới với tên create.order.api.[siteID] và gán cho nó hồ sơ create.order.api và thông tin xác thực create.order.api.[siteID] mà bạn tạo ở bước 1.

Sau khi hoàn thành, bạn sẽ có dịch vụ API tạo đơn hàng cho mỗi trang web của bạn.

Lưu ý: Nếu bạn không đổi tên dịch vụ create.order.api.sfra ban đầu thành dịch vụ tạo đơn hàng cho một trong các trang web của bạn, và nó vẫn tồn tại, bạn có thể xóa nó. Để tên dịch vụ zonos.api.graphql không đổi. Ngay cả với nhiều trang web, bạn chỉ cần một dịch vụ Zonos API duy nhất.

Trong Business Manager, hãy chuyển đến Merchant Tools > Site Preferences > Custom Preferences, sau đó nhấp vào nhóm tùy chọn zonos để truy cập các tùy chọn trang web tùy chỉnh Zonos.

Đặt các tùy chọn trang web sau cho các trang web của bạn:

Trong quá trình thanh toán phương thức Zonos, những người mua chọn các phương thức vận chuyển được xác định trong Bảng điều khiển Zonos của bạn. Khi các đơn hàng này được nhập vào SFCC, các phương thức vận chuyển của họ phải tương ứng với phương thức vận chuyển SFCC hợp lệ. Để hỗ trợ điều này:

1. Thiết lập một hoặc nhiều phương thức vận chuyển trong SFCC để các phương thức vận chuyển của bạn trong Zonos nên được ánh xạ.
2. Trong tùy chọn trang web tùy chỉnh Zonos Ship Method Mapping được mô tả ở trên, hãy thiết lập một hoặc nhiều ánh xạ phương thức vận chuyển giữa (các) phương thức vận chuyển Zonos của bạn và (các) phương thức vận chuyển SFCC của bạn.

Ánh xạ phương thức vận chuyển

Dưới dạng một đối tượng JSON, ánh xạ phương thức vận chuyển ánh xạ (các) phương thức vận chuyển Zonos của bạn sang (các) phương thức vận chuyển SFCC của bạn. Ánh xạ này phải có bản ghi ánh xạ cho mọi phương thức vận chuyển Zonos tiềm năng (mức độ dịch vụ) có thể được chọn trong thanh toán Zonos của bạn. Được khuyến khích cao để bạn cũng cấp bản ghi ánh xạ default sẽ được sử dụng trong các trường hợp mà đơn hàng Zonos được đặt với phương thức vận chuyển mà bản đồ phương thức vận chuyển SFCC không tồn tại, do đó ngăn chặn các lỗi hạ lưu do thiếu phương thức vận chuyển trong đơn hàng SFCC.

Định dạng cho đối tượng JSON là:

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

Ví dụ

Giả sử bạn đã bật các mức độ dịch vụ sau trong Bảng điều khiển Zonos của bạn:

Vì bất kỳ lý do nào của bạn (tức là yêu cầu backoffice, tích hợp dịch vụ vận chuyển của bên thứ ba bổ sung, v.v.), bạn có thể bị giới hạn ở các phương thức vận chuyển sau trong SFCC cho trang web của bạn:

Khi một đơn hàng Zonos mới được nhận và sau đó được đặt vào SFCC, phương thức vận chuyển phải từ danh sách này.

Để xây dựng bản đồ của bạn, hãy đăng nhập vào Bảng điều khiển Zonos của bạn, chuyển đến Shipping > Manage Rates, sau đó nhấp vào mỗi Mức độ dịch vụ được bật được hiển thị, nơi bạn sẽ thấy một màn hình tương tự như sau:

Trong mỗi, nhấp vào Edit details để nhận (hoặc đặt) mã mức độ dịch vụ vận chuyển Zonos (xem bên dưới).

Với mã mức độ dịch vụ vận chuyển, hãy tạo bản ghi ánh xạ ánh xạ nó tới phương thức vận chuyển SFCC mà bạn muốn xuất hiện trên các đơn hàng SFCC của bạn khi mức độ dịch vụ vận chuyển đó (phương thức vận chuyển Zonos) được chọn trong thanh toán Zonos.

Sau khi bạn đã thêm một bản ghi cho mỗi mã mức độ dịch vụ vận chuyển được bật, cũng như ánh xạ phương thức vận chuyển default, đối tượng Zonos Ship Method Mapping JSON của bạn sẽ trông tương tự như thế này:

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

Lưu ý: Vì đây chỉ là ánh xạ của các phương thức vận chuyển Zonos sang các phương thức vận chuyển SFCC, điều quan trọng là chỉ có tất cả các phương thức vận chuyển Zonos được đưa vào bản đồ. Không cần phải có mỗi phương thức vận chuyển SFCC của bạn được đưa vào bản đồ.

Đi kèm với cài đặt là hai công việc SFCC để hỗ trợ tích hợp Zonos:

CreateOrdersFromZonos

Công việc này tìm kiếm các tham chiếu đơn hàng Zonos mới tạo trong kho đối tượng tùy chỉnh zonosOrders, tìm nạp chi tiết đơn hàng đầy đủ từ Zonos và tạo các đơn hàng tương ứng trong SFCC.

Lịch biểu: Bạn có thể lên lịch công việc này để phù hợp với nhu cầu kinh doanh của mình, nhưng thông thường, công việc này nên được cấu hình để chạy trên cơ sở khoảng thời gian, tương đối thường xuyên (tức là cứ 5-10 phút), và mỗi ngày trong tuần.

Thông số tùy chỉnh: Công việc CreateOrdersFromZonos không bao gồm bất kỳ thông số tùy chỉnh nào.

CreateMissingZonosOrders

Mặc dù nó nên hiếm khi xảy ra, nhưng có thể là, vì những hoàn cảnh bất ngờ, có thể có các đơn hàng được đặt trong Zonos không tạo được trong phiên bản SFCC của bạn thông qua quy trình thông thường. Vì lý do này, chúng tôi đã bao gồm công việc CreateMissingZonosOrders. Công việc này thực hiện kiểm tra chéo giữa lịch sử đơn hàng Zonos của bạn và SFCC để xác định và nhập bất kỳ đơn hàng bị thiếu nào.

Lịch biểu: Bạn có thể lên lịch công việc này để phù hợp với nhu cầu kinh doanh của mình, nhưng bạn nên lên lịch công việc này để chạy ít thường xuyên hơn công việc CreateOrdersFromZonos. Một số điều cần xem xét khi lên lịch tần suất cho công việc này chạy:

1. Giống như đối với tất cả các công việc, sau khi xem xét tất cả mọi thứ—bao gồm tải xử lý/băng thông và nhu cầu kinh doanh của bạn—bạn nên lên lịch công việc này để chạy không thường xuyên như bạn cảm thấy bạn có thể.
2. Vì công việc này sẽ truy vấn tất cả các đơn hàng trong một khoảng thời gian, các trang web khối lượng cao nên chạy công việc này thường xuyên hơn (vì vậy ít đơn hàng được xử lý cho mỗi lần chạy công việc), trong khi các trang web khối lượng thấp có thể thoát khỏi tần suất ít hơn.
3. Tần suất cơ bản được đề xuất của chúng tôi cho CreateMissingZonosOrders, mà chúng tôi nghĩ sẽ hoạt động cho hầu hết các trang web, là một lần cứ 90 phút.

Thông số tùy chỉnh: Có hai thông số tùy chỉnh được liên kết với bước công việc CreateMissingZonosOrders mà bạn nên đặt:

1. LookBackHours: Đây là số giờ (từ thời điểm công việc chạy) lùi lại trong thời gian mà công việc nên truy vấn Zonos tìm kiếm các đơn hàng bị thiếu. Dựa trên tần suất được lên lịch cho công việc, giá trị này nên ít nhất bằng thời gian giữa các lần chạy công việc, lý tưởng nhất là nên có sự chồng chéo. Ví dụ: nếu công việc được lên lịch để chạy cứ 90 phút, hãy đặt LookBackHours thành 2 (giờ). Giá trị mặc định (nếu không có giá trị được đặt): 2
2. OrderSize: Số lượng đơn hàng tối đa để lấy cho mỗi truy vấn nội bộ của Zonos. Hãy nghĩ về điều này như kích thước trang mà công việc sử dụng khi truy vấn Zonos cho các đơn hàng. Giá trị mặc định (nếu không có giá trị được đặt): 20

Zonos Hello cung cấp khả năng địa phương hóa phía máy khách như chọn ngôn ngữ động, tin nhắn nhiệm vụ/thuế và chuyển đổi tiền tệ nội tuyến. Khi Zonos được bật trong tùy chọn trang web, Hello tải tự động trên giao diện cửa hàng của bạn thông qua tập lệnh máy khách Zonos.

Các tập lệnh máy khách Zonos được thêm bằng cách sử dụng đưa vào từ xa SFCC của điểm cuối Zonos-ClientScriptInclude, nằm ở cuối các mẫu lớp phủ sau:

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

Nếu dự án của bạn ghi đè các mẫu này trong các cartridge ưu tiên cao hơn, hãy đảm bảo rằng đưa vào từ xa được thêm vào các phiên bản tùy chỉnh của bạn:

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

Tìm hiểu thêm về Zonos Hello.

Zonos Hello tự động chuyển đổi các giá trị giá được hiển thị trên giao diện cửa hàng sang tiền tệ cục bộ của người mua. Để điều này hoạt động chính xác:

1. Các giá trị giá phải được gói trong các phần tử HTML bằng cách sử dụng tên lớp hoặc ID có thể được chọn qua jQuery. Ví dụ: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Các giá trị bộ chọn này phải được đưa vào tùy chọn trang web Currency Element Selector (hoặc trong Bảng điều khiển Zonos của bạn).

Thay đổi mã hiển thị giá

Cartridge Zonos bao gồm các mẫu lớp phủ sau đây cho nơi các giá được hiển thị trong suốt trang web của kiến trúc tham chiếu, sử dụng các tên lớp zonos-list-price, zonos-sales-price và zonos-price được gán cho các phần tử HTML chứa các giá khác nhau:

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

Nếu không có cartridge nào chứa các mẫu này và được cấu hình cao hơn int_zonos trong đường dẫn cartridge, không cần thay đổi mã cho Zonos Hello để chuyển đổi các tiền tệ của các kết xuất giá này trên trang web của bạn. Nếu bạn đã tùy chỉnh các phiên bản của các mẫu này trong một hoặc nhiều cartridge cao hơn int_zonos trong đường dẫn cartridge, bạn sẽ phải đưa vào một tên lớp duy nhất cho các lớp phủ HTML xung quanh các giá của bạn (như minh họa ở trên) trong những mẫu tùy chỉnh đó.

Định cấu hình chuỗi bộ chọn phần tử giá

Chuỗi bộ chọn tiền tệ là giá trị chuỗi bộ chọn kiểu jQuery được sử dụng bởi tập lệnh Zonos để xác định các phần tử HTML chứa các giá trị giá sẽ nhận được cập nhật chuyển đổi tiền tệ. Giá trị này nên là danh sách được phân tách bằng dấu cách của các tên lớp CSS và/hoặc ID được gán cho các phần tử HTML gói gọn hiển thị giá của trang web được mô tả ở bước trước, trong đó các tên lớp được đặt tiền tố bằng . và ID được đặt tiền tố bằng # (không có dấu ngoặc kép). Ví dụ: nếu trang web của bạn sẽ sử dụng các mẫu cho hiển thị giá được đưa vào trong cartridge Zonos, chuỗi bộ chọn sẽ là .zonos-list-price .zonos-sales-price .zonos-price (không có dấu ngoặc kép).

Chuỗi bộ chọn tiền tệ có thể được cấu hình qua Bảng điều khiển Zonos của bạn hoặc trong tùy chọn trang web Currency Element Selector của các tùy chọn trang web tùy chỉnh Zonos trong Business Manager.

Lưu ý: Nếu được cấu hình ở cả hai nơi, giá trị trong Business Manager sẽ có quyền ưu tiên.

Tìm hiểu thêm về chuyển đổi tiền tệ Zonos Hello.

Chuỗi bộ chọn nút thanh toán là giá trị chuỗi bộ chọn jQuery được sử dụng bởi tập lệnh Zonos để xác định các phần tử HTML trên trang web của bạn phục vụ làm điều khiển nút trong đó khi được nhấp chuột, đưa khách hàng vào luồng thanh toán của trang web của bạn.

Khi những người mua nhấp vào nút Thanh toán phù hợp với chuỗi bộ chọn được cấu hình của bạn, Zonos tự động chặn hoạt động và mở thanh toán phương thức.

Chuỗi bộ chọn nút thanh toán có thể được cấu hình qua Bảng điều khiển Zonos của bạn hoặc trong tùy chọn trang web Place Order (Checkout) Button Selector của các tùy chọn trang web tùy chỉnh Zonos trong Business Manager.

Khi người dùng hoàn thành đơn hàng trong thanh toán được lưu trữ Zonos, họ được chuyển hướng đến Pipeline tùy chỉnh hiển thị xác nhận đơn hàng trong SFCC (Zonos-OrderConfirmation). Mẫu kết xuất chính cho xác nhận đơn hàng này là /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Trang xác nhận đơn hàng này sử dụng cùng kiểu dáng như trang xác nhận đơn hàng SFCC/SFRA gốc và chia sẻ một số tệp .isml với trang xác nhận đơn hàng SFCC/SFRA gốc. Điều này có thể cần một số cập nhật kiểu dáng để khớp với bất kỳ cập nhật kiểu dáng tùy chỉnh nào đã được thực hiện cho trang web. Các mẫu kết xuất cơ sở được sử dụng bởi mẫu xác nhận đơn hàng Zonos bao gồm:

• 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

Chức năng cơ bản liên quan đến Pipeline tùy chỉnh này ngoài việc hiển thị xác nhận đơn hàng cho người dùng liên quan đến loại đối tượng tùy chỉnh mới được đưa vào dự nhập dữ liệu, zonosOrders. Khi xác nhận đơn hàng hiển thị cho người dùng, SFCC đang sử dụng ID đơn hàng Zonos được hiển thị trong url cho xác nhận đơn hàng và tạo một đối tượng tùy chỉnh tương ứng với ID đơn hàng Zonos làm Thuộc tính khóa cho đối tượng tùy chỉnh. Điều này sau đó được sử dụng để đặt đơn hàng trong SFCC thông qua công việc CreateOrdersFromZonos. Công việc này sẽ lặp lại thông qua tất cả các đối tượng tùy chỉnh của loại zonosOrders với createdStatus = - None -. Công việc sẽ thực hiện một số công việc:

1. Truy vấn Zonos cho chi tiết đơn hàng.
2. Sử dụng phản hồi này để tạo đơn hàng trong SFCC dựa trên các cài đặt được cấu hình trong tùy chọn trang web cho phương thức vận chuyển và phương thức thanh toán + chi tiết cho các mục, vận chuyển, thanh toán và khách hàng trong phản hồi.
3. Cập nhật Zonos với số đơn hàng SFCC thông qua một đột biến để liên kết điều này với số đơn hàng Zonos trong Bảng điều khiển Zonos.

Nếu các bước trên thành công, thuộc tính đối tượng tùy chỉnh createdStatus sẽ được đặt thành created để loại bỏ đối tượng khỏi cân nhắc trong tương lai. Nếu các bước trên không thành công, thuộc tính đối tượng tùy chỉnh createdStatus sẽ được đặt thành failed và một thông báo lỗi sẽ được ghi chú trong đối tượng trong thuộc tính errorResponse (Zonos) hoặc sfccErrorResponse (SFCC) tùy thuộc vào hệ thống phản hồi với lỗi trong quá trình.

Nếu bạn cần thử lại để đặt đơn hàng, chỉ cần đặt lại createdStatus thành - None - và điều này sẽ được xem xét trong lần chạy công việc tiếp theo.

Tùy chọn—Các cài đặt sau đây là cài đặt nâng cao. Các giá trị mặc định đang có, vì vậy không cần hành động. Nếu bạn muốn thực hiện điều chỉnh, hãy làm theo những hướng dẫn này:

Tạo hóa đơn trên nhập khẩu

Đặt thành Yes theo mặc định. Zonos sẽ tạo một hóa đơn khi nhập đơn hàng. Nếu bạn chọn tắt tính năng này, bạn sẽ cần tạo hóa đơn của riêng mình, và Zonos sẽ đặt giữ xét duyệt gian lận thành trạng thái zonos_hold. Sau khi gian lận được loại bỏ, chúng tôi sẽ hoàn nguyên về trạng thái trước đó.

Đăng nhập khách hàng

Đặt thành No theo mặc định. Nếu bạn muốn yêu cầu một tài khoản cho thanh toán, hãy chuyển sang Yes. Bạn cũng sẽ cần chuyển đến Customer configuration > Login options và cập nhật Redirect Customer to Account Dashboard after Logging In thành No.

Xuất đơn hàng SFCC

Nếu bạn sử dụng hoặc có kế hoạch sử dụng Xuất đơn hàng SFCC, hãy đảm bảo rằng các thuộc tính tùy chỉnh Zonos được gán cho các đối tượng Đơn hàng và Sản phẩm được đưa vào các tệp xuất đơn hàng SFCC của bạn. Từ Merchant Tools > Site Preferences > Orders, hãy đặt phiên bản lược đồ xuất đơn hàng thành phiên bản mới nhất.

Thông tin sản phẩm có thể ảnh hưởng đến lượng thuế và thuế do và chi phí vận chuyển. Bạn càng cung cấp nhiều thông tin sản phẩm cho Zonos, giá trị báo giá được trả về sẽ càng chính xác. Zonos có thể tạo một báo giá ngay cả khi thông tin này không có sẵn, nhưng khuyến nghị cung cấp các chi tiết sản phẩm chính sau để cải thiện độ chính xác:

• Trọng lượng: Trọng lượng ảnh hưởng đến chi phí vận chuyển của bạn, điều này có thể ảnh hưởng đến thuế hoặc thuế. Trọng lượng trong danh sách sản phẩm SFCC của bạn được Zonos sử dụng tự động khi có.
• Kích thước: Kích thước có thể ảnh hưởng đến chi phí vận chuyển của bạn, điều này có thể ảnh hưởng đến thuế hoặc thuế. Zonos có thể sử dụng kích thước sản phẩm (chiều dài, chiều rộng và chiều cao) được đặt trên mỗi sản phẩm trong SFCC, nhưng bạn phải ánh xạ nó trong các tùy chọn trang web tùy chỉnh Zonos để tích hợp thích hợp.
• Mã HS: Mã HS ảnh hưởng đến tỷ lệ thuế và đôi khi có thể ảnh hưởng đến thuế. Zonos có thể sử dụng các mã HS được đặt trong danh sách sản phẩm SFCC của bạn, nhưng bạn phải ánh xạ trường mã HS trong các tùy chọn trang web tùy chỉnh Zonos.
• Quốc gia sản xuất: Quốc gia sản xuất của sản phẩm ảnh hưởng đến tỷ lệ thuế và có thể ảnh hưởng đến thuế. Quốc gia sản xuất được đặt trong danh sách sản phẩm SFCC của bạn được Zonos sử dụng tự động khi có.

Lưu ý: Ngoài ra, bạn có thể nhập thông tin vào Danh mục, ghi đè thông tin được lưu trữ và được chuyển từ SFCC.

Tìm hiểu thêm về thông tin sản phẩm theo nền tảng.