Ürün Listeleme - listProducts()

Ürün Listeleme İşlemi

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan listProducts metodu, Horoz sisteminde sipariş oluşturma adımında kullanılacak olan ürünlerin Horoz Lojistik sisteminden listelenmesi için kullanılabilir. listProducts() metodu ile ilgili önemli bilgiler ve Horoz Lojistik sisteminde ürün listelerken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

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

• listProducts() metodu ile Horoz sistemine ürün listeleme için request gönderimi yaparken, ürüne tanımına 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. listProducts() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik E-İhracat Entegrasyonu Web servisine iletilmelidir.

• listProducts() metodu, reateProduct() metodu ile Horoz Lojistik sistemine kaydedilmiş ürünlerin ürün tanım ekranında veya sipariş giriş ekranında seçim için gösterilecek liste olarak kullanılabilir. Özellikle sipariş kayıt ekranında ürün tanım yapısında yer alan kap tanım türlerine göre satıcının sisteme tanımladığı ürünleri rahat seçmesini sağlayacak bir liste oluşturulması gerekmektedir. Bu nedenle listenin master ve detay olarak oluşturulması sağlanmıştır.

• Bileşenli ürün için gardırop toplam desi ve toplam kg, istif durumu gibi bilgiler master bölümünde, ürün bileşenlerini temsil eden alt parçalar detay bölümünde yer alacaktır. Yapılacak tasarıma göre bu bilgiler ışığında kullanılmalıdır.

• ETGB üzerinde yer alacak kap adeti, siparişin içindeki satış adetiyle kap tanım türüne uygun olması sağlanmalıdır. Örneğin bir gardırop için; 2 adet satıldığını düşünürsek ve 5 bileşeni varsa sipariş içinde gelmesi gereken satış adeti 2, kap adetinin 10 olması beklenir.

• E-İhracat entegrasyon web servisi içerisinde bulunan listProducts metodu, parametre olarak productCode ve productName değerlerini JSON formatta POST method olarak alır. İlgili metot alınan istek parametrelerinin karşılığında istemciye yanıt olarak productCode, productNameTr, productGroupCode, productGroupName, width, length, height, gross, netKg, desi, ean, logCode, packageType, stackStatus, containerDefination, isMasterProductRecord, masterProductRecordId bilgilerini istemciye döner.

• listProducts() metodu ile ürünler sorgulanırken, ürün kodu ya da ürün adı bazında sorgulama yapılabileceği gibi, sadece ürün kodu ya da sadece ürün adı bazında sorgulama yapılabilir. Buna ek olarak, ürün kodu ve ürün adı bilgileri boş ve/veya null geçildiğinde ilgili firma için Horoz sisteminde tanımlı ve geçerli tüm ürün gruplarının bilgileri istemciye dönülür. Ürün sorgulama yapılırken, bileşenli ürünler için productCode bilgisinin master ürün kodu olarak geçilmesi beklenir.

---

POST listProducts()

ENDPOINT

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

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda listProducts() 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
productCode	Ürün kodu bilgisi	string	100	inBody Request	Zorunlu
productName	Ürün adı bilgisi	string	500	inBody Request	Zorunlu

Örnek İstek

  {
    "productCode": null,
    "productName": null
  }

Örnek Cevap

  {
    "response": {
    "responseCode": "STA-100",
    "responseMessage": "ISLEM BASARILI",
    "listProducts": {
    "products": [
    {
      "productId" : 1055,
      "productCode": "AKS10010",
      "productNameTr": "AKSESUAR",
      "productGroupCode": "99",
      "productGroupName": "AYDINLATMA",
      "ean": null,
      "logCode": null,
      "packageType": "KOLİ",
      "stackStatus": "false",
      "containerDefination": "TOPLU ÜRÜN",
      "masterWidth": 50.000,
      "masterLength": 50.000,
      "masterHeight": 50.000,
      "masterGross": 40.000,
      "masterNetKg": 40.000,
      "masterDesi": 41.667
    },
    {
      "productId" : 1056,
      "productCode": "KGN5618",
      "productNameTr": "BEYAZ GARDIROP",
      "productGroupCode": "98",
      "productGroupName": "MOBİLYA",
      "ean": null,
      "logCode": null,
      "packageType": "KOLİ",
      "stackStatus": "true",
      "containerDefination": "BİLEŞENLİ ÜRÜN",
      "masterWidth": 90.000, 
      "masterLength": 160.000,
      "masterHeight": 280.000,
      "masterGross": 25.000,
      "masterNetKg": 25.000,
      "masterDesi": 333.333,
      "productDetail": [
      {
        "productCode": "KGN5618-1",
        "productName": "BEYAZ GARDIROP-1",
        "width": 40.000,
        "length": 80.000,
        "height": 150.000,
        "gross": 10.000,
        "netKg": 10.000,
        "desi": 160.000
      },
      {
        "productCode": "KGN5618-2",
        "productName": "BEYAZ GARDIROP-2",
        "width": 50.000,
        "length": 80.000,
        "height": 130.000,
        "gross": 15.000,
        "netKg": 15.000,
        "desi": 173.333
      }
      ]
    },
    {
      "productId" : 1057,
      "productCode": "TV10010",
      "productNameTr": "TELEVİZYON",
      "productGroupCode": "98",
      "productGroupName": "MOBİLYA",
      "ean": null,
      "logCode": null,
      "packageType": "KOLİ",
      "stackStatus": "false",
      "containerDefination": "NORMAL ÜRÜN",
      "masterWidth": 20.000,
      "masterLength": 100.000,
      "masterHeight": 60.000,
      "masterGross": 20.000,
      "masterNetKg": 20.000,
      "masterDesi": 40.000
 }]}}}

---

Servis Cevapları

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