hepsiburada developers

hepsiburada developers

Did You Know?

Talep Detayını Listeleme

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

Endpoint(Get)

				
					https://oms-external-sit.hepsiburada.com/claims/merchantid/{merchantid}/				
			
Bilgi

Tüm taleplerin (‘NewRequest’ , ‘AwaitingAction’ , ‘InDispute’ , ‘Accepted’ , ‘Rejected’ , ‘Refunded’ , ‘Cancelled’) detaylarını döner.

Endpoint(Get)

				
					https://oms-external-sit.hepsiburada.com/claims/merchantid/{merchantid}/status/{status}				
			
Bilgi

Statüye göre taleplerin (‘NewRequest’ , ‘AwaitingAction’ , ‘InDispute’ , ‘Accepted’ , ‘Rejected’ , ‘Refunded’ , ‘Cancelled’) detaylarını döner.

Parametreler(Parameters)

  1. Merchantid (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) Her satıcının unique bir tanımlayıcısıdır.
  2. Status (opsiyonel, string, ‘NewRequest’ , ‘AwaitingAction’ , ‘InDispute’ , ‘Accepted’ , ‘Rejected’ , ‘Refunded’ , ‘Cancelled’) Taleplerin statü bilgileridir.
  3. Offset (opsiyonel, int) geçerli sayfadaki başlangıç noktası değeri.
  4. Limit (opsiyonel, int) sayfa sonuç sayısı.
NOT
  • Limit Offset pagenation yapısı olarak işlev görmektedir. Limit bir sayfada kaç adet talep listeleneceğini belirtirken, Offset hangi talepten sonraki siparişlerin gösterileceğini belirtir.
  • Limit:10 Offset:0 gönderildiğinde ilk 10 talep listelenecektir. Limit:10 Offset:10 gönderildiğinde ilk 10 talepten sonraki 10 talep listelenecektir.
  • Limit Offset kullanılması zorunludur.

Endpoint(GET) - Örnek İstek

				
					https://oms-external-sit.hepsiburada.com/claims/merchantId/{merchantıd}/status/AwaitingAction?offset=0&limit=100				
			

Endpoint(GET) - BeginDate/EndDate - Örnek İstek

				
					https://oms-external-sit.hepsiburada.com/claims/merchantid/{merchantid}/status/AwaitingAction?offset=0&limit=100&beginDate={yyyy-MM-dd HH:mm}&endDate={yyyy-MM-dd HH:mm}				
			
NOT

Opsiyonel olan begindate ve enddate parametrelerini kullandığınızda talep detaylarınızı belirli bir tarih arasında listeleyebilirsiniz, Limit Offset kullanılması zorunludur.

