Stok Güncelleme

Tek bir ürünün stok miktarını verilen değere çeker. Gönderilen miktar mevcut stoğa eklenmez, stoğun yeni değeri olur. Aynı isteği tekrar göndermek sonucu değiştirmez.

PUT https://api.hizlisanalmarket.com/api/v1/products/{id}/stock · İzin: stock:write

Birden fazla ürünün stoğunu güncelleyecekseniz ya da ürünün Hızlı Sanal Market kimliğini (id) bilmiyorsanız Toplu Stok ve Fiyat ucunu kullanın. O uç ürünü barkod ya da stok koduyla bulur ve tek istekte 1.000 ürünü günceller.

Gövde

Alan Tür Zorunlu Açıklama
quantity Ondalık Evet Yeni stok miktarı. Negatif olamaz. Kilo gibi kesirli birimlerde ondalık kullanılabilir.

Örnek istek

curl -X PUT "https://api.hizlisanalmarket.com/api/v1/products/8f1c2a4e-3b5d-4c6e-9f70-1a2b3c4d5e6f/stock" \
  -H "Authorization: Bearer hm_sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "quantity": 25 }'

Yanıt

{
  "message": "Stok güncellendi.",
  "productId": "8f1c2a4e-3b5d-4c6e-9f70-1a2b3c4d5e6f",
  "quantity": 25
}

Olası hatalar (400)

code Neden
PRODUCT_NOT_FOUND Ürün bu mağazada yok.
QUANTITY_REQUIRED Gövdede quantity yok.
INVALID_QUANTITY Miktar negatif.
PRODUCT_STOCK_DERIVED Ürün bir paket. Stoğu bileşenlerinin stoğundan hesaplanır. Bileşen ürünlerin stoğunu güncelleyin.
PRODUCT_STOCK_NOT_TRACKED Ürün dijital. Dijital ürünlerde stok tutulmaz.

Notlar

  • Varyantlı ürünlerde (beden, renk gibi) stok varyantlarda tutulur. Varyant stokları bu sürümde API ile güncellenemez. Bu ürünlerde isInStock değeri varyant stoklarına göre hesaplanır.