Bölüm 10 — Stok Yönetimi

Bu bölüm, Shipots'ta malzeme ve hizmet kartlarının yönetilmesini, stok giriş/çıkış/transfer hareketlerini, kategori ve birim tanımlarını ile stok hareket geçmişinin izlenmesini anlatır.

Modüldeki sayfalar:

Sayfa	URL	İşlev
Stok Yönetimi	/stock	Malzeme, kategori, transfer, hareket ve birim yönetimi (5 sekme)
Stok Birimleri	/stock-units	Birim ve dönüşüm çarpanı yönetimi (Stok sayfasındaki Birimler sekmesiyle aynı özellik)

Önemli: Uygulamada fiziksel stok sayımı (inventory count) özelliği bulunmamaktadır. Stok bakiyesi yalnızca Giriş, Çıkış ve Transfer hareketlerinden üretilir. Yılsonu sayımında fark tespit edilirse, farkı bir Giriş veya Çıkış işlemiyle düzeltmeniz gerekir.

---

10.1 Stok Birimleri ve Dönüşümler

Sol menüden Malzeme Yönetimi → Stok Birimleri ile açılır (URL: /stock-units). Ayrıca Stok Yönetimi sayfası içindeki Birimler sekmesinden de erişilebilir — her iki yer de aynı veriyi yönetir.

[ŞG: Stok Birimleri — iki sütunlu düzen, solda birim listesi, sağda dönüşüm çarpanları]

Sayfa yapısı

Sayfa iki yan yana bölümden oluşur:

• Sol — Birimler tablosu
• Sağ — Dönüşüm Çarpanları tablosu

10.1.1 Birimler

Birim, bir malzemenin ölçü birimidir (kg, litre, adet, ton vb.).

Tablo sütunları

Sütun	Açıklama
Kod	Kısa kod (örn. kg, lt, adet)
Ad	Tam ad (örn. Kilogram, Litre, Adet)
Durum	Aktif / Pasif

Yeni birim ekleme

1. Sağ üstteki ➕ Yeni Birim düğmesine tıklayın.
2. Açılan modalde:
   • Kod * (örn. kg, lt)
   • Ad * (örn. Kilogram, Litre)
3. Kaydet düğmesine tıklayın.

Varsayılan birimleri yükleme

🔄 Varsayılanları Yükle düğmesi, sık kullanılan birimleri (kg, lt, adet, ton, m³ vb.) tek tıkla sisteme ekler. Yeni kurulumda bu düğmeyi kullanmak en pratik yoldur.

10.1.2 Dönüşüm Çarpanları

Dönüşüm çarpanı, bir birimin başka bir birime nasıl dönüştürüleceğini tanımlar. Örneğin 1 Kutu = 12 Adet gibi.

Tablo sütunları

Sütun	Açıklama
Kaynak Birim	Dönüşümün kaynağı
Hedef Birim	Dönüşümün hedefi
Çarpan	1 kaynak birim kaç hedef birime eşit

Yeni dönüşüm ekleme

1. ➕ Dönüşüm Ekle düğmesine tıklayın.
2. Açılan modalde:

Alan	Açıklama	Zorunlu
Kaynak Birim	Açılır	✅
Hedef Birim	Açılır	✅
Çarpan	1 kaynak = kaç hedef	✅

Örnekler:

• 1 Kutu = 12 Adet → Çarpan: 12
• 1 Ton = 1000 Kilogram → Çarpan: 1000
• 1 Paket = 6 Adet → Çarpan: 6

3. Kaydet düğmesine tıklayın.

İpucu: Dönüşüm çarpanları, farklı birim bazlı alım/satım yaptığınızda hesaplamanın tutarlı olmasını sağlar. Örneğin "Kutu" olarak alınan bir malzeme "Adet" olarak tüketilirse, otomatik dönüştürme için çarpan tanımlı olmalıdır.

---

10.2 Stok Yönetimi Sayfası — Genel Bakış

Sol menüden Malzeme Yönetimi → Stok Yönetimi ile açılır (URL: /stock).

Bu sayfa beş sekmeden oluşur:

Sekme	İşlev
Malzemeler	Stok kartları, bakiye ve değer görünümü
Kategoriler	Malzeme kategorileri (ağaç yapılı)
Transferler	Ambarlar arası transfer irsaliyeleri
Hareketler	Tüm giriş/çıkış/transfer hareket geçmişi
Birimler	Birim ve dönüşüm (Bölüm 10.1 ile aynı)

Üst eylem düğmeleri

