Waktu dan Biaya Pemenuhan Pesanan

Tutorial ini akan memandu Anda:

  1. Deskripsi tingkat tinggi tentang biaya & Kasus penggunaan waktu pemenuhan didukung
  2. Petunjuk khusus tentang cara menentukan waktu dan biaya pemenuhan pesanan untuk Feed layanan.
  3. Ekspektasi untuk akurasi

Untuk contoh feed lengkap yang menunjukkan penggunaan waktu dan biaya pemenuhan pesanan, lihat Contoh Pengalihan Pemesanan EPA.

Biaya

Kami menyediakan beberapa cara untuk menentukan biaya, seperti:

  • Biaya Tetap: "Biaya pengiriman $5" atau "Tarif layanan $5"
  • Biaya Persentase: "Biaya pengiriman 5%" atau "Tarif layanan 5%"
  • Kisaran Biaya: "Biaya Pengiriman Rp20.000-Rp100.000" atau "Tarif Layanan 3%-6%"
  • Rentang Terbuka yang Terbuka "Biaya Pengiriman mulai dari 5%" atau "Tarif Layanan hingga $20"

Biaya dapat ditentukan sebagai biaya pengiriman atau biaya layanan. Anda juga dapat menentukan beberapa biaya (misalnya, "Tarif layanan 5%-10%, Biaya Pengiriman $5").

Yang tidak didukung adalah kasus penggunaan yang memerlukan biaya untuk berubah berdasarkan informasi tentang pengguna.

Contoh Biaya

Biaya Pengiriman dan Pengambilan

Aplikasi mendukung jenis biaya `PENGIRIMAN` dan `SERVICE`.

Pengiriman

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

Layanan

{
  "fee": {
    "fee_id": "12345/service_fee",
    "fee_type": "SERVICE",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

Jenis biaya yang berbeda-beda

Berikut ini beberapa contoh yang mudah digunakan untuk menentukan biaya yang dipilih .

Tetap

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

Persentase keranjang

{
  "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"
    ]
  }
}

Rentang

{
  "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"
    ]
  }
}

Waktu Pemenuhan Pesanan

Kami mengizinkan beberapa format berbeda untuk menentukan waktu ketersediaan guna menyediakan data yang akurat. Poin-poin berikut menjelaskan berbagai kasus penggunaan yang didukung, beserta di mana beberapa contoh bahasa yang mirip dengan yang akan dilihat pengguna di frontend.

  • Waktu Tetap: "Dikirim dalam 30 menit" atau "Ambil dalam 15 menit"
  • Rentang Waktu: "Dikirim dalam 30 menit-1 jam" atau "Ambil dalam 15-20 menit"

Waktu pemenuhan dapat ditentukan untuk pengambilan dan pengiriman menggunakan format umum (dijelaskan di bawah).

Tidak didukung adalah kasus penggunaan yang memerlukan perubahan PWT berdasarkan informasi pengguna.

Contoh waktu pemenuhan pesanan

Waktu pemenuhan pesanan untuk link tindakan disertakan dalam feed Layanan ETA pesan, sebagai bagian dari FoodOrderingService kolom tersebut.

Tetap

{
    "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"
    }
},

Rentang waktu

{
    "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"
    }
},

Periode waktu pemenuhan pesanan

Dengan ServiceHours, waktu pemenuhan dapat disetel untuk periode waktu tertentu. Default lead_time ditetapkan di FoodOrderingService telah digunakan saat berada di luar periode jam layanan.

Dalam contoh ini, lead_time dari 2400s akan ditampilkan dari 11.00 hingga 13.30.
lead_time dari 1200s akan ditampilkan sebelum 11.00 dan setelah 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"
            }
          }
        ]
      }
    }
  ]
}

Biaya & akurasi waktu pemenuhan

Akurasi biaya

Saat Anda memberikan data biaya untuk penjual, kami harap Anda dapat memberikan representasi yang akurat dari biaya Anda. Anda harus menyertakan semua tarif pengiriman dan layanan yang mungkin berlaku untuk pesanan.

Kami menyadari bahwa biaya dapat bervariasi dari waktu ke waktu dan pada setiap pengguna. Oleh karena itu, kami menawarkan kemampuan untuk menentukan biaya sebagai rentang, termasuk rentang terbuka. Jika biaya dapat bervariasi sangat yakin bahwa kisaran yang diberikan mencakup biaya yang dapat dilihat pengguna selama untuk transaksi mereka.

Jika Anda tidak yakin secara spesifik tentang apa yang diperlukan dalam kasus Anda, hubungi Kontak Actions Center.

Akurasi waktu pemenuhan pesanan

Kami memahami bahwa detail pemenuhan pesanan perubahan waktu berdasarkan berbagai faktor. Faktor-faktor ini mencakup:

  • Perubahan pada waktu pemenuhan pesanan berdasarkan ukuran pesanan
  • Perubahan terhadap waktu pemenuhan pesanan berdasarkan waktu untuk menyelesaikan pemesanan dan {i>checkout<i}
  • Latensi antara saat perubahan waktu pemenuhan pesanan diperbarui melalui feed
  • Alamat pengiriman pengguna.

Salah satu faktor tersebut dapat mengarah pada situasi di mana pemenuhan pesanan waktu yang ditampilkan kepada pengguna awalnya bukan waktu pemenuhan yang tepat yang mereka yang akan Anda lihat saat checkout. Sasaran penerapan waktu pemenuhan bukan untuk menghilangkannya sepenuhnya, tetapi untuk memberikan informasi yang jelas kepada pengguna sebagai sesering mungkin.

Partner diharapkan memberikan penerapan yang mengarah pada waktu pemenuhan yang ditampilkan kepada pengguna sesering mungkin, dengan upaya terbaik layanan. Jika ada variabilitas waktu yang signifikan karena faktor-faktor ini, sebaiknya Anda memberikan rentang waktu yang mencakup variabilitas tersebut. Selain itu, jika waktu pemenuhan berubah karena detail pesanan, hal ini harus ditunjukkan dengan jelas kepada pengguna ketika data tersebut tiba dalam alur pemesanan Anda.

Jika Anda tidak yakin secara spesifik tentang apa diperlukan dalam kasus Anda, hubungi kontak Actions Center Anda.

Pembaruan Biaya dan PWT tepat waktu

Setiap perubahan yang menggunakan upload feed normal dapat memerlukan waktu setidaknya 2 jam untuk diproses. Hal ini sangat penting untuk diperhatikan jika Anda berencana untuk mengubah PWT secara rutin.

Partner sangat dianjurkan untuk menerapkan Update Real-time, yang memungkinkan panggilan API mengubah Feed layanan (termasuk biaya dan PWT) dalam waktu 5 menit atau kurang.

Sebelumnya
Feed layanan
Berikutnya
Paket proto feed