Yazılım Entegrasyonu · 12 dk okuma · 10 Eylül 2026 · Güncelleme 9 Eylül 2026

PrestaShop e-Fatura Entegrasyonu: Kurulum ve Kontör Bağlantısı

PrestaShop e-Fatura Entegrasyonu; modül, API, veri eşleştirme, belge testi, iade süreçleri ve gelen-giden kontör hesabıyla kurulur.

efaturakontor.com Editör Ekibie-Fatura & kontör uzmanlığı · İçerik mevzuat değişikliklerine göre güncellenir
Kısa cevap

PrestaShop e-Fatura Entegrasyonu, sipariş ve müşteri verilerinin e-belge sistemine otomatik aktarılması demektir. Kurulum; modül ayarları, API bağlantısı, veri eşleştirme, test ve kontör hesabından oluşur.

PrestaShop e-Fatura Entegrasyonu, sipariş ve müşteri verilerinin e-belge sistemine otomatik aktarılması demektir. Kurulum; modül ayarları, API bağlantısı, veri eşleştirme, test ve kontör hesabından oluşur.

Bu rehber, PrestaShop kullanan mağaza sahipleri, yazılım geliştiriciler ve mali müşavirler için hazırlanmıştır. Siparişin belgeye dönüşmesini, hataların izlenmesini ve gelen-giden belge kontörlerinin doğru hesaplanmasını açıklar.

PrestaShop e-Fatura Entegrasyonu nedir ve nasıl çalışır?

PrestaShop e-Fatura Entegrasyonu, mağaza ile e-belge hizmeti arasında veri alışverişi kuran yazılım bağlantısıdır. Modül, sipariş bilgilerini alır, belge alanlarına dönüştürür ve yetkili entegratör üzerinden gönderim sağlar.

Tipik akışta müşteri sipariş verir, ödeme ve teslimat bilgileri kaydedilir. Modül, vergi bilgilerini kontrol eder, uygun belge türünü belirler ve taslak veya gönderim işlemini başlatır.

Alıcının e-Fatura kayıt durumuna göre belge türü değişebilir. Kayıtlı bir alıcıya e-Fatura, uygun olmayan alıcıya ise ilgili koşullarda e-Arşiv Fatura düzenlenir.

Gönderim sonrasında belge numarası, ETTN veya UUID ve işlem durumu mağazaya aktarılabilir. Bu alanların ekranda görünmesi, kullanılan modülün özelliklerine ve entegratör dokümantasyonuna bağlıdır.

Belge durumu mağazaya dönse bile sipariş durumu ile resmi belge durumu aynı kayıt değildir. Siparişin tamamlandı görünmesi, e-Faturanın kabul edildiğini göstermeyebilir; bu nedenle iki durum alanı ayrı raporlanmalıdır.

Entegrasyon yalnızca sipariş aktarımı değildir; müşteri, ürün, vergi, indirim ve teslimat verileri de eşleştirilir. Bir alan eksikse belge reddedilebilir veya mali kayıtla mağaza kaydı farklılaşabilir.

Otomatik gönderim seçeneği, sipariş durumuna bağlanabilir; ancak her işletme aynı tetikleyiciyi kullanmamalıdır. Ödeme doğrulanmadan belge kesmek, iptal ve iade süreçlerini gereksiz şekilde artırabilir.

Örneğin kapıda ödeme seçeneği sunan bir mağaza, sipariş oluşturulduğunda değil, ödeme doğrulandığında belge üretmeyi tercih edebilir. Ön ödemeli siparişlerde ise belge tetikleyicisi farklı tanımlanabilir.

Yanlış: Her PrestaShop siparişi doğrudan e-Fatura olur. Doğru: Alıcının statüsü, belgenin türü ve işletmenin senaryosu önce kontrol edilir.

PrestaShop e-Fatura entegrasyonu için hangi ön koşullar gerekir?

PrestaShop e-Fatura entegrasyonu için öncelikle işletmenin e-belge statüsü, entegratör hesabı, mağaza sürümü ve veri altyapısı kontrol edilmelidir. Bu kontroller tamamlanmadan modül kurulumu üretim ortamına taşınmamalıdır.

