E-fatura entegrasyonu seçimi

Ne işe yarar?

Uyumsoft, Digital Planet, GİB Portal vb. fatura entegratörü bağlantısı.

Neden önemli?

Yasal belge kesimi entegratör üzerinden yapılır.

Detaylı açıklama

Mağaza bağlantısı yalnızca kimlik bilgisi girişi değildir: sipariş çekim aralığı, otomatik fatura/stok seçenekleri ve kargo eşlemesi birlikte yapılandırılmalıdır.

E-belge kesimi FastEntegre’den GİB’e doğrudan değil, seçtiğiniz entegratör (Uyumsoft, Digital Planet, eLogo, Trendyol e-Faturam, GİB Portal vb.) üzerinden gider. Kullanıcı/şifre, API anahtarı veya sertifika alanları entegratöre göredir. Test ortamı ve test VKN ile en az bir kurumsal (e-fatura) ve bir bireysel (e-arşiv) senaryo kesin. Canlıya geçince otomatik kesimi hemen tüm mağazalarda açmayın.

Ön koşullar

• Oluşturulmuş ana mağaza.
• Platform satıcı panelinde API erişimi ve gerekli izinler.

Adımlar (Menü > Entegrasyon Ayarları > Fatura)

1. Entegratörünüzü seçin.
2. Kullanıcı, şifre veya sertifika bilgilerini girin.
3. Test faturası kesin.
4. Canlıya geçince otomatik kesimi kademeli açın.
5. Menü > Entegrasyon Ayarları > Fatura’dan entegratörü seçin.
6. Kimlik bilgilerini girip entegratör panelindeki bağlantı testi ile doğrulayın.
7. FastEntegre’de test faturası kesin; PDF/XML indiğini görün.
8. Canlı anahtara geçtikten sonra ilk 10 belgeyi manuel kontrol edin.

Bağlantı doğrulama

1. Mağaza detayında Bağlantıyı test et ile API yanıtını doğrulayın.
2. Test başarılıysa tek sipariş çekimini manuel tetikleyin.
3. Mağaza logunda 401/403 yoksa token geçerlidir.
4. İlk 24 saatte sipariş, stok ve (varsa) fatura akışını ayrı ayrı kontrol edin.

Entegratör değişince

Eski entegratördeki taslaklar yeni bağlantıya taşınmaz. Dönem ortası geçişte kesilmiş belgelerin UUID’lerini arşivleyin. Aynı anda iki canlı entegratöre kesim yaptırmayın (çift belge riski).

Kontrol listesi

• API anahtarı platform panelinde aktif.
• Bağlantı testi yeşil.
• Sipariş senkron aralığı tanımlı.
• Kargo ve fatura entegrasyonları (gerekiyorsa) ayrıca bağlandı.

Sık karşılaşılan hatalar

• 401 / kullanıcı hatalı — Entegratör şifresini sıfırlayın; IP kısıtı varsa FastEntegre çıkış IP’sini whitelist’e ekletin.
• Test faturası canlıya gitti — Entegratör “canlı” dayı; test VKN ve test ortamı bayrağını açın. Test vs canlı.

Sık sorulan sorular

GİB Portal yeterli mi?

Düşük hacimde evet; yoğun otomatik kesimde özel entegratör daha stabildir. Sertifika bitişini takvime yazın.

Birden fazla VKN?

Genelde ayrı entegrasyon veya ayrı ana mağaza gerekir. Şüphede destek + entegratör sözleşmesi.

İlgili rehberler

• Entegrasyon çalışmıyor kontrol listesi
• Pazaryeri mağazası ekleme
• E-fatura temelleri
• GİB ve entegratör bağlantısı

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.