QNB eFinans entegrasyonu:
siparişin faturası kendiliğinden kesilir.

QNB eFinans entegrasyonu nedir, QNB eSolutions bu bağlantıda hangi rolü üstlenir?

QNB eFinans entegrasyonu, satış kanallarınızdaki siparişi QNB eSolutions'ın web servislerine fatura verisi olarak gönderen ve belgenin düzenlenmesini GİB izinli bir özel entegratöre bırakan bağlantıdır. QNB eSolutions Elektronik Ticaret ve Bilişim Hizmetleri A.Ş., Gelir İdaresi Başkanlığı'nın yayımladığı e-Fatura ve e-Arşiv özel entegratör listelerinin ikisinde de yer alır. Şirketin kendi açıklamasına göre QNB Türkiye'nin %100 iştirakidir ve 18 Ocak 2025'ten bu yana eFinans yerine eSolutions adını kullanır. Aramalarda iki adın birlikte geçmesinin sebebi budur.

509 Sıra No.lu VUK Genel Tebliği, e-Belge uygulamalarından üç yöntemle yararlanılabileceğini söyler. Pazaryeri satıcısı için pratik farkları şöyledir:

• GİB Portal yöntemi: Faturayı Başkanlığın ücretsiz portalında tek tek düzenlersiniz. Az siparişte yeterlidir; bu seçeneği GİB e-Arşiv Portal entegrasyonu sayfamızda ayrıca anlattık.
• Özel entegratör yöntemi: Belgeleriniz QNB eSolutions gibi Başkanlıktan izin almış bir firmanın sisteminde düzenlenir, iletilir ve saklanır. Yox İş Ortağım bu yöntemde QNB'nin servislerine bağlanır.
• Doğrudan entegrasyon: Firmanın kendi bilgi işlem sistemi GİB'e doğrudan bağlanır; kendi yazılım ve altyapı yatırımınızı gerektirir.

QNB servislerinde fatura tarafı nasıl ayrılır

QNB eSolutions'ın teknik dokümanına göre e-Fatura ile e-İrsaliye aynı servis adresini paylaşır, e-Arşiv Fatura ise kendi servisiyle çalışır. Yox İş Ortağım'daki bağlantı fatura tarafını kapsar: siparişten e-Fatura ve e-Arşiv, fatura PDF'i, iptal başlatma, belge durumu ve gelen e-Faturalar. Satış kanalları, kargo firmaları ve diğer programlarla birlikte bütün listeyi Yox İş Ortağım entegrasyonları sayfasında görebilirsiniz.

QNB eSolutions hesabınızı bağlantıya hazırlamak: başvuru, aktivasyon ve kontör

Bağlantıdan önce QNB tarafında üç şeyin tamamlanmış olması gerekir: GİB başvurusu, QNB'de etiket aktivasyonu ve kullanılabilir kontör. QNB eSolutions'ın ürün sayfalarındaki açıklamalara göre sıra şöyledir:

1. Kamu Sertifikasyon Merkezi'nden mali mühür ya da yetkili bir sağlayıcıdan e-imza temin edin. QNB'ye göre geçişin doğrudan maliyet kalemi mali mühür ücretidir.
2. GİB e-Fatura başvurusunda yararlanma yöntemi olarak Özel Entegrasyon seçeneğini işaretleyin. QNB, kendi tarafındaki başvurunun 1 iş gününde sonuçlandığını belirtir.
3. QNB eSolutions Portal'da Hizmet Aktivasyonları bölümünden e-Fatura etiket aktivasyonunu yapın. e-Fatura kullanıcısıysanız e-Arşiv aktivasyonunu QNB'nin iletişim kanallarından ayrıca yaptırmanız gerekir.
4. Bir kontör paketi alın; belge düzenlemek için kontör bakiyesi şarttır.

Kontör nasıl harcanır, paket süresi dolunca ne olur

