Hướng dẫn này sẽ hướng dẫn bạn:
- Mô tả chung về những trường hợp sử dụng phí và thời gian thực hiện được hỗ trợ
- Hướng dẫn cụ thể về cách chỉ định thời gian và phí thực hiện đơn đặt hàng cho Nguồn cấp dữ liệu dịch vụ.
- Kỳ vọng về độ chính xác
Để xem mẫu nguồn cấp dữ liệu đầy đủ cho thấy cách sử dụng thời gian và phí thực hiện đơn đặt hàng, hãy xem mẫu EPA chuyển hướng đặt hàng.
Phí
Chúng tôi cung cấp một số cách để chỉ định phí, chẳng hạn như:
- Phí cố định: "Phí giao hàng 50.000 VND" hoặc "Phí dịch vụ 50.000 VND"
- Phí theo tỷ lệ phần trăm: "Phí giao hàng 5%" hoặc "Phí dịch vụ 5%"
- Phạm vi phí: "Phí giao hàng từ 2 đến 10 đô la"
- Phạm vi mở "Phí dịch vụ tối đa 200.000 VND"
Bạn có thể chỉ định phí dưới dạng phí giao hàng hoặc phí dịch vụ. Bạn cũng có thể chỉ định nhiều khoản phí (ví dụ: "Phí dịch vụ 5%, Phí giao hàng 50.000 VND").
Không được hỗ trợ là những trường hợp sử dụng yêu cầu thay đổi phí dựa trên thông tin về người dùng.
Ví dụ về phí
Phí giao hàng và đến lấy hàng
Ứng dụng hỗ trợ các loại phí "DELIVERY" và "SERVICE".Giao hàng
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
Dịch vụ
{ "fee": { "fee_id": "12345/service_fee", "fee_type": "SERVICE", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
Các loại phí khác nhau
Sau đây là một số ví dụ dễ sử dụng để chỉ định loại phí đã chọn.Cố định
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
Tỷ lệ phần trăm giỏ hàng
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "cart_percentage": { "base_value": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "percentage_of_cart_value": 10 }, "service_ids": [ "service/entity002" ] } }
Phạm vi
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "range_amount": { "min_amount": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "max_amount": { "currency_code": "USD", "units": 5, "nanos": 600000000 } }, "service_ids": [ "service/entity002" ] } }
Thời gian thực hiện đơn hàng
Chúng tôi cho phép sử dụng nhiều định dạng khác nhau để chỉ định thời gian có thể sử dụng nhằm đảm bảo bạn cung cấp dữ liệu chính xác. Các điểm sau đây mô tả những trường hợp sử dụng được hỗ trợ, cùng với một số ví dụ về ngôn ngữ tương tự như những gì người dùng sẽ thấy trên giao diện người dùng.
- Thời gian cố định: "Giao hàng trong 30 phút" hoặc "Đến lấy hàng trong 15 phút"
- Phạm vi thời gian: "Giao hàng trong 30 phút đến 1 giờ" hoặc "Đến lấy hàng trong 15 đến 20 phút"
Bạn có thể chỉ định thời gian thực hiện đơn hàng cho cả hình thức lấy tại cửa hàng và giao hàng bằng một định dạng chung (được mô tả bên dưới).
Không được hỗ trợ các trường hợp sử dụng yêu cầu ETA thay đổi dựa trên thông tin về người dùng.
Ví dụ về thời gian thực hiện đơn hàng
Thời gian thực hiện đơn đặt hàng cho đường liên kết đến hành động được đưa vào thông báo Nguồn cấp dữ liệu dịch vụ ETA, trong trường FoodOrderingService.
Cố định
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" }, "action_link_id": "action-link-id" } },
Phạm vi thời gian
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" "max_lead_time_duration": "1200s" }, "action_link_id": "action-link-id" } },
Khoảng thời gian thực hiện đơn hàng
Với ServiceHours, bạn có thể đặt thời gian thực hiện đơn hàng cho một khoảng thời gian cụ thể. lead_time mặc định được đặt trong FoodOrderingService sẽ được dùng khi nằm ngoài khoảng thời gian hoạt động của dịch vụ.
lead_time của 2400s sẽ xuất hiện từ 11:00 đến 13:30.
lead_time của 1200s sẽ xuất hiện trước 11:00 và sau 13:30.
{ "data": [ { "service": { "service_id": "merchant-1-service-delivery", "service_type": "DELIVERY", "parent_entity_id": "merchant-1", "lead_time": { "min_lead_time_duration": "1200s" }, "action_link_id": "merchant-1-takeout-delivery-action" } }, { "service_hours": { "hours_id": "merchant-1-advance-hours-delivery", "service_ids": ["merchant-1-service-delivery"], "asap_hours": [ { "time_windows": { "time_windows": { "open_time": { "hours": 11 }, "close_time": { "hours": 13, "minutes": 30 } } }, "lead_time": { "min_lead_time_duration": "2400s" } } ] } } ] }
Độ chính xác của phí và thời gian thực hiện đơn hàng
Độ chính xác của phí
Khi cung cấp dữ liệu về phí cho một người bán, bạn phải cung cấp thông tin chính xác về các khoản phí của mình. Bạn nên thêm tất cả phí giao hàng và phí dịch vụ có thể áp dụng cho một đơn đặt hàng.
Chúng tôi hiểu rằng các khoản phí có thể thay đổi theo thời gian và tuỳ theo người dùng. Vì lý do này, chúng tôi cung cấp khả năng chỉ định phí dưới dạng phạm vi, bao gồm cả phạm vi mở. Trong trường hợp các khoản phí có thể thay đổi đáng kể, hãy đảm bảo rằng phạm vi bạn cung cấp bao gồm các khoản phí mà người dùng có thể thấy trong giao dịch của họ.
Nếu bạn không chắc chắn về những yêu cầu cụ thể trong trường hợp của mình, hãy liên hệ với người liên hệ của bạn tại Actions Center.
Độ chính xác về thời gian thực hiện đơn đặt hàng
Chúng tôi hiểu rằng thời gian thực hiện đơn đặt hàng cụ thể sẽ thay đổi dựa trên nhiều yếu tố. Các yếu tố này bao gồm:
- Thay đổi thời gian thực hiện đơn đặt hàng dựa trên quy mô đơn đặt hàng
- Thay đổi thời gian thực hiện đơn đặt hàng dựa trên thời gian hoàn tất việc đặt hàng và thanh toán
- Độ trễ giữa thời điểm bạn cập nhật thời gian thực hiện đơn đặt hàng thông qua nguồn cấp dữ liệu
- Địa chỉ giao hàng của người dùng.
Bất kỳ yếu tố nào trong số này đều có thể dẫn đến tình huống mà thời gian thực hiện đơn hàng mà người dùng nhìn thấy ban đầu không phải là thời gian thực hiện chính xác mà họ sẽ thấy khi thanh toán. Mục tiêu của việc triển khai thời gian thực hiện đơn hàng không phải là loại bỏ hoàn toàn những yếu tố này, mà là cung cấp thông tin rõ ràng cho người dùng thường xuyên nhất có thể.
Đối tác phải cung cấp một cách triển khai giúp hiển thị thời gian thực hiện chính xác cho người dùng thường xuyên nhất có thể, trên cơ sở nỗ lực hết mình. Nếu có sự khác biệt đáng kể về thời gian do những yếu tố này, bạn nên cung cấp một khoảng thời gian bao gồm sự khác biệt đó. Ngoài ra, nếu thời gian thực hiện thay đổi do thông tin chi tiết về đơn đặt hàng, thì bạn phải cho người dùng thấy rõ điều này khi họ truy cập vào quy trình đặt hàng.
Nếu bạn không chắc chắn về những yêu cầu cụ thể trong trường hợp của mình, hãy liên hệ với người liên hệ của bạn tại Trung tâm hành động.
Thông tin cập nhật kịp thời về Phí và ETA
Mọi thay đổi khi sử dụng phương thức tải nguồn cấp dữ liệu thông thường có thể mất ít nhất 2 giờ để xử lý. Bạn đặc biệt cần lưu ý điều này nếu dự định thay đổi Giờ đến dự kiến thường xuyên.
Đối tác nên triển khai Thông tin cập nhật theo thời gian thực. Tính năng này cho phép lệnh gọi API thay đổi Nguồn cấp dữ liệu dịch vụ (bao gồm cả phí và thời gian dự kiến đến) trong vòng 5 phút hoặc ít hơn.