İşletme, GİB sistemlerindeki e-Fatura mükellefiyet durumunu ve kullanıcı yetkilerini doğrulamalıdır. Zorunluluk kapsamı, sektör ve güncel mevzuata göre değişebileceği için GİB duyurusu ve mali müşavir görüşü esas alınmalıdır.

Ön koşul listesi hazırlanırken teknik ve mali sorumluluklar ayrı yazılmalıdır. Geliştirici sürüm ve API uyumunu, mağaza yöneticisi sipariş verisini, mali müşavir ise belge türü ve mevzuat kapsamını onaylamalıdır.

PrestaShop sürümü, PHP sürümü, sunucu güvenlik ayarları ve modül uyumluluğu birlikte incelenir. Eski bir mağazaya yeni modül yüklemek, ödeme veya sipariş ekranında beklenmeyen uyumsuzluklara neden olabilir.

Üretim veritabanının yedeği alınmalı, sipariş tablolarındaki müşteri ve vergi alanları incelenmelidir. Yedek alınmadan yapılan alan değişiklikleri, geri dönüşü zor veri kayıpları oluşturabilir.

Birden fazla mağaza veya şirket hesabı kullanılıyorsa her mağazanın hangi vergi kimliğiyle belge ürettiği ayrıca tanımlanmalıdır. Yanlış firma hesabı seçimi, teknik bağlantı başarılı olsa bile yanlış satıcı bilgisi oluşturabilir.

Başlangıç kontrolünü aşağıdaki tabloyla belgelemek, geliştirici ve mali müşavir arasındaki iletişimi netleştirir.

Kontrol alanıDoğrulanacak bilgiKontrol edilmezse oluşabilecek sorun
GİB statüsüİşletmenin e-Fatura ve e-Arşiv durumuYanlış belge türü seçilebilir.
Hesap yetkisiGönderim, alım ve görüntüleme izinleriAPI bağlantısı çalışmayabilir.
Teknik uyumlulukPrestaShop, PHP ve modül sürümleriSipariş aktarımı kesilebilir.
Veri yedeğiVeritabanı ve modül ayarlarının kopyasıHatalı değişiklik geri alınamayabilir.

PrestaShop e-Fatura entegrasyonunda işletme bilgileri nasıl hazırlanır?

PrestaShop e-Fatura entegrasyonunda işletme bilgileri, resmi vergi ve adres kayıtlarıyla birebir hazırlanmalıdır. Unvan, VKN veya TCKN, vergi dairesi, adres ve iletişim alanları aynı kaynak üzerinden kontrol edilmelidir.

Satıcı bilgilerinde şirket unvanı, vergi kimlik bilgisi, vergi dairesi, il, ilçe ve açık adres bulunur. Şahıs işletmelerinde kullanılacak kimlik ve unvan formatı, resmi kayıtlarla ve mali müşavir önerisiyle doğrulanmalıdır.

Adres alanlarının biçimsel olarak dolu olması tek başına yeterli değildir. İl, ilçe ve ülke bilgilerinin kodları, kullanılan belge formatındaki karşılıklarıyla eşleşmeli; posta kodu bilinmiyorsa rastgele değer yazılmamalıdır.

Müşteri tarafında ad, soyad veya unvan, VKN ya da TCKN ve adres bilgileri ayrıştırılmalıdır. Kurumsal müşterinin vergi numarası eksikse sistem, kayıtlı alıcıyı doğru eşleştiremeyebilir.

Örneğin bir eczanenin çevrim içi mağazasında hastane müşterisi adına sipariş alınabilir. Bu durumda müşteri adı yerine kurum unvanının, bireysel kimlik alanı yerine kurumun vergi bilgilerinin aktarılması gerekir.

Ürün kartlarında ürün adı, stok kodu, birim, miktar, fiyat ve vergi oranı bulunmalıdır. Kargo, indirim ve hediye ürünleri ayrı satır olarak gönderilecekse her satırın muhasebe karşılığı belirlenmelidir.