QNB'de her elektronik belge bir kontör değerindedir ve aynı kontör e-Fatura, e-Arşiv, e-İrsaliye gibi ürünlerde ortak kullanılır. Paketler yalnız 6 ve 12 aylık süreyle satılır; süre sonunda kalan kontör devretmez, süre dolmadan biterse yeni paket almanız gerekir. QNB'nin Dijital Köprü kampanyasında ücretsiz kullanım koşulları portal ve entegrasyon kullanımı için ayrı tanımlandığından, web servisle keseceğiniz faturalarda geçerli koşulu QNB'den yazılı teyit edin.

Bağlantı için portala girilmeyen ayrı bir QNB kullanıcısı açın

QNB'nin API dokümanı, web servisler için ayrı bir API anahtarı ya da secret verilmediğini, portalda tanımlı kullanıcı kodu ve şifresinin servis bağlantısı için de yetkili olduğunu söyler. Aynı kullanıcıyla portala da giriş yapılıyorsa şifre 90 günde bir yenilenmek zorundadır ve yeni şifre bağlantıya girilene kadar servis oturum açamaz. QNB'nin önerisi, Yönetim > Genel > Kullanıcı Tanımları > Yeni Kullanıcı Ekle yoluyla yalnız entegrasyonda kullanılacak bir alt kullanıcı açmak ve bu kullanıcıyla portala hiç giriş yapmamaktır; bu durumda şifrenin süresi dolmaz.

Yox İş Ortağım'da QNB eFinans entegrasyonu adım adım nasıl kurulur?

QNB tarafındaki hazırlık bittiyse kurulum panelde şu sırayla ilerler:

1. Bilgileri hazırlayın: Entegrasyon için açtığınız QNB kullanıcısının kullanıcı adı ve şifresi, faturayı kesecek firmanın gönderen VKN'si (şahıs işletmesinde TCKN) ve isteğe bağlı olarak faturada görünecek gönderen unvan.
2. Panele girip test edin: Bilgileri Yox İş Ortağım'ın Muhasebe bölümüne yazın ve bağlantı testini çalıştırın. Test olumsuzsa önce bilgilerin aynı QNB hesabına ait olduğunu kontrol edin.
3. Fatura kuralını belirleyin: Faturanın hangi sipariş aşamasında kesileceğini, e-Fatura ve e-Arşiv seçiminin nasıl yapılacağını ve seri ayarlarını seçin.
4. İlk faturayı birlikte doğrulayın: İlk belgenin tutarını, KDV satırlarını ve alıcı bilgisini QNB portalındaki kayıtla karşılaştırın.

Faturanın kesileceği sipariş aşamasını seçmek

Siparişler panelde Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim durumlarından geçer. QNB'nin e-Fatura ve e-Arşiv sayfalarına göre fatura satıştan sonraki günden itibaren 7 gün içinde geçmiş tarihle düzenlenebilir ve ileri tarihli e-Arşiv kesilemez. Öte yandan internet satışına ait e-Arşiv faturada taşıyıcı firma ve gönderim tarihi de yer almalıdır. Hazırlık süresi uzun ürünlerde bu iki şartın hangi aşamada birlikte karşılandığını kurulumda sizinle birlikte kontrol ederiz.

Seri ve numara düzeni

QNB'nin e-Arşiv servisi, fatura numarasının sistem tarafından seçilen seriyle üretilmesine izin verir. Panelden gelen siparişler için ayrı bir seri tanımlamak, portaldan elle kestiğiniz faturalarla otomatik kesilenleri bir bakışta ayırmanızı ve ay sonunda muhasebecinizin kontrolünü kolaylaştırır.

QNB eFinans entegrasyonu siparişten faturaya nasıl işler: e-Fatura ve e-Arşiv farkı

Alıcı e-Fatura kayıtlı kullanıcısıysa siparişin faturası e-Fatura, değilse e-Arşiv Fatura olarak düzenlenir; bu seçim panelde kurala bağlanır. GİB'e göre e-Fatura yalnız sisteme kayıtlı kullanıcılar arasında kullanılır, bireysel müşteriye ve kayıtlı olmayan firmaya e-Arşiv kesilir. QNB'nin servisleri bu iki belgeyi farklı biçimde işler ve panelde gördüğünüz durumlar bu farktan doğar:

QNB dokümanına göre e-Fatura'da servisten dönen ilk yanıt, belgenin işlendiği anlamına gelmez; nihai sonuç durum sorgusuyla doğrulanır. Siparişin yanında görünen gönderildi, kabul ve red bilgisi bu durumdur.

