Ürün Grupları Listeleme - listProductGroups()

Ürün Grupları Listeleme

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan listProductGroups metodu, Horoz Lojistik tarafında ihracat operasyonunun siparişlerinde kullanılacak ürünlere ait ürün gruplarının listesini istemci tarafından yapılacak ürün kayıt işlemi aşamasında ürünün dahil olduğu grup bilgisini ifade etmek için hazırlanmıştır.

Ürün grubu bilgisine, istemci tarafından Horoz Lojistik sistemine bir ürün tanımı yapılırken ihtiyaç duyulacaktır. Bir istemcinin ürün ağacında yer alan ürünlerine ait ürün grubu bilgileri aslında her satıcı için entegrasyon sürecinin başında ilgili istemci için Horoz sistemine manuel olarak Horoz Web Portalı üzerinden tanımlanır. Satıcının başlangıçta tanımlanan mevcut listedeki ürün grupları haricinde yeni bir ürün grubu bilgisine ihtiyacı varsa, satıcı ilgili departmanın müşteri temsilcisi ile iletişime geçerek ihtiyaç duyulan ürün grubunun sisteme eklenmesi için talepte bulunabilir. Horoz Lojistik ihracat müşteri temsilcisi tarafından sisteme tanımı yapılan ürün grubu eş zamanlı olarak listProductGroups() metodunun dönüşlerinde istemciye dönülecektir. listProductGroups() metodu ile ilgili önemli bilgiler ve Horoz sisteminde ürün gruplarını listelerken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

listProductGroups() metodu POST yöntem ile JSON formatta veri alan, bir RESFtul web servis metodudur.
listProductGroups() metodu ile Horoz Lojistik sisteminden ürün grubu sorgusu yaparken, ürün grubuna 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. listProductGroups() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik E-İhracat Entegrasyonu Web servisine iletilmelidir.
listProductGroups() metodu, parametre olarak productGroupCode ve productGroupName değerlerini JSON formatta POST method olarak alır. İlgili metot alınan istek parametrelerinin karşılığında yanıt olarak productGroupCode, productGroupNameTr, productGroupNameEn, productPartnerNameTr, productPartnerNameEn, montageStatus bilgilerini istemciye döner. Dönen yanıt içerisinde ürün grup adı, ürün ortak adı bilgilerinin Türkçe ve İngilizce karşılıkları mevcuttur.
listProductGroups() metodu ile ürün grupları sorgulanırken, ürün grup kodu ya da ürün grup adı bazında sorgulama yapılabileceği gibi, sadece ürün grup kodu yada sadece ürün grup adı bazında sorgulama yapılabilir. Buna ek olarak, ürün grup kodu ve ürün grup 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.

POST listProductGroups()

EndPOINT

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

Parametre Açıklamaları & Kuralları

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

Alanlar
Örnek İstek
Örnek Cevap

Alanlar	Açıklama	Veri Tipi	Uzunluk	Alan Yeri	Zorunluluk
`processKey`	İstemci için tanımlanan `processKey` bilgisi	string	100	Header	Zorunlu
`productGroupCode`	Ürün grup kodu bilgisi	string	10	inBody Request	Opsiyonel
`productGroupName`	Ürün grup adı bilgisi	string	100	inBody Request	Opsiyonel

{ 
  "productGroupCode": "", 
  "productGroupName": "" 
}   

{
  "response": {
    "responseCode": "STA-100",
    "responseMessage": "ISLEM BASARILI",
    "listProductGroups": {
      "productGroups": [
        {
          "productGroupCode": "98",
          "productGroupNameTr": "MOBİLYA",
          "productGroupNameEn": "FURNITURE",
          "productPartnerNameTr": "MOBİLYA",
          "productPartnerNameEn": "FURNITURE",
          "montageStatus": "NO"
        },
        {
          "productGroupCode": "99",
          "productGroupNameTr": "AYDINLATMA",
          "productGroupNameEn": "LIGHTING",
          "productPartnerNameTr": "AYDINLATMA",
          "productPartnerNameEn": "LIGHTING",
          "montageStatus": "NO"
        },
        :
      ]
    }
  }
}

Servis Cevapları

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