Yanlış: Müşteri adresini tek metin alanında tutup belgeye aynen göndermek. Doğru: İl, ilçe, ülke, posta kodu ve açık adres alanlarını mümkün olduğunca ayrı saklamak.

  • İşletme unvanı ve vergi kimlik bilgisi resmi kayıttan doğrulanmıştır.
  • Vergi dairesi, il, ilçe ve açık adres alanları tamamlanmıştır.
  • Kurumsal müşteriler için VKN ve bireysel müşteriler için gerekli kimlik alanları kontrol edilmiştir.
  • Ürün, kargo, indirim ve vergi satırlarının belge karşılığı tanımlanmıştır.
  • Boş bırakılan zorunlu alanlar test siparişiyle ayrıca sınanmıştır.

PrestaShop e-Fatura modülü ve API bağlantısı nasıl kurulur?

PrestaShop e-Fatura modülü, mağazanın yönetim panelinden kurulup entegratörün API bilgileriyle yapılandırılır. Kullanılacak alan adları, kimlik doğrulama yöntemi ve ortam bilgileri sağlayıcının teknik dokümanından alınmalıdır.

İlk adımda modül, PrestaShop sürümüne uygun dosya veya yönetim paneli yöntemiyle yüklenir. Kurulumdan önce modülün geliştirici kaynağı, sürüm notları ve mevcut ödeme eklentileriyle uyumu incelenir.

  1. Üretim mağazasının ve veritabanının güncel yedeğini alın.
  2. Modülü kurun, lisans veya aktivasyon alanlarını sağlayıcı talimatına göre doldurun.
  3. API kullanıcı adı, anahtar, firma kodu veya sertifika bilgilerini ilgili alanlara girin.
  4. Gönderim, alım, durum sorgulama ve hata bildirim seçeneklerini yapılandırın.
  5. Test ortamı varsa bağlantıyı orada sınayın; yoksa üretimde kontrollü sipariş kullanın.

API bağlantısında yalnızca kullanıcı adı ve şifre yeterli olmayabilir. Firma kodu, şube bilgisi, elektronik imza veya mali mühür seçimi sağlayıcının kullandığı yönteme göre değişebilir.

Bağlantı testinde önce kimlik doğrulama, sonra belge gönderme ve son olarak durum sorgulama denenmelidir. Tek bir başarılı oturum açma sonucu, sipariş verisinin doğru biçimde gönderildiğini kanıtlamaz.

Başarılı bağlantı, sipariş ekranında belge oluşturulabildiği anlamına gelmez. Kimlik doğrulama, veri formatı ve belge gönderim testleri ayrı ayrı kontrol edilmelidir.

Üretime geçişte otomatik gönderim hemen tüm siparişlere açılmamalıdır. Önce seçilen birkaç sipariş manuel onayla işlenmeli, belge numarası ve mağaza kaydı karşılaştırıldıktan sonra otomasyon kapsamı genişletilmelidir.

Kurulumdan sonra yönetim panelindeki modül logları ve entegratör yanıtları saklanmalıdır. Böylece bir belge ulaşmadığında sorun PrestaShop, API, veri veya GİB yanıtı olarak ayrıştırılabilir.

PrestaShop e-Fatura entegrasyonunda ürün ve müşteri alanları nasıl eşleştirilir?

PrestaShop e-Fatura entegrasyonunda alan eşleştirme, mağaza veritabanındaki bilgilerin UBL-TR belge alanlarına bağlanmasıyla yapılır. Eşleştirme, ürün, müşteri, sipariş, vergi ve ödeme alanlarını birlikte kapsamalıdır.

Ürün adı ve stok kodu, belge satırındaki açıklama ve tanımlayıcı bilgilerle ilişkilendirilir. Miktar, birim fiyat ve ölçü birimi doğru eşleşmezse toplam tutar, KDV matrahı veya belge satırları hatalı oluşabilir.

Alan eşleştirme belgelendirilirken kaynak alan, hedef alan ve dönüşüm kuralı birlikte yazılmalıdır. Böylece geliştirici bir alanı değiştirdiğinde, bunun fatura satırına ve toplam hesaplamasına etkisi görülebilir.

Vergi oranı, indirim ve kargo bedeli ayrı kurallarla tanımlanmalıdır. Kargo ücretsiz görünüyorsa sıfır tutar gönderilmeli; indirim, ürün fiyatından mı yoksa belge toplamından mı düşüleceği netleştirilmelidir.

Müşteri tipinde bireysel ve kurumsal kayıtlar ayrılmalıdır. Kurumsal kayıtta unvan ve VKN, bireysel kayıtta ad, soyad ve gerekli kimlik bilgileri farklı alanlara aktarılabilir.

