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ütun | Anlamı |
|---|---|
grantId | Bağlantı kimliği. Aynı müşteri iki uygulamanıza bağlıysa iki satır olur. |
customerName | Müşteri kurumun adı. |
vknLast4 | Vergi numarasının yalnız son 4 hanesi; tam numara dosyaya yazılmaz. |
start | Bağlantının açıldığı an (UTC, ISO 8601). |
end | Bağlantının kapandığı an; açık bağlantıda boş. |
exclusionReason | Boş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)
| Alan | Anlamı |
|---|---|
count | Faturalanan koltuk: farklı müşteri kurumu sayısı. |
excludedCount | Kendi planı olduğu için düşülen kurum sayısı. |
rowCount | CSV veri satırı (bağlantı) sayısı. |
revisionId | Dönemde geçerli sponsorlu fiyat revizyonu. |
sha256 | CSV dosyasının SHA-256 özeti; indirdiğiniz dosyayla karşılaştırabilirsiniz. |
cutoff | Sayı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.