Koza Finans Zekâsı Entegrasyon Gereksinimleri Dokümanı

1) Amaç

Koza Finans Zekâsı; ERP/muhasebe sisteminde yer alan cari hesaplar, fatura hareketleri, tahsilat/ödemeler, banka ve kasa
kayıtlarını analiz ederek nakit akışı risklerini, vade uyumsuzluklarını, maliyet sapmalarını ve kârlılık problemlerini
tespit eder. Erken uyarı ve finansal görünürlük sağlar.

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

2) Veri Kaynakları

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

Muhasebe / Finans Yönetimi
Cari Hesap Yönetimi
Satış Faturalama
Satınalma Faturalama
Banka / Kasa Yönetimi
Çek / Senet (varsa – opsiyonel)
Bütçe / Maliyet Merkezi (varsa – opsiyonel)

3) Zorunlu Veri Setleri

3.1) Accounts (Cari / Muhasebe Hesap Kartları)

Amaç: Cari bazlı risk, vade ve limit analizleri.

Alan Adı	Açıklama	Zorunlu
AccountCode	Cari / muhasebe hesap kodu	Evet
AccountName	Hesap adı	Evet
AccountType	Müşteri / Tedarikçi / Banka / Kasa	Evet
Currency	Para birimi	Hayır
CreditLimit	Kredi limiti	Hayır
Status	Aktif / Pasif	Evet

3.2) Invoices (Faturalar – Satış & Satınalma)

Amaç: Gelir-gider akışı, vade analizi, kârlılık kırılımları.

Alan Adı	Açıklama	Zorunlu
InvoiceNo	Fatura no	Evet
InvoiceDate	Fatura tarihi	Evet
InvoiceType	Satış / Alış	Evet
AccountCode	Müşteri/Tedarikçi hesabı	Evet
NetAmount	Net tutar	Evet
TaxAmount	Vergi	Hayır
Currency	Para birimi	Evet
DueDate	Vade tarihi	Hayır
Status	Açık / Kapalı / İptal	Evet

3.3) LedgerEntries (Muhasebe Fiş / Hareket Kayıtları)

Amaç: Gelir-gider kalemleri, dönemsel trendler, anomali tespiti.

Alan Adı	Açıklama	Zorunlu
EntryNo	Fiş/hareket no	Evet
EntryDate	Tarih	Evet
AccountCode	Hesap kodu	Evet
DebitAmount	Borç	Hayır
CreditAmount	Alacak	Hayır
Currency	Para birimi	Hayır
Description	Açıklama	Hayır
ReferenceNo	Referans (fatura/sipariş)	Hayır

3.4) Payments (Tahsilat / Ödeme Hareketleri)

Amaç: Tahsilat performansı, vade uyumu, nakit akışı.

Alan Adı	Açıklama	Zorunlu
PaymentNo	Ödeme/tahsilat no	Evet
PaymentDate	Tarih	Evet
PaymentType	Tahsilat / Ödeme	Evet
AccountCode	Karşı hesap (müşteri/tedarikçi)	Evet
CashAccountCode	Banka/Kasa hesabı	Hayır
Amount	Tutar	Evet
Currency	Para birimi	Evet
ReferenceInvoiceNo	Bağlı fatura (varsa)	Hayır
Status	Planlandı / Gerçekleşti / İptal	Hayır

3.5) BankCashTransactions (Banka / Kasa Hareketleri)

Amaç: Günlük nakit pozisyonu, banka bazlı hareket analizi.

Alan Adı	Açıklama	Zorunlu
TxnNo	Hareket no	Evet
TxnDate	Tarih	Evet
CashAccountCode	Banka/Kasa hesap kodu	Evet
TxnType	Giriş / Çıkış	Evet
Amount	Tutar	Evet
Currency	Para birimi	Evet
Description	Açıklama	Hayır
ReferenceNo	Referans	Hayır

4) Opsiyonel Veri Setleri

4.1) AgingReport (Vade / Yaşlandırma Raporu)

Amaç: Geciken alacak/borç riskleri, tahsilat önceliklendirme.

Alan Adı	Açıklama	Zorunlu
AccountCode	Cari	Evet
Bucket	0-30 / 31-60 / 61-90 / 90+	Evet
Amount	Tutar	Evet
Currency	Para birimi	Hayır
AsOfDate	Rapor tarihi	Evet

4.2) CostCenters (Masraf Merkezleri / Projeler)

Amaç: Gider kırılımları, bütçe takibi (varsa).

Alan Adı	Açıklama	Zorunlu
CostCenterCode	Masraf merkezi	Evet
CostCenterName	Ad	Hayır
Status	Aktif/Pasif	Hayır

4.3) Budgets (Bütçeler)

Amaç: Bütçe-sapma analizi (varsa).

Alan Adı	Açıklama	Zorunlu
BudgetNo	Bütçe no	Evet
Period	Dönem (2026-01 vb.)	Evet
CostCenterCode	Masraf merkezi	Hayır
PlannedAmount	Planlanan	Evet
ActualAmount	Gerçekleşen	Hayır
Currency	Para birimi	Hayır

5) Entegrasyon Yöntemi

Koza Finans Zekâsı ERP/muhasebe sistemine yazmaz; sadece okur.

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

6) Performans & Format Beklentileri

AccountCode referans bütünlüğü sağlanmalı
Para birimi (Currency) tutarlı olmalı
Vade tarihi (DueDate) mevcutsa ISO formatında olmalı
Net tutarlar ve vergi tutarları ayrı alanlarda tutulmalı

7) Hazırlık Kontrol Listesi

Cari hesaplar (müşteri/tedarikçi/banka/kasa) tanımlı
Satış & alış faturaları sistemde tutuluyor
Tahsilat & ödeme hareketleri kayıt altına alınıyor
Banka/kasa hareketleri erişilebilir
Read-only API / servis erişimi sağlanabilir

8) Örnek API Endpoint’leri

/api/accounts
/api/invoices
/api/ledger-entries
/api/payments
/api/bank-cash-transactions
/api/aging-report
/api/cost-centers
/api/budgets

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