1) Amaç
Koza Satış Zekâsı; ERP/CRM sistemlerinde tutulan müşteri, teklif, sipariş, fatura ve sevkiyat verilerini analiz ederek
satış trendlerini, müşteri davranışlarını, kayıp fırsatları ve kârlılık problemlerini tespit eder.
Satış performansı, müşteri segmentasyonu ve erken uyarı senaryoları üretir.
Bu doküman, Koza Satış Zekâsı’nın çalışması için gerekli veri alanlarını ve entegrasyon ön koşullarını tanımlar.
2) Veri Kaynakları
Koza Satış Zekâsı aşağıdaki ERP / CRM modüllerinden veri bekler:
- Satış Yönetimi
- Müşteri / Cari Yönetimi
- CRM (fırsatlar, pipeline – opsiyonel)
- Sevkiyat / Lojistik
- Finans (faturalama, tahsilat – opsiyonel)
3) Zorunlu Veri Setleri
3.1) Customers (Müşteri / Cari Kartları)
Amaç: Müşteri bazlı analiz, segmentasyon, risk ve potansiyel hesaplamaları.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| CustomerCode | Müşteri kodu | Evet |
| CustomerName | Müşteri adı | Evet |
| CustomerType | Yurtiçi / Yurtdışı / Bayi | Hayır |
| Sector | Sektör | Hayır |
| Country | Ülke | Hayır |
| Status | Aktif / Pasif | Evet |
3.2) SalesOffers (Satış Teklifleri)
Amaç: Teklif dönüşüm oranı, kayıp teklif analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| OfferNo | Teklif no | Evet |
| OfferDate | Teklif tarihi | Evet |
| CustomerCode | Müşteri | Evet |
| ItemCode | Ürün / hizmet | Evet |
| Quantity | Miktar | Evet |
| UnitPrice | Birim fiyat | Evet |
| Status | Açık / Kazanıldı / Kaybedildi | Evet |
| LossReason | Kayıp nedeni | Hayır |
3.3) SalesOrders (Satış Siparişleri)
Amaç: Sipariş akışı, teslimat uyumu, müşteri talep trendleri.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| SONo | Sipariş no | Evet |
| SODate | Sipariş tarihi | Evet |
| CustomerCode | Müşteri | Evet |
| ItemCode | Ürün | Evet |
| OrderedQty | Sipariş miktarı | Evet |
| PlannedDeliveryDate | Planlanan teslim | Hayır |
| ActualDeliveryDate | Gerçek teslim | Hayır |
| Status | Açık / Kısmi / Kapalı | Evet |
3.4) SalesInvoices (Satış Faturaları)
Amaç: Ciro, kârlılık ve müşteri bazlı gelir analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| InvoiceNo | Fatura no | Evet |
| InvoiceDate | Fatura tarihi | Evet |
| CustomerCode | Müşteri | Evet |
| ItemCode | Ürün | Evet |
| Quantity | Fatura miktarı | Evet |
| NetAmount | Net tutar | Evet |
| Currency | Para birimi | Evet |
3.5) Shipments (Sevkiyatlar)
Amaç: Teslimat performansı, gecikme analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| ShipmentNo | Sevkiyat no | Evet |
| ShipmentDate | Sevkiyat tarihi | Evet |
| CustomerCode | Müşteri | Evet |
| SONo | Bağlı sipariş | Hayır |
| Status | Hazırlanıyor / Çıktı / Teslim | Evet |
4) Opsiyonel Veri Setleri
4.1) Opportunities (Fırsatlar / Pipeline)
Amaç: Satış tahmini, pipeline sağlığı.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| OpportunityNo | Fırsat no | Evet |
| CustomerCode | Müşteri | Evet |
| Stage | Aşama | Evet |
| ExpectedAmount | Beklenen tutar | Hayır |
| ExpectedCloseDate | Kapanış tarihi | Hayır |
4.2) Collections (Tahsilatlar)
Amaç: Nakit akışı ve müşteri risk analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| CollectionNo | Tahsilat no | Evet |
| CollectionDate | Tarih | Evet |
| CustomerCode | Müşteri | Evet |
| Amount | Tutar | Evet |
| Currency | Para birimi | Evet |
5) Entegrasyon Yöntemi
Koza Satış Zekâsı ERP/CRM sistemine yazmaz; sadece okur.
- REST API
- SOAP Web Service
- Database View
- Scheduled Export (JSON/CSV)
6) Performans & Format Beklentileri
- CustomerCode, ItemCode referans bütünlüğü sağlamalı
- Para birimi alanları tutarlı olmalı
- Zaman damgaları (offer, order, invoice, shipment) zorunlu
7) Hazırlık Kontrol Listesi
8) Örnek API Endpoint’leri
/api/customers
/api/sales-offers
/api/sales-orders
/api/sales-invoices
/api/shipments
/api/opportunities
/api/collections