Lấy một đơn hàng

Điểm cuối API “Lấy Đơn Hàng” này được sử dụng để lấy dữ liệu cho một đơn hàng đã hoàn thành trong Hệ thống Zonos. Phản hồi sẽ chứa một đối tượng JSON, đại diện cho tất cả thông tin có sẵn cho đơn hàng bao gồm địa chỉ thanh toán và giao hàng, phương thức giao hàng, tổng đơn hàng và trạng thái.

Điểm cuối 

Số đơn hàng

Lấy danh sách số đơn hàng.

Chi tiết đơn hàng

Lấy thông tin chi tiết cho một đơn hàng.

Cách sử dụng điểm cuối API Lấy Đơn Hàng

Có hai cách phổ biến để sử dụng các điểm cuối này.

1. (Phần 1 + Phần 2) – Sử dụng một trang xác nhận / thành công đơn hàng tùy chỉnh trên miền của bạn để kích hoạt hệ thống của bạn gọi điểm cuối orderDetail và nhập một đơn hàng đã hoàn thành. Ngoài ra, thường xuyên gọi điểm cuối orderNumbers để đối chiếu bất kỳ đơn hàng nào trong Hệ thống Zonos chưa được nhập vào hệ thống của bạn.
2. (Chỉ Phần 2) – Sử dụng trang xác nhận / thành công đơn hàng cơ bản của Zonos hoặc một trang tĩnh trên miền của bạn để thông báo cho khách hàng về việc hoàn thành đơn hàng. Lên lịch cho hệ thống của bạn thường xuyên gọi điểm cuối orderNumbers để xác định khi nào một đơn hàng mới sẵn sàng được nhập vào hệ thống của bạn. Khi một đơn hàng chưa hoàn thành được tìm thấy, gọi điểm cuối orderDetail để lấy dữ liệu về những đơn hàng đó.

Phần 1: Trang thành công trên miền của bạn

Mỗi khi một người mua hoàn thành một đơn hàng trong Zonos Checkout, họ sẽ ngay lập tức được chuyển hướng đến một URL trang thành công đơn hàng. ID đơn hàng đã hoàn thành sẽ được thêm vào URL chuyển hướng dưới dạng chuỗi truy vấn. URL của trang thành công đơn hàng nên được cung cấp cho Zonos. URL cũng có thể được truyền dưới dạng tham số trong điểm cuối createTempCart khi tạo giỏ hàng tạm thời trong Hệ thống Zonos.

Ví dụ: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Khi một khách hàng được chuyển hướng đến trang này, hệ thống của bạn sẽ cần phân tích giá trị cho orderId từ URL. Bạn sẽ sau đó sử dụng orderId để gọi điểm cuối orderDetail để lấy dữ liệu đơn hàng.

Phần 2: Sử dụng một công việc theo lịch

Ngoài việc gọi để lấy chi tiết đơn hàng khi trang thành công được kích hoạt, chúng tôi khuyên bạn nên thiết lập một cuộc gọi theo lịch cho tất cả các đơn hàng và chi tiết của chúng như một biện pháp phòng ngừa. Bằng cách này, bạn có thể lấy bất kỳ đơn hàng đã hoàn thành nào trong Hệ thống Zonos mà chưa được nhập vào hệ thống của bạn.

Quá trình này nên là một công việc / kịch bản theo lịch, chẳng hạn như một công việc Cron, chạy một lần mỗi giờ / ca / ngày / v.v. (lên lịch thường xuyên như quy trình kinh doanh của bạn cho là cần thiết). Kịch bản nên gọi cho tất cả các đơn hàng và chi tiết của chúng đã xảy ra kể từ lần gọi đơn hàng cuối cùng. Điểm cuối orderNumbers cho phép bạn lấy các đơn hàng sinceOrderId hoặc sinceDate như đã được minh họa trên GUI thử nghiệm API nằm ở đây. Tất cả các đơn hàng được lấy qua cuộc gọi theo lịch này nên được đối chiếu với các đơn hàng đã được chèn vào hệ thống của bạn mỗi lần trang thành công được kích hoạt. Bất kỳ đơn hàng nào chưa có trong hệ thống của bạn nên được chèn vào hệ thống của bạn và được coi là đơn hàng hợp lệ.

Trạng thái đơn hàng ban đầu

IGLOBAL_ORDER_IN_PROCESS hoặc IGLOBAL_FRAUD_REVIEW

Khi gọi điểm cuối orderDetail, chúng tôi khuyên bạn nên hệ thống của bạn đầu tiên kiểm tra thuộc tính orderStatus của dữ liệu đơn hàng.

Các đơn hàng không yêu cầu xem xét gian lận sẽ khởi tạo với orderStatus : IGLOBAL_ORDER_IN_PROCESS. Một đơn hàng trong trạng thái này đã sẵn sàng để được xử lý và giao hàng.

Các đơn hàng yêu cầu xem xét gian lận sẽ khởi tạo trong orderStatus : IGLOBAL_FRAUD_REVIEW. Một đơn hàng trong trạng thái này hiện đang được sàng lọc và xem xét để phát hiện gian lận. Chúng tôi khuyên bạn nên đặt đơn hàng này ở trạng thái xem xét hoặc giữ trong hệ thống của bạn và tiếp tục gọi điểm cuối orderDetail cho đến khi đơn hàng tiến triển qua quy trình xem xét gian lận của Zonos.

Khi quy trình sàng lọc gian lận của Zonos hoàn tất, đơn hàng sẽ chuyển sang một trong các trạng thái sau:

• Đơn hàng vượt qua sàng lọc gian lận

  • Đơn hàng sẽ chuyển sang orderStatus : IGLOBAL_ORDER_IN_PROCESS và có thể tiếp tục đến giai đoạn giao hàng.

• Đơn hàng không vượt qua sàng lọc gian lận

  • Đơn hàng sẽ chuyển sang orderStatus : IGLOBAL_ORDER_CANCELLED và nên bị hủy trong hệ thống của bạn.

GUI thử nghiệm API

Vui lòng liên hệ hỗ trợ để biết thông tin tài khoản của bạn.