Yolda/Teslim Edildi/Teslim Edilemedi Statüleri Webhook

Hepsiburada Market/Su/Çiçek Dikeyimizde Hizmet Veren Satıcılarımız,Sipariş Statü ve Akış Bilgilendirmesine Ait Web Servis Format Mimarisine Bu Sayfadan Erişim Sağlayabilirler.

📘

Önemli

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

Yolda/Teslim Edildi/Teslim Edilemedi Statüleri

Kuryelerimiz veya Müşteri Hizmetlerimiz siparişin statüsünü Yolda,Teslim Edildi,Teslim Edilemedi olarak belirttiğinde Hepsiburada tarafından,satıcılarımızın web servisine siparişin güncel statüsüne dair veri 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.

IIS’de baseurl oluşturuldugunda default PUT servisi kapalı gelir, bunu açmanız gerekir.

  • Methodlarımız PUT olarak ifade edilir.

Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı Yolda Statüsüne Ait Web Servis Url Bilgisi

https://{merchant_api_baseUrl}/packages/{packagenumber}/intransit

Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı

{
          "merchantId": "ab28300e-c126-4e70-a483-9f3fe0e5f297",
          "shippedDate": "2020-04-16T10:14:17.707Z",
          "packageNumber": "013105889",
          "barcode": "6220131054891",
          "trackingInfoCode": "176162533695",
          "trackingInfoUrl": "http://selfservis.hepsiburada.com/reports/SSWDocumentDetail.aspx?DocId=176162533695"
}

Response

Response 204(Success)

❗️

Not

Servise response iletirken idempotent mantığını kullanmanız önerilir.

Alan Adı Açıklamaları

Alan Adı Açıklama
merchantId
Mağazanın/bayinin unique kod bilgisidir.
shippedDate
Siparişin kuryeye teslim edilme tarihidir.
packageNumber
Paket numarası bilgisidir.
barcode
Paketin kurye barkod bilgisidir.
trackingInfoCode
Paketin kurye takip kodudur.
trackingInfoUrl
Paketin kurye takip url bilgisidir.

Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı Teslim Edildi Statüsüne Ait Web Servis Url Bilgisi

https://{merchant_api_baseUrl}/packages/{packagenumber}/deliver

Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı

{
          "merchantId": "ab28300e-c126-4e70-a483-9f3fe0e5f297",
          "receivedDate": "2020-04-16T11:13:30.230Z",
          "receivedBy": "string",
          "packageNumber": "013105889",
          "barcode": "6220131054891"
}

Response

Response 204(Success)

❗️

Not

Servise response iletirken idempotent mantığını kullanmanız önerilir.

Alan Adı Açıklamaları

Alan Adı Açıklama
merchantId
Mağazanın/bayinin unique kod bilgisidir.
receivedDate
Paketin teslim edilme tarihidir.
receivedBy
Paket teslim edildiği kişi bilgisidir.
packageNumber
Paket numarası bilgisidir.
barcode
Paketin kurye barkod bilgisidir.

Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı Teslim Edilemedi Statüsüne Ait Web Servis Url Bilgisi

https://{merchant_api_baseUrl}/packages/{packagenumber}/undeliver

Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı

{
          "merchantId": "ab28300e-c126-4e70-a483-9f3fe0e5f297",
          "undeliveredDate": "2020-04-16T11:13:30.230Z",
          "undeliveredReason": "customer is unreachable",
          "packageNumber": "013105889",
          "barcode": "6220131054891"
 }

Response

Response 204(Success)

❗️

Not

Servise response iletirken idempotent mantığını kullanmanız önerilir.

Alan Adı Açıklamaları

Alan Adı Açıklama
merchantId
Mağazanın/bayinin unique kod bilgisidir.
undeliveredDate
Paketin teslim edilmediği tarih bilgisidir.
undeliveredReason
Paketin teslim edilememe nedenidir.
packageNumber
Paketin paket numarasıdır.
barcode
Paketin kurye barkod bilgisidir.