Sipariş karşılama süresi ve ücretleri

Bu eğitimde şu konular ele alınmaktadır:

  1. Hangi ücret ve sipariş karşılama kullanım alanlarının desteklendiğine dair üst düzey bir açıklama
  2. Hizmet feed'leri için sipariş karşılama süresini ve ücretlerini belirtme ile ilgili ayrıntılı talimatlar.
  3. Doğruluk beklentileri

Sipariş karşılama süresinin ve ücretlerinin kullanımını gösteren tam bir feed örneği için Sipariş Yönlendirme EPA örneğine bakın.

Ücretler

Ücretleri belirtmek için çeşitli yöntemler sunuyoruz. Örneğin:

  • Sabit Ücret: "Teslimat ücreti 5 TL" veya "Hizmet ücreti 5 TL"
  • Yüzdelik Ücret: "%5 teslimat ücreti" veya "%5 hizmet ücreti"
  • Ücret Aralığı: "Teslimat Ücretleri 2-10 ABD doları"
  • Açık Uçlu Aralıklar "20 ABD dolarına kadar hizmet ücretleri"

Ücretler, teslimat ücreti veya hizmet ücreti olarak belirtilebilir. Birden fazla ücret de belirtebilirsiniz (ör. "%5 hizmet ücreti, 5 ABD doları teslimat ücreti").

Kullanıcıyla ilgili bilgilere göre ücretlerin değiştirilmesini gerektiren kullanım alanları desteklenmez.

Ücret örnekleri

Teslimat ve teslim alma ücretleri

Uygulama, "DELIVERY" (TESLİMAT) ve "SERVICE" (HİZMET) ücreti türlerini destekler.

Adrese teslim

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

Hizmet

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

Farklı ücret türleri

Aşağıda, seçilen bir ücret türünü belirtmek için kolayca kullanabileceğiniz bazı örnekler verilmiştir.

Düzeltildi

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

Alışveriş sepeti yüzdesi

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

Aralık

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

Sipariş Karşılama Süresi

Doğru veriler sağlamanıza yardımcı olmak için kullanılabilirlik zamanını belirtirken birkaç farklı biçim kullanmanıza izin veriyoruz. Aşağıdaki noktalarda, desteklenen farklı kullanım alanları ve kullanıcının ön uçta göreceğine benzer bazı örnek diller açıklanmaktadır.

  • Belirli Saatler: "30 dakikada teslim edilir" veya "15 dakikada teslim alınabilir"
  • Zaman aralıkları: "30 dakika-1 saat içinde teslim edilir" veya "15-20 dakika içinde teslim alınabilir"

Ortak bir biçim (aşağıda açıklanmıştır) kullanılarak hem teslim alma hem de teslimat için karşılama süresi belirtilebilir.

ETA'ların kullanıcıyla ilgili bilgilere göre değiştirilmesini gerektiren kullanım alanları desteklenmez.

Sipariş karşılama süresi örnekleri

İşlem bağlantıları için sipariş karşılama süresi, Hizmetler feed'indeki ETA iletiye FoodOrderingService alanı kapsamında dahil edilir.

Düzeltildi

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

Zaman aralığı

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

Sipariş karşılama zaman aralıkları

ServiceHours ile, belirli bir zaman aralığı için karşılama süreleri ayarlanabilir. Hizmet saatleri dışında FoodOrderingService içinde ayarlanan varsayılan lead_time kullanılır.

Bu örnekte, 2400s lead_time 11:00-13:30 saatleri arasında gösterilir.
1200s lead_time, 11:00'dan önce ve 13:30'dan sonra gösterilir. 
{
  "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"
            }
          }
        ]
      }
    }
  ]
}

Ücret ve sipariş karşılama süresi doğruluğu

Ücret doğruluğu

Bir satıcı için ücret verileri sağladığınızda, ücretlerinizin doğru bir şekilde gösterilmesini sağlamanız gerekir. Sipariş için geçerli olabilecek tüm teslimat ve hizmet ücretlerini eklemeniz gerekir.

Ücretlerin zaman içinde ve kullanıcılara göre değişebileceğini kabul ediyoruz. Bu nedenle, açık uçlu aralıklar da dahil olmak üzere ücretleri aralık olarak belirtebilme olanağı sunuyoruz. Ücretlerin önemli ölçüde değişebileceği durumlarda, sağlanan aralığın kullanıcının işlemi sırasında görebileceği ücretleri kapsadığından emin olun.

Hangi işlemlerin gerekli olduğundan emin değilseniz İşlemler Merkezi'ndeki ilgili kişinizle iletişime geçin.

Sipariş karşılama süresinin doğruluğu

Sipariş karşılama süresinin ayrıntılarının çeşitli faktörlere bağlı olarak değiştiğinin farkındayız. Bu faktörler şunlardır:

  • Sipariş boyutuna göre sipariş karşılama süresinde yapılan değişiklikler
  • Sipariş verme ve ödeme işlemlerinin tamamlanma süresine göre sipariş karşılama süresinde yapılan değişiklikler
  • Sipariş karşılama süresi değişikliklerinin feed'ler aracılığıyla güncellenmesi arasındaki gecikme
  • Kullanıcının teslimat adresi.

Bu faktörlerden herhangi biri, başlangıçta kullanıcıya gösterilen sipariş karşılama süresinin, ödeme sırasında göreceği tam karşılama süresi olmadığı durumlara yol açabilir. Karşılanma süresinin uygulanmasının amacı bu süreleri tamamen ortadan kaldırmak değil, kullanıcılara mümkün olduğunca sık net bilgiler vermektir.

İş ortaklarının, mümkün olduğunca sık bir şekilde ve en iyi çabayı göstererek kullanıcılara doğru karşılama süresini gösteren bir uygulama sağlaması beklenir. Bu faktörler nedeniyle zamanlamada önemli bir değişkenlik varsa bu değişkenliği kapsayan bir zaman aralığı belirtmenizi öneririz. Ayrıca, sipariş ayrıntıları nedeniyle karşılama süresi değişirse bu durum, sipariş akışınıza ulaştıklarında kullanıcılara net bir şekilde gösterilmelidir.

Özellikle hangi bilgilerin gerekli olduğundan emin değilseniz İşlemler Merkezi'ndeki ilgili kişinizle iletişime geçin.

Ücretler ve tahmini varış zamanlarıyla ilgili zamanında güncellemeler

Normal bir feed yüklemesi kullanılarak yapılan değişikliklerin işlenmesi en az 2 saat sürebilir. Bu durum, özellikle TVS'leri sık sık değiştirmeyi planlıyorsanız önemlidir.

İş ortaklarının, anlık güncellemeleri uygulaması önemle tavsiye edilir. Bu özellik, hizmet feed'inin (ücretler ve tahmini varış süreleri dahil) 5 dakika veya daha kısa bir süre içinde değiştirilmesini sağlayan bir API çağrısı yapılmasını mümkün kılar.

Önceki
Hizmet feed'i
Sonraki
Feed proto paketi