Ödeme yöntemi, sipariş tarihi, teslimat adresi ve fatura adresi de ayrı incelenmelidir. Teslimat adresini fatura adresi yerine göndermek, özellikle farklı adres isteyen kurumsal müşterilerde düzeltme gerektirebilir.

Yanlış: PrestaShop vergi ayarını belge doğrulaması yapmadan tek kaynak kabul etmek. Doğru: Ürün kategorisi, istisna durumu ve güncel muhasebe kuralını mali müşavirle kontrol etmek.

İlk eşleştirmeden sonra en az bir normal ürün, indirimli ürün, kargo satırı ve kurumsal müşteriyle test yapılmalıdır. Test sonuçları, gerçek sipariş akışına geçmeden önce yazılı olarak onaylanmalıdır.

PrestaShop e-Fatura entegrasyonunda siparişten e-Fatura nasıl oluşturulur?

PrestaShop e-Fatura entegrasyonunda siparişten belge oluşturma, sipariş durumunun kontrol edilmesi ve doğru alıcı profilinin seçilmesiyle başlar. Belge, ödeme ve müşteri verileri doğrulandıktan sonra taslak veya gönderim olarak hazırlanır.

Mağaza yöneticisi önce siparişin ödeme durumunu ve iade talebi bulunup bulunmadığını kontrol eder. Ardından fatura adresi, vergi kimliği, ürün satırları, kargo ve toplam tutar karşılaştırılır.

Otomatik belge tetikleyicisi belirlenirken ödeme yöntemi, stok durumu ve operasyon ekibinin onay adımı birlikte değerlendirilmelidir. Sipariş oluşturma anı, her işletmede resmi belgenin düzenlenmesi için uygun olmayabilir.

Alıcı e-Fatura kullanıcısıysa e-Fatura senaryosu seçilebilir; değilse koşullara uygun e-Arşiv süreci değerlendirilir. Bu seçim, yalnızca müşterinin sitede kurumsal görünmesine göre otomatik yapılmamalıdır.

Manuel onay seçeneğinde görevli, belge ön izlemesindeki satırları sipariş ekranıyla karşılaştırır. Otomatik akışta ise aynı kontroller kural olarak modüle tanımlanmalı ve başarısız kayıtlar bekleyenler listesine alınmalıdır.

Belge gönderildikten sonra PrestaShop sipariş durumu ile e-belge durumu ayrı izlenmelidir. Siparişin kargoya verilmesi, belgenin GİB tarafından kabul edildiğini tek başına göstermez.

Örneğin küçük bir kafe sahibi, PrestaShop üzerinden paketli kahve sattığında sipariş bilgilerini kontrol eder. Ödeme doğrulanır, alıcının statüsü incelenir, belge oluşturulur ve kabul durumu sipariş kaydına işlenir.

Kafe sahibi aynı siparişi yanlışlıkla iki kez gönderirse iki belge oluşma riski doğabilir. Bu nedenle yeniden gönderme düğmesi kullanılmadan önce belge numarası, ETTN ve son API yanıtı aranmalıdır.

e-Arşiv senaryosunun ayrıntıları için e-Arşiv Fatura ürün sayfasındaki belge akışı incelenebilir. Ancak güncel kapsam, işletmenin durumuna göre mali müşavirle doğrulanmalıdır.

PrestaShop e-Fatura kontör bağlantısı nasıl çalışır?

PrestaShop e-Fatura kontör bağlantısı, modülün e-belge gönderme ve alma işlemlerini ortak kontör hesabına bağlar. Kontör, sipariş adedinden değil, işlenen e-belge hareketinden takip edilir.

Kontör planlamasında sipariş hacmi başlangıç göstergesidir; ancak gelen faturalar, e-İrsaliyeler ve yeniden düzenlenen belgeler ayrıca hesaba katılmalıdır. Bu nedenle tahmin, yalnızca aylık satış siparişine bakılarak yapılmamalıdır.

Tek havuz kontör yapısında e-Fatura, e-Arşiv Fatura, e-İrsaliye, e-SMM, e-MM ve e-Bilet aynı bakiye üzerinden kullanılabilir. Hangi belge türünün işlendiği, modül ve entegratör kayıtlarında ayrıca görünmelidir.

