Anlık Bağlantı
Anlık Bağlantı Sorun Giderme
Anlık bağlantıda sık görülen belirtiler ve çözümleri.
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
Panelde görülen belirti, olası neden ve çözüm.
| Belirti | Olası neden | Çözüm |
|---|---|---|
| "Bağlantı başarısız" — adres reddedildi | Adres özel ağda (10.x, 192.168.x, localhost) ya da HTTPS değil. | Herkese açık HTTPS alan adı verin (ters vekil/tünel). |
| "Bağlantı başarılı" ama "ERP'den getir" imza hatası veriyor | Servis imzayı yanlış hesaplıyor ya da saat ±300 sn dışında. | İmza satırı {ts}\n{METHOD}\n{yol+sorgu}; sunucu saatini NTP ile eşleyin; örnek kodda verify fonksiyonuna bakın. |
| "ERP bu cari için … hareket döndürmedi" | /statements boş rows döndü. | Dönem aralığı dâhil uçlu; cari kodu eşleşmesi ve tarih filtresini ERP sorgusunda kontrol edin. |
| Kartta "bir yanıtta en fazla 20.000 satır … sayfalama" hatası | /statements sayfalama yapmadan 20.000'den fazla satır (ya da 16 MB'tan büyük gövde) döndürdü. | page_size kadar satır döndürüp next_cursor verin; biz cursor ile devam sayfalarını isteriz (örnek kodlardaki gibi). |
| Kartta "aynı sayfa imlecini yeniden döndürdü" ya da "aynı satırları … yeniden döndürdü" | next_cursor ilerlemiyor (hep aynı değer) ya da farklı imleçle aynı satırlar geliyor. | İmleç ERP sorgusunun kaldığı yeri kodlamalı (son belge numarası / satır konumu); son sayfada boş bırakın. Sıralamayı sabit bir anahtarla (belge no + satır) yapın. |
| Kartta "… dakika içinde vermedi" ya da "… sayfadan fazla döndürdü" | Sayfalar çok yavaş ya da çok küçük (64 sayfa / 15 dakika tavanı). | Sayfa başına binlerce satır verin (20.000'e kadar), ERP sorgusunu dönem ve cari üzerinden indeksleyin ya da dönemi bölün. |
| Cari aramada sonuç yok | /counterparties?q= sorgusu ad/kod/VKN'de arama yapmıyor. | En az ad ve ERP kodunda "içerir" araması yapın; en fazla 50 sonuç döndürün. |
| Bakiyeler geldi, çoğu "e-posta eksik" | /balances kayıtlarında email boş, biçimi geçersiz ya da aynı adres başka bir firmada kayıtlı (panel "N firmanın ERP'deki e-postası kullanılamadı" diye ad + nedenle uyarır). | ERP'deki e-posta alanını ekleyin (firma başına tek, geçerli adres); rehber dolunca taslaktaki boş satırlar bir sonraki getirmede ve Firmalar adımı açılışında kendiliğinden tamamlanır. Muhasebe personeli eksikleri panelde satır içi de tamamlayabilir. |