Hepsiburada Market/Su/Çiçek Dikeyimizde Hizmet Veren Satıcılarımız,Siparişin İade Statü ve Akış Bilgilendirmesine Ait Web Servis Format Mimarisine Bu Sayfadan Erişim Sağlayabilirler.
Önemli
Talep Entegrasyonu methodlarımız ile ilgili sorularınız olması durumunda Sıkça Sorulan Sorular sayfamızı ziyaret edebilirsiniz.
İhtilaflı Talep Kabul/Red Bildirimi
İhtilaflı statüdeki(InDispute) talebin(iadenin),Hepsiburada tarafından ilgili talep için gerçekleşen onay/red nihai karar sonucu satıcılarımızın web servisine 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ı İade Kabul Bildirim Web Servis Url Bilgisi
https://{merchant_api_baseUrl}/claims/accept
Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı
{
"claimNumber":"904839457",
"type":"Return",
"quantity":1,
"status":"Accepted",
"customerId":"8c53fe2f-910e-4689-bc63-b20cae6c824a",
"customerName":"TestEntegrasyon Test",
"orderNumber":"2388993356"
"explanation":"test",
"claimDate":"2021-08-20T06:43:36.278Z",
"orderDate":"2021-06-25T12:52:37Z",
"line":
{
"lineItemId":"60d5d195-315d-5f99-7005-52b806060606",
"productName":"Pepsi Twist 1 Lt Pet",
"listingId":"8e7ea954-dffe-48ca-bafd-7873ca224a96",
"merchantId":"791b919d-6ad0-4413-a780-8c37e44878a4",
"hbSku":"HBV00000NE0PC",
"merchantSku":"TESTHX1234",
"price":
{"currency":"TRY",
"amount":10.0},
"totalPrice":
{"currency":"TRY",
"amount":10.0
},
"productImageUrlFormat":"https://productimages.hepsiburada.net/s/31/{size}/10336882884658.jpg"},
"acceptedBy":"Admin",
"acceptedDate":"2021-08-20T06:46:31.007Z"}
Response
Response 204(Success)
Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı İade Red Bildirim Web Servis Url Bilgisi
https://{merchant_api_baseUrl}/claims/reject
Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı
{
"claimNumber":"317987726",
"type":"Return",
"quantity":1,
"status":"Rejected",
"customerId":"8c53fe2f-910e-4689-bc63-b20cae6c824a",
"customerName":"Test1 Test",
"orderNumber":"2388993356",
"explanation":"twst",
"claimDate":"2021-08-20T06:59:26.113Z",
"orderDate":"2021-06-25T12:52:37Z",
"line":
{
"lineItemId":"60d5d195-315d-5f99-7005-52ba06060606",
"productName":"Mersoy Erzincan Tulum Peyniri 250 gr",
"listingId":"0a866ed1-4366-42f7-af1c-3eaded9ad50a",
"merchantId":"791b919d-6ad0-4413-a780-8c37e44878a4",
"hbSku":"HBV00000NE0R8",
"merchantSku":"TESTHX5678",
"price":
{
"currency":"TRY",
"amount":17.0},
"totalPrice":
{
"currency":"TRY",
"amount":17.0},"productImageUrlFormat":"https://productimages.hepsiburada.net/s/31/{size}/10336883933234.jpg"},
"adminRejection":
{
"reason":"RequestIsIncorrectOrIncomplete",
"statement":"test"
},
"rejecttedDate":"2021-08-20T07:00:35.003Z"
}
Response
Response 204(Success)
Not
Servise response iletirken idempotent mantığını kullanmanız önerilir.