01Sık hatalar ve çözümleri
Yetki süresi doldu
Neden: API anahtarı, token veya yetki süresi sona erdi. Çözüm: yetkiyi yenilemek ve süre dolmadan uyarı veren izleme kurmak.
Oran sınırı
Neden: Kısa sürede platformun izin verdiğinden fazla istek gönderildi. Çözüm: kuyruk, bekleme ve toplu güncelleme stratejisi.
Stok çakışması
Neden: Aynı ürün iki kanalda aynı anda satıldı, güncellemeler çakıştı. Çözüm: tek stok kaynağı ve sıralı (kuyruklu) güncelleme.
Mükerrer kayıt
Neden: Aynı sipariş veya cari iki kez aktarıldı. Çözüm: benzersiz anahtarla tekrar kontrolü (idempotency).
Kategori veya özellik reddi
Neden: Kategori eşleşmesi yok ya da zorunlu özellik değeri eksik. Çözüm: kategori ve özellik eşleştirmesini tamamlamak.
02Kategoriye özgü sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Faturalar elle kesiliyor | Sipariş ve fatura ayrı | Siparişten e-belge otomasyonu |
| Mutabakat günler sürüyor | Cari hareketler dağınık | Otomatik mutabakat |
| Vadesi geçen alacaklar fark edilmiyor | Takip yok | Vade uyarıları |
03Aktarılan veriler
| Veri | Yön | Sıklık |
|---|---|---|
| İrsaliye | kaynak → hedef | sevkiyatta |
04Kalıcı önlemler
- İzleme panosu ve hata bildirimi
- Yetki sürelerinin dolmadan yenilenmesi
- Platform duyurularının takibi
- Hata kuyruğunun günlük kontrolü
05İşletim ve bakım ipuçları
- Yıl bazlı değişen mevzuat eşikleri resmî kaynaktan kontrol edilir; sabit değer olarak koda gömülmez.
- E-belge entegratörünün duyuruları ve format değişiklikleri takip edilir.
- Yedekler ve erişim yetkileri düzenli kontrol edilir.
06Planlama notları
- Mali müşavirle hesap planı ve aktarım formatı netleşir.
- E-belge gönderimi GİB portalı ya da özel entegratör üzerinden yapılır; yazılım, kullanılan entegratörün servisine bağlanır.
- E-belge zorunluluk eşikleri Gelir İdaresi Başkanlığı'nın (GİB) güncel düzenlemeleriyle belirlenir; rakam yazılmaz, "güncel tebliğlere göre" denir.
07Zonguldak Merkez'de destek
Zonguldak Merkez, Zonguldak iline bağlı bir ilçedir ve PTT adres verisine göre 115 mahalle ve köy kaydından oluşur.
Zonguldak Merkez'de bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.
Aynı ildeki Çaycuma, Kilimli ve Gökçebey ilçeleri için de e-irsaliye entegrasyonu talepleri değerlendirilir; toplantılar uzaktan yapılır.
Kullandığınız sistemleri ve bağlamak istediğiniz platformu WhatsApp'tan yazın; e-irsaliye entegrasyonu akışını birlikte çıkaralım. Telefon: 0540 003 19 81.
SSSSık sorulan sorular
Aynı sipariş iki kez aktarılabilir mi?
Benzersiz anahtar kontrolü (idempotency) kurulduğunda aynı kayıt ikinci kez işlenmez.
Sadece Zonguldak için mi çalışıyorsunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
Hata kuyruğunu kim kontrol eder?
İşletmede belirlenen bir sorumlu günlük kontrol eder; bakım anlaşması varsa bizim tarafımızdan da izlenir.
E-irsaliye entegrasyonu için hangi erişimler gerekir?
Bağlanacak sistemlerin resmî API veya entegrasyon bilgileri, varsa test hesabı ve verinin ana kaynağının hangi sistem olacağı kararı gerekir.
Muhasebe programımızı değiştirmek zorunda mıyız?
Hayır. Çoğu durumda mevcut programın resmî entegrasyon araçlarıyla bağlantı kurulur; değişiklik ancak ihtiyaç karşılanmıyorsa değerlendirilir.
E-irsaliye entegrasyonu çalışırken bir kayıt aktarılamazsa ne olur?
Başarısız aktarım hata kuyruğunda bekletilir, yeniden denenir ve raporlanır; hangi kaydın neden aktarılamadığı görülür.
Zonguldak Merkez'de bulunuyorum, yerinde görüşme mümkün mü?
Toplantılar görüntülü yapılır ve ekran paylaşımıyla ilerler. Cihaz kurulumu, saha incelemesi veya ekip eğitimi gibi yerinde bulunmayı gerektiren adımlar ayrıca planlanır.
Hata olduğunu nasıl anlarım?
İzleme kurulu bir entegrasyonda başarısız kayıtlar listelenir ve sorumlu kişiye bildirim gider; ayrıca günlük özet raporu alınabilir.
→İlgili sayfalar
E-İrsaliye Entegrasyonu hakkında diğer konular
- E-irsaliye entegrasyonu çoklu platform yönetimiBirden çok sistemle birlikte kullanım
- E-irsaliye entegrasyonu API ve sınırlamalarYetki, oran sınırı ve kurallar
- E-irsaliye entegrasyonu test ve canlıya almaTest ortamı ve geçiş
- E-irsaliye entegrasyonu nasıl çalışır?Veri akışı ve teknik yapı
- E-irsaliye entegrasyonunun güvenliğiKimlik bilgisi, yetki ve veri güvenliği
Zonguldak Merkez'de ilgili hizmetler
Zonguldak içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sevk ile otomatik irsaliye
- yanıt takibi
- e-Arşiv
- e-Defter
- kasa
- banka
- tevkifat
- Zonguldak
- Merkez