Ana içeriğe atla
Ürün kartı; stok, fatura, sipariş ve teklif kayıtlarında kullanılan ana tanımdır.

Zorunlu alanlar

string
gerekli
Ş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.
string
gerekli
Ürün tanımı. En fazla 255 karakter.
string
gerekli
Ana birim kodu: birim tanımlarından bir birimin evrensel kodu (ör. C62) ya da evrensel kodu yoksa adı.
Diğer alanların hepsi isteğe bağlıdır.

Ü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). Her Code zorunludur 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.
Ürünün TransportMode alanı ihracat kod listesidir; sevkiyat tanımındaki TransportMode (1 karayolu, 2 demiryolu, 3 denizyolu, 4 havayolu) ile aynı liste değildir.

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.
Ürün kaydederken bu kural doğrulanı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 birimi UnitCode 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.
Bu örnekte 1 koli 12 ana birime (ör. adet) eşittir; satırda 2 koli göndermek ana birimde 24 eder. Quantity 0 ise çevrim tanımlı değildir ve bu birimle gönderilen satırlar reddedilir.

Kapsam dışı alanlar

Ürünün pazaryeri (Trendyol, Hepsiburada, N11, …) bilgileri, resimleri, varyantları ve depozito bilgileri API üzerinden yönetilmez.