1) Amaç
Koza Lojistik Zekâsı; sevkiyat gecikmeleri, teslimat performansı, taşıma maliyet sapmaları, rota/kapasite sorunları ve
müşteri hizmet seviyesi (OTIF) risklerini erken tespit eder. Taşıma modları ve taşıyıcılar arasında performans karşılaştırması yapar.
2) Veri Kaynakları
- ERP: Sevkiyat belgeleri, irsaliye, müşteri, sipariş, fatura referansları
- WMS (varsa): Toplama/paketleme, depo çıkış olayları, koli/palet detayları
- TMS (varsa): Rota, taşıma planı, taşıma maliyeti, kapasite, teslimat olayları
- Kargo/Taşıyıcı API (varsa): Tracking, teslimat status/event, POD
3) Zorunlu Veri Setleri
3.1) Shipments (Sevkiyat Başlıkları)
| Alan | Açıklama | Zorunlu |
|---|---|---|
| ShipmentNo | Sevkiyat/irsaliye no | Evet |
| ShipmentDate | Sevk tarihi | Evet |
| CustomerCode | Müşteri | Evet |
| ShipFrom | Çıkış depo/tesis | Hayır |
| ShipTo | Teslim adres kodu (adres yerine kod önerilir) | Hayır |
| CarrierCode | Taşıyıcı/kargo firması | Hayır |
| TransportMode | Karayolu/Denizyolu/Hava vb. | Hayır |
| Status | Hazırlandı/Sevk/Teslim | Hayır |
| UpdatedAt | Son güncelleme | Hayır |
3.2) ShipmentLines (Sevkiyat Satırları)
| Alan | Açıklama | Zorunlu |
|---|---|---|
| ShipmentNo | Üst sevkiyat | Evet |
| LineNo | Satır | Evet |
| ItemCode | Ürün | Evet |
| Qty | Miktar | Evet |
| OrderNo | Bağlı sipariş (varsa) | Hayır |
| LotOrSerial | Lot/seri (varsa) | Hayır |
3.3) TrackingEvents (Takip Olayları)
Takip olayları TMS veya taşıyıcı API üzerinden sağlanabilir. En azından “Sevk edildi / Dağıtıma çıktı / Teslim edildi”
adımlarının zaman damgası önerilir.
| Alan | Açıklama | Zorunlu |
|---|---|---|
| TrackingNo | Takip numarası | Evet |
| ShipmentNo | Bağlı sevkiyat | Hayır |
| EventTime | Olay zamanı | Evet |
| EventCode | PickedUp/InTransit/OutForDelivery/Delivered/Exception | Evet |
| EventLocation | Şehir/aktarma merkezi (ops.) | Hayır |
| ExceptionCode | Gecikme/hasar/iadeye dönme vb. | Hayır |
3.4) DeliveryPromises (Taahhüt Edilen Teslim Tarihleri)
Amaç: OTIF (On Time In Full) hesaplamak için taahhüt tarihi gerekir.
| Alan | Açıklama | Zorunlu |
|---|---|---|
| OrderNo | Sipariş no | Evet |
| CustomerCode | Müşteri | Evet |
| PromisedDeliveryDate | Taahhüt edilen teslim tarihi | Evet |
| RequestedDeliveryDate | İstenen teslim (varsa) | Hayır |
4) Opsiyonel Veri Setleri
- FreightCosts: Sevkiyat bazlı taşıma maliyeti (fatura, km bazlı, taşıyıcı tarifesi)
- PackagingUnits: Koli/palet ölçüleri, ağırlık, hacim (doluluk analizi için)
- WarehouseOperations: Toplama/paketleme süreleri (WMS)
- POD: Teslim kanıtı (imza, fotoğraf, teslim alan kişi – KVKK/uyumla)
- ReturnsFlow: İade/ters lojistik olayları
5) Entegrasyon Yöntemi
- ERP API/DB: Shipments, ShipmentLines, DeliveryPromises
- TMS API: TrackingEvents, FreightCosts, Routes
- Carrier API: TrackingEvents (webhook varsa tercih edilir)
- Event/MQ: shipment.created / shipment.updated / tracking.updated
- Scheduled Export: Günlük KPI ve maliyet özetleri için
6) Üretilen KPI & Analizler
- OTIF: Zamanında ve eksiksiz teslimat oranı
- On-Time: Taahhüt vs. gerçekleşen teslimat
- Carrier Performance: Taşıyıcı bazlı gecikme/exception analizi
- Freight Cost Variance: Planlanan vs gerçekleşen taşıma maliyeti
- Exception Heatmap: Gecikme/hasar/iadeye dönme yoğunluğu
7) Performans & Format Beklentileri
- ShipmentNo benzersiz olmalı, satırlarla (ShipmentLines) referans bütünlüğü korunmalı
- TrackingEvents event zamanları sıralı ve ISO 8601 formatında olmalı
- UpdatedAt alanı veya değişiklik yakalama (CDC/event) önerilir
- Kişisel veri içeren alanlar (adres, teslim alan kişi) gerekiyorsa maskeleme/pseudonymization önerilir
8) Hazırlık Kontrol Listesi
9) Örnek Endpoint/Topic Seti
# ERP
/api/logistics/shipments
/api/logistics/shipment-lines
/api/logistics/delivery-promises
# TMS / Carrier
/api/logistics/tracking-events
/api/logistics/freight-costs
/webhook/carrier/tracking
# Event Topics (varsa)
topic.erp.shipment.created
topic.erp.shipment.updated
topic.tms.tracking.updated
topic.tms.freightCost.updated
Yetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS