T-SOFT/Admin API/Stok

Stok

Kapsam: okuma için read_inventory, stok ayarlamak için write_inventory.

Stok depo bazında tutulur; stoğu değiştirmek için ilgili depodaki miktarı ayarlarsınız. stockField değeri 1 olan depo, ürünün ve varyantın stock alanındaki miktardır.

Depolar

GET /catalog/warehouses

curl 'https://magaza.com/api/v3/admin/2026-01/catalog/warehouses' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Alan	Açıklama
`name`, `code`	Depo adı ve kodu
`isActive`	Depo kullanımda mı
`priority`	Sipariş karşılamada öncelik
`fulfillsOnline`	Online siparişleri karşılar mı
`tracksLocations`	Raf/lokasyon bazında stok tutuyor mu

Filtreler: id, warehouseType.

Depo stoklarını okuma

GET /catalog/warehouse-stocks

curl 'https://magaza.com/api/v3/admin/2026-01/catalog/warehouse-stocks?filter[productId]=45789' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

filter[productId] zorunludur; verilmezse 400 döner. filter[variantId] ve filter[warehouseId] ile daraltabilirsiniz.

Alan	Açıklama
`warehouseId`	Depo
`productId`	Ürün
`variantId`	Varyant (varyantsız üründe `0`)
`quantity`	Depodaki miktar
`updatedAt`	Son değişiklik

Stok ayarlama

Bir ürünün ya da varyantın bir depodaki miktarını mutlak değer olarak yazar.

POST /catalog/warehouse-stocks/-actions/set

curl -X POST 'https://magaza.com/api/v3/admin/2026-01/catalog/warehouse-stocks/-actions/set' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/json' \
  -d '{"productId": 45789, "variantId": 1203, "warehouseId": 1, "quantity": 25}'

Alan	Zorunlu	Açıklama
`productId`	Evet	Ürün
`variantId`	Hayır	Varyant; varyantsız ürün için göndermeyin
`warehouseId`	Evet	Depo
`quantity`	Evet	Yeni miktar, `0` ile `999999999` arası
`expected`	Hayır	Depoda şu an olmasını beklediğiniz miktar; gerçek miktar farklıysa yazılmaz ve `422` döner

Gövde JSON:API zarfı değil, düz JSON'dur. Yanıt güncellenmiş warehouse-stocks kaydıdır.

Pasif bir depo, ürüne ait olmayan bir varyant ya da tracksLocations değeri true olan (stoğu raf bazında tutan) bir depo 422 döner.

Eşzamanlı satışta stok ezmemek

Siz okuyup yazana kadar bir sipariş stoğu düşürebilir. Okuduğunuz miktarı expected olarak gönderin; arada değişmişse istek 422 döner, yeniden okuyup tekrar deneyin:

{"productId": 45789, "warehouseId": 1, "quantity": 30, "expected": 25}

expected göndermediğinizde değer mutlak olduğu için aynı isteği tekrarlamak güvenlidir.