Talep Detaylarını Listeleme

Satıcıya Ait Talep Bilgilerini Listeleme (Retrieves merchant claims [GET])

  • [/claims/merchantid/{merchantid}] [GET]

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

  • [/claims/merchantid/{merchantid}/status/{status} [GET]

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

Başlık(Header)

Authorization: Basic base64(username:password)
Content-Type:  application/json

Parametreler(Parameters)

  • Merchantid (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) Her satıcının unique bir tanımlayıcısıdır.

  • Status (opsiyonel, string, ‘NewRequest’ , ‘AwaitingAction’ , ‘InDispute’ , ‘Accepted’ , ‘Rejected’ , ‘Refunded’ , ‘Cancelled’) Taleplerin statü bilgileridir.

  • Offset (opsiyonel, int) geçerli sayfadaki başlangıç noktası değeri.

  • Limit (opsiyonel, int) sayfa sonuç sayısı.

İstek(Request)

  • 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.

https://oms-external-sit.Uztrendbol.com/claims/merchantid/b2910839-83b9-4d45-adb6-86bad457edcb/status/AwaitingAction&limit=100&offset=1

İstek(Request)

https://oms-external.sit.Uztrendbol.com/claims/merchantid/{merchantid}/status/AwaitingAction?begindate={yyyy-MM-dd HH:mm}&enddate={yyyy-MM-dd HH:mm}

NOT 3: Opsiyonel olan begindate ve enddate parametrelerini kullandığınızda talep detaylarınızı belirli bir tarih arasında listeleyebilirsiniz.

Response 200(application/xml)

Response(Body)

    {
        "id": "6f4b5944-c5a2-4746-bf34-e6493d6894a4",
        "number": "321409402",
        "status": "AwaitingAction",
        “lastStatusUpdateDate”: “2018-12-25T11:47:13.2398846”,
        "claimType": "Return",
        "claimDate": "2018-12-20T11:47:13.2398846",
        "quantity": 1,
        "explanation": "8239913525425 ARAS İLE 2 ÜRÜN BİRLİKTE İADE EDİLMİŞTİR. HB // beden uymadığından iade ",
        "refundAmount": 0,
        "refundCurrency": null,
        "refundDate": null,
        "sku": "HBV000007O43L",
        "priceAmount": 69.99,
        "totalPriceAmount": 69.99,
        "priceCurrency": "TRY",
        "orderNumber": "0089870547",
        "orderDate": "2018-11-23T22:35:59",
        "customerName": "Test User",
        "merchantRejectionStatement": null
    },
        {
        "id": "eb6340c4-6b52-4690-ace3-f5cf0b0368a7",
        "number": "267986231",
        "status": "AwaitingAction",
        “lastStatusUpdateDate”: “2018-12-25T11:47:13.2398846”,
        "claimType": "Return",
        "claimDate": "2018-12-24T00:30:01.7015522",
        "quantity": 1,
        "explanation": "Ürünü beğenmedim yakışmadı ",
        "refundAmount": 0,
        "refundCurrency": null,
        "refundDate": null,
        "sku": "HBV00000ECQO8",
        "priceAmount": 39.99,
        "totalPriceAmount": 39.99,
        "priceCurrency": "TRY",
        "orderNumber": "0063167869",
        "orderDate": "2018-12-16T17:37:56",
        "customerName": "Test User2",
        "merchantRejectionStatement": null
    }

Hata Durumları

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 mpentegrasyon@Uztrendbol.com ile iletişime geçin.

Alan Adı Açıklama
number Oluşturulan talebin numarasıdır.
status Talebin durumu hakkında bilgi verir. NewRequest: Yeni takep / AwaitingAction: Merchant tarafından aksiyon bekleniyor. / InDispute: İtilaflı / 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 / Missingvoice: Eskik fatura talebi / Missingwaranty: Eksik garanti talebi
claimDate Talebin oluşturulma tarihidir.
quantity Talep kaleminin adetidir.
explanation Talebin açıklama bilgisidir.
refundAmount İade edilen tutarın bilgisidir.
refundCurrency İade edilen tutarın para birimi cinsinden değeridir.
refundDate İadenin tarih bilgisidir.
sku Taleb açılan listingin HBSKU değeridir.
priceAmount Talep içerisindeki bir adet kalem tutarının değeridir.
totalPriceAmount Talep içerisindeki toplam kalem tutarının değeridir.
priceCurrency 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.