Temel hesap kuralı nettir: gelen ve giden belgelerin her biri 1 kontör düşürür. Örneğin bir ayda 80 giden ve 20 gelen belge işlendiğinde toplam kullanım 100 kontör olur.

Bir PrestaShop siparişi, her zaman tek belge anlamına gelmez. Ayrı fatura, irsaliye veya farklı alıcılar için ayrı belgeler oluşturuluyorsa hesap, oluşan belge adedine göre yapılır.

Bakiye izlenirken başlangıç bakiyesi, gün içi hareketler ve bekleyen işlemler aynı raporda karşılaştırılmalıdır. Başarısız görünen bir denemenin kontör hareketi oluşturup oluşturmadığı, yalnızca sipariş ekranından anlaşılamaz.

Kontör bakiyesi yetersizse belge gönderimi durabilir veya işlem bekleyen statüsünde kalabilir. Bu nedenle otomatik gönderim kullanan mağazalar, yönetim panelindeki bakiye ve hata bildirimlerini düzenli izlemelidir.

e-İrsaliye kullanan mağazalarda ürün sevkiyatı ayrıca belge doğurabilir. Fiziksel ürün satan işletmeler, e-İrsaliye sayfasındaki kapsamı ve kendi sevkiyat senaryosunu karşılaştırmalıdır.

Kontör hareketleri aylık sipariş raporuyla değil, gönderilen ve alınan belge raporuyla karşılaştırılmalıdır. Fark görüldüğünde modül logu, portal kayıtları ve entegratör hareket dökümü birlikte incelenmelidir.

PrestaShop e-Fatura entegrasyonunda gelen ve giden kontörler nasıl hesaplanır?

PrestaShop e-Fatura entegrasyonunda gelen belge de giden belge de ayrı bir kontör hareketidir. Gelen faturalar tedarikçilerden alınır, giden belgeler ise mağazanın müşterilerine düzenlediği e-belgelerdir.

Örneğin bir eczane, ay içinde tedarikçilerinden 12 e-Fatura alıp çevrim içi satışlarından 35 belge gönderirse toplam kullanım 47 kontördür. Sipariş sayısı, bu hesabın yalnızca bir bölümünü açıklayabilir.

Bu eczane, gelen tedarikçi faturalarını PrestaShop sipariş raporuna eklemek yerine ayrı bir gelen belge raporunda izlemelidir. Böylece satış hacmi sabit kalsa bile kontör kullanımındaki artışın kaynağı görülebilir.

Gelen belgeler PrestaShop siparişleriyle doğrudan ilişkili olmayabilir. Tedarikçi faturaları portal gelen kutusunda tutulabilir veya modül destekliyorsa muhasebe sistemine aktarılabilir.

Modül gelen kutusu senkronizasyonu sunmuyorsa, gelen faturalar için portal kontrolü gerekir. Belgenin sisteme düşüp düşmediği, kabul durumu ve arşiv kaydı portal üzerinden doğrulanmalıdır.

Giden belgelerde müşteri statüsü, belge türü ve gönderim sonucu takip edilmelidir. Aynı sipariş için oluşturulmuş taslak, gönderilmiş belge ve kabul edilmiş belge ayrımı raporlarda açıkça görünmelidir.

Kontör hesabı incelenirken belge türleri bir havuzda toplansa bile raporlar ayrı sınıflandırılmalıdır. Böylece artışın siparişlerden mi, tedarikçi faturalarından mı, sevkiyat belgelerinden mi geldiği anlaşılır.

Gelen ve giden belge raporları uyuşmuyorsa önce tarih aralığı, şirket hesabı ve belge statüleri kontrol edilir. Sonuç alınamazsa güncel entegratör hareket kaydıyla mali müşavir kayıtları karşılaştırılır.

PrestaShop e-Fatura entegrasyonunda test ve hata kontrolü nasıl yapılır?

PrestaShop e-Fatura entegrasyonunda test, gerçek müşterilere otomatik belge göndermeden önce veri ve bağlantı kontrollerinin birlikte yapılmasıdır. Test, başarılı API bağlantısından daha geniş bir doğrulama sürecidir.