Sayfa başlığının sağında, hangi sekmede olursanız olun görünen dört düğme vardır:

Düğme	İşlev
📥 PDF	Mevcut listeyi PDF olarak indirir
🟢 Giriş	Stok giriş modali (Bölüm 10.4)
🟡 Çıkış	Stok çıkış modali (Bölüm 10.4)
🔵 Transfer İrsaliyesi	Çok kalemli transfer modali (Bölüm 10.5)

---

10.3 Malzeme Kartları

Malzemeler sekmesi, stok kartlarınızı listeler.

[ŞG: Malzemeler sekmesi — üstte filtreler, düşük stok toggle, altta tablo]

Üst filtreler

• Kart Türü — Stok Kartı / Hizmet Kartı (çoklu seçim)
• Kategori — Çoklu seçim
• İşyeri — Çoklu seçim (bakiye hangi işyerinde görünsün)
• Ambar — Çoklu seçim
• Ara — Kod veya ad arama
• ☑ Düşük stok — Sadece bakiyesi minimum stoğun altında olan kalemleri gösterir

Tablo sütunları

Sütun	Açıklama
Kod	Otomatik veya girilmiş kod
Tür	Stok veya Hizmet
Malzeme Adı	Adı
Kategori	Bağlı kategori
Birim	Ölçü birimi
Giriş	Kümülatif giriş miktarı
Çıkış	Kümülatif çıkış miktarı
Bakiye	Mevcut stok (bold)
Min Stok	Kart üzerinde tanımlı alt sınır
Ort. Maliyet	Ağırlıklı ortalama birim maliyet
Stok Değeri	Bakiye × Ort. Maliyet
Durum	Aktif / Pasif
(son)	📊 Ekstre / ✏️ Düzenle / 🗑️ Sil

Kart Türü ayrımı

• Stok Kartı — Fiziksel envanter takip edilir (giriş/çıkış bakiyeyi etkiler)
• Hizmet Kartı — Envanteri olmayan, fatura kalemi olarak kullanılan kartlar (örn. taşıma hizmeti, komisyon)

10.3.1 Yeni Malzeme Kartı Oluşturma

1. Sağ üstteki mavi ➕ Yeni Malzeme düğmesine tıklayın.
2. Açılan modalde:

