Tích hợp Checkout liền mạch với cửa hàng Miva của bạn bằng cách thực hiện theo các bước trong phần này.
1
Bắt đầu
Bắt đầu bằng cách hoàn thành biểu mẫu đăng ký của chúng tôi. Quá trình onboarding sẽ bắt đầu sau khi thỏa thuận tài khoản của bạn có hiệu lực.
2
Onboarding
Trong vòng 24 giờ sau khi đăng ký, một đại diện onboarding chuyên dụng sẽ liên hệ với bạn để bắt đầu quá trình tích hợp được tùy chỉnh.
Quan trọng: Các bước được liệt kê dưới đây được cung cấp cho tham khảo của bạn và bạn sẽ được hướng dẫn qua chúng bởi đại diện onboarding của bạn.
3
Cài đặt mô-đun Checkout
Zonos khuyên dùng
Cài đặt mô-đun trên trang staging để kiểm tra trước khi phát hành.
Tải xuống mô-đun từ Miva App Store, hoặc yêu cầu tệp zonos.mvc trực tiếp từ Zonos.
Trong trang quản trị Miva của bạn, đi tới Domain Settings -> Modules -> Add Module, tải lên tệp zonos.mvc, sau đó nhấp vào Add.
Đi tới Settings -> Modules, tìm Zonos, và nhấp vào Install. Xác nhận nó hiển thị là Installed.
4
Tạo API token
Trong Miva, đi tới Users -> API Tokens và nhấp vào Add API Token. Định cấu hình như sau:
Name: Zonos Checkout
Allowed IP Addresses:0.0.0.0/0, ::/0
Signature: Require Signature with Key -- nhấp vào Generate để tạo khóa ký
Timestamp: Require Timestamp Within 30 seconds
Tại sao là 0.0.0.0/0, ::/0?
Các cửa hàng Miva phía sau Cloudflare định tuyến các lệnh gọi API đi ra thông qua mạng lưới của Cloudflare, khiến địa chỉ IP nguồn không thể dự đoán được. Điều này an toàn -- mọi yêu cầu đều được ký mã hóa bằng HMAC-SHA256, vì vậy chỉ mô-đun Zonos có khóa bí mật của bạn mới có thể tạo ra các yêu cầu hợp lệ.
5
Gán nhóm dựa trên vai trò
Trên màn hình tiếp theo, bật Customer Service & Sales để cho phép token tạo và sửa đổi đơn hàng. Nhấp vào Save.
6
Định cấu hình cài đặt Zonos
Điều hướng đến mô-đun Checkout trong Miva bằng cách đi tới Miva -> Utility Settings -> Zonos, sau đó điền vào các trường sau:
Store ID: Sao chép Zonos account number của bạn từ Dashboard -> Settings -> Account -> Integrations.
Zonos API Key: Khóa API bí mật của bạn (không bao giờ chia sẻ khóa này).
Zonos Public Key: Khóa công khai của bạn.
Store Currency: Đơn vị tiền tệ cơ bản của cửa hàng bạn (ví dụ: USD).
Environment: Chọn Live cho môi trường sản xuất hoặc Test để kiểm tra.
Checkout Button Selector: Bộ chọn CSS cho nút thanh toán của bạn (ví dụ: a[href*="checkout.html"]).
Hidden Selectors: Để ẩn các tùy chọn thanh toán nội địa và các chi tiết khác có thể không liên quan đến khách hàng quốc tế.
Import Orders: Đánh dấu để tự động nhập các đơn hàng Zonos đã hoàn thành vào trang quản trị Miva. Điều này yêu cầu webhook phải được đăng ký ở bước tiếp theo.
Nhấp vào Update ở phía trên bên phải để lưu trước khi tiếp tục.
Đơn hàng được nhập qua webhook trong mô-đun 10.x. Các phiên bản mô-đun trước đây sử dụng URL/endpoint thành công đơn hàng thay thế.
7
Đăng ký webhook
Sau khi lưu cài đặt của bạn, nhấp vào Register Webhooks. Thao tác này kết nối cửa hàng của bạn với Zonos để các đơn hàng đã hoàn thành được tự động nhập, việc hủy đơn được đồng bộ hóa, và các cập nhật vận chuyển được đẩy trở lại Miva.
Webhook phải được đăng ký trước khi việc nhập đơn hàng, đồng bộ hủy đơn và cập nhật vận chuyển hoạt động. Hộp kiểm Import Orders yêu cầu webhook phải được đăng ký.
8
Nhập chi tiết API token
Cuộn xuống để hoàn thành các trường còn lại:
Miva API Token: Access Token từ API Token bạn đã tạo trong bước Tạo API token.
Miva API Signature: Signing Key từ cùng mục API Token đó.
Image Type: Chọn kích thước hình ảnh sản phẩm nào được hiển thị trong Zonos checkout (Main phù hợp với hầu hết các cửa hàng).
Additional Field Mappings: Tùy chọn ánh xạ các trường tùy chỉnh của Miva với các thuộc tính/metadata của Zonos (màu sắc, chất liệu, kích thước, v.v.). Chúng tôi khuyên bạn ánh xạ mã HS nếu bạn đã đặt mã HS cụ thể sản phẩm trong danh sách sản phẩm Miva của bạn. Điều này không bắt buộc để tạo ra báo giá thuế và phí vì chúng tôi có thể sử dụng mã HS cụ thể sản phẩm mà bạn đã nhập vào Catalog hoặc sử dụng mã HS mặc định của bạn. Tuy nhiên, điều này được khuyến nghị; độ chính xác của các tính toán Landed cost sẽ tăng lên đáng kể với các sản phẩm được phân loại chính xác. Để ánh xạ một trường trong Miva, hãy tạo một trường tùy chỉnh cho mã HS, sau đó ánh xạ nó dưới Utility Settings -> Zonos.
Nhấp vào Update để lưu tất cả cài đặt.
9
Kiểm tra tích hợp của bạn
Bây giờ bạn đã thiết lập tài khoản và mô-đun của mình, bạn đã sẵn sàng để kiểm tra bằng cách thực hiện các bước sau:
Kiểm tra báo giá vận chuyển
Đặt đơn hàng kiểm tra trên trang web của bạn
Kiểm tra luồng đơn hàng thông qua các hệ thống của bạn
Sau khi hoàn thành kiểm tra, bạn hiện đã sẵn sàng để hoạt động! Đặt Environment thành Live, xác nhận thông tin đăng nhập Zonos của bạn chính xác, và đảm bảo webhook đã được đăng ký trên cửa hàng trực tiếp của bạn.
Cần giúp đỡ?
Nếu bạn có câu hỏi, vui lòng liên hệ với nhóm hỗ trợ của chúng tôi. Nếu bạn hiện đang làm việc với Trình quản lý Dự án Dịch vụ Chuyên nghiệp để onboarding tài khoản của bạn, vui lòng liên hệ với họ để được hỗ trợ.
Kích thước vận chuyển, quốc gia xuất xứ và mã HS được đặt trong danh mục Miva sẽ tự động ánh xạ sang Zonos và được sử dụng cho báo giá Landed cost / vận chuyển nếu đã được điền. Không cần ánh xạ bổ sung nào để định cấu hình.
Cột kích thước mặt hàng trong giỏ hàng
Nếu cửa hàng của bạn bán các sản phẩm có thể tùy chỉnh mà tất cả các biến thể dùng chung một SKU, Product Shipping Rules tiêu chuẩn của Miva lưu trữ một bộ kích thước cho mỗi sản phẩm, vì vậy mọi cấu hình đều được xử lý như cùng một kích thước bất kể khách hàng đã chọn gì.
Miva và Zonos hỗ trợ kích thước ở cấp độ biến thể, nhưng điều đó yêu cầu thiết lập từng biến thể riêng lẻ. Điều này có thể không khả thi đối với các cửa hàng có hàng trăm hoặc hàng nghìn cấu hình không ánh xạ tới các biến thể rời rạc.
Tính năng này giải quyết vấn đề đó bằng cách đọc kích thước theo từng cấu hình trực tiếp từ giỏ hàng tại checkout, sử dụng bất kỳ logic tùy chỉnh nào mà cửa hàng của bạn đã có sẵn để tính toán chúng -- ví dụ, phân tích kích thước từ mô tả sản phẩm.
Yêu cầu
Cửa hàng của bạn phải đã điền các cột kích thước tùy chỉnh trên các mặt hàng trong giỏ hàng khi các mặt hàng được thêm vào giỏ (được xử lý ở phía Miva, ngoài phạm vi của mô-đun Zonos).
Bạn cần biết chính xác tên cột bạn đang sử dụng.
Cấu hình
Nhập các tên cột đó vào ba trường tương ứng trong trang quản trị mô-đun Zonos. Để trống để quay về Product Shipping Rules tiêu chuẩn -- tính năng này hoàn toàn tùy chọn và sẽ không ảnh hưởng đến các cửa hàng không sử dụng nó.
Đồng bộ vận chuyển & theo dõi
Khi nhãn vận chuyển được tạo hoặc mã theo dõi được nhập trong Zonos Dashboard, mã theo dõi và trạng thái vận chuyển sẽ tự động được đẩy đến đơn hàng tương ứng trong trang quản trị Miva. Điều này yêu cầu webhook phải được đăng ký (xem bước Đăng ký webhook ở trên).
Mã theo dõi cũng có thể được nhập trực tiếp trong Miva. Sử dụng hộp thoại nhập Enter Tracking Number trên bất kỳ đơn hàng Zonos nào -- mã theo dõi và trạng thái vận chuyển sẽ tự động đồng bộ trở lại Zonos Dashboard.
Nhật ký gỡ lỗi
Nhật ký gỡ lỗi có thể truy cập bên trong trang quản trị Miva, dưới cài đặt mô-đun Zonos. Nó ghi lại toàn bộ vòng đời của mọi sự kiện đơn hàng mà mô-đun xử lý -- nhập, đồng bộ theo dõi, hủy đơn và các yêu cầu hủy gửi đi đến Zonos -- bao gồm cả thành công và thất bại ngay trong cùng nhật ký.
Mỗi mục bao gồm mã đơn hàng Zonos, mã đơn hàng Miva, và, khi có liên quan, các chi tiết cấp khách hàng như phản hồi lỗi từ API của Miva hoặc Zonos. Điều này khiến nó trở thành nguồn thông tin đầy đủ nhất để chẩn đoán sự cố.
Nhật ký chỉ lưu giữ 500 dòng gần nhất. Các mục cũ hơn không được lưu trữ, vì vậy hãy kiểm tra ngay sau khi sự cố xảy ra -- các sự kiện trước đó có thể đã bị ghi đè.
Một nhật ký thứ hai, hướng tới công khai, có sẵn thông qua URL trực tiếp -- không cần đăng nhập trang quản trị Miva. Nó chỉ ghi lại lỗi (không có thành công) và không chứa PII của khách hàng hoặc dữ liệu nhạy cảm. Mỗi mục được gắn tiền tố phiên bản mô-đun (ví dụ: [v10.09]) để nhận dạng nhanh.
Store Code:miva_store_code được trả về trong mảng metadata của phản hồi API cho tất cả các đơn hàng dashboard.
Hủy đơn hàng & hoàn tiền
Tất cả các khoản hoàn tiền thanh toán phải được xử lý trực tiếp qua Zonos dashboard. Các nút Refund, Capture và Void trong Miva không khả dụng đối với các đơn hàng được nhập từ Zonos, theo thiết kế. Bất kỳ khoản hoàn tiền nào được xử lý trong Zonos sẽ không tự động cập nhật số tiền thanh toán trên đơn hàng Miva tương ứng -- đơn hàng Miva giữ nguyên số tiền đã ghi nhận ban đầu và không được đồng bộ với hoạt động hoàn tiền trong Zonos.
Đối với việc hủy đơn hàng, hành vi phụ thuộc vào trạng thái hiện tại của đơn hàng:
Open (chưa được vận chuyển): Hủy đơn trong Miva cũng sẽ hủy đơn trong Zonos và vô hiệu hóa việc ủy quyền thanh toán. Vì Zonos không ghi nhận thanh toán cho đến khi đơn hàng được vận chuyển, khách hàng thực sự không bao giờ bị tính phí và không cần hoàn tiền riêng.
Shipped hoặc Completed: Hủy đơn trong Miva sẽ đánh dấu đơn hàng Miva là đã hủy, nhưng Zonos sẽ từ chối việc hủy vì đơn hàng đã được hoàn tất và không còn đủ điều kiện để hủy tự động. Trong trường hợp này, một ghi chú chỉ dành cho quản trị viên được thêm vào đơn hàng Miva -- chỉ hiển thị cho nhân viên cửa hàng và không bao giờ hiển thị cho khách hàng -- giải thích rằng đơn hàng cần được xử lý trong Zonos. Một thông báo email cũng được gửi đến địa chỉ email chính của tài khoản cửa hàng để cảnh báo người bán thực hiện hành động trong Zonos dashboard, nơi họ có thể xử lý thủ công bất kỳ khoản hoàn tiền phù hợp nào.
Khắc phục sự cố: đơn hàng không xuất hiện trong Miva trên các trang dev/staging
Triệu chứng: Đơn hàng hoàn tất trong Zonos Checkout và xuất hiện trong Zonos dashboard, nhưng không có gì hiển thị trong trang quản trị Miva.
Nguyên nhân: Zonos gửi một webhook ORDER_CREATED (HTTP POST) đến endpoint /mm5/json.mvc của cửa hàng bạn. Trên các trang dev, bảo mật cấp máy chủ thường chặn yêu cầu này trước khi nó đến được Miva. Các nguyên nhân phổ biến:
HTTP Basic Auth -- Nếu trang dev có lời nhắc mật khẩu (Plesk, cPanel, .htaccess, v.v.), webhook sẽ bị từ chối với lỗi 401 Unauthorized. Đưa các IP của Zonos vào danh sách trắng trong cấu hình .htaccess hoặc Plesk của bạn để chúng bỏ qua lời nhắc xác thực.
Cloudflare WAF / IP Access Rules -- Nếu trang web được ủy quyền qua Cloudflare, các quy tắc bảo mật của nó có thể chặn yêu cầu POST trước khi nó đến được máy chủ của bạn. Thêm một quy tắc WAF để cho phép các yêu cầu POST có đường dẫn URL chứa /mm5/json.mvc, hoặc đưa các IP của Zonos vào danh sách trắng trực tiếp trong IP Access Rules của Cloudflare.
Danh sách IP được phép cấp máy chủ -- Nếu trang dev chỉ giới hạn lưu lượng truy cập cho các IP cụ thể (thường gặp trên các môi trường staging bị khóa với IP văn phòng hoặc nền tảng), các yêu cầu webhook của Zonos sẽ bị âm thầm loại bỏ mà không có phản hồi. Thêm tất cả các IP gửi webhook của Zonos vào danh sách được phép của máy chủ bạn (Plesk IP Access Restriction Manager, cPanel IP Blocker, hoặc các quy tắc bảo mật tường lửa/bảng điều khiển hosting của bạn).
Điều này thường chỉ ảnh hưởng đến các trang dev/staging -- các trang Miva sản xuất thường công khai và không cần đưa IP vào danh sách trắng. Nếu không chắc chắn cách định cấu hình việc này, hãy liên hệ với nhà cung cấp hosting hoặc hỗ trợ Miva của bạn.
Thông tin sản phẩm ảnh hưởng đến thuế, phí và chi phí vận chuyển, vì vậy Zonos nhận được càng nhiều thông tin thì báo giá càng chính xác. Zonos vẫn có thể tạo báo giá khi thiếu một phần thông tin này.
Trọng lượng, kích thước, quốc gia xuất xứ và mã HS: Các giá trị được đặt trong quy tắc vận chuyển của danh mục Miva sẽ tự động được chuyển sang Zonos. Không cần ánh xạ.
Mã HS trong trường tùy chỉnh: Nếu bạn lưu mã HS trong một trường tùy chỉnh của Miva, hãy ánh xạ trường đó trong Additional Field Mappings tại Utility Settings -> Zonos.
Giá trị bị thiếu: Zonos sẽ dùng chi tiết sản phẩm trong Catalog hoặc mã HS mặc định của bạn.
Lưu ý: Bất kỳ giá trị nào bạn nhập vào Catalog sẽ ghi đè giá trị được chuyển từ Miva.
Mô-đun 10.x nhập các đơn hàng Zonos đã hoàn tất vào trang quản trị Miva thông qua webhook. Đánh dấu Import Orders trong cài đặt Zonos, sau đó nhấp vào Register Webhooks. Webhook cũng đồng bộ việc hủy đơn và đẩy các cập nhật vận chuyển trở lại Miva. Các phiên bản mô-đun trước đây sử dụng URL đặt hàng thành công (order success URL) thay thế.
Tại sao đơn hàng không xuất hiện trong Miva trên trang dev hoặc staging của tôi?
Bảo mật cấp máy chủ trên trang dev thường chặn webhook ORDER_CREATED mà Zonos gửi đến /mm5/json.mvc -- HTTP Basic Auth, Cloudflare WAF hoặc IP Access Rules, hoặc danh sách IP được phép của máy chủ. Hãy cho phép các IP gửi webhook của Zonos được liệt kê trong mục Khắc phục sự cố: đơn hàng không xuất hiện trong Miva trên các trang dev/staging ở trên. Các trang sản xuất thường công khai và không bị ảnh hưởng.
Làm cách nào để hoàn tiền cho đơn hàng được đặt qua Zonos Checkout?
Xử lý tất cả các khoản hoàn tiền trong Zonos dashboard. Các nút Refund, Capture và Void trong Miva không khả dụng đối với các đơn hàng được nhập từ Zonos, và các khoản hoàn tiền thực hiện trong Zonos không cập nhật số tiền thanh toán trên đơn hàng Miva.
Điều gì xảy ra khi tôi hủy một đơn hàng Zonos trong Miva?
Điều này phụ thuộc vào trạng thái của đơn hàng:
Open (chưa được vận chuyển): Đơn hàng cũng bị hủy trong Zonos và việc ủy quyền thanh toán bị vô hiệu hóa. Khách hàng không bao giờ bị tính phí, vì vậy không cần hoàn tiền.
Shipped hoặc Completed: Zonos từ chối việc hủy. Một ghi chú chỉ dành cho quản trị viên được thêm vào đơn hàng Miva và một email được gửi đến địa chỉ email chính của tài khoản cửa hàng để bạn có thể xử lý mọi khoản hoàn tiền trong Zonos dashboard.
Tôi có thể xem mô-đun đã xử lý một đơn hàng như thế nào ở đâu?
Sử dụng nhật ký gỡ lỗi trong cài đặt mô-đun Zonos trên trang quản trị Miva. Nhật ký ghi lại mọi lần nhập đơn hàng, đồng bộ theo dõi và hủy đơn, bao gồm cả thành công và thất bại, và lưu giữ 500 dòng gần nhất. Để chỉ xem lỗi mà không cần đăng nhập trang quản trị Miva, hãy sử dụng URL nhật ký lỗi công khai được mô tả trong mục Nhật ký gỡ lỗi ở trên.
Miva
Checkout cho Miva
Tích hợp mô-đun Checkout (v10.x) cho Miva.Thực hiện theo các bước trong hướng dẫn này để tích hợp Zonos Checkout với cửa hàng Miva của bạn.
Tích hợp
Tích hợp Checkout liền mạch với cửa hàng Miva của bạn bằng cách thực hiện theo các bước trong phần này.
Bắt đầu
Bắt đầu bằng cách hoàn thành biểu mẫu đăng ký của chúng tôi. Quá trình onboarding sẽ bắt đầu sau khi thỏa thuận tài khoản của bạn có hiệu lực.
Onboarding
Trong vòng 24 giờ sau khi đăng ký, một đại diện onboarding chuyên dụng sẽ liên hệ với bạn để bắt đầu quá trình tích hợp được tùy chỉnh.
Cài đặt mô-đun Checkout
Cài đặt mô-đun trên trang staging để kiểm tra trước khi phát hành.
zonos.mvctrực tiếp từ Zonos.zonos.mvc, sau đó nhấp vào Add.Tạo API token
Trong Miva, đi tới Users -> API Tokens và nhấp vào Add API Token. Định cấu hình như sau:
0.0.0.0/0, ::/0Các cửa hàng Miva phía sau Cloudflare định tuyến các lệnh gọi API đi ra thông qua mạng lưới của Cloudflare, khiến địa chỉ IP nguồn không thể dự đoán được. Điều này an toàn -- mọi yêu cầu đều được ký mã hóa bằng HMAC-SHA256, vì vậy chỉ mô-đun Zonos có khóa bí mật của bạn mới có thể tạo ra các yêu cầu hợp lệ.
Gán nhóm dựa trên vai trò
Trên màn hình tiếp theo, bật Customer Service & Sales để cho phép token tạo và sửa đổi đơn hàng. Nhấp vào Save.
Định cấu hình cài đặt Zonos
Điều hướng đến mô-đun Checkout trong Miva bằng cách đi tới Miva -> Utility Settings -> Zonos, sau đó điền vào các trường sau:
a[href*="checkout.html"]).Nhấp vào Update ở phía trên bên phải để lưu trước khi tiếp tục.
Đăng ký webhook
Sau khi lưu cài đặt của bạn, nhấp vào Register Webhooks. Thao tác này kết nối cửa hàng của bạn với Zonos để các đơn hàng đã hoàn thành được tự động nhập, việc hủy đơn được đồng bộ hóa, và các cập nhật vận chuyển được đẩy trở lại Miva.
Nhập chi tiết API token
Cuộn xuống để hoàn thành các trường còn lại:
Nhấp vào Update để lưu tất cả cài đặt.
Kiểm tra tích hợp của bạn
Bây giờ bạn đã thiết lập tài khoản và mô-đun của mình, bạn đã sẵn sàng để kiểm tra bằng cách thực hiện các bước sau:
Tìm hiểu cách chạy các bài kiểm tra này. Bạn sẽ cần đặt trường Environment của mô-đun thành Test trong khi kiểm tra.
Sau khi hoàn thành kiểm tra, bạn hiện đã sẵn sàng để hoạt động! Đặt Environment thành Live, xác nhận thông tin đăng nhập Zonos của bạn chính xác, và đảm bảo webhook đã được đăng ký trên cửa hàng trực tiếp của bạn.
Nếu bạn có câu hỏi, vui lòng liên hệ với nhóm hỗ trợ của chúng tôi. Nếu bạn hiện đang làm việc với Trình quản lý Dự án Dịch vụ Chuyên nghiệp để onboarding tài khoản của bạn, vui lòng liên hệ với họ để được hỗ trợ.
Tùy chọn: bật chuyển đổi tiền tệ
Để hiển thị giá bằng đơn vị tiền tệ địa phương của khách truy cập trên cửa hàng của bạn, hãy định cấu hình chuyển đổi tiền tệ trong Zonos dashboard.
Thiết lập chuyển đổi tiền tệ
.price).Zonos Hello sẽ tự động chuyển đổi và hiển thị giá bằng đơn vị tiền tệ địa phương của người mua khi tính năng này được bật.
Các tính năng bổ sung
Quy tắc vận chuyển
Kích thước vận chuyển, quốc gia xuất xứ và mã HS được đặt trong danh mục Miva sẽ tự động ánh xạ sang Zonos và được sử dụng cho báo giá Landed cost / vận chuyển nếu đã được điền. Không cần ánh xạ bổ sung nào để định cấu hình.
Cột kích thước mặt hàng trong giỏ hàng
Nếu cửa hàng của bạn bán các sản phẩm có thể tùy chỉnh mà tất cả các biến thể dùng chung một SKU, Product Shipping Rules tiêu chuẩn của Miva lưu trữ một bộ kích thước cho mỗi sản phẩm, vì vậy mọi cấu hình đều được xử lý như cùng một kích thước bất kể khách hàng đã chọn gì.
Miva và Zonos hỗ trợ kích thước ở cấp độ biến thể, nhưng điều đó yêu cầu thiết lập từng biến thể riêng lẻ. Điều này có thể không khả thi đối với các cửa hàng có hàng trăm hoặc hàng nghìn cấu hình không ánh xạ tới các biến thể rời rạc.
Tính năng này giải quyết vấn đề đó bằng cách đọc kích thước theo từng cấu hình trực tiếp từ giỏ hàng tại checkout, sử dụng bất kỳ logic tùy chỉnh nào mà cửa hàng của bạn đã có sẵn để tính toán chúng -- ví dụ, phân tích kích thước từ mô tả sản phẩm.
Yêu cầu
Cấu hình
Nhập các tên cột đó vào ba trường tương ứng trong trang quản trị mô-đun Zonos. Để trống để quay về Product Shipping Rules tiêu chuẩn -- tính năng này hoàn toàn tùy chọn và sẽ không ảnh hưởng đến các cửa hàng không sử dụng nó.
Đồng bộ vận chuyển & theo dõi
Khi nhãn vận chuyển được tạo hoặc mã theo dõi được nhập trong Zonos Dashboard, mã theo dõi và trạng thái vận chuyển sẽ tự động được đẩy đến đơn hàng tương ứng trong trang quản trị Miva. Điều này yêu cầu webhook phải được đăng ký (xem bước Đăng ký webhook ở trên).
Mã theo dõi cũng có thể được nhập trực tiếp trong Miva. Sử dụng hộp thoại nhập Enter Tracking Number trên bất kỳ đơn hàng Zonos nào -- mã theo dõi và trạng thái vận chuyển sẽ tự động đồng bộ trở lại Zonos Dashboard.
Nhật ký gỡ lỗi
Nhật ký gỡ lỗi có thể truy cập bên trong trang quản trị Miva, dưới cài đặt mô-đun Zonos. Nó ghi lại toàn bộ vòng đời của mọi sự kiện đơn hàng mà mô-đun xử lý -- nhập, đồng bộ theo dõi, hủy đơn và các yêu cầu hủy gửi đi đến Zonos -- bao gồm cả thành công và thất bại ngay trong cùng nhật ký.
Mỗi mục bao gồm mã đơn hàng Zonos, mã đơn hàng Miva, và, khi có liên quan, các chi tiết cấp khách hàng như phản hồi lỗi từ API của Miva hoặc Zonos. Điều này khiến nó trở thành nguồn thông tin đầy đủ nhất để chẩn đoán sự cố.
Nhật ký lỗi công khai (không yêu cầu đăng nhập)
Một nhật ký thứ hai, hướng tới công khai, có sẵn thông qua URL trực tiếp -- không cần đăng nhập trang quản trị Miva. Nó chỉ ghi lại lỗi (không có thành công) và không chứa PII của khách hàng hoặc dữ liệu nhạy cảm. Mỗi mục được gắn tiền tố phiên bản mô-đun (ví dụ:
[v10.09]) để nhận dạng nhanh.Định dạng URL:
https://
[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1Ví dụ:
Hủy đơn hàng & hoàn tiền
Tất cả các khoản hoàn tiền thanh toán phải được xử lý trực tiếp qua Zonos dashboard. Các nút Refund, Capture và Void trong Miva không khả dụng đối với các đơn hàng được nhập từ Zonos, theo thiết kế. Bất kỳ khoản hoàn tiền nào được xử lý trong Zonos sẽ không tự động cập nhật số tiền thanh toán trên đơn hàng Miva tương ứng -- đơn hàng Miva giữ nguyên số tiền đã ghi nhận ban đầu và không được đồng bộ với hoạt động hoàn tiền trong Zonos.
Đối với việc hủy đơn hàng, hành vi phụ thuộc vào trạng thái hiện tại của đơn hàng:
Khắc phục sự cố: đơn hàng không xuất hiện trong Miva trên các trang dev/staging
Triệu chứng: Đơn hàng hoàn tất trong Zonos Checkout và xuất hiện trong Zonos dashboard, nhưng không có gì hiển thị trong trang quản trị Miva.
Nguyên nhân: Zonos gửi một webhook
ORDER_CREATED(HTTP POST) đến endpoint/mm5/json.mvccủa cửa hàng bạn. Trên các trang dev, bảo mật cấp máy chủ thường chặn yêu cầu này trước khi nó đến được Miva. Các nguyên nhân phổ biến:/mm5/json.mvc, hoặc đưa các IP của Zonos vào danh sách trắng trực tiếp trong IP Access Rules của Cloudflare.Các IP gửi webhook của Zonos
Câu hỏi thường gặp
Zonos sử dụng thông tin sản phẩm nào từ Miva?
Thông tin sản phẩm ảnh hưởng đến thuế, phí và chi phí vận chuyển, vì vậy Zonos nhận được càng nhiều thông tin thì báo giá càng chính xác. Zonos vẫn có thể tạo báo giá khi thiếu một phần thông tin này.
Tìm hiểu thêm về thông tin sản phẩm theo nền tảng.
Đơn hàng Zonos được đưa vào Miva như thế nào?
Mô-đun 10.x nhập các đơn hàng Zonos đã hoàn tất vào trang quản trị Miva thông qua webhook. Đánh dấu Import Orders trong cài đặt Zonos, sau đó nhấp vào Register Webhooks. Webhook cũng đồng bộ việc hủy đơn và đẩy các cập nhật vận chuyển trở lại Miva. Các phiên bản mô-đun trước đây sử dụng URL đặt hàng thành công (order success URL) thay thế.
Tại sao đơn hàng không xuất hiện trong Miva trên trang dev hoặc staging của tôi?
Bảo mật cấp máy chủ trên trang dev thường chặn webhook
ORDER_CREATEDmà Zonos gửi đến/mm5/json.mvc-- HTTP Basic Auth, Cloudflare WAF hoặc IP Access Rules, hoặc danh sách IP được phép của máy chủ. Hãy cho phép các IP gửi webhook của Zonos được liệt kê trong mục Khắc phục sự cố: đơn hàng không xuất hiện trong Miva trên các trang dev/staging ở trên. Các trang sản xuất thường công khai và không bị ảnh hưởng.Làm cách nào để hoàn tiền cho đơn hàng được đặt qua Zonos Checkout?
Xử lý tất cả các khoản hoàn tiền trong Zonos dashboard. Các nút Refund, Capture và Void trong Miva không khả dụng đối với các đơn hàng được nhập từ Zonos, và các khoản hoàn tiền thực hiện trong Zonos không cập nhật số tiền thanh toán trên đơn hàng Miva.
Điều gì xảy ra khi tôi hủy một đơn hàng Zonos trong Miva?
Điều này phụ thuộc vào trạng thái của đơn hàng:
Tôi có thể xem mô-đun đã xử lý một đơn hàng như thế nào ở đâu?
Sử dụng nhật ký gỡ lỗi trong cài đặt mô-đun Zonos trên trang quản trị Miva. Nhật ký ghi lại mọi lần nhập đơn hàng, đồng bộ theo dõi và hủy đơn, bao gồm cả thành công và thất bại, và lưu giữ 500 dòng gần nhất. Để chỉ xem lỗi mà không cần đăng nhập trang quản trị Miva, hãy sử dụng URL nhật ký lỗi công khai được mô tả trong mục Nhật ký gỡ lỗi ở trên.
Trang này có hữu ích không?