Ürün Oluşturma - createProducts()

Ürün Oluşturma

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan createProducts metodu, Horoz sisteminde sipariş oluşturma adımında kullanılacak olan ürünlerin Horoz Lojistik sistemine tanımlanması için kullanılmalıdır. createProduct() metodu ile ilgili önemli bilgiler ve Horoz Lojistik sisteminde ürün oluşturulurken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

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

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

• Ürünler sisteme tanımlanırken satıcının tanımlarında yer alan ürün kodu, ürün adı, Horoz Lojistik tarafından verilen ürün grup seçimi ve boyut bilgileriyle tanımlanması gerekir. Tanımlanan bu ürünler sipariş giriş anında ürün kodu veya adıyla siparişteki adet değerleri girilerek sipariş oluşturulur.

• Bu metotla girilen ürünler silme özelliğine sahip değildir. Satıcı tarafından özellikle boyut bilgileri hatalı girilmiş ürün tanımlarının düzeltilmesi için updateProduct metodu kullanılmalıdır.

• Sistemde tanımlı olan satıcı ve ürün kodu bilgilerine göre tekillik kontrol edilir. Aynı ürün sisteme iki defa eklenemez.

• Ürünler tanımlanırken özellikle siparişin muhteviyatında gereksinim duyulan karma koli ihtiyaçları bu metotla satıcı tarafından sipariş giriş öncesinde sisteme tanımlanması gerekmektedir. Bu tanımı yaparken karma koli olmasından dolayı ürün kodu ve ürün adı tekillik yaklaşımı gözetilerek satıcı tarafından belirlenebilir. ÜRÜN KODU: KOLİ1, ÜRÜN ADI: 50 DESİ KOLİ ; ÜRÜN KODU:KOLİ2, ÜRÜN ADI: 100 DESİ KOLİ bu şekilde ihtiyacına göre taşıma kolileri oluşturulup kullanılabilir. Bu kullanımda sipariş giriş yapılırken kolilerin içinde yer alacak ürün adetleri sipariş giriş anında toplam satış adeti olarak geçilmelidir.

• Ürün tanımlarının direkt siparişe etki eden özellikle ETGB’nin oluşmasında da etkin kap ve koli adetleri gibi bir bilgi gerekir. Bunu ürün tanımlarında ürünler sisteme eklenirken seçilecek tür belirler. Türler Normal ürün, Bileşenli Ürün ve Toplu üründür. Normal ürün 1 kap , 1 adet olarak, örneğin televizyonu temsil eder.

• Sipariş girişinde satış adeti kaç seçilirse ETGB üzerinde yer alan kap adeti de aynı olmalıdır. Bileşenli ürün özellikle mobilya için geçerli olup mobilyanın demonte bileşenlerinin kap adeti olarak ETGB üstünde yer alması için ve ürünün toplam desi ve ağırlığını belirleyebilmek için tüm parçalarının girileceği türler için kullanılmalıdır.
  Örneğin satılan bir gardırop, siparişlere gardırop olarak bir satış adetiyle eklenir. Ancak gardıroba ait bileşenler (kapak, raf, çekmece, üst-alt tabla) kap adeti olarak sisteme girilmiş değer üstünden ETGB’ye ve sipariş detaylarına eklenir. Toplu ürün ise karma koli anlamına gelen satıcıların yoğunlukla parçalı ürünleri tek koli olarak sevk ettikleri durumları karşılar. Örneğin gömlek ve çorapların bulunduğu 50 desilik bir koli oluşturulması verilebilir. Burada gömlek ve çorapların satış adetleri eşya adetini, kullanılan 50 desilik koli kap adetini temsil etmektedir.

ÜRÜN TİPİ	ÜRÜN ADI	EŞYA ADEDİ	KAP ADEDİ
NORMAL ÜRÜN	TELEVİZYON	1 ADET	1 ADET
BİLEŞENLİ ÜRÜN	GARDIROP	1 ADET	1.KAPAK 2.RAF 3.ÇEKMECE 4.ÜST 5.ALT TABLA
TOPLU ÜRÜN	KARMA KOLİ	30 ÇORAP, 20 GÖMLEK	1 ADET

• Birkaç farklı barkod türü olmasına rağmen EAN sembolü; 12 veya 13 haneli bir ürün tanıtım kodudur. Her EAN, ürünü, üreticiyi ve niteliklerini benzersiz bir şekilde tanımlar; tipik olarak, EAN bir ürün etiketine 14 veya ambalajına barkod olarak basılır. Bir EAN kodu, bir Avrupa sistemi temelinde bir nesneyi tanımlamak için kullanılan rakamların benzersiz bir birleşimidir. (‘EAN’, ‘The European Article Number’ anlamına gelir)