Alıcının e-Fatura'ya kayıt tarihi neden önemli

QNB'nin kayıtlı kullanıcı sorgusu, alıcının e-Fatura sistemine kayıt zamanını da döndürür. Dokümana göre fatura tarihi bu kayıt zamanından önceyse belge e-Fatura olarak düzenlenemez, e-Arşiv olmalıdır. Yeni şirketleşmiş bir alıcının siparişinde ya da geçmiş tarihli faturada bu ayrıntı belge türünü değiştirebilir.

Pazaryeri ve site siparişlerinde e-Arşiv faturada bulunması gereken bilgiler

İnternet üzerinden yapılan satışın e-Arşiv faturası, mağazada kesilen bir satış faturasından daha fazla bilgi taşır. 509 Sıra No.lu VUK Genel Tebliği'ne göre e-Arşiv Fatura uygulamasındaki satıcı, internet satışına ait faturayı alıcıya elektronik ortamda iletmek zorundadır. Faturada “Bu satış internet üzerinden yapılmıştır.” ifadesiyle birlikte şu bilgiler yer almalıdır:

• Satış işleminin yapıldığı web adresi
• Ödeme şekli ve ödeme tarihi
• Mal satışlarında gönderiyi taşıyanın adı soyadı ya da unvanı ile VKN/TCKN bilgisi
• Malın gönderildiği ya da hizmetin ifa edildiği tarih
• İade bölümü: malı iade edenin adı soyadı, adresi, imzası ve iade edilen malın cinsi, miktarı, birim fiyatı, tutarı

Tebliğe göre e-Fatura kayıtlı alıcıya internet üzerinden mal satıldığında e-Faturada da iade bölümü dışındaki bu bilgiler bulunur. Bireysel müşteri ürünü iade ederken kendisine iletilen faturanın çıktısındaki iade bölümünü doldurup imzalar ve ürünle birlikte gönderir; bu belge satıcının düzenleyeceği gider pusulası yerine geçer.

2026'da kâğıt fatura seçeneği ne durumda

e-Arşiv uygulamasına kayıtlı olmayan mükellefler 2025 boyunca vergiler dahil 3 bin TL'yi aşmayan faturaları kâğıtta düzenleyebiliyordu. 31 Aralık 2025 tarihli Resmî Gazete'de yayımlanan 589 Sıra No.lu VUK Genel Tebliği'ne göre 1 Ocak 2026'dan itibaren tutarına bakılmaksızın bu faturaların e-Arşiv olarak GİB portalından ya da izinli bir özel entegratörün sisteminden düzenlenmesi gerekir. Basit usulde vergilendirilen ve işletme hesabı esasına göre defter tutanlar için bu tarih 1 Ocak 2027'ye ertelendi; 2026 boyunca onlar için 3 bin TL sınırı sürüyor.

Fatura iptali, alıcı reddi ve iade: QNB eSolutions'ta hangi yol geçerli?

Gönderilmiş bir e-Belge üzerinde değişiklik yapılamaz; hatalı belge iptal edilir ya da alıcı tarafından reddedilir, doğrusu yeniden düzenlenir. Yox İş Ortağım'da iptal edilen ya da iade gelen siparişin faturası için iptal panelden başlatılır; ancak hangi belgenin iptal edilebileceğini QNB eSolutions ve mevzuat belirler. Resmî kaynaklara göre yollar şöyledir:

İptal kararını vermeden önce kontrol edilecekler

• Siparişin iptal mi iade mi olduğunu ayırın. Kargoya verilmeden iptal edilen siparişte fatura iptal edilir, teslim edilmiş ürünün dönüşünde iade belgesi düzenlenir.
• 8 günlük süreyi takip edin. Pazaryerinde iptal onayı gecikirse fatura iptal süresi dolabilir; süre geçmişse izlenecek yolu mali müşavirinizle belirleyin.
• Aynı belgeye iki yerden işlem yapmayın. İptali panelden başlattıysanız aynı faturayı portaldan ayrıca iptal etmeye çalışmayın; sonucu QNB portalındaki kayıttan kontrol edin.

