Hepsiburada Market/Su/Çiçek Dikeyimizde Hizmet Veren Taşıyıcılarımız,İade Statü ve Akış Bilgilendirmesine Ait Web Servis Format Mimarisine Bu Sayfadan Erişim Sağlayabilirler.
İade Talep Bilgisi Alma
Son kullanıcılarımız Hepsiburada Hızlı Teslimat/Randevulu Teslimat uygulaması üzerinden siparişi teslim aldıktan sonra, ilgili siparişte eksik/yanlış/hasarlı ürün sebebiyle ürünlerin bir veya birkaçını iade etmek isteyebilir. Bu durumda müşteri uygulama üzerinden iade talep ettiğinde, taşıyıcıya ilgili müşterinin bilgileri, iade edilecek ürünlerin bilgileri ve ürünleri alıp teslim edeceği mağaza bilgileri gönderilir.
Not
Webhook modeli ile çalışacak olan firmalarımızın aşağıda ifade edilen json kontrat ile bir web servis geliştirmeleri ve web servise ait BaseURL,username ve password bilgisini Hepsiburada Entegrasyon Ekibi’ne servis tanımı yapılabilmesi amacıyla ticket üzerinden iletmeleri gerekmektedir. (Web servis güvenliği Basic Auth ile sağlanır.)
Hepsiburada Webhook Servisleri üzerinde operasyonel akışı kesecek herhangi bir kontrol veya kısıt olmamalıdır.Siparişe ait veriler tarafınıza iletildikten sonra gerekli kontrollerinizi iç sistemlerinizde sağlayabilirsiniz.
- Method POST olarak ifade edilir.
Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı Web Servis Url Bilgisi
https://{delivery_api_baseUrl}/claim/created
Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı
{
"orderNumber": "2751686245",
"claimGroupReferenceNumber": "adb8f49e-ef25-4c1d-a9db-0e405e102ddb",
"merchant": {
"id": "5a1d3201-7d71-4e82-b812-3dd41b73bf55",
"name": "Test Kocasinan ATAŞEHİR",
"address": "Küçükbakkalköy Mahallesi, Kocasinan Caddesi, No:62-64/A Ataşehir/İstanbul KÜÇÜKBAKKALKÖY / ATAŞEHİR /İSTANBUL",
"phone": "2434543657",
"latitude": 41.0677123515095,
"longitude": 28.9975011348724
},
"user": {
"firstName": "Testİsim",
"lastName": "TestSoyisim"
},
"shippingAddress": {
"phoneNumber": "5330233620",
"addressDetail": "test test No:1 Kat:1 Daire:1",
"countryCode": "TUR",
"country": "Türkiye",
"city": "İstanbul",
"district": "İÇERENKÖY",
"county": "ATAŞEHİR",
"cityCode": 34,
"floor": "",
"postalCode": "",
"townCode": "2033",
"districtCode": "10239",
"latitude": 40.972091599999985,
"longitude": 29.109985499999976
}
}
Response
Response 201 Created (Success)
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
orderNumber
|
Sipariş numarasıdır. |
|
claimGroupReferenceNumber
|
İade referans numarasıdır.Bir siparişin farklı zamanlarda oluşturulan birden fazla iade talebi olabilir. Bunların hepsi Hepsiburada sistemi için farklı iadeyi göstermektedir ve aynı siparişe ait iadelerin ayrımı ClaimGroupReferenceNumber ile yapılmaktadır. |
|
merchant.id |
Mağazanın Hepsiburada sistemindeki uniqueId değeridir. (Test ve Canlı ortam için merchantId bilgisi hepsiburada.com tarafından iletilecektir.) |
|
merchant.name |
Mağazanın adı. |
|
merchant.address |
Mağazanın adresidir. |
|
merchant.phone |
Mağazanın telefon numarasıdır. |
|
merchant.latitude |
Mağazanın konum bilgisidir. |
|
merchant.longitude |
Mağazanın konum bilgisidir. |
|
user.firstName |
Siparişe ait son kullanıcı isim bilgisidir. |
|
user.lastName |
Siparişe ait son kullanıcı soyisim bilgisidir. |
|
shippingAddress.phoneNumber
|
siparişe ait son kullanıcının telefon numarasıdır. |
|
shippingAddress.addressDetail |
Siparişe ait son kullanıcının adres bilgisidir. |
|
shippingAddress.countryCode |
Siparişe ait son kullanıcının adres bilgisinin ülke bilgisinin kısa kodudur. |
|
shippingAddress.country |
Siparişe ait son kullanıcının adres bilgisinin ülke bilgisidir. |
|
shippingAddress.city |
Siparişe ait son kullanıcının adres bilgisinin il bilgisidir. |
|
shippingAddress.county |
Siparişe ait son kullanıcının adres bilgisinin ilçe bilgisidir. |
|
shippingAddress.district |
Siparişe ait son kullanıcının adres bilgisinin mahalle bilgisidir. |
|
shippingAddress.cityCode |
Siparişe ait son kullanıcının adres bilgisinin il kod bilgisidir.
|
|
shippingAddress.floor |
Siparişe ait son kullanıcının adres bilgisine ait kat/bina bilgisidir. |
|
shippingAddress.postalCode |
Siparişe ait son kullanıcının adres bilgisinin il posta kodu bilgisidir. |
|
shippingAddress.townCode |
Siparişe ait son kullanıcının adres bilgisinin ilçe posta kodu bilgisidir. |
|
shippingAddress.districtCode |
Siparişe ait son kullanıcının adres bilgisinin mahalle posta kodu bilgisidir. |
|
shippingAddress.latitude |
Siparişe ait son kullanıcının adres bilgisinin konumudur. |
|
shippingAddress.longitude |
Siparişe ait son kullanıcının adres bilgisinin konumudur. |
İade Talep İptal Bilgisi Alma
Son kullanıcılarımız Hepsiburada Hızlı Teslimat/Randevulu Teslimat uygulaması üüzerinden oluşturduğu iade talebini iptal ettiğinde, ilgili iade talebinin iptal bilgisi kurye firmalarının web servisin iletilir.
Not
Webhook modeli ile çalışacak olan firmalarımızın aşağıda ifade edilen json kontrat ile bir web servis geliştirmeleri ve web servise ait BaseURL,username ve password bilgisini Hepsiburada Entegrasyon Ekibi'ne servis tanımı yapılabilmesi amacıyla ticket üzerinden iletmeleri gerekmektedir. (Web servis güvenliği Basic Auth ile sağlanır.)
Hepsiburada Webhook Servisleri üzerinde operasyonel akışı kesecek herhangi bir kontrol veya kısıt olmamalıdır.Siparişe ait veriler tarafınıza iletildikten sonra gerekli kontrollerinizi iç sistemlerinizde sağlayabilirsiniz.
- Method POST olarak ifade edilir.
Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı Web Servis Url Bilgisi
https://{delivery_api_baseUrl}/claim/cancelled
Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı
{
"orderNumber": "2638249575",
"claimGroupReferenceNumber": "525b4bd8-89e9-4994-b381-5c5ae1b058ac"
}
Response
Response 201 Created (Success)
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
orderNumber
|
Sipariş numarasıdır. |
|
claimGroupReferenceNumber |
İade referans numarasıdır.Bir siparişin birden fazla iadesi mevcutsa, sadece gönderilen ClaimGroupReferenceNumber numarasına ait iade kaydı iptal edilmelidir. Diğer iadelerin statüsünde değişiklik olmamalıdır.
|