Başlangıç

Servis Limitleri

İstek limitleri, veri tavanları ve süreler.

Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0

Limitler anahtar ya da firma başına uygulanır. Aşımda yanıt 429 rate_limited olur ve Retry-After başlığı bekleme süresini saniye cinsinden verir. Aşağıdakiler varsayılan değerlerdir; firma bazında farklı limit için destek ile görüşün.

İstek limitleri

Kapsam	Limit	Açıklama
Tüm istekler (anahtar başına)	300 / dakika	Dış zarf; kayan pencere. Yalnız kabul edilen istekler sayılır.
Ekstre teslimatı `complete { statement }`	Tek eşzamanlı analiz	Anahtar başına; aynı anda bir ekstre analiz edilir, ikincisi `429` alır ve talep `pending` kalır. İş açma kovası yok (iş sihirbazda açılır).
Cari listesi teslimatı `complete { counterparties }`	30 / dakika	Aynı firmanın başka bir teslimatı kilidi 5 sn'den uzun tutarsa `429` + `Retry-After: 5`.
Yoklama `GET /erp-requests`	12 / dakika	Önerilen aralık 20–30 saniye (`poll_after_seconds`).
Anlık bağlantı çağrıları (firma başına)	30 / dakika	Cari arama, ekstre/bakiye çekme ve bağlantı testi birlikte.

Veri tavanları

Uç / işlem	Tavan
Talep teslimatı `complete`	10.000 cari · 20.000 ekstre satırı · 5.000 bakiye kaydı
Anlık bağlantı yanıtları	cari arama 500 sonuç · ekstre 20.000 satır · bakiye 5.000 firma

Süreler

Konu	Süre
Idempotency-Key önbelleği	24 saat.
Talep (talep ile aktarım) ömrü	30 dakika; `claim` en çok 10 dakika uzatır, toplam en çok 40 dakika.
Tek indirmelik dışa aktarma	Bir kez indirilir; ikinci istek `410 export_consumed`.
Anlık bağlantı zaman aşımları	`ping` 10 sn · `counterparties` 20 sn · `statements` / `balances` 60 sn.

Anlık bağlantı yanıt sınırları

Zaman aşımı: ping 10 sn, counterparties 20 sn, statements sayfa başına 60 sn, balances 60 sn (mutlak). Yanıt gövdesi: ping 64 KB, counterparties 1 MB, statements sayfa başına 16 MB, balances 16 MB.
Bağlayıcı yalnız API/ERP entegrasyonu açık paketlerde tanımlanabilir ve kullanılabilir; entegrasyon geçici kapatıldıysa çağrılar durur.
İmzalanacak yol+sorgu, isteğin satırındaki ham hâliyle (request-target) alınmalıdır; çerçeveler yolu yeniden kodlayabilir (Türkçe karakterli q ve cursor için önemli).
Ekstre (/statements) sayfalıdır: her istekte page_size (20.000) gelir, devam isteklerinde cursor; siz yanıta next_cursor koydukça (opak metin, en çok 512 karakter) sonraki sayfa istenir, son sayfada next_cursor boş/null bırakılır. Sayfalama uygulamayan servis tüm satırları tek yanıtta döner (en çok 20.000 satır / 16 MB) — daha büyük ekstre için sayfalama şart. Sayfa başına en çok 20.000 satır; toplam en çok 250.000 satır, 64 sayfa, 128 MB satır verisi ve 15 dakika (tüm sayfalar). Bakiye listesi en çok 5.000 firma; cari arama en çok 500 sonuç.
Ekstre çekimi arka planda çalışır: muhasebe personeli "Ekstreyi getir" dediğinde sihirbaz kartı "hazırlanıyor" gösterir, sayfalar toplandıkça satırlar doğrudan işlenir (Excel üretilmez); bitince kart dosyaya döner, hata olursa nedenle birlikte "Tekrar dene" çıkar. Firma başına aynı anda tek ekstre çekimi.
Firma başına dakikada 30 çağrı (arama + çekme + test birlikte).
Tutarlar string ya da sayı olabilir; en fazla 14 tam + 2 ondalık hane. Kabul edilen yazımlar: "12500.00" · 12500 · "12.500,50" (Türkçe binlik nokta + ondalık virgül) · "1234,50". Dikkat: noktalı string "1.239" Türkçe binlik olarak 1239 okunur; sayı 1.239 ise 1,24'e yuvarlanır — ondalığı "1239.00" gibi 2 haneyle ve noktayla gönderin. Tarihler YYYY-MM-DD. Bilinmeyen alanlar yok sayılır.