Testi yalnızca boş bir siparişle yapmak yeterli değildir. Normal ürün, indirim, kargo, kurumsal müşteri, bireysel müşteri ve iade talebi içeren farklı kayıtlar ayrı ayrı denenmelidir.

Önce düşük riskli bir sipariş senaryosu seçilir ve müşteri, ürün, vergi, kargo, indirim toplamları karşılaştırılır. Ardından belge taslağı, gönderim yanıtı, kabul durumu ve mağaza sipariş kaydı incelenir.

Hata mesajı yalnızca ekranda okunup kapatılmamalıdır. Tarih, sipariş numarası, API yanıtı, belge kimliği ve modül logu kaydedilirse geliştirici sorunu daha hızlı sınıflandırabilir.

Ret yanıtı alındığında önce veri hatası ile bağlantı hatası ayrılmalıdır. Eksik kimlik bilgisi belge verisi sorunudur; yetkilendirme veya zaman aşımı mesajı ise API ya da sunucu bağlantısına işaret edebilir.

Test sırasında aşağıdaki kontrol listesi kullanılabilir:

  • Test siparişindeki müşteri adı ve vergi kimliği belgeyle aynıdır.
  • Ürün miktarı, birim fiyat, indirim ve kargo tutarı doğru aktarılmıştır.
  • Vergi matrahı ve toplam tutar, PrestaShop siparişiyle karşılaştırılmıştır.
  • Belge türü, alıcının e-Fatura statüsüne göre seçilmiştir.
  • Gönderim yanıtında kabul, ret veya bekleme durumu görülmüştür.
  • Belge numarası ve ETTN mağaza kaydına işlenmiştir.
  • Kontör hareketi portal veya hesap raporunda kontrol edilmiştir.

Yanlış: Hata alan siparişi düğmeye art arda basarak yeniden göndermek. Doğru: Önce mevcut belge numarasını, işlem statüsünü ve log kaydını kontrol etmek.

PrestaShop e-Fatura entegrasyonunda iade, iptal, e-Arşiv ve e-İrsaliye nasıl yönetilir?

PrestaShop e-Fatura entegrasyonunda iade ve iptal, normal sipariş gönderiminden ayrı iş akışlarıyla yönetilir. E-Arşiv ve e-İrsaliye ise alıcı durumu ve ürün sevkiyatı gibi farklı koşullara göre değerlendirilir.

İade talebi geldiğinde önce ürünün teslim, ödeme ve fatura durumu kontrol edilir. Belge kabul edilmişse mağaza siparişini silmek, resmi e-belge kaydını ortadan kaldırmaz.

İade sürecinde siparişin sistemden silinmesi yerine, ilk belgenin numarası ve ilgili iade kaydı birlikte korunmalıdır. Kullanılacak düzeltme yöntemi, belgenin türüne ve işletmenin muhasebe uygulamasına göre belirlenir.

İade faturası, iptal veya başka düzeltme yöntemi için güncel mevzuat ve işletmenin muhasebe politikası uygulanmalıdır. Süre, senaryo ve belge türü hakkında rakam vermek yerine mali müşavir onayı alınmalıdır.

e-Arşiv belgesinde düzeltme yöntemi, e-Fatura belgesindeki yöntemle aynı olmayabilir. Bu nedenle e-Arşiv Fatura süreci, alıcının statüsü ve ilk belgenin durumuyla birlikte incelenmelidir.

Fiziksel ürün sevk ediliyorsa e-İrsaliye gerekliliği ayrıca değerlendirilir. Fatura kesilmiş olması, sevkiyat belgesinin otomatik olarak tamamlandığı anlamına gelmez.

PrestaShop sipariş durumları, iade ve iptal bilgilerini gösterebilir; fakat resmi belge statülerini tek başına kanıtlamaz. Belge portalı, entegratör kaydı ve muhasebe sistemi birlikte kontrol edilmelidir.

İşletmenin sektörü, mükellefiyet durumu ve belge tarihi sonucu değiştirebilir. Güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

PrestaShop e-Fatura entegrasyonunda güvenlik ve mevzuat nasıl korunur?

PrestaShop e-Fatura entegrasyonunda güvenlik, API kimlik bilgilerinin korunması ve belge kayıtlarının izlenebilir tutulmasıyla sağlanır. Mevzuat uyumu ise teknik ayarlardan ayrı olarak mali müşavir ve güncel GİB duyurularıyla doğrulanır.

