Hướng dẫn này sẽ trình bày:
- Nội dung mô tả chung về những trường hợp sử dụng phí và thời gian thực hiện đơn hàng đượ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 mức sử dụng thời gian và phí thực hiện đơn đặt hàng, vui lòng xem mẫu EPA chuyển hướng đơn đặt hàng.
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"
- Tỷ lệ phần trăm phí: "Phí giao hàng 5%" hoặc "Phí dịch vụ 5%"
- Phạm vi phí: "Phí giao hàng $2 đến $10" hoặc "Phí dịch vụ 3%-6%"
- Phạm vi không kết thúc "Phí giao hàng từ 5%" hoặc "Phí dịch vụ tối đa 20 USD"
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 thay đổi phí 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ột 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 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 đang cung cấp dữ liệu chính xác. Các điểm sau đây mô tả các trường hợp sử dụng được hỗ trợ, cùng với một số ngôn ngữ mẫu tương tự như ngôn ngữ mà 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 trong 30 phút đến 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ả dịch vụ đến lấy hàng và giao hàng bằng một định dạng chung (như mô tả dưới đây).
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 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"
}
},
Tính chính xác về phí và 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 về các khoản phí. 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 cho phép bạn chỉ định mức phí theo 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 được cung cấp bao gồm cả các khoản phí mà người dùng có thể thấy trong giao dịch.
Nếu bạn không chắc chắn các 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 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ể về thời gian thực hiện đơn hàng 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 hàng dựa trên số lượng đơn hàng
- Những thay đổi đối với thời gian thực hiện đơn đặt hàng dựa trên thời gian hoàn tất quy trình đặ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 trường hợp 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 đơ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 dữ liệu này, mà là cung cấp thông tin rõ ràng cho người dùng nhất có thể.
Đối tác nên cố gắng hết sức để hỗ trợ việc triển khai sao cho thời gian thực hiện đơn hàng chính xác sẽ được hiển thị cho người dùng thường xuyên nhất có thể. Nếu có sự thay đổi đáng kể về thời gian do những yếu tố này, bạn nên đưa ra nhiều 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 về đơn đặt hàng, thì bạn phải thông báo rõ ràng cho người dùng về thời gian thực hiện đơn hà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 các 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 Actions Center.
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 bằng cách 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 cần lưu ý nếu bạn có kế hoạch thay đổi ETA thường xuyên.
Đối tác nên triển khai tính năng Cập nhật theo thời gian thực để 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à ETA) trong vòng tối đa 5 phút.