Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

Koltuk dökümü

Sponsorlu bağlantı sözleşmesi (Model B) olan geliştirici firma, müşterileri adına ödediği koltukları her ay bir dökümle görür. Döküm, ilgili ayın faturasının kanıtıdır; sürpriz fatura olmaması için firma panelinde anlık sayı da gösterilir.

Ne zaman oluşur

  • Her ayın 1’inde, İstanbul saatiyle 00:05’te önceki takvim ayı için bir kez oluşturulur.
  • Döküm oluştuktan sonra değiştirilmez. Aynı ay için yeniden çalışma aynı dosyayı ve aynı özeti kullanır; abonelikler sonradan değişse de yeniden hesaplanmaz.
  • Koltuk sayısı o ay için doğrulanamıyorsa döküm oluşturulmaz ve fatura açılmaz.
  • Hiç koltuk olmayan ay için de 0 adetli döküm saklanır.
  • Düzeltme gerekirse döküm silinmez; düzeltme kredi notuyla yapılır.

CSV sütunları

Dosya UTF-8, satır sonu CRLF’dir; satırlar müşteri kurumu ve bağlantı kimliğine göre sabit sıralıdır. =, +, -, @ ile başlayan hücreler tablolama programında formül olarak çalışmasın diye başına ' alır.

SütunAnlamı
grantIdBağlantı kimliği. Aynı müşteri iki uygulamanıza bağlıysa iki satır olur.
customerNameMüşteri kurumun adı.
vknLast4Vergi numarasının yalnız son 4 hanesi; tam numara dosyaya yazılmaz.
startBağlantının açıldığı an (UTC, ISO 8601).
endBağlantının kapandığı an; açık bağlantıda boş.
exclusionReasonBoşsa koltuk sayılır. OWN_PAID_PUBLIC_API: müşterinin ay sonunda kendi ücretli API planı vardı, koltuktan düşüldü.

Faturalanan adet CSV satır sayısı değildir; koltuk sayılan farklı müşteri kurumu sayısıdır.

Özet (manifest)

AlanAnlamı
countFaturalanan koltuk: farklı müşteri kurumu sayısı.
excludedCountKendi planı olduğu için düşülen kurum sayısı.
rowCountCSV veri satırı (bağlantı) sayısı.
revisionIdDönemde geçerli sponsorlu fiyat revizyonu.
sha256CSV dosyasının SHA-256 özeti; indirdiğiniz dosyayla karşılaştırabilirsiniz.
cutoffSayımın kesim anı (dönem sonu veya sözleşme bitişi).

Fatura satırındaki koltuk adedi, özet ve CSV özeti bu dökümden birebir alınır.

Firma değiştiren müşteri

  • Müşteri bir firmanın bağlantısını iptal edip başka bir firmaya bağlanırsa eski bağlantı aktarılmaz; yeni firma için yeni izin verilir.
  • Aynı ay içinde firma değişirse o ay için iki firma da müşteriyi kendi dökümünde birer koltuk olarak sayar; aylık sayım firmalar arasında paylaştırılmaz.
  • Müşteri aynı anda iki firmaya bağlı olabilir. Her firma yalnız kendi bağlantısını, uçlarını, teslimlerini ve dökümünü görür.
  • Müşteri ay sonunda kendi ücretli API planına sahipse iki firmanın dökümünde de düşülür; deneme süresindeki plan düşülmez.
  • Müşteri verisi müşterinin kendi kurumunda kalır; iptal veri silmez.

Erişim

Döküm yalnız uygulama sahibi firmanın yöneticisine ve platform yönetimine oturum doğrulamasıyla açılır. Başka firmanın dökümü istenemez; dosya depo adresi dışarı verilmez ve imzalı bağlantı üretilmez. Her CSV indirmesi denetim kaydına yazılır.