# Dosyadan İstatistiksel Gösterge Fiili Değer Yükleme Arayüzü

> İK, enerji izleme veya tesis yönetimi sistemlerinden gelen personel sayısı, kWh, metrekare gibi değerleri dosyadan okuyup masraf yeri ve iç siparişlere istatistiksel gösterge olarak kaydeden custom arayüz. Uygulama sunucusundaki klasörden arka planda çalışır; test modu ve satır bazında günlük içerir.

- Tür: Program, Custom geliştirme, Arayüz
- Modül: CO
- Tahmini efor: M (3–5 iş günü)
- Son güncelleme: 2026-11-17
- URL: https://nekuhub.com/programlar/dosyadan-istatistiksel-gosterge-yukleme-arayuzu/


## Standart çözüm neden yetmiyor?

KB31N istatistiksel göstergeleri ekrandan girer; dışarıdan gelen bir dosyayı okuyamaz ve zamanlanamaz. Yüzlerce masraf yeri için her ay değerler elle girilir ya da Excel'den kopyalanır; hata ve eksik değer riski yüksektir. Çevrimlerin doğru çalışması için değerlerin kapanıştan önce otomatik gelmesi gerekir.

### En yakın standart alternatifler

- KB31N: İstatistiksel göstergeleri ekrandan tek belge olarak girer; dosya okumaz ve zamanlanamaz.
- KB33N: Kaydedilen göstergeleri gösterir; yükleme yapmaz.

## Kullanılan tablolar

| Tablo | Rolü | Erişim | Bağlantı | Sistem |
|---|---|---|---|---|
| COSR | İstatistiksel gösterge dönem değerleri: fark hesabı için okunur, BAPI üzerinden yazılır | Okuma / yazma | COSR-OBJNR = CSKS-OBJNR veya AUFK-OBJNR AND COSR-STAGR = dosyadaki gösterge | ECC + S/4 |
| TKA03 | Gösterge tanımı, birimi ve kategorisi | Okuma | TKA03-KOKRS = P_KOKRS AND TKA03-STAGR = dosyadaki gösterge | ECC + S/4 |
| CSKS | Masraf yerinin kayıt tarihindeki geçerliliği | Okuma | CSKS-KOKRS = P_KOKRS AND CSKS-KOSTL = dosyadaki masraf yeri | ECC + S/4 |
| AUFK | Alıcı iç siparişin varlığı ve nesne numarası | Okuma | AUFK-AUFNR = dosyadaki sipariş AND AUFK-KOKRS = P_KOKRS | ECC + S/4 |

## Kullanılan BAPI ve fonksiyonlar

- BAPI_ACC_STAT_KEY_FIG_POST: İstatistiksel gösterge fiili değerlerini CO belgesi olarak kaydeder
- BAPI_TRANSACTION_COMMIT: Başarılı paketleri kalıcı olarak kaydeder
- BAPI_TRANSACTION_ROLLBACK: Test modunda ve hatalı paketlerde değişikliği geri alır

## Seçim ekranı parametreleri

| Parametre | Açıklama | Tip | Referans alan | Zorunlu |
|---|---|---|---|---|
| P_KOKRS | Kontrol alanı | Tekil değer | TKA03-KOKRS | Evet |
| P_PATH | Gelen dosya klasörü veya dosya yolu | Tekil değer | - | Evet |
| P_BUDAT | Kayıt tarihi | Tekil değer | COBK-BUDAT | Evet |
| P_DELTA | Toplam değer türünde yalnızca farkı kaydet | Onay kutusu | - | Hayır |
| P_TEST | Test modu (kayıt yapmadan kontrol et) | Onay kutusu | - | Hayır |

## Girdi dosyası kolonları

| Kolon | Hedef alan | Zorunlu |
|---|---|---|
| Masraf yeri | CSKS-KOSTL | Hayır |
| İç sipariş (masraf yeri boşsa) | AUFK-AUFNR | Hayır |
| İstatistiksel gösterge | TKA03-STAGR | Evet |
| Değer | Dönem değeri; P_DELTA işaretliyse COSR'deki mevcut değerle farkı kaydedilir | Hayır |
| Birim | TKA03-MSEHI | Hayır |
| Açıklama | COEP-SGTXT | Hayır |

## Sonuç listesi kolonları

| Kolon | Kaynak |
|---|---|
| Satır | Hesaplanan: Dosyadaki satır numarası |
| Masraf yeri | CSKS-KOSTL |
| İç sipariş | AUFK-AUFNR |
| Gösterge | TKA03-STAGR |
| Kaydedilen değer | Hesaplanan: Dosya değeri veya P_DELTA ile hesaplanan fark |
| Durum | Hesaplanan: BAPI dönüş mesajlarına göre: kaydedildi, test tamam, atlandı veya hata |
| CO belgesi | COBK-BELNR |
| Mesaj | Hesaplanan: BAPI dönüş tablosundaki ilk hata veya başarı mesajı |

## Program nasıl çalışır?

1. Dosya uygulama sunucusundaki gelen klasörden (arka plan) veya kullanıcının bilgisayarından okunur; işlenen dosya arşiv klasörüne taşınır.
2. Her satır kontrol edilir: gösterge TKA03'te tanımlı olmalı, masraf yeri CSKS'te kayıt tarihinde geçerli olmalı veya iç sipariş AUFK'ta bulunmalıdır; birim TKA03-MSEHI ile aynı olmalıdır.
3. P_DELTA işaretliyse toplam değer türü göstergelerde dönemin mevcut değeri COSR'den okunur ve yalnızca fark kaydedilir; böylece aynı dosya iki kez yüklense de değer ikiye katlanmaz.
4. Satırlar BAPI_ACC_STAT_KEY_FIG_POST yapısına paketlenir; test modunda BAPI çağrılıp BAPI_TRANSACTION_ROLLBACK ile geri alınır.
5. Gerçek çalıştırmada BAPI_TRANSACTION_COMMIT çağrılır; oluşan CO belge numarası, hatalar ve atlanan satırlar günlükte listelenir ve sorumluya e-postayla bildirilebilir.

## Yetki nesneleri

- K_CSKS: Masraf yerine kayıt yetkisi
- K_ORDER: İç siparişe kayıt yetkisi
- K_CCA: Masraf yeri muhasebesi işlem yetkisi

## Sık sorulan sorular

### Dosya biçimi ne olmalı?

Noktalı virgülle ayrılmış CSV veya XLSX kullanılabilir. Kaynak sistem masraf yeri yerine kendi kodunu gönderiyorsa eşleme tablosu kapsamına alınır.

### Aynı dosya yanlışlıkla iki kez işlenirse ne olur?

P_DELTA açıkken mevcut değerle fark kaydedildiği için ikinci yüklemede fark sıfır olur ve satır atlanır. İşlenen dosya arşiv klasörüne taşınır.

### Plan değerleri de yüklenebilir mi?

Bu arayüz fiili değerleri kapsar. Plan istatistiksel göstergeleri (KP46) için ayrı bir BAPI ile benzer bir yükleme ek kapsam olarak kurulabilir.

---
Bu programı sizin sisteminize göre yazalım: https://nekuhub.com/teklif-al/?report=co-statistical-key-figure-upload
