Ürün Servisleri

Bu bölümdeki uçlarla mağazanın ürünlerini okuyabilir, yeni ürün açabilir, ürünleri güncelleyebilir ve stok ile fiyatları senkron tutabilirsiniz.

İşlem Uç İzin
Ürün listesi ve tek ürün GET /products, GET /products/{id} products:read
Ürün ekleme POST /products products:write
Ürün güncelleme PUT /products/{id} products:write
Stok güncelleme PUT /products/{id}/stock stock:write
Toplu stok ve fiyat POST /products/stock-price stock:write

Ürünü tanımlayan alanlar

Alan Açıklama
id Hızlı Sanal Market'in ürün kimliği (GUID). Ürün açıldığında döner. Tek ürün okuma, güncelleme ve stok uçlarında adreste kullanılır.
sku Stok kodu. Mağaza içinde benzersizdir. Kendi sisteminizdeki ürün koduyla eşleştirmek için en uygun alandır.
barcode Barkod (EAN/GTIN). Toplu stok/fiyat ucunda eşleştirme için kullanılabilir.

Kendi sisteminizde Hızlı Sanal Market id değerini saklamanız gerekmez. Toplu Stok ve Fiyat ucu ürünü barkod ya da stok koduyla bulur. Ürün listesi de sku ve barcode ile tam eşleşme filtresi alır.

Fiyat ve KDV

  • price, ürünün KDV dahil satış fiyatıdır.
  • compareAtPrice (isteğe bağlı), vitrinde üstü çizili gösterilen indirim öncesi fiyattır. O da KDV dahildir.
  • taxRate, KDV oranıdır (yüzde): 0, 1, 10, 20 gibi.
  • Fiyatlar Türk lirası cinsindendir. Kuruş için ondalık nokta kullanılır: 449.90.

Ürün durumu

status alanı şu değerlerden birini alır:

Değer Anlamı
Active Yayında, vitrinde görünür.
Draft Taslak, vitrinde görünmez. API'de isActive: false ile açılan ürünler bu durumdadır.
Archived Arşivlenmiş.
OutOfStock Tükendi olarak işaretlenmiş.

Stok

  • stockQuantity ondalıklı olabilir (örneğin kilo ile satılan ürünlerde 2.5). Ürünün kesirli satılıp satılmadığını allowFractionalQuantity gösterir.
  • unit satış birimidir: adet, kg, lt gibi. Gönderilmezse adet kabul edilir.
  • Paket ürünlerin stoğu bileşenlerinin stoğundan hesaplanır. Dijital ürünlerde stok tutulmaz. Bu ürünlere stok yazılamaz (bkz. Stok Güncelleme).