Tüm isteklerde X-Tenant header’ı zorunludur. İşlemler yalnızca belirtilen tenant’a ait depolar ile sınırlandırılmıştır.
Endpoint özeti
| Metot | Endpoint | Açıklama |
|---|
GET | /api/v1/warehouses | Depoları filtreli olarak listeler |
GET | /api/v1/warehouses/{id} | Tek bir depoyu getirir |
POST | /api/v1/warehouses | Yeni depo oluşturur |
PUT | /api/v1/warehouses/{id} | Depoyu kısmi günceller |
DELETE | /api/v1/warehouses/{id} | Depoyu kalıcı olarak siler |
Tüm parametreler, alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın. Depo kavramı
Depo, ürünlerin fiziksel olarak bulunduğu konumu temsil eder. Stok girişi, transferi ve düzeltmeleri her zaman belirli bir depoya bağlıdır.
İş kuralları
Soft delete yoktur. DELETE /warehouses/{id} işlemi kaydı kalıcı olarak siler; geri alınamaz.
code benzersizliği: Depo kodu (code) sistem genelinde (tüm tenant’lar arasında) benzersiz olmalıdır.
Lokasyon validasyonu zincirlidir:
city_id → belirtilen country_id’ye ait olmalıdistrict_id → hem country_id hem city_id’ye ait olmalı
Yetkilendirme
Uygulama izinleri (permissions)
| İşlem | Permission |
|---|
| Listeleme | ViewAny:Warehouse |
| Detay / Tek gösterme | View:Warehouse |
| Oluşturma | Create:Warehouse |
| Güncelleme | Update:Warehouse |
| Silme (kalıcı) | Delete:Warehouse |
Token scope’ları (Passport)
| İşlem | Scope |
|---|
Okuma (index, show) | warehouses:read |
Yazma (store, update, destroy) | warehouses:write |
