Zorunlu alanlar
Şirket içinde benzersiz ürün kodu. Oluştururken
"Next" gönderirseniz kod, şirketin ÜRÜN seri tanımından üretilir; güncellemede "Next" kullanılamaz (2003). Üretim mantığı cari kodundaki ile aynıdır, yalnızca seri tanımı farklıdır.Ana birim kodu: birim tanımlarından bir birimin evrensel kodu (ör.
C62) ya da evrensel kodu yoksa adı.Ürün tipi
Uygulamadaki masraf, demirbaş ve ihtiyaç malzemesi kayıtları ayrı ekranlardan girilir; API üzerinden oluşturulamaz ve bu değerler reddedilir (
2007). Veritabanında zaten var olan bu tür kayıtlar da API’de tamamen görünmezdir: listede, detayda, alt kaynaklarında (fiyat, parametre, kritik stok) ve ProductCode ile yapılan hiçbir referansta (teklif/sipariş/irsaliye satırı, fiyat kapsamı, …) çıkmaz; ID’si doğrudan denenirse 2000 (ürün bulunamadı) döner.
Stok tipi
Vergi alanları
VatRate: KDV oranı tanımlarındaki oranlardan biri (ör.20).AdditionalTaxes: ek vergiler (ÖTV gibi),{ Code, Rate }listesi olarak, en fazla 3 kayıt (2017). HerCodezorunludur ve aşağıdaki ek vergi kodlarından biri olmalıdır (2015); aynı kod bir ürün üzerinde yalnızca bir kez kullanılabilir (2016). Üründe ek vergi yoksa boş liste gönderin.
İhracat alanları
Gtip, DeliveryTerm (teslim şekli), PackagingType (paketleme tipi), TransportMode, OriginCountryCode (menşei ülke kodu), Brand ve Model alanları ihracat faturalarının ek bilgilerinde kullanılır.
Gruplar
Group1 … Group5 alanları ürün gruplarının seçilebilir değerleridir. Gönderilen ad, grup detaylarından ilgili grup numarasına ait olmalıdır: Group2 alanına yalnızca 2. grubun detayı gönderilebilir (2011).
Ürün grupları hiyerarşiktir: bir detayın üstü (ParentGroup) her zaman bir önceki grubun detayıdır.
- Grup 1 detaylarının üstü olmaz, hepsi her zaman seçilebilir.
- Grup 2’de bir detay seçildiyse, grup 3’te yalnızca üstü o detay olanlar ile üstü boş olanlar seçilebilir. Aynı kural 3 → 4 ve 4 → 5 için de geçerlidir.
- Üstü boş olan detay her üst seçiminde seçilebilir. Örneğin her markada geçerli bir “SUV” gövde tipi, üstü boş bırakılarak tanımlanır.
Group3 alanına, üstü Group2 ile seçilen detay olmayan (ve üstü boş da olmayan) bir detay gönderirseniz istek 2013 ile reddedilir.
Varyantlar
Bir ürün başka bir ürünün (ana ürününün) varyantı olabilir. Ürün yanıtları (ürün listesi, ürün detayı, değişen ürünler)MainProductId ve MainProductCode alanlarını döner: ana üründe ikisi de boş, varyantta doludur. Varyantlar Noyax’ta tanımlanır; API bu bağı oluşturmaz ya da değiştirmez.
Değişen ürünler yanıtında kendi fiyatı olmayan varyant ana ürünün fiyatlarını (PricesFromMainProduct: true), hiç ürün grubu seçilmemiş varyant da ana ürünün gruplarını (GroupsFromMainProduct: true) döner. Ürün listesi ve ürün detayı varyantın yalnızca kendi değerlerini döner.
Birimler
Ürünün ana birimiUnitCode ile yazılır. 2. ve 3. birimler API üzerinden yazılamaz, Noyax’ta tanımlanır; ürün yanıtında AlternativeUnits listesinde ana birime çevrimleriyle döner. Fiyatlarda ve teklif, sipariş, irsaliye, fatura satırlarında UnitCode olarak ana birim ya da bu birimlerden biri gönderilebilir.
Quantity 0 ise çevrim tanımlı değildir ve bu birimle gönderilen satırlar reddedilir.