Alan	Açıklama	Zorunlu
Malzeme Adı	Adı	✅
Kart Türü	Stok Kartı / Hizmet Kartı	✅
Kategori	Açılır (Bölüm 10.6'dan)	—
Birim	Açılır (Bölüm 10.1'den)	—
Minimum Stok	Alt sınır değeri	—
Açıklama	Serbest metin	—

3. Kaydet düğmesine tıklayın. Sistem otomatik bir kod üretir.

10.3.2 Malzeme Ekstresi

Her malzeme satırının sağındaki 📊 Ekstre düğmesi, o malzemenin tüm hareket geçmişini gösteren büyük bir modal açar.

[ŞG: Malzeme Ekstresi modalı — üstte filtreler, altta kümülatif bakiye tablosu]

Ekstre üst filtreleri

• İşyeri / Ambar — Hangi ambarın hareketlerini göreceğinizi filtreler
• Başlangıç / Bitiş Tarihi — Dönem

Filtrelerin sağında anlık özet kartları görünür (toplam giriş, çıkış, net bakiye).

Ekstre tablo sütunları

Sütun	Açıklama
Tarih	Hareket tarihi
Tür	Giriş / Çıkış / Transfer
Giriş / Çıkış	Miktar (uygun sütunda)
Döviz / Birim Fiyat / Toplam	Finansal bilgi
Ambar	İlgili ambar
Açıklama	Hareket notu
Bakiye	Her satırdan sonraki yürüyen bakiye (bold)

İpucu: Ekstre, belirli bir malzemenin kullanımını tarihsel olarak izlemenin en hızlı yoludur. Sayım dönemlerinde veya kayıp araştırmalarında kullanılır.

---

10.4 Stok Giriş / Çıkış Hareketleri

Giriş ve çıkış işlemleri aynı modal üzerinden yapılır; tek fark işlem tipidir.

10.4.1 Stok Girişi (Manuel)

[ŞG: Stok Girişi modalı — malzeme, hedef ambar, miktar, fiyat alanları]

1. Üstteki yeşil 🟢 Giriş düğmesine tıklayın.
2. Açılan modalde:

Malzeme ve tarih

Alan	Açıklama	Zorunlu
Malzeme	Açılır (stok kartlarından)	✅
Tarih	İşlem tarihi	—

Malzeme seçildiğinde, varsa son işlem fiyatı bilgisi bir bilgi kutusunda görüntülenir (örn. "Son giriş fiyatı: 125,50 TRY — 2026-03-15").

Hedef (girişin nereye yapılacağı)

Alan	Açıklama	Zorunlu
İşyeri	Açılır	✅
Ambar	İşyerine bağlı ambarlardan	✅
Gemi	Opsiyonel	—

Miktar ve fiyat

Alan	Açıklama	Zorunlu
Miktar	Ondalıklı	✅
Birim Fiyat	Birim başı fiyat (ortalama maliyet hesabı için)	—
Döviz	TRY / USD / EUR	—
Tedarikçi	Cari hesap listesinden	—
Açıklama	Serbest metin	—

3. Kaydet düğmesine tıklayın. Malzemenin bakiyesi ve ortalama maliyeti otomatik güncellenir.

İpucu: Tedarikçiden alımla gelen stok, genellikle Fatura (Bölüm 9.3 — Alış Faturası) üzerinden girilir ve stok bu yolla otomatik güncellenir. Bu sayfadaki manuel Giriş, fiziksel sayım farkı, bağış, iade gibi özel durumlar için kullanılır.

10.4.2 Stok Çıkışı (Manuel)

1. Üstteki turuncu 🟡 Çıkış düğmesine tıklayın.
2. Aynı modal açılır, farklı olarak:
   • Tedarikçi alanı gizlenir (çıkışta tedarikçi olmaz)
   • Modal başlığı "Stok Çıkışı" olur
3. Alanları doldurup Kaydet düğmesine tıklayın.

Not: Malzemenin bakım yürütme sırasında (Bölüm 7.4) "Kullanılan Malzemeler" olarak yazılması da bir çıkış hareketi oluşturur — bu durumda manuel çıkış girmenize gerek yoktur. Manuel çıkış, fire, kayıp, iade gibi özel durumlar için kullanılır.

10.4.3 Ortalama Maliyet Hesabı

Sistem, her giriş hareketi sonrası ağırlıklı ortalama maliyeti otomatik hesaplar:

Ort. Maliyet = (Mevcut Bakiye × Eski Ort.Maliyet + Giriş Miktarı × Yeni Birim Fiyat) / (Mevcut Bakiye + Giriş Miktarı)

Bu değer Malzeme tablosundaki Ort. Maliyet ve Stok Değeri sütunlarında görüntülenir ve faturalama/muhasebe raporlarında kullanılır.

---

10.5 Transfer İrsaliyesi

Bir ambardan (veya gemiden) başka bir ambara çok kalemli stok aktarımı için transfer irsaliyesi düzenlenir.

[ŞG: Transfer İrsaliyesi — tam ekran modal, kaynak (kırmızı) ve hedef (yeşil) bölümleri yan yana, altta kalem tablosu]

Transferi başlatma

Üstteki 🔵 Transfer İrsaliyesi veya Transferler sekmesindeki ➕ Yeni İrsaliye düğmesine tıklayın. Tam ekran modal açılır.

İrsaliye başlık bilgileri

Alan	Açıklama
İrsaliye No	Otomatik (salt okunur)
Tarih	İrsaliye tarihi
Açıklama	Serbest metin

Kaynak (KIRMIZI bölüm)

Nereden çıkış yapılacağının bilgisi:

Alan	Açıklama	Zorunlu
İşyeri	Açılır	✅
Ambar	Seçili işyerinin ambarları	✅
Gemi	Opsiyonel	—

Hedef (YEŞİL bölüm)

Nereye giriş yapılacağının bilgisi — kaynak ile aynı alan yapısı.

Kalemler

Her satırda:

Alan	Açıklama
Malzeme	Arama ile stok kartından seçim
Miktar	Aktarılacak miktar
Birim	Seçilen malzemenin birimi
Birim Fiyat	İsteğe bağlı
Döviz	TRY / USD / EUR
Toplam	Otomatik hesaplanır
Not	Satır bazlı not

➕ Kalem Ekle düğmesiyle birden fazla malzemeyi aynı irsaliyede aktarabilirsiniz.

Kaydetme

Kaydet düğmesi irsaliyeyi Taslak durumunda oluşturur. Taslak irsaliyeler Transferler sekmesinde tamamlanabilir, iptal edilebilir veya silinebilir.

Transfer durumları

• 🔵 Taslak — Henüz gerçekleşmemiş irsaliye
• 🟢 Tamamlandı — Kaynak stoktan düşülmüş, hedefe eklenmiş
• ⚫ İptal — İptal edildi, stok hareketi olmadı

İpucu: Transfer irsaliyesi, liman teslimatları, gemi-gemi malzeme aktarımı veya işyerleri arası nakil için kullanılır. Tek kalemli hızlı aktarım için Çıkış (eski ambardan) + Giriş (yeni ambara) da yapılabilir, ama transfer izi kaybolur — bu yüzden irsaliye kullanmak denetim açısından daha iyidir.

Transferler sekmesi

Sütun	Açıklama
İrsaliye No	Numara
Kaynak / Hedef	İşyeri/ambar bilgisi
Kalem	Kaç kalem içerdiği
Tarih	Düzenleme tarihi
Durum	Taslak / Tamamlandı / İptal
(son)	Aksiyon düğmeleri

Filtre: Durum (çoklu seçim).

---

10.6 Malzeme Kategorileri

Kategoriler sekmesinde, malzemelerin sınıflandırma ağacı yönetilir.

[ŞG: Kategoriler sekmesi — kategori ağacı ve düzenleme düğmeleri]

Tablo sütunları

Sütun	Açıklama
Kategori Adı	Kategori adı
Üst Kategori	Hangi kategorinin alt dalı olduğu (yoksa "ana kategori")
Durum	Aktif / Pasif
(son)	Düzenle / Sil

Yeni Kategori Ekleme

➕ Yeni Kategori düğmesiyle açılan modalde:

Alan	Açıklama	Zorunlu
Kategori Adı	Açıklayıcı ad	✅
Üst Kategori	Mevcut kategorilerden biri, yoksa "ana kategori"	—
Açıklama	Serbest metin	—

İpucu: Kategorileri hiyerarşik tanımlayın (örn. "Makine Parçaları > Contalar > Yuvarlak Contalar"). Bu, raporlamayı ve aramayı kolaylaştırır.

---

10.7 Hareket Geçmişi

Hareketler sekmesi, sistemdeki tüm stok hareketlerini (giriş + çıkış + transfer) tek tabloda gösterir.

[ŞG: Hareketler sekmesi — 6 filtre üstte, geniş hareket tablosu]

Filtreler

Filtre	Seçenekler
Tür	Giriş / Çıkış / Transfer (çoklu)
Gemi	Çoklu
İşyeri	Çoklu
Ambar	Çoklu
Kategori	Çoklu
Malzeme	Çoklu

Tablo sütunları

Sütun	Açıklama
Tarih	Hareket tarihi
Tür	Giriş (yeşil) / Çıkış (kırmızı) / Transfer (mavi)
Malzeme	İşlem yapılan malzeme
Gemi	Varsa
Ambar	İlgili ambar
Miktar	İşlem miktarı
Kaynak	Transferde veya çıkışta kaynak
Tedarikçi	Girişte tedarikçi
Açıklama	Notlar

İpucu: Bu sekme, denetim ve audit ihtiyaçları için kritiktir. Bir ay boyunca bir ambardan yapılan tüm çıkışları görmek, kayıp kontrolü yapmak veya belirli bir tedarikçinin alımlarını incelemek için kullanın.

---

10.8 Tipik Stok Akışı Özeti

Yeni bir firma için stok modülünü kullanmaya başlama sırası:

1. Birimler (10.1) — Varsayılanları Yükle ile başlayın; sonra eksikleri ekleyin.
2. Dönüşüm Çarpanları (10.1.2) — Farklı birimle alım/kullanım yapılıyorsa tanımlayın.
3. Kategoriler (10.6) — Malzeme sınıflandırma ağacını kurun.
4. Malzeme Kartları (10.3.1) — Her malzeme için kart açın (kod, birim, min stok).
5. İşyeri + Ambar (Bölüm 3.7) — Bu tanımların yapılmış olması gerekir.
6. Başlangıç Stoku Girişi (10.4.1) — Kuruluma mevcut stoğunuzu manuel Giriş ile yükleyin.
7. Günlük operasyonlarda:
   • Alımlar → Fatura üzerinden (Bölüm 9.4'teki Alış Faturası stokları otomatik günceller)
   • Kullanım → Bakım üzerinden (Bölüm 7.4'teki Kullanılan Malzemeler)
   • Aktarım → Transfer İrsaliyesi (10.5)
   • Diğer → Manuel Giriş/Çıkış (10.4)

---

Bir sonraki bölüm: Bölüm 11 — Görev ve Takvim.