Stok

Stok kartları ve stok hareketleri yönetimi.

GET /api/v1/stok

Stok Listesi

Tüm stok kartlarını sayfalanmış olarak listeler.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`page`	integer	Opsiyonel	Sayfa numarası (varsayılan: 1)
`per_page`	integer	Opsiyonel	Sayfa başı kayıt (varsayılan: 25, maks: 100)
`search`	string	Opsiyonel	Stok adı veya koduna göre arama
`kategori_id`	integer	Opsiyonel	Kategoriye göre filtre

Response 200

{
    "success": true,
    "data": [
        {
            "sk_id": 1,
            "sk_stokKodu": "STK-001",
            "sk_stokAdi": "Laptop Çantası",
            "sk_birimFiyati": 250,
            "sk_kdvOrani": 20,
            "sk_mevcut": 45
        }
    ],
    "meta": {
        "current_page": 1,
        "total": 156,
        "per_page": 25
    }
}

GET /api/v1/stok/{id}

Stok Detay

Belirtilen ID'ye ait stok kartının detay bilgilerini döner.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`id`	integer	Zorunlu	Stok kartı ID

Response 200

{
    "success": true,
    "data": {
        "sk_id": 1,
        "sk_stokKodu": "STK-001",
        "sk_stokAdi": "Laptop Çantası",
        "sk_birimFiyati": 250,
        "sk_kdvOrani": 20,
        "sk_mevcut": 45,
        "sk_birim": "Adet",
        "sk_barkod": "8690123456789"
    }
}

POST /api/v1/stok

Stok Kartı Oluştur

Yeni bir stok kartı oluşturur.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`sk_stokAdi`	string	Zorunlu	Stok adı
`sk_stokKodu`	string	Opsiyonel	Stok kodu (otomatik oluşturulur)
`sk_birimFiyati`	decimal	Zorunlu	Birim fiyatı
`sk_kdvOrani`	integer	Zorunlu	KDV oranı (0, 1, 10, 20)
`sk_birim`	string	Opsiyonel	Birim (Adet, Kg, Lt, vb.)

Request Body

{
    "sk_stokAdi": "Wireless Mouse",
    "sk_birimFiyati": 189.9,
    "sk_kdvOrani": 20,
    "sk_birim": "Adet"
}

Response 201

{
    "success": true,
    "data": {
        "sk_id": 157,
        "sk_stokKodu": "STK-157",
        "sk_stokAdi": "Wireless Mouse"
    },
    "message": "Stok kartı başarıyla oluşturuldu."
}

PUT /api/v1/stok/{id}

Stok Kartı Güncelle

Mevcut stok kartını günceller.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`id`	integer	Zorunlu	Stok kartı ID
`sk_stokAdi`	string	Opsiyonel	Stok adı
`sk_birimFiyati`	decimal	Opsiyonel	Birim fiyatı

Request Body

{
    "sk_stokAdi": "Wireless Mouse Pro",
    "sk_birimFiyati": 219.9
}

Response 200

{
    "success": true,
    "data": {
        "sk_id": 157
    },
    "message": "Stok kartı güncellendi."
}

DELETE /api/v1/stok/{id}

Stok Kartı Sil

Stok kartını siler. Hareket kaydı olan stok kartları silinemez.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`id`	integer	Zorunlu	Stok kartı ID

Response 200

{
    "success": true,
    "message": "Stok kartı silindi."
}

cURL Örneği

GET /api/v1/stok

curl -X GET https://api.pratikesnaf.com/api/v1/stok \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"