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

# Depolar API

> Ürün stoklarının tutulduğu depo konumlarını yönetmek için endpoint'ler.

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

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

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

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

<Warning>
  **Soft delete yoktur.** `DELETE /warehouses/{id}` işlemi kaydı **kalıcı olarak siler**; geri alınamaz.
</Warning>

<Note>
  **`code` benzersizliği:** Depo kodu (`code`) sistem genelinde (**tüm tenant'lar arasında**) benzersiz olmalıdır.
</Note>

<Note>
  **Lokasyon validasyonu zincirlidir:**

  * `city_id` → belirtilen `country_id`'ye ait olmalı
  * `district_id` → hem `country_id` hem `city_id`'ye ait olmalı
</Note>

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