İade Listesi

İade Listesi (claim-list)

idefix sisteminde iade talebi oluşan shipmentları bu metod ile çekebilirsiniz.

vendor her satıcının unique bir tanımlayıcısıdır. Zorunlu bir alandır.

GET claim-list:

https://merchantapi.idefix.com/oms/{vendorId}/claim-list

  • ile belirtilen alanlar zorunlu alanlardır.
Parametre Ad Açıklama
ids Tekil olarak ilgili iadenin detayını çekmek için claim ID ile istek atılabilir.
orderNumber shipmentin idefix sistemindeki ana sipariş numarasına karşılık gelir.
claimReason İlgili reason ID ye göre oluşturulmuş claimleri listelemek için kullanılır.
startDate Belirli bir tarihten sonraki iadeler için sorgulama yapılabilir. Örnek Format : 2022/09/30 23:59:59
endDate Belirtilen tarihe kadar olan iadeler için sorgulama yapılabilir. Örnek Format : 2022/09/30 23:59:59
lastUpdatedAt İadenin durumunun son güncellenme tarihini baz alır.Ornek Format : 2022/09/30 23:59:59
Örnek Servis Cevabı:
{
    "totalCount": 2,
    "itemCount": 2,
    "pageCount": 1,
    "currentPage": 1,
    "limit": 50,
    "items": [
        {
            "customerId": 104710723,
            "customerName": "Derya Kaya",
            "vendorTitle": "idefix",
            "createdAt": "2023-05-17T18:56:29+03:00",
            "orderCreatedAt": "2023-05-03T16:04:12+03:00",
            "orderNumber": "IDE64525bcc2d1c6",
            "id": 241,
            "cargoTrackingUrl": null,
            "cargoTrackingNumber": null,
            "cargoKey": "CLMY241",
            "cargoCompanyId": 74,
            "cargoCompanyName": "Yurtiçi Kargo",
            "cargoProfileId": 1,
            "cargoProfileName": "Yurtiçi Kargo Platform Öder",
            "cargoTypeId": 3,
            "cargoTypeName": "return",
            "items": [
                {
                    "productPrice": 10.05,
                    "vendorPrice": 10.05,
                    "discountedTotalPrice": 10.05,
                    "platformDiscount": 0,
                    "vendorDiscount": 0,
                    "totalDiscount": null,
                    "interestPrice": 0,
                    "vat": 0,
                    "totalPrice": 10.05,
                    "productName": "Tezus",
                    "productImage": "https://static.idefix.net/resize/{size}product/263195/tezus-64372d7596f8c.jpg",
                    "productCode": "IDE-1681337716963",
                    "barcode": "9786057903372",
                    "erpId": "1819603001",
                    "slug": "tezus-p-263195",
                    "note": null,
                    "customerNote": null,
                    "vendorNote": "müşteri ürünü fazla göndermiş",
                    "platformReason": null,
                    "platformReasonId": null,
                    "vendorReason": "Teslim edilemeyen gönderi",
                    "vendorReasonId": 3015,
                    "customerReason": null,
                    "customerReasonId": null,
                    "stateUpdatedAt": "2023-05-17T18:57:22+03:00",
                    "declineRequestNote": null,
                    "declineRequestReasonName": null,
                    "state": "approved",
                    "stateName": "İade onaylandı",
                    "orderLineId": 10000375,
                    "id": 262,
                    "autoApproveDate": "2023-05-19T23:59:59+03:00",
                    "isAutoApprove": false,
                    "approvedAt": "2023-05-17T18:57:22+03:00",
                    "isControversial": false
                }
            ]
        },
        {
            "customerId": 104710723,
            "customerName": "Derya Kaya",
            "vendorTitle": "idefix",
            "createdAt": "2023-05-16T09:39:26+03:00",
            "orderCreatedAt": "2023-05-03T16:04:12+03:00",
            "orderNumber": "IDE64525bcc2d1c6",
            "id": 232,
            "cargoTrackingUrl": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code=91687272748",
            "cargoTrackingNumber": "916872729748",
            "cargoKey": "CLMY232",
            "cargoCompanyId": 74,
            "cargoCompanyName": "Yurtiçi Kargo",
            "cargoProfileId": 1,
            "cargoProfileName": "Yurtiçi Kargo Platform Öder",
            "cargoTypeId": 3,
            "cargoTypeName": "return",
            "items": [
                {
                    "productPrice": 10.9,
                    "vendorPrice": 10.9,
                    "discountedTotalPrice": 10.9,
                    "platformDiscount": 0,
                    "vendorDiscount": 0,
                    "totalDiscount": null,
                    "interestPrice": 0,
                    "vat": 0,
                    "totalPrice": 10.9,
                    "productName": "Köy Hayatından Sahneler",
                    "productImage": "https://static.idefix.net/resize/{size}product/214882/koy-hayatindan-sahneler-6436b3c3a468e.jpg",
                    "productCode": "IDE-1681306562203",
                    "barcode": "9786050923131",
                    "erpId": "1582829001",
                    "slug": "koy-hayatindan-sahneler-p-214882",
                    "note": null,
                    "customerNote": null,
                    "vendorNote": null,
                    "platformReason": null,
                    "platformReasonId": null,
                    "vendorReason": null,
                    "vendorReasonId": null,
                    "customerReason": "Modelini beğenmedim",
                    "customerReasonId": 6251,
                    "stateUpdatedAt": "2023-05-17T17:05:42+03:00",
                    "declineRequestNote": null,
                    "declineRequestReasonName": null,
                    "state": "approved",
                    "stateName": "İade onaylandı",
                    "orderLineId": 10000376,
                    "id": 252,
                    "autoApproveDate": "2023-08-02T23:59:59+03:00",
                    "isAutoApprove": false,
                    "approvedAt": "2023-05-17T17:05:42+03:00",
                    "isControversial": false
                }
            ]
        }
    ]
}
Response parametreleri:
Parametre Ad Açıklama
totalDiscount item in platform ve vendor indirimlerinin toplam indirimleridir.
discountedTotalPrice İndirimlerin düşülmüş olduğu toplam item tutarıdır.
platformDiscount Platformun uyguladığı toplam indirim tutarıdır.
vendorDiscount Vendor tarafından uygulanan toplam indirim tutarıdır.
Shipment statüleri:
Parametre Ad Açıklama
ready İadesi oluşan shipmentlerin ilk statüsüdür. Bu aşamada müşteri önyüzden iade butonuna bastığında oluşur.
in_cargo İade talebi oluşturulduktan sonra müşteri ürünü kargoya teslim eder, sistem kargodan ürünün durumunu sorgular. Ürünün kargoya ulaşmış olduğunu bildiren statüdür.
waiting_vendor_approve İade talebi oluşan shipment ilgili satıcının deposuna ulaştığını bildiren statüdür. Bu statüde ilgili satıcının iadeyi inceleyerek onay ya da red talebinde bulunması beklenir.
approved Gelen iadenin onaylandığını bildiren statüdür.
decline Gelen iadenin reddedildiğini bildiren statüdür.
vendor_decline_request Gelen iadenin ilgili satıcı tarafından incelendiği ve iade red talep statüsüne gönderildiğini bildiren statüdür. Bu statüde iadenin red sebebi idefix sistemi tarafından kontrol edilecektir.