Tüm isteklerde X-Tenant header’ı zorunludur. İşlemler yalnızca belirtilen tenant’a ait ürünler ile sınırlandırılmıştır.
Endpoint özeti
| Metot | Endpoint | Açıklama |
|---|
GET | /api/v1/products | Ürünleri filtreli olarak listeler |
GET | /api/v1/products/{id} | Tek bir ürünü detaylı getirir |
POST | /api/v1/products | Yeni ürün oluşturur |
PUT | /api/v1/products/{id} | Ürünü kısmi günceller |
DELETE | /api/v1/products/{id} | Ürünü soft delete eder |
DELETE | /api/v1/products/{id}/force | Ürünü kalıcı olarak siler |
Tüm parametreler, alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın. Ürün kavramı
Ürün, klinikteki fiziksel stok kalemlerini temsil eder. Her ürün; adı, fiyatı, KDV oranı, stok takip modu, birim bilgisi ve isteğe bağlı olarak marka ve kategori ile yönetilir.
İş kuralları
tax_rate: Sadece şu değerleri alabilir: 0, 1, 10, 20.
barcode: Gönderilirse tenant içinde benzersiz olmalıdır.
inner_unit_count: Kutu veya paket başına birim sayısını belirtir (min. 0).
Silme kuralları
Stok bakiyesi olan ürün silinemez. Stok bakiyesi > 0 olan bir ürüne soft delete veya force delete uygulanamaz.
Satışa bağlı ürün silinemez. Herhangi bir satış kalemine bağlı ürün, force delete dahil hiçbir şekilde silinemez.
Yetkilendirme
Uygulama izinleri (permissions)
| İşlem | Permission |
|---|
| Listeleme | ViewAny:Product |
| Detay / Tek gösterme | View:Product |
| Oluşturma | Create:Product |
| Güncelleme | Update:Product |
| Silme (soft delete) | Delete:Product |
| Kalıcı silme (force delete) | ForceDelete:Product |
Token scope’ları (Passport)
| İşlem | Scope |
|---|
Okuma (index, show) | products:read |
Yazma (store, update, destroy, forceDelete) | products:write |
