Fatura entegrasyonu hata ayıklama

Ne işe yarar?

Kesim hatalarında sistematik teşhis.

Neden önemli?

Rastgele yeniden deneme aynı hatayı tekrarlar.

Detaylı açıklama

Belge tipi (e-fatura vs e-arşiv), KDV oranı ve müşteri VKN/TCKN uyumu GİB reddinin en sık nedenleridir. Canlıya geçmeden önce test ortamında en az bir kurumsal ve bir bireysel senaryo deneyin.

Kesim hatasında rastgele yeniden deneme aynı GİB/entegratör kodunu tekrarlar. Kodu kopyalayıp entegratör dokümanında arayın; sonra test faturası ile bağlantıyı ayırın (bağlantı mı, bu sipariş mi). Genel “sistem hatası” çoğu zaman karşı taraf kesintisidir.

Ön koşullar

• Aktif e-fatura/e-arşiv entegratörü veya GİB Portal bağlantısı.
• Siparişte fatura için zorunlu kimlik ve adres alanları.

Adımlar (Menü > Faturalar > hata logu)

1. Hata kodunu ve Türkçe açıklamayı kopyalayın.
2. Entegratör dokümantasyonunda kodu arayın.
3. Test faturası ile bağlantıyı doğrulayın.
4. Düzeltme sonrası tek siparişle canlı deneme yapın.
5. Hata kodu ve Türkçe/JSON mesajını kopyalayın.
6. Entegratör dokümanında kodu arayın.
7. Bağlantı testi + test VKN faturası ile ortamı doğrulayın.
8. Düzeltme sonrası tek canlı siparişle deneyin; kuyruğu toptan basmayın.

Kesim öncesi doğrulama

1. Alıcı e-fatura mükellefi mi kontrol edin.
2. Satır tutarları, iskonto ve kargo bedeli toplamı siparişle uyumlu mu?
3. Vergi dairesi ve unvan bilgisi kurumsal alıcıda dolu mu?
4. Test kesiminde PDF ve XML indirip arşivleyin.

Sınıflama

• Şema (adres, VKN, KDV): belge verisi.
• 401: kimlik.
• 5xx / timeout: kesinti.
• Mükellefiyet: belge tipi.

Sık karşılaşılan hatalar

• Genel “sistem hatası” — Entegratör durum sayfasına bakın; kesinti bitince kuyruktaki belgeleri yeniden gönderin.
• Genel “sistem hatası” — Entegratör durum sayfası; kesinti bitince kuyruğu yeniden gönderin.
• Sadece bazı siparişler — Bağlantı sağlamdır. O siparişin adres/KDV/iskonto satırına bakın.

Sık sorulan sorular

Kuyruk şişti, ne sırayla?

Önce bugünün kargolanacakları, sonra eski. Toplu basış 429 üretir.

Log nerede?

Fatura detayı ve mağaza/entegrasyon logu. Log okuma.

İlgili rehberler

• E-fatura temelleri
• Müşteri adresi ve VKN/TCKN
• Entegrasyon çalışmıyor kontrol listesi
• Acil: sipariş veya fatura kesilemiyor

Hâlâ çözülmedi?

• Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
• WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
• Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.