e-Fatura Entegrasyonunda 401 ve 403 Hatalarını Ayırma

Ofiste bilgisayar ve evraklar üzerinde birlikte çalışan iki kişi — Temsili stok fotoğrafı: Pavel Danilyuk / Pexels. Görseldeki kişiler Entegrino müşterisi olarak tanıtılmamaktadır.

e-Fatura entegrasyonunda 401 veya 403 yanıtı aldığınızda önce erişim ve yetkiyi inceleyin; ürün, alıcı veya tutar bilgisini rastgele değiştirerek yeniden göndermeyin. Hatanın hangi işlemde oluştuğunu belirleyin, mevcut belge kaydını koruyun ve bağlantı düzeldikten sonra yalnızca gerekli adımı kontrollü çalıştırın.

401 ile 403 aynı sorunu anlatmayabilir

Turkcell e-Şirket geliştirici kılavuzu, ilgili e-Fatura işlemlerinde 401 yanıtını token süresinin bitmesiyle, 403 yanıtını ise kullanıcının yetkisinin bulunmamasıyla açıklar. Kılavuz veri doğrulama hatalarını ayrıca tanımlar. Bu açıklamalar sağlayıcıya özgüdür; başka bir entegratörde aynı kodun ayrıntılı nedeni kendi güncel belgesinden kontrol edilmelidir.

Dolayısıyla “bağlantı reddedildi” mesajını “fatura tutarı yanlış” diye yorumlamak doğru bir başlangıç değildir. Yetki sorunu devam ederken tutarı değiştirmek hem asıl sorunu çözmez hem de doğru satış verisini bozabilir. Teknik hata ile ticari verinin doğruluğu ayrı incelemelerdir.

Varsayımsal örnek: E-1170 mobilya siparişi

Bir mobilya satıcısında E-1170 masa ve sandalye siparişinin belge işlemi erişim hatasıyla dursun. Depo ekibi sevkiyat hazırlığını sürdürüyor, müşteri temsilcisi de belge bağlantısını bekliyor olsun. Operatör bütün siparişi silip yeniden oluşturursa önceki işlem geçmişiyle bağ kopabilir. Oysa kontrol edilmesi gereken ilk bilgiler, başarısız çağrının türü, zamanı ve alınan yanıttır.

Örneğin hata mevcut belgenin durumunu sorgularken oluşmuşsa, yeni fatura oluşturmak sorgu yetkisini düzeltmez. Hata belge oluşturma çağrısında görülmüşse de önceki denemelerin kayıtları incelenmeden satışın hiç işlenmediği varsayılmamalıdır.

İlk incelemede tutulacak kayıtlar

Siparişin yerel kimliği ve varsa belge kimliği.
İşlemin amacı: oluşturma, sorgulama, indirme veya gönderim.
Yanıt kodu, açıklaması ve işlem zamanı.
Kullanılan sağlayıcı hesabı ve ortamın adı.
Son başarılı işlem zamanı ve incelemeyi üstlenen kişi.

Bu kayda parola, API anahtarı veya erişim belirteci eklemeyin. Destek ekibine gönderilecek örneklerde müşteri bilgilerini ihtiyaçla sınırlayın. Hesap adını bilmek ile gizli erişim bilgisini paylaşmak aynı şey değildir.

Yetkiyi düzelttikten sonra kuyruğu nasıl açmalı?

Otomatik tekrarları kontrol altına alın: Aynı hatayla sürekli gönderim yapan işlerin sayısını ve kapsamını belirleyin.
Nedeni doğrulayın: Sağlayıcının güncel yöntemine göre erişim bilgisini veya işlem yetkisini yetkili ekip kontrol etsin.
Mevcut belgeleri araştırın: Kuyruktaki her satış için daha önce oluşmuş bir belge veya başarılı işlem olup olmadığını inceleyin.
Tek kayıtla deneyin: Bağlantı düzeldikten sonra E-1170 için gerekli işlemin sonucunu doğrulayın.
Bekleyenleri ayırın: Başarılı kayıtları, hâlâ yetki hatası verenleri ve veri incelemesi gerektirenleri ayrı takip edin.

Bütün kuyruğu baştan çalıştırmak yerine son başarılı adımı temel alın. Mobilya siparişindeki teslimat adresi veya ürün miktarı değişmişse bu değişiklikleri ayrıca değerlendirin; erişim düzeltmesi ticari değişiklikleri otomatik onaylamaz. Yeniden denemede aynı sipariş ile belge ilişkisinin korunması gerekir.

Depo ve CRM kaydına doğru bilgi verin

Müşteri temsilcisine “fatura iptal oldu” veya “belge teslim edildi” gibi doğrulanmamış bir sonuç göstermeyin. Yerel takipte “erişim sorunu inceleniyor” etiketi kullanılabilir; bu bir resmi belge durum kodu değildir. Sevkiyat ekibi de belge sonucunun kontrol edildiğini görmeli, kendi teslimat kaydını ayrıca izlemelidir.

Bağlantı sonrası yalnızca dosya indirme adımı başarısızsa PDF indirme hatasında yeniden belge oluşturmama rehberini uygulayın. Entegrino için otomatik token yenileme, kullanıcı yetkisi düzenleme veya bu sağlayıcıyla hazır bağlantı vaat edilmez.