Tüm isteklerde
X-Tenant header’ı zorunludur. İşlemler yalnızca belirtilen tenant’a ait ürün ve depo kayıtları ile sınırlandırılmıştır.Endpoint özeti
Stok kavramı
Stok yönetimi, ürünlerin depo bazında miktarlarını takip eder. Her işlem (giriş, sayım, düzeltme, transfer) bir stok hareketi (StockMovement) kaydı oluşturur.
Stok durumu hesaplama
GET /stocks/overview yanıtında her ürün-depo kombinasyonu için stok durumu şu kurala göre belirlenir:
İş kuralları
Stok girişi (POST /stocks/entry)
type alanı: full modda quantity zorunludur; partial modda boxes, inner_units ve base_units zorunludur (quantity gönderilemez). partial modda bu üç alanın toplamı > 0 olmalıdır.Stok sayımı (POST /stocks/count)
Davranış: Ürünün o depoda daha önce hareketi yoksa başlangıç stoğu (
initialStock) oluşturulur. Hareketi varsa stok sayımı (stockCount) oluşturulur ve gerekirse farkı kapatmak için otomatik bir düzeltme hareketi (adjustmentMovement) eklenir.Stok düzeltmesi (POST /stocks/adjustment)
correction modu: Hedef miktarı belirtir; sistem mevcut bakiyeyle farkı hesaplar ve yalnızca fark kadar hareket oluşturur. Fark sıfırsa hiçbir hareket oluşturulmaz.in_out modu: direction alanı zorunludur (in veya out) ve quantity > 0 olmalıdır.