Hướng dẫn này sẽ trình bày:
- Mô tả chung về mức phí và mức phí có hỗ trợ các trường hợp sử dụng thời gian thực hiện đơn hàng
- Hướng dẫn cụ thể về cách chỉ định thời gian thực hiện đơn đặt hàng và phí 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 biết mức sử dụng thời gian và phí thực hiện đơn hàng, hãy truy cập vào Mẫu chuyển hướng đơn đặt hàng EPA.
Phí
Chúng tôi đưa ra một số cách để chỉ định mức phí, chẳng hạn như:
- Phí cố định: "Phí giao hàng 5 USD" hoặc "Phí dịch vụ 5 USD"
- Phần trăm phí: "5% phí giao hàng" hoặc "Phí dịch vụ 5%"
- Phạm vi phí: "Phí giao hàng từ 2 đến 10 USD" hoặc "Phí dịch vụ 3%-6%"
- Phạm vi đã kết thúc mở "Phí giao hàng bắt đầu ở mức 5%" hoặc "Phí dịch vụ tối đa $20"
Phí có thể được chỉ định là 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% – 10%, Phí giao hàng 5 USD").
Không được hỗ trợ là những trường hợp sử dụng yêu cầu phí thay đổi dựa trên thông tin về người dùng.
Ví dụ về các loại phí
Phí giao hàng và đến lấy hàng
Ứng dụng hỗ trợ các loại phí "PHÂN PHỐI" và "Dịch vụ".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 mức phí đã chọn loại.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 một số định dạng khác nhau để chỉ định thời gian có thể sử dụng nhằm giúp đảm bảo bạn cung cấp dữ liệu chính xác. Các điểm sau mô tả các trường hợp sử dụng khác nhau được hỗ trợ, cùng với bằng một số ngôn ngữ mẫu tương tự với 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 sau 15 phút"
- Phạm vi thời gian: "Giao hàng sau 30 phút-1 giờ" hoặc "Đến lấy hàng sau 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 đến lấy hàng và giao hàng bằng một định dạng chung (như mô tả bên dưới).
Không được hỗ trợ là những trường hợp sử dụng yêu cầu ETA phải 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 các đường liên kết hành động được đưa vào nguồn cấp dữ liệu Dịch vụ
ETA
như một phần của
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" } },
Khung thời gian thực hiện đơn hàng
Với ServiceHours,
có thể đặt thời gian thực hiện đơn hàng cho một khoảng thời gian cụ thể. Mặc định
lead_time được thiết lập ở
FoodOrderingService được sử dụng
khi nằm ngoài khung giờ bảo dưỡng.
lead_time của
2400s sẽ được hiển thị từ 11:00 sáng đến 1:30 chiều.
lead_time trong số 1200s sẽ được hiển thị trước
11 giờ sáng và sau 1:30 chiều.
{ "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" } } ] } } ] }
Phí & độ chính xác của thời gian thực hiện đơn hàng
Tính chính xác về phí
Khi bạn cung cấp dữ liệu về các khoản phí cho một người bán, chúng tôi mong bạn cung cấp thông tin trình bày chính xác phí của bạn. Bạn phải thêm tất cả phí giao hàng và phí dịch vụ có thể áp dụng cho đơn đặt hàng.
Chúng tôi nhận thấy rằng các khoản phí có thể thay đổi theo thời gian và đối với 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 phí có thể thay đổi cần đảm bảo chắc chắn rằng phạm vi được cung cấp bao gồm cả các khoản phí mà người dùng có thể thấy trong khoảng thời gian giao dịch của họ.
Nếu bạn không chắc chắn về các yêu cầu cụ thể trong trường hợp của mình, hãy liên hệ với Địa chỉ liên hệ của Actions Center.
Tính chính xác về thời gian thực hiện đơn hàng
Chúng tôi hiểu rằng các chi tiết cụ thể trong việc thực hiện đơn hàng thay đổi thời gian 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 hàng dựa trên số lượng đơn 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ễ tính từ thời điểm các thay đổi về thời gian thực hiện đơn đặt hàng được cập nhật 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 thực hiện đơn hàng thời gian hiển thị cho người dùng ban đầu không phải là thời gian thực hiện đơn hàng 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 không phải là loại bỏ hoàn toàn những vấn đề này, nhưng 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 cần cung cấp phương thức triển khai dẫn đến thời gian thực hiện đơn hàng mà người dùng nhìn thấy thường xuyên nhất có thể, với nỗ lực tối đa cơ sở. Nếu có sự thay đổi đáng kể về thời gian do những yếu tố này, bạn nên bạn cung cấp khoảng thời gian bao gồm sự biến đổi đó. Ngoài ra, nếu thời gian thực hiện đơn hàng thay đổi do thông tin chi tiết của đơn đặt hàng, thông tin này phải được hiển thị rõ ràng cho người dùng khi hàng đến trong quy trình đặt hàng của bạn.
Nếu bạn không chắc chắn về là bắt buộc trong trường hợp của bạn, hãy liên hệ với người liên hệ Actions Center của bạn.
Cập nhật kịp thời các khoản Phí và thời gian đến dự kiến
Mọi thay đổi khi tải nguồn cấp dữ liệu lên thông thường đều có thể mất ít nhất 2 giờ để xử lý. Điều này đặc biệt quan trọng nếu bạn có kế hoạch thay đổi ETA thường xuyên.
Đối tác rất nên triển khai Thông tin cập nhật theo thời gian thực, cho phép một lệnh gọi API thay đổi Nguồn cấp dữ liệu dịch vụ (bao gồm cả các khoản phí và thời gian đến dự kiến) trong vòng tối đa 5 phút.