Response Body

				
					[
    {
        "id": "615efd50-7871-de97-7d5e-632206060606",
        "number": "830419905",
        "status": "AwaitingAction",
        "claimType": "Return",
        "claimDate": "2021-10-07T16:59:44.878",
        "quantity": 1,
        "explanation": "test",
        "refundAmount": 0,
        "refundCurrency": "",
        "refundDate": "",
        "merchantRejectionStatement": "",
        "sku": "HBV000012P91N",
        "priceAmount": 100,
        "totalPriceAmount": 100,
        "priceCurrency": "TRY",
        "orderNumber": "3313938139",
        "orderDate": "2021-10-07T16:42:03.661",
        "customerName": "Test User Test User",
        "lineItemId": "615ef92b-7871-de97-7d5e-4feb06060606",
        "AwaitingActionExpireDate": null,
        "MerchantSku": "HBV000012P91N_TEST",
        "Reason": "Bedeni / boyutu uymadı",
        "RequestedProduct": null
    },
    {
        "id": "61641147-6f79-6082-5c7d-34ec06060606",
        "number": "739216689",
        "status": "AwaitingAction",
        "claimType": "Return",
        "claimDate": "2021-10-11T13:26:15.584",
        "quantity": 3,
        "explanation": "Beden hatalı ",
        "refundAmount": 0,
        "refundCurrency": "",
        "refundDate": "",
        "merchantRejectionStatement": "",
        "sku": "HBV000012P91N",
        "priceAmount": 100.46666666666665,
        "totalPriceAmount": 301.4,
        "priceCurrency": "TRY",
        "orderNumber": "0664134105",
        "orderDate": "2021-10-11T13:18:44.806",
        "customerName": "Test User Test User",
        "lineItemId": "61640f85-6f79-6082-5c7d-335906060606",
        "AwaitingActionExpireDate": null,
        "MerchantSku": "HBV000012P91N_TEST",
        "Reason": "Bedeni / boyutu uymadı",
        "RequestedProduct": null
    },
    {
        "id": "61641353-6f79-6082-5c7d-36d806060606",
        "number": "861491359",
        "status": "AwaitingAction",
        "claimType": "Return",
        "claimDate": "2021-10-11T13:34:59.314",
        "quantity": 1,
        "explanation": "",
        "refundAmount": 0,
        "refundCurrency": "",
        "refundDate": "",
        "merchantRejectionStatement": "",
        "sku": "HBV000012P91N",
        "priceAmount": 100.46666666666667,
        "totalPriceAmount": 100.46666666666667,
        "priceCurrency": "TRY",
        "orderNumber": "0664134106",
        "orderDate": "2021-10-11T13:31:20.757",
        "customerName": "Test User Test User",
        "lineItemId": "61641278-6f79-6082-5c7d-35fb06060606",
        "AwaitingActionExpireDate": null,
        "MerchantSku": "HBV000012P91N_TEST",
        "Reason": "",
        "RequestedProduct": {
            "Sku": "HBV000012P91O",
            "VariantProperties": [
                {
                    "Name": "Beden",
                    "Value": "XXXL"
                },
                {
                    "Name": "Renk",
                    "Value": "Açık Mavi"
                }
            ],
            "ChangeOption": "WithDifferentVariant"
        }
    }
]				
			

Alan Açıklamaları

Alan AdıAçıklama
Number
Oluşturulan talebin numarasıdır.
Status
Talebin durumu hakkında bilgi verir. NewRequest: Yeni talep / AwaitingAction: Merchant tarafından aksiyon bekleniyor. / InDispute: İhtilaflı / Accepted: Kabul edilmiş. / Rejected: red edildi. / Refunded: İade talepleri için müşteriye ödemesi yapıldı. / Cancelled: Talep kapatıldı.
ClaimType
Talebin hangi konu için açıldığını bildirir. Return: İade talebi / Missingpart: / Missingıtem: Eksik parça talebi / Damagedwithreport: Hasarlı ürün talebi / Wrongproduct: yanlış ürün talebi / Undeliveredproduct: Teslim edilemeyen ürün talebi / MissingInvoice: Eksik fatura talebi / Missingwaranty: Eksik garanti talebi
ClaimDate
Talebin oluşturulma tarihidir.
Quantity
Talep kaleminin adet bilgisidir.
Explanation
Talebin açıklama bilgisidir.
RefundAmount
İade edilen tutarın bilgisidir.
RefundCurrency
Talep içerisindeki tutarın para birimi cinsinden değeridir..
OrderNumber
Paketin bağlı olduğu sipariş numarasıdır.
OrderDate
Paketin bağlı olduğu siparişin tarih bilgisini verir.
CustomerName
Sipariş sahibinin adıdır.
MerchantRejectionStatement
Merchantın red nedeninin açıklamasıdır.
lineItemId
Her sipariş kaleminin unique bir tanımlayıcısıdır.
AwaitingActionExpireDate
Talep için aksiyon alınabilecek son tarih bilgisi.
MerchantSku
Satıcı stok kodu.
Reason
Açıklama alanına gelebilecek değerler;
Kalitesiz buldum
Daha ucuzunu buldum
Bedeni / boyutu uymadı
Bozuk / hasarlı geldi
Ürünün parçası eksik
Yanlış ürün geldi
Diğer
Faturam gelmedi
Faturamda hata var
Faturamı kaybettim
İhtiyacım olan zamanda gelmedi
Ürünün son kullanma tarihi geçmiş
Ürünüm farklı gramajda geldi
Değişim

Hata Durumları

Hata KoduHata Mesajı
400
Bad Request: URL içerisindeki parametreleri kontrol edin.
401
Unauthorized: Password ve şifre hatalı girilmiştir. Lütfen kontrol ediniz.
404
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
405
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
500
Internal Server: Lütfen Ticket ileterek entegrasyon ekibi ile iletişime geçiniz.

Sayfa Başlıkları