Raporlar ve Belgeler

Bu sayfa Raporlar grubundaki iki ekranı anlatır. CSV kolonlarının anlamını da bulursunuz.

İki belge türü vardır. Üretilmiş Belgeler, İşlemler ekranından istediğiniz filtreli CSV dosyalarıdır. Gün Sonu Raporları, sistemin her gece kendiliğinden ürettiği günlük CSV dosyalarıdır.

Üretilmiş Belgeler

Ekran Raporlar → Üretilmiş Belgeler menüsündedir. Görüntülemek ve belge oluşturmak için “İşlem dışa aktarma (CSV)” yetkisi gerekir.

Nasıl oluşur: İşlemler ekranında filtreleri uygulayın ve “CSV’ye aktar” düğmesine basın. Belge “Sırada” durumuyla bu listeye düşer ve birkaç dakika içinde hazırlanır. Hazır olunca panelde bildirim gelir.

Kurallar:

• Belgeler 30 gün saklanır. Süre dolunca belge “Süresi doldu” olur ve indirilemez.
• Aynı anda en fazla 3 belge hazırlanabilir.
• Bir belgede en fazla 100.000 satır olabilir. Aşımda belge “Başarısız” olur. Filtreyi daraltıp tekrar deneyin.

Sütun	İçerik
Belge	Dosya adı.
Durum	Sırada, Hazırlanıyor, Hazır, Başarısız, Siliniyor, Süresi doldu, Silindi.
Oluşturma	Belgenin istendiği an.
Ayrıntı	Satır sayısı ve dosya boyutu.
Son indirme	Belgeyi indirebileceğiniz son gün. Saklama süresi dolunca belge indirilemez.

Eylemler: “İndir” yalnız “Hazır” durumunda açıktır. “Aynı filtrelerle yeniden dene” yalnız “Başarısız” durumunda çıkar. “Sil” hazırlanmakta olan belge dışında her durumda çıkar. Silme geri alınamaz.

İşlem belgesi kolonları

Dosya 13 sabit kolondan oluşur. Tutarlar kuruş cinsinden tamsayıdır. Tarihler Türkiye saatiyledir. Dosya UTF-8 ile kodludur. Türkçe harflerin Excel’de doğru görünmesi için dosyanın başında BOM adlı bir işaret bulunur.

Kolon	Anlamı
paymentCode	Ödeme kodu.
createdAt	Ödemenin oluşturulduğu an.
partnerTxCode	Sizin işlem referansınız.
status	Ödeme durumu. API değeri yazılır.
amount	Kart sahibinden çekilen toplam tutar, kuruş.
currency	Para birimi, try.
installmentCount	Taksit sayısı.
maskedPan	Maskeli kart numarası.
cardFamily	Kart ailesi.
cardBank	Kartı çıkaran banka.
cardBrand	Kart markası.
payoutStatus	Belediye hesabında kullanılmaz.
paymentLinkId	Belediye hesabında boştur.

Bu dosyada komisyon ve net tutar kolonu yoktur. Mali kolonlar yalnız gün sonu raporundadır.

Gün Sonu Raporları

Ekran Raporlar → Gün Sonu Raporları menüsündedir. Görüntülemek için “Gün sonu raporlarını görüntüleme” yetkisi gerekir. Muhasebe personeli için uygun yetkidir.

Ne zaman üretilir: Her gece saat 01.00’de sistem bir önceki işlem gününün raporunu üretir. İşlem günü, bankanın gün sonu kesimine göre belirlenen gündür. Takvim günü değildir. Kesim Türkiye saatiyle 22.00’dir. Ekranda bu gün “İş günü” sütununda görünür. Kesim saatinde ve sonrasında yapılan işlemler ertesi işlem gününe sayılır.

