Ürün Güncelleme - updateProduct()

Ürün Güncelleme

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan updateProduct metodu, sipariş oluşturma adımında kullanılacak olan ve Horoz Lojistik sistemine daha önce tanımlanmış ürünlerin bilgilerinin güncellenmesi için kullanılmalıdır. updateProduct() 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.

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

• updateProduct() metodu ile Horoz sisteminde ürün bilgileri güncelleme işlemi yaparken, ilgili ürüne 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. updateProduct() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik E-İhracat Entegrasyonu Web servisine iletilmelidir.

• updateProduct() metodu satıcı tarafından özellikle boyut bilgileri hatalı girilmiş ürün tanımlarının düzeltilmesi için kullanılmalıdır.

• updateProduct() metodu ile boyut bilgileri güncellendiği gibi, ürünün kap tanımı bilgiside güncellenebilir ve ürün NORMAL ve/veya TOPLU ÜRÜN tipinden BİLEŞENLİ ÜRÜN tipine dönüştürülebilir. Bu dönüşümün tam tersi de gerçekleştirilebilir.

• updateProduct() metodu, istemcinin Horoz sisteminde sipariş oluşturulacak ve daha önce kayıt edilmiş ürünlerin Horoz sistemindeki bilgilerini güncellemeye yarayan E-İhracat web servisi metodudur.

• updateProduct() metodu parametre olarak; productId, productCode, productName, productGroupName, width, length, height, gross, netKg, desi, ean, logCode, packageType, stackStatus, containerDefination değerlerini JSON formatta POST method olarak alır.

• Karşılığında responseCode ve responseMessage bilgilerini istemciye dönerek güncelleme işleminin başarı/başarısızlık durumunu bildirir. Ürün güncelleme işlemi herhangi bir sipariş içinde kullanılmış olan ürün için yapılamaz.

---

POST updateProduct()

ENDPOINT

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

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda updateProduct() 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
productId	Ürün Id bilgisi	Integer	-	inBody Request	Zorunlu
productCode	Ürün kodu bilgisi	string	100	inBody Request	Zorunlu
productName	Ürün adı bilgisi	string	500	inBody Request	Zorunlu
productGroupName	Ürün grup kodu bilgisi	string	10	inBody Request	Zorunlu
productDetail	Ürün detayları dizisi	Array	-	inBody Request	-------
width	En – productDetail dizisinin alanıdır.	Float	-	inBody Request	Zorunlu
length	Boy – productDetail dizisinin alanıdır.	Float	-	inBody Request	Zorunlu
height	Yükseklik – productDetail dizisinin alanıdır.	Float	-	inBody Request	Zorunlu
gross	Brüt Ağırlık – productDetail dizisinin alanıdır.	Float	-	inBody Request	Zorunlu
netKg	Net Ağırlık – productDetail dizisinin alanıdır.	Float	-	inBody Request	Zorunlu
desi	Desi – productDetail dizisinin alanıdır.	Float	-	inBody Request	Zorunlu
ean	Ürün EAN kodu	string	13	inBody Request	Opsiyonel
logCode	Ürün log kodu	string	7	inBody Request	Opsiyonel
packageType	Paket tipi	string	100	inBody Request	Zorunlu
stackStatus	İstif durumu	Boolean	-	inBody Request	Zorunlu
containerDefination	Kap tanımı	string	15	inBody Request	Zorunlu

Örnek İstek

  {
    "productId": 10545,
    "productCode": "KGN5618",
    "productName": "BEYAZ GARDIROP",
    "productGroupName": "MOBİLYA",
    "productDetail": [
      {
        "width": 10.2,
        "length": 10.2,
        "height": 10.2,
        "gross": 100.2,
        "netKg": 100.2,
        "desi": 55
      },
      {
        "width": 10.2,
        "length": 10.2,
        "height": 10.2,
        "gross": 100.2,
        "netKg": 100.2,
        "desi": 55
      }
    ],
    "ean": "123456",
    "logCode": "654321",
    "packageType": "PALET",
    "stackStatus": false,
    "containerDefination": "BİLEŞENLİ ÜRÜN"
  }

Örnek Cevap

  {
    "response": {
      "responseCode": "STA-100",
      "responseMessage": "Basarili",
      "updateProductResponse": [
        {
          "productId": 10565
        }
      ]
    }
  }

updateProduct() metodu içerisinde beklenen enum değerler için aşağıda detaylı bilgi verilmiştir.

ENUM ALAN ADI	ENUM ALAN ADI	AÇIKLAMA
productGroupName	Ürün grup adı	listProductGroups metodundan dönen yanıt içerisinden alınan, ürün tanımı için uygun olan productGroupName bilgisi doğru ve UPPERCASE olarak geçilmelidir.
packageType	Paket tipi	PALET, KONTEYNER, DOSYA, KOLİ değerlerinden ürün tanımı için uygun olan değer geçilerek paket tipi bildirilebilir.
containerDefination	Kap tanımı	NORMAL ÜRÜN, TOPLU ÜRÜN, BİLEŞENLİ ÜRÜN değerlerinden ürün tanımı için uygun olan değer geçilerek kap tanımı bildirilebilir.

---

Servis Cevapları

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