• Log kodu; EAN kodunun içerisinde yer alan ürünün üretim bandındaki versiyonunu temsil eden koddur.

• createProduct metodu, istemcinin Horoz sisteminde sipariş oluşturulacak ürünleri Horoz sistemine kayıt edilmesini sağlayan E-İhracat web servisi metodudur. E-İhracat entegrasyonuna dahil olacak istemciler için ürün tanımlamasının, sipariş oluşturma işlemlerinden önce yapılması elzemdir.

• createProduct metodu parametre olarak; 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, responseMessage ve productId bilgilerini istemciye dönerek kayıt işleminin başarı/başarısızlık durumunu bildirir.

• Ürün tanımları sipariş datası içerisinde tekli ürün için ürün tanımı şeklinde kullanılabilir. (Ürün kodu, Ürün adı) Bileşenli ürün ürünü temsil eden ana kayıt ile gönderilmelidir. (Fil Dişi Çocuk Gardırop) Ürünün satışı yapılmış adeti ve sahip olduğu parça sayısı ile çarpılmış kadar kap adeti siparişe geçilmesi gerekir. Toplu ürün sisteme tanımlanmış ana kaydıyla (50’lik koli) gönderilir. Satış adeti fiziki kap adeti isteğe bağlı olarak siparişe değerlerine geçilebilir. (50’lik koli = 1 Satış Adeti = 20 Çorap, 40 Gömlek gibi.)

---

POST createProducts()

ENDPOINT

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

Parametre Açıklamaları & Kuralları

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

Alanlar

Alanlar	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
productGroupName	Ürün grup kodu bilgisi	string	10	inBody Request	Zorunlu
productDetail	Ürün detayları dizisi	array	-	inBody Request	-
width	En	float	-	inBody Request	Zorunlu
lenght	Boy	float	-	inBody Request	Zorunlu
height	Yükseklik	float	-	inBody Request	Zorunlu
gross	Brüt ağırlık	float	-	inBody Request	Zorunlu
netKg	Net ağırlık	float	-	inBody Request	Zorunlu
desi	Desi	float	-	inBody Request	Opsiyonel
ean	Ürün EAN kodu	string	13	inBody Request	Opsiyonel
logCode	Ürün LOG kodu	string	7	inBody Request	Zorunlu
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

{
  "productCode": "TV10010",
  "productName": "TELEVİZYON",
  "productGroupName": "MOBİLYA",
  "productDetail": [
    {
      "width": 20,
      "length": 100,
      "height": 60,
      "gross": 20,
      "netKg": 20,
      "desi": 40
    }
  ],
  "ean": null,
  "logCode": null,
  "packageType": "KOLI",
  "stackStatus": "true",
  "containerDefination": "NORMAL ÜRÜN"
}

Örnek Cevap

{
  "response": {
    "responseCode": "STA-100",
    "responseMessage": "Basarili",
    "createProductResponse": [
      {
        "productId": 10557
      }
    ]
  }
}

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

ENUM ALAN	ÜRÜN ADI	EŞYA ADEDİ
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.

containerDefination (kap tanımı) bilgisine geçilecek bilgilerden BİLEŞENLİ ÜRÜN ürün bildirimi NORMAL ÜRÜN ve TOPLU ÜRÜN bildiriminden farklı olarak, bünyesinde bileşenleri bulunan ürünler için yapılacak ürün bildirimini ifade eder. BİLEŞENLİ ÜRÜN bildirimine bünyesinde birden fazla bileşen ürün bulunabilecek olan bir GARDIROP örnek olarak verilebilir.

Horoz sistemine BİLEŞENLİ ÜRÜN için bildirim yapılırken; containerDefination : BİLEŞENLİ ÜRÜN olarak geçilerek, request içerisindeki productDetail dizisi içerisine ürüne ait bileşenlerin width, length, height, gross, netKg ve desi bilgileri bileşen bazında geçilmelidir.
containerDefination : TOPLU ÜRÜN yada containerDefination : NORMAL ÜRÜN olan ürün bildirimleri için productDetail dizisi içerisine yalnızca 1 ürüne ait width, length, height, gross, netKg ve desi bilgileri geçilmelidir. Horoz sistemine gönderilecek bileşenli ürüne ait, productDetail içerisinde birden fazla bileşeni bulunan bir kayıt içeriğindeki her bir bileşen; Horoz sisteminde bir ürün anlamını taşır.

Sisteme birer ürün olarak kayıt edilen bileşenler için ürün adı ve ürün kodu bilgisi master ürün adı ve master ürün kodu bilgisinin sonuna - 1, - 2 şeklinde adet kadar eklenerek oluşturulur. Bileşenli ürün oluşturma aşamasında, yanıt içerisinde dönen productId, bileşenli ürüne ait master ürün bilgisinin id bilgisidir.

---

Servis Cevapları

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