Koza Planlama Zekâsı – Entegrasyon Gereksinimleri

Bu doküman, Koza Planlama Zekâsı’nın bir işletmede devreye alınabilmesi için ERP / MRP sistemlerinde hazır olması gereken
talep tahmini, üretim planı, kapasite ve malzeme ihtiyaç verilerini ve teknik beklentileri tanımlar.
Hedef kitle: IT ekipleri, ERP danışmanları, planlama ekipleri, üretim planlama yöneticileri, sistem entegratörleri.

  • Veri erişimi: Read-only (sadece okuma)
  • Desteklenen yöntemler: REST API, SOAP, Database View, Scheduled Export (JSON/CSV)
  • Veri güncelliği önerisi: Maks. 15–60 dakika (plan revizyonlarında daha sık)
  • Zaman formatı: ISO 8601

1) Amaç

Koza Planlama Zekâsı; satış tahminleri, üretim planları, kapasite ve stok verilerini bir arada analiz ederek
talep – kapasite – stok dengesizliklerini, planlama hatalarını ve ileriye dönük riskleri tespit eder.
“Ne olur?” ve “ne olmalı?” senaryoları üretir.

Bu doküman, Koza Planlama Zekâsı’nın çalışması için gerekli veri alanlarını ve entegrasyon ön koşullarını tanımlar.

2) Veri Kaynakları

Koza Planlama Zekâsı aşağıdaki modüllerden veri bekler:

  • Satış Tahmin / Talep Planlama
  • Üretim Planlama / MRP
  • Kapasite Planlama
  • Stok Yönetimi
  • Satınalma (lead time analizi için)
  • Üretim Yönetimi (gerçekleşen vs plan karşılaştırması)

3) Zorunlu Veri Setleri

3.1) DemandForecasts (Talep Tahminleri)

Amaç: Talep trendleri, sezonluk etkiler, planlama sapmaları.

Alan Adı Açıklama Zorunlu
ForecastNo Tahmin no Evet
ItemCode Ürün Evet
Period Dönem (2026-02 vb.) Evet
ForecastQty Tahmin miktarı Evet
Method Manuel / Sistem Hayır
CreatedDate Oluşturulma tarihi Hayır

3.2) ProductionPlans (Üretim Planları)

Amaç: Planlanan üretim – gerçekleşen üretim farkları.

Alan Adı Açıklama Zorunlu
PlanNo Plan no Evet
ItemCode Ürün Evet
PlannedStartDate Plan başlangıç Evet
PlannedEndDate Plan bitiş Evet
PlannedQty Planlanan miktar Evet
LineOrWorkCenter Hat/İş merkezi Hayır
Status Planlandı / Onaylandı / İptal Hayır

3.3) CapacityCalendars (Kapasite Takvimleri)

Amaç: Kapasite darboğazları, yüklenme oranı.

Alan Adı Açıklama Zorunlu
WorkCenterCode İş merkezi / Hat Evet
Date Tarih Evet
AvailableHours Uygun saat Evet
PlannedHours Planlanan saat Hayır
ShiftCount Vardiya sayısı Hayır

3.4) MRPRequirements (Malzeme İhtiyaç Planları)

Amaç: Malzeme eksikliği riski, satınalma zamanlaması.

Alan Adı Açıklama Zorunlu
ItemCode Malzeme Evet
RequiredDate İhtiyaç tarihi Evet
RequiredQty İhtiyaç miktarı Evet
SourceType Üretim / Satınalma Hayır
PlanNo Bağlı plan Hayır

4) Opsiyonel Veri Setleri

4.1) PlanningScenarios (Planlama Senaryoları)

Amaç: “What-if” analizleri, alternatif planlar.

Alan Adı Açıklama Zorunlu
ScenarioNo Senaryo no Evet
Name Senaryo adı Hayır
Description Açıklama Hayır
CreatedBy Oluşturan Hayır

4.2) LeadTimes (Tedarik & Üretim Süreleri)

Amaç: Gerçek lead time – plan lead time farkları.

Alan Adı Açıklama Zorunlu
ItemCode Malzeme/ürün Evet
ProcessType Satınalma / Üretim Evet
PlannedLeadTimeDays Planlanan süre Hayır
ActualLeadTimeDays Gerçekleşen süre Hayır

5) Entegrasyon Yöntemi

Koza Planlama Zekâsı ERP/MRP sistemine yazmaz; sadece okur.

  • REST API
  • SOAP Web Service
  • Database View
  • Scheduled Export (JSON/CSV)

6) Performans & Format Beklentileri

  • ItemCode, PlanNo, WorkCenterCode referans bütünlüğü sağlanmalı
  • Tarih alanları ISO 8601 formatında olmalı
  • Miktar alanları (Qty) sayısal ve tutarlı olmalı

7) Hazırlık Kontrol Listesi

8) Örnek API Endpoint’leri

/api/demand-forecasts
/api/production-plans
/api/capacity-calendars
/api/mrp-requirements
/api/planning-scenarios
/api/lead-times

Yetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS