İ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 Shipment’in idefix sistemindeki ana sipariş numarasına karşılık gelir.
claimReason İlgili reason ID’ye göre oluşturulmuş claim’leri 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. Örnek 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 bazında platform ve vendor indirimlerinin toplam tutarıdır.
discountedTotalPrice İndirimler düşüldükten sonraki toplam item tutarıdır.
platformDiscount Platform tarafından uygulanan 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 shipment’in ilk statüsüdür. 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ştığını bildiren statüdür.
waiting_vendor_approve İade talebi oluşan shipment’in ilgili satıcının deposuna ulaştığını bildiren statüdür. Bu statüde satıcının iadeyi inceleyerek onay veya 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 satıcı tarafından incelendiğini ve red talebi statüsüne gönderildiğini bildiren statüdür. Bu statüde iade red sebebi idefix sistemi tarafından kontrol edilir.