Thời gian thực hiện đơn hàng và phí (chỉ dành cho phiên bản cũ)

Hướng dẫn này sẽ hướng dẫn bạn:

Nội dung mô tả tổng quan về các 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 thực hiện đơn đặt hàng và phí cho (các) action_link trong nguồn cấp dữ liệu
Kỳ vọng về độ chính xác

Để xem mẫu nguồn cấp dữ liệu đầy đủ cho biết thời gian thực hiện đơn đặt hàng và phí, hãy xem Mẫu EPA về việc chuyển hướng đơn đặt hàng.

Các trường hợp sử dụng phí và thời gian thực hiện

Các trường hợp sử dụng phí

Chúng tôi cung cấp một số cách để chỉ định phí. Các điểm dưới đâ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ư nội dung người dùng sẽ thấy trên giao diện người dùng.

Phí cố định: "Phí giao hàng 5 USD" hoặc "Phí dịch vụ 5 USD"
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 USD" hoặc "Phí dịch vụ từ 3 đến 6%"
Dải ô mở: "Phí giao hàng từ 5%" hoặc "Phí dịch vụ lên đến 20 USD"

Như trong các ví dụ ở trên, bạn có thể chỉ định phí 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").

Chúng tôi không hỗ trợ các trường hợp sử dụng yêu cầu cập nhật phí trong suốt cả ngày hoặc thay đổi dựa trên thông tin về người dùng.

Các trường hợp sử dụng Thời gian thực hiện đơn hàng

Chúng tôi cho phép một số định dạng để chỉ định thời gian có sẵn nhằm đảm bảo bạn cung cấp dữ liệu chính xác. Các điểm dưới đâ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ư nội dung người dùng sẽ thấy ở giao diện người dùng.

Thời gian cố định: "Giao hàng trong 30 phút" hoặc "Nhận hàng trong 15 phút"
Phạm vi thời gian: "Giao hàng trong vòng 30 phút đến 1 giờ" hoặc "Nhận hàng trong vòng 15 đến 20 phút"
Phạm vi thời gian mở: "Giao hàng trong hơn 10 phút" hoặc "Nhận hàng trong vòng chưa đến 1 giờ"

Bạn có thể chỉ định thời gian thực hiện đơn hàng cho cả phương thức đến lấy hàng và giao hàng bằng một định dạng phổ biến (như mô tả bên dưới). Như trong các ví dụ ở trên, văn bản hiển thị cho người dùng sẽ phản ánh loại thực hiện được chỉ định trong đường liên kết hành động.

Chúng tôi không hỗ trợ các trường hợp sử dụng yêu cầu cập nhật thời gian trong ngày hoặc thay đổi dựa trên thông tin về người dùng.

Chỉ định thời gian thực hiện đơn đặt hàng thông qua nguồn cấp dữ liệu

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 action_link của nguồn cấp dữ liệu Người bán, trong trường food_ordering_metadata. Đối với mỗi action_link được liên kết với người bán, bạn phải cung cấp thông tin thực hiện đơn hàng bằng một trong các đường dẫn thông báo.

Thời gian thực hiện cố định

Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Thông báo này phải có định dạng như sau:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

Thời gian thực hiện đơn hàng theo phạm vi

Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Thông báo này phải có định dạng như sau:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

Cảnh báo: Không chỉ định cả fulfillment_lead_time_duration và fulfillment_lead_time_duration_range trong một đối tượng action_link duy nhất.

Lưu ý: fulfillment_lead_time_duration, fulfillment_lead_time_duration_range.min_duration, fulfillment_lead_time_duration_range.max_duration thuộc loại google.protobuf.Duration và cung cấp cho người dùng ETA cho hành động thực hiện.

Chỉ định phí thông qua nguồn cấp dữ liệu

Tương tự như thời gian thực hiện đơn đặt hàng, bạn có thể thêm phí vào thông báo action_link trong trường food_ordering_metadata. Đối với mỗi action_link liên kết với một người bán, bạn có thể cung cấp thông tin về phí bằng cách sử dụng đường dẫn thông báo:

merchant.action_link.food_ordering_metadata.fee_details

Dưới đây là một số ví dụ về các trường hợp sử dụng khác nhau.

Phí giao hàng cố định là 1,99 USD:

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]

Phí giao hàng theo tỷ lệ phần trăm là 5,6%.

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]

Phí dịch vụ từ 1,99 đến 9,99 USD

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]

Phí dịch vụ theo tỷ lệ phần trăm từ 1,2% đến 2,7%

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]

Hai khoản phí, phí dịch vụ là 5 đô la và phí giao hàng là 1, 2%.

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Lưu ý: Mục nhập amount và amount_range thuộc loại google.type.Money

Độ 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 người bán, bạn phải cung cấp thông tin chính xác về phí của mình. Bạn nên thêm tất cả phí vận chuyển 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 phí có thể thay đổi theo thời gian và giữa các người dùng. Vì lý do này, chúng tôi cung cấp tính 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 đá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 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ệ phụ trách Trung tâm hành động.

Độ chính xác về thời gian thực hiện đơn hàng

Chúng tôi hiểu rằng thông tin chi tiết về thời gian thực hiện đơn đặt hàng 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 kích thước đơ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 đơn đặt hàng và thanh toán
Độ trễ giữa thời điểm cập nhật thay đổi về 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 cũng có thể dẫn đến trường hợp thời gian thực hiện đơn đặt hàng ban đầu hiển thị cho người dùng 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 vấn đề 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 cần triển khai để thời gian thực hiện đơn hàng được hiển thị chính xác cho người dùng thường xuyên nhất có thể, trên cơ sở nỗ lực tốt nhất. Nếu thời gian có sự thay đổi đáng kể 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ự thay đổ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 cho người dùng thấy rõ điều này khi họ đến 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.