GİB ve entegratör bağlantısı

3 dk okuma · Güncelleme: 2026-09-10

ChatGPT, yardım metinlerini ve llms.txt dosyasını okuyarak yanıtlar.

Ne işe yarar?

GİB e-Fatura Portal veya özel entegratör üzerinden kimlik doğrulama.

Neden önemli?

Süresi dolan sertifika tüm kesimi durdurur.

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.

GİB e-Fatura Portal veya özel entegratör kimliği süresi dolunca tüm kesim durur. Sertifika/imza bitişini takvime yazın. FastEntegre’deki kullanıcı bilgisi entegratör paneliyle aynı olmalıdır. IP kısıtı varsa sunucu IP’sini whitelist’e ekletin. Portal şifresi sık değişir; 401’de önce orayı yenileyin.

Ö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ü > Entegrasyon Ayarları > Fatura)

Entegratör panelinde bağlantı testi yapın.
İmza/sertifika bitiş tarihini takvime not edin.
FastEntegre’de aynı kullanıcı bilgilerini kaydedip test faturası gönderin.
Entegratör/GİB panelinde bağlantı testi yapın.
Sertifika bitiş tarihini not edin.
FastEntegre fatura entegrasyonuna aynı kimliği kaydedip test faturası gönderin.
Bitişe 30 gün kala yenileme sürecini başlatın.

Kesim öncesi doğrulama

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

Portal vs özel entegratör

Portal düşük hacim ve manuel onay için uygundur. Yoğun otomatik kesimde özel entegratör kuyruk ve hata kodu zenginliği sağlar. İkisini aynı anda canlı kesim için kullanmayın.

Sık karşılaşılan hatalar

Yetki hatası 401 — Portal şifresini yenileyin; IP kısıtı varsa sunucu IP’sini whitelist’e ekleyin.
Yetki hatası 401 — Portal şifresini yenileyin; IP kısıtı varsa whitelist.
Sertifika geçersiz — Yenileme bitmeden kesimi durdurun. Eski sertifika ile “bazen çalışır” olmaz.

Sık sorulan sorular

GİB kesintisinde ne yapmalı?

Durum duyurusunu izleyin; kuyruğu yeniden gönderin. Acil senaryo.

Kullanıcı adı e-posta mı?

Entegratöre göre değişir. Paneldeki alan etiketini olduğu gibi doldurun.

İlgili rehberler

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.

Bu makale yardımcı oldu mu?