İade Statüleri (SearchReturnStatus)

İade Statülerinin Çekilmesi

Horoz sistemlerinde yer alan iadelerinizin güncel statülerini görüntülemek için SearchReturnStatus() metodu kullanılmaktadır. İade numarası bazlı veya toplu statü listelemesini desteklemektedir.

• Bu method ile iade statülerinin listelenmesi sağlanmadan önce Horoz Lojistik sistemlerinde aktif iadelerinizin olması gerekmektedir.
• Tüm iadeleri toplu olarak çekmek için returnCode parametresi boş bırakılmalıdır.

POST SearchReturnStatus

Kullanım

https://ewms.horoz.com.tr:9992/ecomwarehouseservice_test/v1/SearchReturnStatus https://ewms.horoz.com.tr:9992/ecomwarehouseservice_app/v1/SearchReturnStatus

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda SearchReturnStatus() işleminin giriş ve çıkış parametreleri ve bu parametrelerin tür ve formatları listelenmiştir.

Request Alanları

Parametre	Zorunluluk	Açıklama	Veri Tipi
processKey	Evet	Size tanımlanan processKey Bilgisi	string
returnCode	Hayır	Tekil sorgu için iade numarası	string

Response Alanları

Parametre	Açıklama	Veri Tipi
result	İşlem kodu (0-Başarılı / 1-Başarısız)	string
errorCode	Hata Mesajı	string
systemMessage	Sistem Mesajı	string
resultData[]	Sonuç Dizisi	array

resultData[]

Parametre	Açıklama	Veri Tipi
id	Benzersiz Numara	int
returnCode	İade Kodu	string
statusDate	İade Tarihi	datetime
dataTransfer	Aktarım Bilgisi	string
status	Statüsü	string
waybillNumber	İrsaliye Numarası	string
waybillDate	İrsaliye Tarihi	string
parameter01/20	Parametrik Alanlar	string
itemDetails[]	Item Detay Dizisi	array

itemDetails[]

Parametre	Açıklama	Veri Tipi
itemCode	Item Kodu	string
quantity	Adet Bilgisi	int
reason	Açıklama	string
parameter01/20	Parametrik Alanlar	string

Örnek İstek

{
    "processKey": "A1389BF5246943ED8F40DEF725E0EE84",
    "returnCode": ""
}

Örnek Cevap

{
    "resultData": [
        {
            "id": 26,
            "returnCode": "RTNLOREM",
            "statusDate": "2026-04-14T00:00:00",
            "dataTransfer": "TRANSFERINFO",
            "status": "OK",
            "waybillNumber": "HRZWAYBILLTEST",
            "waybillDate": "2026-04-14T00:00:00",
            "parameter01": "TESTPARAMETRIK",
            "itemDetails": [
                {
                    "itemCode": "PRO1",
                    "quantity": 1
                }
            ]
        }
    ],
    "result": "0",
    "errorCode": "",
    "systemMessage": ""
}

Servis Cevapları

result	errorCode	systemMessage	Açıklama
0		İade statüleri başarıyla getirildi.
1	101	Bir hata meydana geldi!	Statü gösterimlerinde hata mesajları görüntülenir.