Neyi içerir: Rapor, oluşturulma zamanı o işlem gününün penceresine düşen ve rapor üretilirken başarılı, iptal ya da iade durumunda olan ödemeleri içerir. Ödeme kesime yakın oluşturulup kesimden sonra tahsil edildiyse oluşturulduğu işlem gününün raporunda yer alır. Sonradan iade edilen ve aynı işlem günü iptal edilen ödemelerin satırı da yer alır. Onaylanan iadeler ayrı birer eksi satır olarak gelir. Rapor üretildikten sonra değişmez. Üretim anında henüz onaylanmamış bir iade rapora girmez. Güncel durumun kaynağı İşlemler ekranıdır.

Kurallar:

• Raporlar 30 gün saklanır.
• Bir raporda en fazla 200.000 satır olabilir. Ödeme ve iade satırları birlikte sayılır. Aşımda rapor “Başarısız” olur. Bu durumda LydiaGate’e başvurun.
• Bu ekranda yalnız indirme yapılır. Oluşturma, yeniden deneme ve silme yoktur.
• O gün işlem yoksa rapor yine üretilir ve “0 satır · işlem yok” yazar.

Sütun	İçerik
İş günü	Raporun ait olduğu gün.
Durum	Hazır, Hazırlanıyor ya da Başarısız.
Üretim	Üretim anı.
Ayrıntı	Satır sayısı ve dosya boyutu.
Son indirme	Raporu indirebileceğiniz son gün.

Gün sonu raporu kolonları

Dosya 23 sabit kolondan oluşur. İki satır tipi vardır: payment ödeme satırı, refund iade satırı. 2 ile 14 arasındaki kolonlar işlem belgesiyle aynıdır.

#	Kolon	Ödeme satırı	İade satırı
1	rowType	payment	refund
2	paymentCode	Ödeme kodu	İade edilen ödemenin kodu
3	createdAt	Ödeme anı	İade anı
4	partnerTxCode	Sizin işlem referansınız	Ödemenin referansı
5	status	Ödeme durumu	approved
6	amount	Çekilen toplam, artı	İade tutarı, eksi
7	currency	try	try
8	installmentCount	Taksit	Boş
9	maskedPan	Maskeli kart	Aynı
10	cardFamily	Kart ailesi	Boş
11	cardBank	Kartı çıkaran banka	Boş
12	cardBrand	Kart markası	Boş
13	payoutStatus	Belediye hesabında kullanılmaz	Boş
14	paymentLinkId	Boş	Boş
15	businessDate	İşlem günü	Aynı
16	windowStart	Pencerenin başı	Aynı
17	windowEnd	Pencerenin sonu	Aynı
18	refundCode	Boş	İade kodu
19	refundMethod	Boş	void ya da credit
20	partnerRefundCode	Boş	Sizin iade referansınız
21	commissionAmount	Komisyon, artı. Hesaplanmadıysa boş.	Bankanın geri verdiği komisyon, eksi.
22	netAmount	Anapara, artı. Hesaplanmadıysa boş.	Geri dönen komisyon düşülmüş iade tutarı, eksi.
23	commissionRate	Oran, yüzde olarak. %2,50 → 2.50. Hesaplanmadıysa boş.	Boş

amount kolonunun toplamı günün net tahsilatını verir. İade satırındaki komisyon kolonu, bankanın hesabınıza geri verdiği komisyonu eksi olarak gösterir. LydiaGate komisyonu bankaya bildirdiyse bu tutar, bildirilen komisyon ters kaydıdır. Bildirim yapılmayan ödemelerde iade oranıyla hesaplanan bir tahmindir ve bankanın tutarından bir kuruş sapabilir. İptalde ödemenin komisyonunun tamamıdır. Bu hesap yeni üretilen raporlarda geçerlidir. Hazır raporlar değişmez. Komisyonu hesaplanmış bir ödeme aynı gün iptal edilirse ödeme ve iptal satırlarının toplamı sıfır olur. Komisyonu hesaplanmış ödemelerde netAmount kolonunun toplamı banka hesabınızdaki hareketi izler. Komisyonu hesaplanmamış ödemelerde bu toplam tutmaz. Pencere kolonları, farklı gün sonu kesimine sahip terminallerin satırlarını ayırt eder. Bir iade satırının ödemesi başka bir işlem gününe ait olabilir. Bu durumda ödeme satırı aynı dosyada bulunmaz.