Fiyat ve stok güncelle

POST /sapigw/suppliers/{supplierId}/products/price-and-inventory — PIM API · Fiyat & Stok

Barkod bazında liste fiyatı, satış fiyatı ve stok miktarını günceller. İstek kuyruğa alınır, sonuç BatchRequestId ile sorgulanır.

  • Yalnızca PIM'de kayıtlı barkodların fiyatı yazılır; Barcode boş satırlar atlanır.
  • Stok, firmanın varsayılan deposuna yazılır.
  • thresholdCheck=false gönderilirse yalnızca fiyat güncellenir, stok yazılmaz.
  • Firmada fiyat veya stok aktarımı kapalıysa ilgili kısım işlenmez ve sonuç satırlarına hata mesajı düşer.
  • SourceFirstPrice gönderilmez veya 0 olursa ListPrice değeri kullanılır.

Parametreler

  • supplierId (path, string, zorunlu): CommerceLab'in size ilettiği tedarikçi kimliği. Bu ortamda tanımlı değilse istek 401 alır.
  • thresholdCheck (query, boolean): true (varsayılan): fiyat eşik kontrolüyle fiyat ve stok yazılır. false: eşik kontrolü yapılmadan yalnızca fiyat yazılır, stok güncellenmez.
  • trustedSource (query, boolean): Firmada "güvenilir kaynak" zorunluluğu açıksa true gönderilmelidir; gönderilmezse istek işlenmeden reddedilir. Zorunluluk kapalıysa etkisizdir.
  • Tenant (header, string): Basic Auth ile birden fazla firmaya erişen kullanıcılarda firma kodu. Bearer token kullanılıyorsa gerekmez.

İstek gövdesi

  • items (object[], zorunlu): Güncellenecek barkodlar.
    • items.barcode (string, zorunlu): PIM'de kayıtlı barkod.
    • items.quantity (integer): Stok miktarı (varsayılan depo).
    • items.listPrice (number): Liste fiyatı.
    • items.salePrice (number): Satış fiyatı.
    • items.catalogName (string): Fiyatın yazılacağı katalog adı; boşsa firmanın varsayılan fiyat kataloğu kullanılır.
    • items.sourceFirstPrice (number): İlk (kaynak) fiyat; gönderilmezse veya 0 ise listPrice kullanılır.

Yanıtlar

  • 200: İstek alındı; alanların anlamı ürün aktarımıyla aynıdır.
  • 400: İstek gövdesi geçerli JSON değil veya alan tipleri uyumsuz.
  • 401: Kimlik doğrulanamadı veya supplierId bu ortamda tanımlı değil. Gövde boştur.
  • 500: Sunucu tarafında beklenmeyen hata.

200 yanıt alanları

  • Message (string): İstek kuyruğa alınamadıysa nedeni (ör. istek limiti aşıldı); başarılıysa null.
  • IsSuccess (boolean): İstek kuyruğa alındıysa true.
  • BatchRequestId (string): İşlem kimliği; sonucu sorgulamak için saklayın. Limit aşımında null.