> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ürünler API

> Klinikteki ürün envanterini, stok takip modunu, fiyatlandırma ve KDV bilgilerini yönetmek için endpoint'ler.

<Note>
  Tüm isteklerde `X-Tenant` header'ı **zorunludur**. İşlemler yalnızca belirtilen tenant'a ait ürünler ile sınırlandırılmıştır.
</Note>

## 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         |

<Tip>
  Tüm parametreler, alanlar ve örnek istek/yanıtlar için **[API Referansı](/api-reference)** sekmesine bakın.
</Tip>

## Ü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`.

<Note>
  **`barcode`:** Gönderilirse tenant içinde **benzersiz** olmalıdır.
</Note>

<Note>
  **`inner_unit_count`:** Kutu veya paket başına birim sayısını belirtir (min. 0).
</Note>

## Silme kuralları

<Warning>
  **Stok bakiyesi olan ürün silinemez.** Stok bakiyesi `> 0` olan bir ürüne soft delete veya force delete uygulanamaz.
</Warning>

<Warning>
  **Satışa bağlı ürün silinemez.** Herhangi bir satış kalemine bağlı ürün, **force delete dahil** hiçbir şekilde silinemez.
</Warning>

## 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` |