API kullanıcı adı, parola, anahtar veya sertifika dosyaları tema dosyalarına ve herkese açık depolara yazılmamalıdır. Yönetim panelinde sınırlı yetki, güçlü parola ve mümkünse çok aşamalı erişim kullanılmalıdır.

Sunucu bağlantısı HTTPS üzerinden çalışmalı, modül ve PrestaShop sürümleri güncel tutulmalıdır. Güncelleme öncesinde yedek alınması, uyumsuzluk durumunda mağazanın geri döndürülebilmesini sağlar.

Yedeklerin yalnızca oluşturulması değil, geri yüklenebilir olduğunun da kontrollü ortamda denenmesi gerekir. API anahtarları ve sertifika dosyaları yedeklenirken erişim izinleri, dosya konumu ve sorumlu kullanıcılar kayıt altına alınmalıdır.

Belge XML dosyaları, API yanıtları ve işlem logları yetkisiz kişilere açılmamalıdır. Saklama ve erişim politikası, kişisel verilerin korunması ve mali kayıt gereklilikleriyle uyumlu hazırlanmalıdır.

Uzman notu: API parolasını değiştirdiğinizde yalnızca modülü güncellemek yeterli olmayabilir; otomatik gönderim, gelen kutusu senkronizasyonu ve durum sorgularını ayrı ayrı test edin.

Loglarda müşteri verileri ve kimlik bilgileri bulunabileceği için hata kayıtları geliştiriciye aktarılırken erişim kapsamı sınırlandırılmalıdır. Gereksiz kişisel veri içeren ekran görüntüleri, açık paylaşım kanallarında kullanılmamalıdır.

Elektronik imza veya mali mühür gerektiren süreçlerde kullanılan sertifikanın geçerliliği ayrıca izlenmelidir. e-İmza bilgilerini teknik kurulumdan önce, işletmenizin belge senaryosuyla birlikte değerlendirin.

Vergi hadleri, zorunluluklar, belge süreleri ve ceza tutarları yıllık olarak güncellenebilir. Emin olmadığınız durumda güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

Özet: 5 maddede PrestaShop e-Fatura entegrasyonu

Özetle PrestaShop e-Fatura entegrasyonu, modül kurmaktan çok veri, belge, bağlantı ve kontrol süreçlerinin birlikte tasarlanmasıdır. Aşağıdaki beş madde, üretim ortamına geçmeden önce temel kararları toparlar.

Her maddeyi mağaza yöneticisi, geliştirici ve mali müşavir birlikte onaylamalıdır. Böylece teknik olarak çalışan ancak yanlış belge türü veya eksik vergi bilgisi üreten kurulumların önüne geçilir.

  • 1. Statüyü doğrulayın: İşletmenin e-Fatura ve e-Arşiv kapsamını, alıcıların durumunu ve güncel GİB kurallarını kontrol edin.
  • 2. Veriyi eşleştirin: VKN veya TCKN, unvan, adres, ürün, miktar, vergi, indirim ve kargo alanlarını belge alanlarıyla bağlayın.
  • 3. API bağlantısını sınayın: Modül sürümünü, kimlik doğrulamayı, gönderim yanıtını, durum sorgusunu ve log kaydını ayrı ayrı test edin.
  • 4. Kontörü belge üzerinden izleyin: Gelen ve giden belgelerin her birinin 1 kontör düşürdüğünü raporlarla karşılaştırın.
  • 5. İstisnaları yönetin: İade, iptal, e-Arşiv ve e-İrsaliye süreçlerini normal sipariş akışından ayrı kurallarla izleyin.

Kurulum tamamlandıktan sonra birkaç farklı müşteri ve ürün senaryosuyla düzenli kontrol yapılmalıdır. Belge statüsü ile PrestaShop sipariş statüsü aynı kayıt olarak değerlendirilmemelidir.

Sorularınız için önce sık sorulan sorular bölümünü, ardından entegratör loglarını ve mali müşavir görüşünü kontrol edin. Teknik uyumsuzluklarda modül geliştiricisine sipariş numarası ve hata yanıtıyla başvurun.