QNB portalında elle faturalama ile QNB eFinans entegrasyonu arasındaki fark

Günde birkaç siparişte QNB portalından elle fatura kesmek yeterlidir; sipariş birden fazla kanaldan gelmeye başlayınca iş, aynı bilgiyi ekranlar arasında taşımaya dönüşür. Aşağıdaki karşılaştırma yalnız panelde tanımlı işleri içerir:

Pazaryeri faturaları, alış faturaları ve aylık KDV özeti

Pazaryerleri komisyon, kargo ve hizmet bedelleri için size fatura keser; e-Fatura kullanıcısıysanız bu belgeler QNB hesabınızın gelen kutusuna düşer. Panele gelen faturaları alış faturası olarak işlemek, sattığınız siparişlerin faturalarıyla birlikte aylık KDV özetini tek ekranda görmenizi sağlar. Tek bir satırın vergisini kontrol etmek için KDV hesaplama aracı, pazaryerinin keseceği komisyonu önceden görmek için komisyon hesaplama aracı işinize yarar. Mağaza bağlantıları için Trendyol entegrasyonu ve Hepsiburada entegrasyonu sayfalarına bakın; mağazalar şifre yerine resmî API bilgileriyle bağlanır.

QNB eFinans entegrasyonu hangi pakette yer alır, toplam maliyet nelerden oluşur?

Yox İş Ortağım'da muhasebe, e-Fatura ve ERP bağlantıları 51 programı kapsar ve Başlangıç ile Büyüme paketlerinde yer almaz. QNB eFinans bağlantısı Profesyonel paketten itibaren açılır ve paketteki program hakkından birini kullanır:

Yıllık ödemede %20 indirim uygulanır; ürün, kullanıcı ve rapor limitleri paket karşılaştırmasında yer alır. Faturayı QNB'den keserken ön muhasebeyi ayrı bir programda tutuyorsanız, örneğin Paraşüt entegrasyonu ile ikinci bir program bağlayacaksanız iki program Kurumsal paket gerektirir. Toplam maliyet üç kalemden oluşur:

• Yox İş Ortağım paketi: Profesyonel ya da üstü bir paket.
• QNB eSolutions kontörü: Her belge bir kontör harcar; iptal edip yeniden kestiğiniz fatura da yeni bir belge sayılır. Kontör fiyatı paket büyüklüğüne ve süresine göre değişir, güncel fiyatı QNB'nin paketler sayfasından öğrenin.
• Mali mühür ya da e-imza: Kamu Sertifikasyon Merkezi'nin ya da sağlayıcının ücretine tabidir.

QNB eFinans bağlantısında kontrol listesi ve sık yapılan hatalar

Bağlantıyı bütün siparişlere açmadan önce QNB hesabını ve faturalama kuralını aşağıdaki listeyle gözden geçirin.

Canlıya almadan önce kontrol edin

• QNB'de e-Fatura ve e-Arşiv etiket aktivasyonları ikisi birden tamamlandı mı?
• Entegrasyon için portala girilmeyecek ayrı bir kullanıcı açıldı mı?
• Kontör bakiyesi aylık sipariş sayınızın yanında iptal ve yeniden düzenleme payını da karşılıyor mu?
• Ürünlerinizin KDV oranları doğru mu; kampanyalı siparişte faturada alıcının ödediği tutar mı görünüyor?
• Seçtiğiniz fatura aşaması 7 günlük sınırı ve kargo bilgisinin hazır olduğu anı birlikte karşılıyor mu?

QNB bağlantısında sık yapılan hatalar

• Portal kullanıcısını bağlantıda kullanmak: 90 günlük şifre yenilemesinden sonra servis oturum açamaz ve faturalar bekler.
• Aynı siparişi iki yerden faturalamak: Bağlantı kurulduktan sonra portalı yalnız kontrol için kullanın.
• e-Fatura'nın ilk yanıtını kesin sonuç saymak: Kuyruktaki belge işleme hatası alabilir; durum bilgisini takip edin.
• Kontör süresini unutmak: 6 ya da 12 aylık süre dolduğunda kalan kontör devretmez.