HX Slot/Poligon Entegrasyonu Önemli Bilgiler

📘

Önemli

Slot/Poligon Entegrasyonu methodlarımız ile ilgili sorularınız olması durumunda Sıkça Sorulan Sorular sayfamızı ziyaret edebilirsiniz.

❗️

Not

Slot yönetimi, anlık/hızlı teslimat tipinde yapılamamaktadır.

Taşımacılık Hepsiburada üzerinden ilerliyor ise satıcılarımız Slot Yönetimi sağlayamamaktadır.

Slot Bilgisi Alma

Bu method Hepsiburada sistemimizdeki slot bilgilerini ve tiplerini görüntülemenize olanak tanır.Mağazalarınıza/bayilerinize sadece Hepsiburada sistemimizde tanımlı olan slot bilgilerini ve tiplerini eşleştirebilirsiniz.Eğer ilgili bilgilerden farklı bir bilgi eşleştirmek isterseniz bilginizin sistemimize kayıt olabilmesi adına Ticari ekibimiz ile iletişime geçmelisiniz.Kayıt sonrası eşleştirme sağlayabilirsiniz.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
slotTypes
Slot tipleri listesi.
slotTypes.slotId
Slotun unique id değeri.
slotTypes.intervalInMinute
Slotun dakikası.
slotTypes.instantDelivery
Slotun teslimat tipi.true:anlık/hızlı teslimat , false:randevulu teslimat.

Mağaza/Bayi Slot Bilgisi Eşleştirme/Var Olanı Güncelleme

Bu method ile mağazanıza/bayinize Hepsiburada sistemimizden temin ettiğiniz slot bilgisi ile tanım eşleştirebilir ve mağazanızda/bayinizde var olan eşleşmiş slot tanımını güncelleyebilirsiniz.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
Slots.slotId
Slotun unique id değeri.
Slots.slottag
Slotun teslimat tipi. "slotTag": "TH" Randevulu teslimat. "slotTag": "WAFFM" 45 dk hızlı teslimat.
Slots.CutOffTimeInMinute
Slotun cutoff süresi.instant(anlık teslimat) slotlar için cutoff bilgisi 0 olmalıdır.
Slots.instantDelivery
Slotun teslimat tipi.true:anlık/hızlı teslimat , false:randevulu teslimat.

Slot Tanımı Kontrolü

Bu method mağazanızda/bayinizde tanımlı olan güncel slot bilgilerini ve tiplerini görüntülemenize olanak tanır.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
merchantId
Her satıcının unique bir tanımlayıcısıdır.
definedSlots
Merchantta tanımlı olan slot listesi.
definedSlots.slotId
Slotun unique id değeri.
definedSlots.slotTag
Slotun teslimat tipi. "slotTag": "TH" Randevulu teslimat. "slotTag": "WAFFM" 45 dk hızlı teslimat.

Slot Açma

Bu method girilen tarih için mağaza/bayi özelinde herhangi bir kayıt yoksa yaratır, varsa statüsünü aktif eder.Mağaza/bayide mutlaka bu slotid'nin tanımlı olma şartı bulunmaktadır.Bu işlem öncesinde mağazanızda/bayinizde kayıtlı slotid bilgilerini bir önceki adım olan Slot Tanımı Kontrolü methodunu kullanarak öğrenmelisiniz.

Süreç Bulk(toplu) olarak yönetilebilir.

Multipoligon(zone) bazlı yönetime sahip olan satıcılarımız methodunu kullanmalıdır.

Multipoligon(zone) bazlı yönetime sahip olan satıcılarımız süreci methodunu kullanarak bulk(toplu)şekilde yönetebilir.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
SlotId
Slotun unique id değeri.
SlotDate
Slotun aktif edileceği/yaratılacağı tarih.
MerchantId
Her satıcının unique bir tanımlayıcısıdır.
SlotLimit
Slota belirlediğiniz limit. (Opsiyoneldir).

❗️

Not

406 Not Acceptable: Merchantta tanımlı olmayan SlotId bilgisi girildiğinde alınan hatadır.

400 Bad Request: SlotDate parametresinin geçmiş tarihli belirtmesi ile ilgili alınan hatadır.

Slot Kapatma

🚧

Bilgi

Slot saatinden 1 saat önce sistem otomatik olarak saat aralığını son kullanıcıya pasif hale getirir.

Bu method mağaza/bayi özelinde açık bir şekilde var olan slot bilgisini pasif duruma getirir.Bu işlem öncesinde mağazanızda/bayinizde kayıtlı slotid bilgilerini bir önceki adım olan Slot Tanımı Kontrolü methodunu kullanarak öğrenmelisiniz.

Süreç Bulk(toplu) olarak yönetilebilir.

Multipoligon(zone) bazlı yönetime sahip olan satıcılarımız methodunu kullanmalıdır.

Multipoligon(zone) bazlı yönetime sahip olan satıcılarımız süreci methodunu kullanarak bulk(toplu)şekilde yönetebilir.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
SlotId
Slotun unique id değeri.
SlotDate
Slotun pasif edileceği tarih.
MerchantId
Her satıcının unique bir tanımlayıcısıdır.

Slot Açma/Kapatma Kontrolü

Slot Açma ve Slot Kapatma methodlarındaki işlemlerinizin nihai sonucunu bu method ile öğrenebilirsiniz.slotStatus alanına bakmanızı öneririz.

Methodunu kullanarak nihai sonucu öğrenebilirsiniz.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
SlotId
Slotun unique id değeri.
Date
Slotun tarihi.
MerchantId
Her satıcının unique bir tanımlayıcısıdır.
slotStatus
Slotu statü durumu.false:kapalı,true:açık.

Methodunu kullanarak nihai sonucu Multipoligon(zone) bazlı öğrenebilirsiniz.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
SlotId
Slotun unique id değeri.
SlotDate
Slotun tarihi.
MerchantId
Her satıcının unique bir tanımlayıcısıdır.
ZoneId
Zone ismi.
Source
İstek atan kişinin e-mail adresi.

Bölge(Poligon) Belirleme

Bu methodumuza entegre olan satıcılarımız,mağazalarının/bayilerinin hizmet vereceği bölgeyi belirleyebilir.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Alan Adı Açıklamaları

Alan Adı
Açıklama
merchantId
Her satıcının unique bir tanımlayıcısıdır.
MerchantPolygonData
Merchanta ait poligon veri listesi.

Multipoligon(zone) bazlı yönetime sahip olan satıcılarımız süreci methodunu kullanarak yönetebilir.

Bölge(Poligon) İşlem Kontrolü

Bu methodumuza entegre olan satıcılarımız sistemimizde tanımlı Bölge(Poligon) bilgisini öğrenebilir.