Stok

Taban adres: https://api.winkwop.com/api/v1/integration/inventory/{product_id} İzinler: GET için read_inventory, PUT için write_inventory.

Bu uç, ürün güncelleme ucundan bilerek ayrı tutuldu: bir ERP her senkronizasyonda sadece stok miktarını gönderir, ürünün adını/fiyatını/açıklamasını tekrar tekrar taşımasına gerek olmasın diye.

Oku

curl https://api.winkwop.com/api/v1/integration/inventory/{product_id} \
  -H "X-Api-Key: wk_sk_..."

{
  "product_id": "b3f5...-uuid",
  "sku": "TS-001",
  "track_quantity": true,
  "quantity": 42,
  "stocks": {
    "8a12...-loc-uuid": 30,
    "9c44...-loc-uuid": 12
  }
}

• quantity: depo ayrımı yapmayan mağazalar için toplam miktar (products.quantity).
• stocks: depo bazlı miktar (location_id → adet). Mağaza tek depo/depo yönetimi kullanmıyorsa boş dönebilir — o zaman quantity'ye bakın.
• Depo id'lerinin hangi fiziksel depoya karşılık geldiğini görmek için Depolar sayfasındaki listeleme ucunu kullanın — stocks yalnızca location_id'yi verir, depo adını değil.

Güncelle

quantity ve stocks alanlarının en az biri gönderilmelidir; ikisi de gönderilebilir, gönderilmeyen taraf değişmeden kalır. stocks içinde listelenmeyen depoların stoğu da değişmez — yalnızca gönderdiğiniz location_id güncellenir.

Tek depo, toplam miktar:

curl -X PUT https://api.winkwop.com/api/v1/integration/inventory/{product_id} \
  -H "X-Api-Key: wk_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"quantity": 37}'

Depo bazlı:

curl -X PUT https://api.winkwop.com/api/v1/integration/inventory/{product_id} \
  -H "X-Api-Key: wk_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "stocks": {
      "8a12...-loc-uuid": 25,
      "9c44...-loc-uuid": 10
    }
  }'

Yanıt, güncel hâliyle aynı GET gövdesini döner — ayrıca bir okuma isteği atmanıza gerek kalmaz.

İkisi de boş gönderilirse 400 BAD_REQUEST alırsınız. Ürün başka bir mağazaya aitse ya da yoksa 404 NOT_FOUND döner.