Karayolu Siparişi Statü Listeleme - listRoadOrderStatus()

Karayolu Siparişi Statü Listeleme

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan listRoadOrderStatus metodu, Horoz sistemine iletilmiş siparişlerin kargo durumlarının listesini istemciye dönen fonksiyondur. listRoadOrderStatus() metodu ile ilgili önemli bilgiler ve Horoz sisteminde karayolu siparişi kargo durumlarını sorgularken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

• listRoadOrderStatus() metodu POST yöntem ile JSON formatta veri alan, bir RESFtul web servis metodudur.

• listRoadOrderStatus() metodu ile Horoz sisteminden karayolu siparişi kargo durumu sorgusu yaparken, siparişe ait bilgiler metodun body kısmına JSON veri tipinde geçilmelidir. İstemciye ait processKey bilgisi metodun header kısmına parametre tipinde geçilmelidir. listRoadOrderStatus() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik E-İhracat Entegrasyonu Web servisine iletilmelidir.

• E-İhracat entegrasyon web servisi içerisinde bulunan listRoadOrderStatus() metodu, parametre olarak customerOrderNumber değerini JSON formatta POST method olarak alır.

• İlgili metot alınan istek parametrelerinin karşılığında istemciye yanıt olarak dönen listedeki sipariş ve/veya siparişler için beklenen kargo takip bilgilerini istemciye döner.

• listRoadOrderStatus() metodu ile siparişlere ait kargo takip durumları sorgulanırken, sadece müşteri sipariş numarası bazında sorgulama yapılabilir. Müşteri sipariş numarası boş geçilemez. listRoadOrderStatus() metodunda dönülen statüler sipariş bazlı olup, ürün bazlı statü dönüşü yapılmamaktadır.

---

POST listRoadOrderStatus()

ENDPOINT

http://b2btest.horoz.com.tr:7801/eexport_test/v1/listRoadOrderStatus

Parametre Açıklamaları & Kuralları

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

Alanlar

Parametre	Açıklama	Veri Tipi	Uzunluk	Alan Yeri	Zorunluluk
processKey	İstemci için tanımlanan processKey bilgisi	string	100	Header	Zorunlu
customerOrderNumber	Müşteri sipariş numarası	string	100	inBody Request	Opsiyonel

Örnek İstek

 { 
  "customerOrderNumber": "805716833729"
  }

Örnek Cevap

  {
    "response": {
      "responseCode": "STA-100",
      "responseMessage": "ISLEM BASARILI",
      "orderDeliveryState": {
        "customerOrderNumber": "805716833729",
        "senderTitle": "KALITE BARKOD ETIKET VE KAGIT SANAYI TICARET LIMITED SIRKETI",
        "senderAddress": "GEBZE DEPO ADRES : BALCİK MERKEZ MAH. SİLE CAD. NO:20 GEBZE/KOCAELİ ? TURKEY",
        "recipientTitle": "ANMELDER: KALITE BARKOD ETIKET VE KAGIT SANAYI TICARET LTDS",
        "recipientAddress": "Amazon Fulfillment Center Kaltbandstrasse 4 44145 Dortmund",
        "deliveryStatu": "TESLİM EDİLDİ",
        "deliveryDate": "28.12.2022 10:00:14",
        "deliveredName": "JANNISSOKKO"
      },
      "listOfMovements": {
        "movements": [
          {
            "customerOrderNumber": "805716833729",
            "movementType": "YURTDIŞI",
            "movementCountry": "TÜRKİYE",
            "stateHolder": "HOROZ",
            "statu": "SİPARİŞ OLUŞTURULDU",
            "statusBranch": "ALMANYA DİĞER",
            "statusDate": "30.11.2022 09:40:54"
          },
          {
            "customerOrderNumber": "805716833729",
            "movementType": "YURTDIŞI",
            "movementCountry": "TÜRKİYE",
            "stateHolder": "HOROZ",
            "statu": "DSV SİPARİŞ KAYDI OLUŞTURULDU",
            "statusBranch": "ALMANYA DİĞER",
            "statusDate": "30.11.2022 10:00:15"
          }
        ]
      }
    }
  }

“deliveryStatu” alanına gelebilecek tüm statü bilgileri aşağıdaki tabloda belirtilmiştir.

Response Kodu
DSV TÜRKİYE SİPARİŞ KABUL
SİPARİŞ ONAYLANDI
DSV SİPARİŞ BARKODU ALINDI
DSV SİPARİŞ KAYDI OLUŞTURULDU
SİPARİŞ OLUŞTURULDU
SİPARİŞ TESLİM EDİLDİ
TESLİMAT İPTAL EDİLDİ
DSV ALMANYA DEPO GİRİŞ
DSV ALMANYA DEPO ÇIKIŞ
TESLİMAT İÇİN YOLA ÇIKTI
TESİSTEN AYRILDI
SİPARİŞ VERİSİ ENTEGRASYON ÜZERİNDEN İLETİLDİ
SİPARİŞ İPTAL EDİLDİ
DSV DEPO GİRİŞ
DSV DEPO ÇIKIŞ
HATA: SİPARİŞ AKTARILAMADI
ALIM TARAMASI
ALICI TESLİMATI REDDETTİ
TESİSTEN AYRILDI-YOLDA

---

Servis Cevapları

Servise ait başarılı/başarısız servis cevaplarına buradan erişebilirsiniz.