Koza Tedarik Zekâsı – Entegrasyon Gereksinimleri

Bu doküman, Koza Satınalma Zekâsı’nın bir işletmede devreye alınabilmesi için ERP sisteminde hazır olması gereken
satınalma, tedarikçi, teklif ve sipariş verilerini ve teknik beklentileri tanımlar.
Hedef kitle: IT ekipleri, ERP danışmanları, satınalma 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. 5–15 dakika
  • Zaman formatı: ISO 8601 (örn. 2026-01-09T12:30:00+03:00)


1) Amaç

Koza Tedarik Zekâsı; ERP sisteminde tutulan satınalma talepleri, teklif süreçleri, siparişler ve tedarikçi performans
verilerini analiz ederek fiyat dalgalanmalarını, tedarikçi risklerini, gecikmeleri ve maliyet iyileştirme fırsatlarını
tespit eder.

Bu doküman, Koza Satınalma 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ınalma Zekâsı aşağıdaki ERP modüllerinden veri bekler:

  • Satınalma Yönetimi
  • Tedarikçi / Cari Yönetimi
  • Stok Yönetimi (bağlantılı analizler için)
  • Finans (fiyat / ödeme performansı için – opsiyonel)
  • Kalite (tedarikçi kalite performansı – opsiyonel)

3) Zorunlu Veri Setleri

3.1) PurchaseRequests (Satınalma Talepleri)

Amaç: Talep-sipariş dönüşüm süresi, gecikme ve talep yoğunluğu analizi.

Alan Adı Açıklama Zorunlu
RequestNo Talep numarası Evet
RequestDate Talep tarihi Evet
RequestedBy Talep eden Hayır
ItemCode Malzeme kodu Evet
Quantity Miktar Evet
RequiredDate İhtiyaç tarihi Hayır
Status Açık / Onaylandı / Kapandı Evet

3.2) RFQs (Teklif Talepleri)

Amaç: Teklif toplama süresi, tedarikçi yanıt oranı ve rekabet analizi.

Alan Adı Açıklama Zorunlu
RFQNo Teklif talep no Evet
RFQDate Teklif talep tarihi Evet
SupplierCode Tedarikçi kodu Evet
ItemCode Malzeme kodu Evet
Quantity Miktar Evet
Status Açık / Yanıtlandı / Kapandı Evet

3.3) SupplierQuotations (Tedarikçi Teklifleri)

Amaç: Fiyat karşılaştırması, trend analizi, anomali tespiti.

Alan Adı Açıklama Zorunlu
QuoteNo Teklif no Evet
RFQNo Bağlı RFQ Evet
SupplierCode Tedarikçi Evet
ItemCode Malzeme Evet
UnitPrice Birim fiyat Evet
Currency Para birimi Evet
DeliveryTime Teslim süresi (gün) Hayır
ValidUntil Geçerlilik tarihi Hayır

3.4) PurchaseOrders (Satınalma Siparişleri)

Amaç: Sipariş döngü süresi, gecikme ve tedarikçi performans analizi.

Alan Adı Açıklama Zorunlu
PONo Sipariş no Evet
PODate Sipariş tarihi Evet
SupplierCode Tedarikçi Evet
ItemCode Malzeme Evet
OrderedQty Sipariş miktarı Evet
UnitPrice Birim fiyat Evet
PlannedDeliveryDate Planlanan teslim Hayır
ActualDeliveryDate Gerçek teslim Hayır
Status Açık / Kısmi / Kapalı Evet

4) Opsiyonel Veri Setleri

4.1) SupplierPerformance (Tedarikçi Performansı)

Alan Adı Açıklama Zorunlu
SupplierCode Tedarikçi Evet
OnTimeDeliveryRate Zamanında teslim oranı Hayır
QualityScore Kalite puanı Hayır
ReturnRate İade oranı Hayır

4.2) PriceHistory (Fiyat Geçmişi)

Alan Adı Açıklama Zorunlu
ItemCode Malzeme Evet
SupplierCode Tedarikçi Hayır
UnitPrice Birim fiyat Evet
Currency Para birimi Evet
PriceDate Fiyat tarihi Evet

5) Entegrasyon Yöntemi

Koza Satınalma Zekâsı ERP’ye yazmaz; sadece okur.

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

6) Performans & Format Beklentileri

  • Zaman damgaları zorunlu (talep, teklif, sipariş)
  • Para birimi alanları tutarlı olmalı
  • SupplierCode, ItemCode referans bütünlüğü sağlamalı

7) Hazırlık Kontrol Listesi

8) Örnek API Endpoint’leri

/api/purchase-requests
/api/rfqs
/api/supplier-quotations
/api/purchase-orders
/api/suppliers
/api/price-history

Not: Alan isimleri ERP sistemine göre değişebilir. İlk bağlantı sırasında Koza AI ekibi alan eşleştirme
(mapping) ve veri doğrulama çalışmasını yapar.