efaturakontor.com'da tüm e-belgelerde geçerli havuz kontör paketleri 100'den 500.000 kontöre kadar sunulur ve ücretsiz e-Fatura portalı bulunur. Kontörler Sovos altyapısına aynı gün tanımlanır; kullanım süresi 12-18 aydır.

İhtiyacınız olan belge türlerini ve kullanım hacmini kontör paketleri üzerinden inceleyebilir, güncel şartları mali müşavirinizle birlikte değerlendirebilirsiniz.

Sık Sorulan Sorular

PrestaShop e-Fatura entegrasyonu için hangi bilgiler gerekir?

PrestaShop e-Fatura entegrasyonu için işletme unvanı, VKN veya TCKN, vergi dairesi, adres, e-Fatura statüsü ve entegratör hesap bilgileri gerekir. PrestaShop ve PHP sürümleriyle modül uyumu da kontrol edilmelidir. Ürün, müşteri, vergi, indirim, kargo ve ödeme alanları belge alanlarıyla eşleştirilir. Üretim öncesinde veritabanı yedeği alınır ve test siparişleri hazırlanır. Güncel kapsamı mali müşavirinizle doğrulayın.

PrestaShop siparişlerinin tamamı e-Fatura olarak mı kesilir?

Hayır. PrestaShop siparişinin tamamı otomatik olarak e-Fatura sayılmaz. Belge türü, alıcının e-Fatura kayıt durumu, işletmenin mükellefiyet bilgisi ve sipariş senaryosuna göre değerlendirilir. Kayıtlı alıcı için e-Fatura, uygun koşullarda diğer alıcı için e-Arşiv Fatura gündeme gelebilir. Ödeme, iade ve belge durumu ayrıca kontrol edilmelidir. Güncel GİB kurallarını ve mali müşavirinizi kontrol edin.

PrestaShop e-Fatura kontör hesabı nasıl yapılır?

Gelen ve giden belgelerin her biri 1 kontör düşürür. Örneğin 35 giden ve 12 gelen belge işleyen bir işletmenin toplam kullanımı 47 kontördür. Hesap sipariş sayısına göre değil, işlenen e-belge adedine göre yapılır. e-Fatura, e-Arşiv, e-İrsaliye ve diğer desteklenen e-belgeler ortak havuzdan takip edilebilir. Raporlama sırasında belge statüleri ayrıca incelenmelidir.

Gelen e-Faturalar PrestaShop mağazasına otomatik gelir mi?

Bu özellik kullanılan PrestaShop modülüne ve entegratör bağlantısının kapsamına bağlıdır. Modül gelen kutusu senkronizasyonunu destekliyorsa tedarikçi faturaları sisteme aktarılabilir. Desteklemiyorsa gelen belgeler portal üzerinden izlenir. Her gelen belge için 1 kontör düşer. Belge kabul durumu, arşiv kaydı ve muhasebe kaydı ayrıca kontrol edilmelidir.

PrestaShop e-Fatura entegrasyonunda gönderim hatası olursa ne yapılır?

Önce sipariş numarası, belge numarası, ETTN veya UUID, API yanıtı ve modül logu kontrol edilir. Belgenin daha önce gönderilip gönderilmediği doğrulanmadan yeniden gönderim yapılmamalıdır. Eksik VKN, hatalı adres, yanlış vergi alanı veya kimlik doğrulama sorunu ayrı ayrı incelenir. Gerekirse geliştiriciye tarih, işlem kimliği ve tam hata kaydı iletilir.

PrestaShop e-Fatura ve e-Arşiv Fatura arasındaki fark nedir?

e-Fatura, e-Fatura sistemine kayıtlı alıcılar arasındaki elektronik fatura akışıdır. e-Arşiv Fatura ise alıcının durumuna ve mevzuattaki koşullara göre farklı bir elektronik fatura senaryosudur. PrestaShop entegrasyonu, alıcı profilini ve işletme kurallarını kontrol ederek uygun belge türünü seçmelidir. Kesin kapsam, belge tarihi ve işletme statüsü için güncel GİB duyurusu incelenmelidir.

Kontöre mi ihtiyacınız var?

Tüm e-belgelerde geçerli havuz kontör, ücretsiz portal, aynı gün tanımlama. Sovos altyapısı.

Paketleri Gör
WhatsApp Hemen Ara