Gelen e-Faturayı listede görmek, hedef muhasebe veya ERP sistemine güvenle kaydetmekle aynı aşama değildir. Yeni belge işaretini kaldırmadan önce belgenin hedefte kalıcı olarak bulunduğunu doğrulayın. Aksi hâlde başarısız bir aktarım, sonraki “yeni belgeler” taramasının dışında kalabilir.

isNew işareti neyi yönetir?

Turkcell e-Şirket resmî API kılavuzunda gelen faturaların isNew=true olarak kaydedildiği ve muhasebe/ERP uygulamasına çekilen belgelerin tekrar çekilmemesi için bu alanın false yapılabildiği açıklanır. Bu, aktarım akışının yönetiminde kullanılan bir işarettir. Hedef sistemdeki kaydın başarıyla tamamlandığını kendiliğinden kanıtlayan bir muhasebe onayı olarak kullanılmamalıdır.

Aşağıdaki sıra bir entegrasyon tasarım önerisidir; sağlayıcının bütün bağlantılarda bu sırayı otomatik uyguladığı iddiası değildir. Kritik nokta, belgenin tekrar bulunabilmesi ile hedefte mükerrer kayıt oluşmamasını birlikte sağlamaktır.

Varsayımsal örnek: K-1630 kırtasiye tedariki

Bir kırtasiye işletmesine defter, kalem ve dosya tedarikleri için 20 e-Fatura gelsin. Aktarıcı önce 20 belgenin yeni işaretini kaldırıp ardından hedef kayıtlarını oluşturmaya başlasın. Hedef sistemdeki bağlantı kesintisi nedeniyle yalnızca 18 belge kaydedilmiş olsun.

Bir sonraki çalışma yalnızca yeni işaretli belgeleri arıyorsa kalan iki belge listede görünmeyebilir. Kaynakta 20 belge bulunmasına rağmen hedefte 18 kayıt vardır. Fark iki belgedir; yeni belgeler listesinin boş olması bu farkın kapandığını göstermez. Örnekte tutar veya vergi hesabı değil, aktarım adedi karşılaştırılmaktadır.

Tedarikçi tekrar belge göndermeden önce mevcut belgelerin kimliklerini uzlaştırın. Kaynakta zaten bulunan belgeyi yeniden istemek, gerçek aktarım sorununu çözmez ve ekiplerin aynı belgeyi birden fazla yoldan kaydetmesine yol açabilir.

Kaybetmeden ve çoğaltmadan aktarım sırası

1. Kaynak kimliğini kaydedin: İşletme hesabı ve belge kimliğiyle bir aktarım kaydı oluşturun. Belge numarasını yalnızca ekran başlığı olarak kullanıp iz bırakmadan ilerlemeyin.
2. Hedefte varlığını kontrol edin: Daha önce aynı belge kaydedilmiş mi? Varsa ikinci kayıt açmadan mevcut hedef referansını doğrulayın.
3. Kalıcı kaydı tamamlayın: Hedef işlemin başarı cevabını ve oluşan kayıt kimliğini saklayın. Belleğe alınmış veri veya iş kuyruğuna bırakılmış görev, tek başına tamamlanmış kayıt değildir.
4. Yeni işaretini ardından güncelleyin: Kaynak işaretini değiştirme adımını, hedefteki doğrulanmış kayıtla ilişkilendirin. Güncelleme başarısızsa bunu ayrı bir tekrar deneme işi olarak tutun.
5. Hataları belge bazında ayırın: K-1630 örneğindeki iki başarısız kaydı ayrı inceleyin. Başarılı 18 belgeyi yeniden oluşturmadan yalnızca eksik olanları tamamlayın.
6. Son uzlaştırmayı yapın: Kaynak belge kimlikleriyle hedef referanslarını karşılaştırın. İşaret durumu ile kayıt varlığını ayrı sütunlarda gösterin.

Ters hata da mümkündür

Hedef kayıt oluşmuş ancak kaynak işaretinin güncellenmesi başarısız olmuş olabilir. Bu durumda belge tekrar yeni listesine gelebilir. Aktarıcı doğrudan ikinci kayıt açarsa bu kez eksik kayıt yerine mükerrer kayıt oluşur. Bu nedenle sadece işlem sırasını düzeltmek yeterli değildir; yeniden çalıştırıldığında aynı belgeyi tanıyan bir kontrol de gerekir.

Test ortamında iki kesinti deneyin: hedef kayıt tamamlanmadan kesinti ve hedef kayıt tamamlandıktan sonra işaret güncellemesi öncesinde kesinti. İlkinde belge kaybolmamalı, ikincisinde hedefte ikinci kayıt oluşmamalıdır. Testin sonucunu kaynak ve hedef kimlikleriyle belgeleyin.

• 20 kaynak belgeye karşılık kaç doğrulanmış hedef kayıt var?
• Hedef referansı olmayan belgeler ayrı listeleniyor mu?
• Tekrar gelen belge mevcut hedef kayda bağlanıyor mu?
• İşaret güncelleme hatası yeni belge oluşturmayı tetikliyor mu?
• Hata nedeni ve sonraki kontrol sorumlusu belli mi?

Benzer bir durum ayrımı için gelen e-Faturada okundu ve muhasebe kaydı rehberine bakabilirsiniz. Bu yazının özel konusu ise aktarım işaretinin yanlış zamanda değiştirilmesi ve kesinti sonrası toparlanmadır.

Sık sorulan sorular

Yeni listesinin boş olması aktarımın bittiğini gösterir mi?

Tek başına göstermez. Liste filtresini ve kaynak belge kimliklerinin hedefteki karşılıklarını birlikte kontrol edin.

Bütün belgeleri tekrar aktarmak çözüm olur mu?

Önce mevcut kayıtları uzlaştırın. Aynı belgeyi tanımayan toplu tekrar, başarılı kayıtları çoğaltabilir.

Entegrino bu kontrolü hazır sunuyor mu?

Bu rehber hazır entegratör bağlantısı veya otomatik hata giderme özelliği vaat etmez. Kullanılan bağlantıda kayıt ve tekrar deneme davranışı test edilmelidir.

Kaynak kontrolü: 4 Kasım 2026. K-1630 ve belge adetleri varsayımsaldır. Fotoğraf temsili ofis ortamıdır; kişiler Entegrino müşterisi değildir.