Dưới đây là các thuộc tính có thể có trong một yêu cầu đồng bộ hóa chuẩn như được nêu trong Đồng bộ hóa dữ liệu đơn hàng qua API.
Yêu cầu mục
| Thuộc tính | Mô tả | Bắt buộc/không bắt buộc | Ví dụ |
|---|---|---|---|
gtin | Đây là mã để xác định sản phẩm trong đơn hàng. | Bắt buộc | 9891998566P |
id | Đây là mã nhận dạng đơn hàng trong hệ thống của nhà bán lẻ. Nếu mã này không có sẵn thì CitrusAd sẽ tự động tạo một mã nhận dạng. | Không bắt buộc. | 3h30e938-c158-4d78-a0af-b48bbwfrcss4 |
orderDate | Đây là ngày hoặc ngày và giờ của đơn hàng. Mã này phải ở định dạng tiêu chuẩn ISO-8601 và phải là một dấu thời gian chính xác, đầy đủ, ví dụ: 2019-03-14T15:06:17+10:00. Phải ở thời gian UTC hoặc múi giờ được điều chỉnh theo ví dụ trên. | Bắt buộc | 2021-12-02T15:00:00Z |
catalogId | ID danh mục bạn đang đồng bộ hóa dữ liệu đơn hàng. Hữu ích cho việc đồng bộ hóa nhiều nhà bán lẻ thông qua API. Không áp dụng cho việc đồng bộ hóa tập tin. | Tùy chọn | 6adb93d0-7he4-4d4e-9b47-e5d3714c976a |
orderItems | Một mảng gồm tất cả mặt hàng được gửi trong đơn hàng. | Bắt buộc | [ { "gtin": "9891998566P", "quantity": 3, "regularUnitPrice": "1.00", "totalOrderItemPriceAfterDiscounts": "3.00" } ] |
quantity | Số lượng sản phẩm đặt hàng | Bắt buộc | 3 |
regularUnitPrice | Đơn giá thông thường của sản phẩm trong đơn hàng. | Tùy chọn | 2.99 |
sessionId | Đây là id được tạo mà bạn kiểm soát để xác định phiên của người dùng. CitrusAd có thể sử dụng id này để phân bổ mua hàng. | Bắt buộc trong quy trình tích hợp tiêu chuẩn | 5cat7-9964-4f |
totalOrderItemPriceAfterDiscounts | Đây là tổng giá của các sản phẩm được giảm giá. Ví dụ: nếu một mục đơn hàng có 3 mặt hàng với giá là 2,00, thì giá trị sẽ là 6.00. | Tùy chọn | 5.98 |
sellerId | Id không trùng lặp của người bán. Chỉ bắt buộc nếu đang hỗ trợ người bán trên thị trường trong những bước đầu tiên. Có thể để trống cho các sản phẩm không có trên thị trường. Khi tích hợp seller_id, phải chú ý đến một số yêu cầu bổ sung, vui lòng tham khảo sellerId cho sàn thương mại để biết thêm thông tin. | Tùy chọn | 73nns-32sxr-32ss Tùy chỉnh mỗi lần tích hợp |