Opencart e-Fatura Entegrasyonu: Kurulum ve Kontör Bağlantısı
OpenCart e-Fatura entegrasyonunda modül kurulumu, veri eşleştirme, kontör tanımı, test ve hata yönetimini adım adım öğrenin.
Opencart e-Fatura entegrasyonu, mağaza modülü ile sipariş verilerini özel entegratöre aktararak elektronik belge oluşturma sürecidir. Kurulumda modül, şirket bilgileri, belge türleri, sipariş alanları ve kontör hesabı birlikte tanımlanır. Başarılı işlem sonrasında belge numarası ve durum bilgisi OpenCart siparişine geri yazılır.
Opencart e-Fatura entegrasyonu, mağaza modülü ile sipariş verilerini özel entegratöre aktararak elektronik belge oluşturma sürecidir. Kurulumda modül, şirket bilgileri, belge türleri, sipariş alanları ve kontör hesabı birlikte tanımlanır. Başarılı işlem sonrasında belge numarası ve durum bilgisi OpenCart siparişine geri yazılır.
Bu anlatım, OpenCart mağazası yöneten işletme sahiplerine, yazılım ekiplerine ve mali müşavirlere yardımcı olur. Amaç, yalnızca modülü kurmak değil, yanlış müşteri bilgisi, hatalı vergi oranı ve başarısız kontör bağlantısı gibi sorunları önceden çözmektir.
Entegrasyon doğrudan GİB sistemine rastgele istek göndermek anlamına gelmez. OpenCart, yetkili özel entegratörün teknik servisine bağlanır. Özel entegratör gerekli kontrolleri yapar ve uygun belgeleri GİB süreçlerine iletir.
Kontör, bir elektronik belgenin işleme alınması karşılığında kullanılan hizmet birimi demektir. Efaturakontor.com hesabında gelen ve giden belgelerin her biri 1 kontör düşürür. Bu nedenle yalnızca satış faturalarını değil, gelen belgeleri de kullanım hesabına dahil etmek gerekir.
Örneğin küçük bir kafe, OpenCart üzerinden paketli kahve satıyorsa ödeme tamamlandıktan sonra müşterinin mükellefiyet durumunu kontrol eder. Alıcı e-Fatura kullanıcısıysa e-Fatura, değilse uygun koşullarda e-Arşiv Fatura oluşturulur. Belge sonucu sipariş ekranında saklanır.
Yanlış: OpenCart siparişini tamamlandı durumuna almak, faturanın mevzuata uygun biçimde kesildiğini gösterir. Doğru: Sipariş verileri doğrulanır, belge türü seçilir, entegratör yanıtı alınır ve belge durumu ayrıca takip edilir.
Bu işlem, işletmenin e-belge kapsamını veya mali müşavir kontrolünü ortadan kaldırmaz. Vergi mükellefiyetini, belge düzenleme yükümlülüğünü ve güncel GİB kurallarını ayrıca değerlendirin. Teknik kurulumdan önce güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.
OpenCart e-Fatura entegrasyonu kimler için uygundur?
OpenCart e-Fatura entegrasyonu, elektronik belge düzenleme yükümlülüğü bulunan veya gönüllü olarak dijital fatura kullanmak isteyen mağazalar için uygundur. Uygunluk, kullanılan e-ticaret yazılımından değil, işletmenin vergi ve faaliyet durumundan kaynaklanır.
Bir işletmenin e-Fatura kullanıcısı olup olmadığı, GİB kayıtları ve güncel düzenlemeler üzerinden belirlenir. Sektöre, faaliyet türüne, mükellefiyet durumuna veya güncel hadlere göre farklı yükümlülükler oluşabilir. Bu nedenle eski blog yazılarındaki limitlere güvenmeyin.
Alıcının da e-Fatura kullanıcısı olup olmadığı önemlidir. Ticari unvan, vergi kimlik numarası veya T.C. kimlik numarasıyla yapılan alıcı sorgusu, belge türünün belirlenmesine yardımcı olur. Sorgu sonucu alınmadan sabit biçimde yalnızca e-Fatura seçmek risklidir.
Örneğin bir eczane, OpenCart mağazasında hem işletmelere hem tüketicilere satış yapabilir. İşletme müşterisi e-Fatura kayıtlıysa alıcı bilgileriyle e-Fatura düzenlenir. Bireysel müşteride ise e-Arşiv kuralları ve müşterinin verdiği bilgiler dikkate alınır.
Yanlış: OpenCart kullanan her işletme otomatik olarak e-Fatura mükellefidir. Doğru: İşletmenin GİB statüsü, faaliyet alanı ve güncel mevzuat yükümlülüğü önce kontrol edilir.
Gönüllü geçişte de şirket bilgilerinin, mali mühür veya elektronik imza yetkisinin ve entegratör hesabının doğru olması gerekir. Şahıs işletmesi ile sermaye şirketinde kullanılacak kimlik ve imza süreçleri aynı olmayabilir.
Mağaza bir pazaryeriyle de çalışıyorsa, pazaryerinin fatura düzenleme rolü ayrıca incelenmelidir. Aynı sipariş için iki farklı sistemin belge üretmesi mükerrer düzenleme doğurabilir. Bu ayrımı sözleşme ve mali müşavir görüşüyle netleştirin.
e-Fatura kapsamını belirlemek için GİB’in güncel mükellef bilgilerini ve işletmenizin tebliğ kapsamını kontrol edin. Güncel GİB duyurusunu ve mali müşavirinizi kontrol etmeden otomatik belge kuralı oluşturmayın.
OpenCart e-Fatura ve e-Arşiv entegrasyonu arasındaki fark nedir?
OpenCart e-Fatura ve e-Arşiv entegrasyonu arasındaki temel fark, alıcının elektronik fatura kayıt durumudur. e-Fatura, kayıtlı kullanıcılar arasında düzenlenen ve sistem üzerinden iletilen elektronik fatura demektir. e-Arşiv Fatura, e-Fatura kullanıcısı olmayan alıcılara elektronik ortamda düzenlenen fatura demektir.
OpenCart modülü, sipariş sırasında müşterinin statüsünü doğrudan ürün sepetinden anlamaz. Alıcı türü ve kimlik bilgileri kontrol edilerek uygun belge akışı seçilmelidir. Bu seçim, yalnızca müşterinin şirket adı yazmasına veya bireysel görünmesine göre yapılmamalıdır.
| Karşılaştırma | e-Fatura | e-Arşiv Fatura |
|---|---|---|
| Alıcı | e-Fatura sistemine kayıtlı alıcılar için kullanılır. | Uygun koşullarda kayıtlı olmayan alıcılara düzenlenir. |
| OpenCart verisi | Vergi kimlik numarası ve unvan doğruluğu önemlidir. | Ad, soyad, adres ve iletişim bilgileri önemlidir. |
| İletim | Entegratör üzerinden elektronik belge akışı gerçekleşir. | Entegratör üzerinden belge oluşturulur ve alıcıya sunulur. |
| Kontör hesabı | Giden her belge için 1 kontör düşer. | Giden her belge için 1 kontör düşer. |
Belge türlerini ayrıntılı incelemek için e-Fatura ürün sayfasındaki kapsamı ve teknik açıklamaları kontrol edin. Tüketici satışlarında kullanılacak belge akışı için e-Arşiv Fatura bilgilerini ayrıca değerlendirin.
Bir siparişin e-Fatura olması, müşterinin mutlaka ödeme yaptığı anlamına gelmez. İade, iptal, kısmi teslimat ve ön ödeme gibi durumlar farklı muhasebe işlemleri gerektirebilir. OpenCart ödeme durumu ile elektronik belge durumunu ayrı alanlarda tutun.
GİB kuralları, sektör ve müşteri türüne göre değişebilir. Tablodaki genel ayrım teknik yönlendirme sağlar, ancak her sipariş için hukuki sonuç üretmez. Güncel GİB duyurusunu ve mali müşavirinizi kontrol ederek belge senaryonuzu kesinleştirin.
OpenCart e-Fatura entegrasyonu hangi sistemlerle konuşur?
OpenCart e-Fatura entegrasyonu, mağaza yazılımı, entegratör hesabı ve elektronik belge servisleri arasında veri alışverişi kurar. OpenCart ürün, müşteri ve sipariş kayıtlarını gönderir. Entegratör belgeyi işler, sonucu ve belge kimliğini mağazaya geri iletir.
Mağaza tarafında genellikle bir eklenti veya modül bulunur. Bu modül, OpenCart veritabanındaki sipariş alanlarını servis talebine dönüştürür. Kullanılan OpenCart sürümü, PHP sürümü, tema yapısı ve eklenti mimarisi uyumlu değilse bağlantı kurulamayabilir.
Entegratör tarafında şirket, kullanıcı, API yetkisi, belge serisi ve belge türü tanımlanır. Bu alanların isimleri hizmet sağlayıcının paneline göre değişebilir. Bu nedenle başka bir entegrasyonun endpoint veya parametrelerini kopyalamak doğru değildir.
Veri akışı genellikle siparişin seçilmesi, bilgilerin doğrulanması, belge talebinin gönderilmesi, servis yanıtının alınması ve siparişin güncellenmesi aşamalarından oluşur. Bazı modüller sonucu anında alır, bazıları durum sorgulaması veya geri bildirim mekanizması kullanır.
API, iki yazılımın belirlenmiş kurallarla veri alışverişi yapmasını sağlayan teknik arayüz demektir. API anahtarı, kullanıcı adı ve parola mağazanın yönetim panelinde saklanabilir. Bu bilgiler yalnızca yetkili yöneticiler tarafından görüntülenmelidir.
GİB erişimi, entegratörün yetkilendirme ve belge iletim yapısına bağlıdır. OpenCart yöneticisinin GİB sunucusuna doğrudan erişim açması beklenmez. Teknik sorunda önce modül kayıtları, sonra entegratör paneli ve son olarak belge yanıtı incelenmelidir.
Bağlantı mimarisini satın alma kararıyla karıştırmayın. Önce hangi verinin nereden geldiğini, hangi sistemde saklandığını ve hatanın hangi noktada oluştuğunu gösteren basit bir akış şeması hazırlayın.
OpenCart e-Fatura modülü kurulmadan önce hangi bilgiler hazırlanır?
OpenCart e-Fatura modülü kurulmadan önce mağaza sürümü, sunucu bilgileri, şirket verileri ve entegratör erişim bilgileri hazırlanır. Bu hazırlık, kurulum sırasında eksik alan nedeniyle oluşan belge hatalarını azaltır.
Öncelikle OpenCart sürümünü, PHP sürümünü ve aktif eklentileri not edin. Modül sağlayıcısının uyumluluk listesini kontrol edin. Uyumsuz bir sürümü canlı mağazaya yüklemek, sepet, ödeme veya yönetim ekranında beklenmeyen sorunlar yaratabilir.
Şirketin resmi unvanı, vergi kimlik numarası veya T.C. kimlik numarası, vergi dairesi, adresi ve iletişim bilgileri hazır olmalıdır. Şube veya birden fazla belge serisi varsa bu ayrım da kurulumdan önce mali müşavirle netleştirilmelidir.
- OpenCart ve veritabanı için geri yüklenebilir bir yedek alınmalıdır.
- Mağazanın HTTPS sertifikası ve sunucu saat ayarı kontrol edilmelidir.
- Şirket unvanı, vergi bilgileri ve adres alanları resmi kayıtlarla karşılaştırılmalıdır.
- Entegratör kullanıcı adı, API bilgisi ve yetki kapsamı güvenli biçimde hazırlanmalıdır.
- e-Fatura ve e-Arşiv için kullanılacak belge serileri mali müşavirle belirlenmelidir.
- Test siparişleri için gerçek müşterilerin kişisel verileri yerine kontrollü kayıtlar kullanılmalıdır.
Ürünlerde vergi oranı, stok kodu, birim, fiyat ve indirim alanlarının tutarlı olması gerekir. OpenCart tema ekranında görünen fiyat ile veritabanındaki fiyat aynı olmayabilir. Modülün hangi alanı okuyacağını kurulum belgesinden doğrulayın.
Ödeme yöntemleri, kargo bedeli ve kupon indirimi de fatura toplamını etkiler. Bu kalemlerin ürün satırı, indirim satırı veya ayrı hizmet satırı olarak aktarılması farklı sonuçlar doğurur. Muhasebe beklentisini önceden yazılı hale getirin.
Test ortamı bulunmuyorsa canlı ortamda önce düşük riskli, kontrollü bir sipariş planlayın. Test belgesinin gerçek belgeye dönüşüp dönüşmediğini mutlaka kontrol edin. Emin olmadığınız belge senaryosunda güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.
OpenCart e-Fatura entegrasyonu modülü nasıl kurulur?
OpenCart e-Fatura entegrasyonu modülü, yedek alınan ve sürüm uyumluluğu doğrulanan mağazaya kontrollü biçimde kurulur. Modül dosyalarını doğrudan canlı sisteme yüklemek yerine önce staging veya yedeklenebilir bir ortam tercih edilmelidir.
OpenCart 2, OpenCart 3 ve OpenCart 4 kurulum yöntemleri aynı olmayabilir. Bazı sürümlerde uzantı yöneticisi, bazılarında yükleme aracı veya sunucu erişimi gerekir. Modül sağlayıcısının sürüm özelindeki kurulum kılavuzunu esas alın.
- OpenCart, veritabanı ve mevcut modül ayarlarının geri yüklenebilir yedeğini alın.
- Modülün OpenCart, PHP ve sunucu gereksinimlerini mevcut sistemle karşılaştırın.
- Modül paketini sağlayıcının önerdiği yöntemle yükleyin ve yönetici izinlerini tanımlayın.
- Entegratör hesabındaki API bilgilerini ilgili bağlantı alanlarına güvenli biçimde girin.
- Şirket, belge türü, seri, para birimi ve vergi ayarlarını işletme kurallarına göre yapılandırın.
- Sipariş durumlarıyla belge oluşturma durumlarını eşleştirin ve otomatik gönderimi başlangıçta sınırlayın.
- Kontrollü test siparişiyle belge oluşumunu, yanıtı ve OpenCart kayıtlarını karşılaştırın.
Kurulumdan sonra yönetim panelinde modülün aktif görünmesi, entegrasyonun çalıştığını kanıtlamaz. Yetki hatası, yanlış API ortamı veya eksik şirket bilgisi ancak bağlantı testiyle anlaşılır.
Yanlış: Modülü yükledikten sonra bütün eski siparişleri otomatik göndermek güvenli bir başlangıçtır. Doğru: Önce yeni bir test siparişiyle tek belge oluşturulur, sonuç doğrulanır ve geçmiş sipariş aktarımı ayrıca planlanır.
Eski siparişlerin toplu aktarımı duplicate belge, yanlış tarih veya güncel olmayan müşteri bilgisi oluşturabilir. Toplu işlem gerekiyorsa tarih aralığı, sipariş durumu ve belge durumu filtresi kullanın. Her kaydı gönderimden önce kontrol edin.
Kurulum sırasında ekran adları farklıysa bu durum normaldir. Önemli olan menü adını ezberlemek değil, bağlantı bilgileri, belge ayarları ve sipariş durumlarının doğru alanlara yazılmasıdır.
OpenCart sipariş bilgileri e-Fatura alanlarına nasıl eşleştirilir?
OpenCart sipariş bilgileri e-Fatura alanlarına, müşteri, adres, ürün, vergi ve toplam tutar verileri ayrı ayrı eşleştirilerek aktarılır. Eşleştirme doğru yapılmazsa bağlantı çalışsa bile belge reddedilebilir veya muhasebe kaydı yanlış oluşabilir.
Kurumsal alıcı için unvan, vergi kimlik numarası, vergi dairesi ve adres bilgileri gerekir. Bireysel alıcıda ad, soyad, T.C. kimlik numarası veya mevzuata uygun müşteri bilgileri kullanılabilir. Zorunlu alanları müşteri türüne göre tanımlayın.
Ürün satırında stok kodu, ürün adı, miktar, birim, birim fiyat, vergi oranı ve indirim bilgisi bulunur. OpenCart fiyatlarının vergi dahil veya hariç tutulduğu ayar, fatura toplamıyla birebir uyuşmalıdır.
Kargo bedeli, kupon indirimi, ödeme komisyonu ve paketleme ücreti gibi kalemlerin nasıl aktarılacağı önceden belirlenmelidir. Bu kalemler sipariş toplamında bulunup belgeye aktarılmazsa toplam kontrolü başarısız olabilir.
Örneğin küçük bir market, aynı siparişte üç ürün ve bir kargo bedeli satabilir. Modül ürün toplamlarını, indirim tutarını ve kargo bedelini ayrı okursa belge toplamı daha kolay denetlenir. Yuvarlama farkları ayrıca kontrol edilmelidir.
Yanlış: Müşteri formundaki şirket adı, tek başına vergi bilgisi yerine kullanılabilir. Doğru: Müşteri türüne göre resmi kimlik numarası, unvan ve adres alanları ayrı doğrulanır.
Para birimi ve ondalık basamak ayarları da önemlidir. Türk lirası dışındaki siparişlerde kur bilgisinin hangi sistemden alınacağı açıkça belirtilmelidir. Entegratörün desteklediği kur ve yuvarlama yöntemini doğrulamadan otomatik gönderim açmayın.
Eksik veya hatalı alanlarda siparişi silmek çözüm değildir. Önce müşteri ve ürün kaydı düzeltilir, ardından belge oluşturma ekranından güncel veriyle yeni deneme yapılır. Daha önce belge oluştuysa yeniden gönderimden önce durum kontrol edilmelidir.
OpenCart e-Fatura entegrasyonunda kontör bağlantısı nasıl yapılır?
OpenCart e-Fatura entegrasyonunda kontör bağlantısı, modülün doğru entegratör hesabına ve belge kullanım havuzuna bağlanmasıyla yapılır. API erişimi başarılı olsa bile hesapta yeterli kontör yoksa belge gönderimi tamamlanmayabilir.
Tek havuz kontör modeli, e-Fatura, e-Arşiv, e-İrsaliye, e-SMM, e-MM ve e-Bilet gibi desteklenen e-belgelerde ortak kullanım sağlar. Hangi belgelerin hesabınızdan düşeceğini ve kullanım süresini paket koşullarından kontrol edin.
Efaturakontor.com hesabında gelen belgelerin her biri 1 kontör, giden belgelerin her biri 1 kontör düşürür. Bu kural, yalnızca OpenCart’tan gönderilen satış belgelerini değil, hesabınıza ulaşan belgeleri de planlamanız gerektiğini gösterir.
Bağlantı için önce entegratör hesabındaki şirket bilgilerinin OpenCart modülündeki bilgilerle aynı olduğunu kontrol edin. Ardından API kullanıcı bilgilerini, ortam seçimini, belge serisini ve otomatik gönderim ayarını tanımlayın.
Hesap tanımlama ekranında kontör bakiyesi, belge geçmişi veya işlem sonucu görünüyorsa ilk testten önce bu alanları kaydedin. Böylece test öncesi ve sonrası kullanım hareketini karşılaştırabilirsiniz. Paket seçeneklerini kontör paketleri sayfasından inceleyebilirsiniz.
Belge gönderimi hata verdiğinde aynı siparişi art arda göndermeyin. Önce entegratör panelindeki belge durumunu, belge numarasını ve işlem kaydını kontrol edin. Başarılı görünen bir belgeyi yeniden göndermek mükerrer işlem riski yaratabilir.
Uzman notu: Kontör düşümü yalnızca satış adedine göre hesaplanmaz; gelen ve giden her elektronik belgeyi ayrı kullanım olarak planlayın.
Kontör bağlantısı, muhasebe belge serisini veya GİB uygunluğunu kendiliğinden doğrulamaz. Bakiye yeterli olsa bile yanlış vergi bilgisi, hatalı alıcı veya uygun olmayan belge türü gönderimi durdurabilir.
OpenCart siparişinden e-Fatura hangi aşamada oluşturulur?
OpenCart siparişinden e-Fatura, müşteri ve sipariş bilgileri tamamlandıktan sonra, işletmenin belirlediği geçerli işlem durumunda oluşturulur. Belgeyi sipariş oluşturulur oluşturulmaz göndermek, ödeme, adres veya alıcı statüsü değişikliklerini gözden kaçırabilir.
Her işletme aynı tetikleme durumunu kullanmak zorunda değildir. Bazı mağazalar ödeme onayını, bazıları sipariş hazırlamayı, bazıları da sevkiyat öncesini esas alabilir. Seçim, ürünün teslim yapısı ve mali müşavir görüşüyle belirlenmelidir.
Ödeme durumu ile e-belge durumu ayrı tutulmalıdır. Bir siparişin ödeme bekliyor, hazırlanıyor veya tamamlandı olması; belgenin taslak, gönderildi, kabul edildi veya hata verdiği anlamına gelmez.
Uygun akışta modül önce alıcının e-Fatura durumunu kontrol eder. Sonra sipariş satırlarını ve toplamını doğrular. Belgeyi gönderir, entegratör yanıtını kaydeder ve belge numarasıyla tarihini siparişe bağlar.
Bir kafe sahibi, teslim edilmeyen veya iptal edilen siparişlerde otomatik fatura oluşmasını istemeyebilir. Bu durumda otomatik gönderim yalnızca ödeme ve teslim koşulları tamamlanan siparişlere uygulanabilir. İstisna listeleri ayrıca tanımlanmalıdır.
İade alınması, düzenlenmiş faturanın sistemden silineceği anlamına gelmez. İade veya düzeltme işleminin hangi belgeyle yapılacağı, belgenin türüne ve güncel mevzuata göre değerlendirilir.
Yanlış: Sipariş durumunu tamamlandı yapmak, oluşturulmuş faturanın kabul edildiğini gösterir. Doğru: OpenCart sipariş durumu ile entegratörün belge kabul durumunu ayrı ayrı izleyin.
Belge PDF görünümüyle sınırlı değildir. Elektronik belgenin asıl veri yapısı ve sistem yanıtı da saklanmalıdır. Müşteriye gönderilen görsel kopya, entegrasyon durumunun tek kanıtı olarak kullanılmamalıdır.
OpenCart e-Fatura entegrasyonu nasıl test edilir ve hatalar nasıl çözülür?
OpenCart e-Fatura entegrasyonu, canlı otomasyondan önce farklı müşteri, ürün, vergi ve ödeme senaryolarıyla test edilir. Tek bir başarılı test, bütün sipariş türlerinin doğru çalıştığını kanıtlamaz.
İlk testte bireysel alıcı, ikinci testte kurumsal alıcı, üçüncü testte e-Fatura kayıtlı alıcı kullanılabilir. Ayrıca indirimli ürün, kargo bedeli, farklı vergi oranı ve dövizli sipariş gibi işletmeye özgü senaryolar seçilmelidir.
Her testte OpenCart sipariş toplamını, gönderilen belge verisini, entegratör yanıtını ve kontör hareketini karşılaştırın. Belge numarası oluşmuşsa aynı siparişi tekrar göndermeden önce entegratör panelinde belgeyi arayın.
Yaygın hatalar eksik vergi numarası, yanlış şirket unvanı, tanımsız belge serisi, geçersiz API bilgisi, uyumsuz para birimi ve hatalı sipariş durumu eşleşmesidir. Hata mesajını kopyalamak yerine hangi alanın reddedildiğini belirleyin.
Sunucu logları, OpenCart sistem kayıtları ve entegratör işlem kayıtları farklı bilgiler içerir. Önce zaman damgasını ve sipariş numarasını eşleştirin. Sonra isteğin mağazadan çıkıp çıkmadığını ve yanıtın geri dönüp dönmediğini kontrol edin.
Yetki hatasında API kullanıcı bilgileri ve IP kısıtları incelenir. Veri hatasında müşteri veya ürün kaydı düzeltilir. Tekrarlanan zaman aşımında ise ağ, sunucu güvenliği ve servis durumunun kontrol edilmesi gerekir.
Yanlış: Hata alan siparişi silip yeniden oluşturmak sorunu çözer. Doğru: Önce işlem kaydı, belge durumu ve kontör hareketi incelenir; sonra eksik veri düzeltilerek kontrollü yeniden deneme yapılır.
Testler tamamlandığında otomatik gönderimi kademeli açın. İlk günlerde günlük birkaç belgeyi manuel karşılaştırmak, seri üretime geçmeden önce alan eşleştirme hatalarını yakalar.
OpenCart e-Fatura entegrasyonunda güvenlik ve arşiv nasıl yönetilir?
OpenCart e-Fatura entegrasyonunda güvenlik, API bilgilerini korumak, yönetici erişimini sınırlamak ve belge kayıtlarını düzenli izlemekle yönetilir. Mağaza yöneticisi, entegratör hesabı ve sunucu güvenliği aynı plan içinde ele alınmalıdır.
API anahtarı veya parola tema dosyasına, ürün açıklamasına ya da herkese açık JavaScript koduna yazılmamalıdır. Yönetim panelindeki erişim bilgilerini yalnızca görevli kullanıcılar görmelidir. İşten ayrılan personelin yetkisi aynı gün kaldırılmalıdır.
HTTPS sertifikası geçerli olmalı, sunucu saati doğru çalışmalı ve yönetici hesabında güçlü parola kullanılmalıdır. Gereksiz yönetici kullanıcılarını silin. Modül güncellemelerini canlı sisteme almadan önce yedek ve test ortamında deneyin.
Yerel OpenCart yedeği, entegratörün elektronik belge arşivinin yerine geçmez. Portal hizmetinde belgeler için 10 yıl güvenli saklama sunulsa bile, işletme kendi erişim yetkilerini ve belge indirme prosedürünü ayrıca düzenlemelidir.
Her ay başarısız gönderimleri, bekleyen belgeleri, iptal ve iade kayıtlarını, kontör hareketlerini inceleyin. Sipariş sayısı ile gönderilmiş belge sayısı arasındaki fark, atlanan veya mükerrer işlemleri gösterebilir.
Müşteri adı, adresi, telefon ve vergi bilgileri kişisel veya ticari veri içerebilir. Bu verileri yalnızca gerekli sistemlere aktarın. Log kayıtlarında hassas bilgilerin açık biçimde tutulup tutulmadığını yazılım ekibinizle kontrol edin.
Sık sorulan sorular bölümünde saklama, portal ve entegrasyon süreçlerine ilişkin güncel açıklamaları kontrol edebilirsiniz. Hizmet kapsamı değişebileceği için teknik kurulum belgesini ve güncel GİB duyurularını birlikte inceleyin.
Güvenlik sorunu veya sürekli belge hatası varsa otomatik gönderimi geçici olarak durdurun. Siparişleri kaybetmeden manuel inceleme listesi oluşturun ve mali müşavirinizle belge statülerini karşılaştırın.
Özet: 5 maddede OpenCart e-Fatura entegrasyonu nasıl yapılır?
OpenCart e-Fatura entegrasyonu için önce mevzuat kapsamı, sonra teknik uyumluluk, veri eşleştirme ve kontör akışı doğrulanır. Kurulumdan sonra otomatik gönderim, test sonuçları ve belge durumları birlikte izlenir.
- İşletmenin e-Fatura veya e-Arşiv yükümlülüğünü güncel GİB bilgileri ve mali müşavir görüşüyle belirleyin.
- OpenCart sürümü, PHP ortamı, HTTPS, modül uyumluluğu ve geri yüklenebilir yedekleri kurulumdan önce kontrol edin.
- Müşteri, vergi, ürün, indirim, kargo, ödeme ve toplam tutar alanlarını elektronik belge alanlarıyla doğru eşleştirin.
- Entegratör API bilgilerini, şirket kaydını, belge serilerini, sipariş tetikleyicilerini ve kontör hesabını test ederek bağlayın.
- Her belgenin kabul, hata, iade veya iptal durumunu OpenCart kaydıyla karşılaştırın ve aynı belgeyi kontrol etmeden yeniden göndermeyin.
Entegrasyonun başarısı, modülün yönetim panelinde görünmesinden değil, doğru belgenin doğru alıcıya iletilmesinden anlaşılır. Bu nedenle test siparişlerinde müşteri türü, vergi bilgisi, indirim, kargo ve ödeme senaryolarını ayrı ayrı deneyin.
Kontör planında satış hacmine ek olarak gelen belgeleri de hesaba katın. Efaturakontor.com kullanımında gelen ve giden belgelerin her biri 1 kontör düşürdüğü için, yalnızca günlük sipariş adedini baz almak eksik planlama yaratabilir.
Teknik bağlantı tamamlandığında mali süreç bitmez. Belge serileri, iade yöntemi, arşiv erişimi, kullanıcı yetkileri ve mevzuat değişiklikleri düzenli aralıklarla gözden geçirilmelidir.
efaturakontor.com'da e-Fatura, e-Arşiv ve diğer desteklenen e-belgelerde geçerli tek havuz kontör paketleri 100 ile 500.000 kontör arasında sunulur; ücretsiz e-Fatura portalı ve 12-18 ay kullanım süresi seçenekleri bulunur.
Uygun paket seçildiğinde kontörler Sovos altyapısına aynı gün tanımlanır; güncel kapsamı ve işletmenize uygun belge akışını satın almadan önce mali müşavirinizle doğrulayın.
Sık Sorulan Sorular
OpenCart e-Fatura entegrasyonu nedir?
OpenCart e-Fatura entegrasyonu, mağazadaki müşteri, ürün ve sipariş bilgilerinin özel entegratör sistemine aktarılmasıdır. Entegratör, uygun belgeyi oluşturur ve belge numarasıyla durum bilgisini OpenCart siparişine geri iletir. Kurulum için OpenCart sürümü, şirket bilgileri, API yetkisi, belge serisi ve vergi alanları hazırlanmalıdır. Belge türü, alıcının e-Fatura kayıt durumuna göre belirlenir.
OpenCart'a e-Fatura modülü nasıl kurulur?
Önce OpenCart ve veritabanı yedeği alınır, ardından modülün OpenCart ve PHP sürümüyle uyumu kontrol edilir. Modül, sağlayıcının önerdiği yükleme yöntemiyle kurulur. Yönetici izinleri, API bilgileri, şirket kaydı, belge serisi ve sipariş durumları tanımlanır. Otomatik gönderim açılmadan önce farklı müşteri ve ürün senaryolarıyla kontrollü test yapılır.
OpenCart e-Fatura entegrasyonunda kontör nasıl düşer?
Efaturakontor.com hesabında gelen belgelerin her biri 1 kontör, giden belgelerin her biri 1 kontör düşürür. Bu nedenle OpenCart’tan gönderilen e-Fatura ve e-Arşiv belgeleri yanında hesaba gelen belgeler de kullanım planına dahil edilmelidir. Hatalı bir belgeyi yeniden göndermeden önce belge durumunu ve kontör hareketini kontrol etmek gerekir.
OpenCart siparişleri e-Fatura'ya nasıl aktarılır?
Modül, seçilen sipariş durumundaki müşteri, adres, ürün, vergi, indirim, kargo ve ödeme bilgilerini alır. Alıcının e-Fatura kayıt durumu kontrol edilir ve uygun belge türü seçilir. Veriler doğrulandıktan sonra entegratör servisine gönderilir. Oluşan belge numarası, tarih ve kabul veya hata durumu OpenCart siparişiyle ilişkilendirilir.
e-Fatura yerine e-Arşiv ne zaman kullanılır?
e-Arşiv Fatura, e-Fatura sistemine kayıtlı olmayan alıcılara, mevzuatın izin verdiği durumlarda elektronik fatura düzenlemek için kullanılır. OpenCart modülü bu seçimi alıcının kimlik bilgileri ve kayıt durumu üzerinden yapabilir. Ancak müşterinin kurumsal görünmesi tek başına yeterli değildir. Güncel GİB kuralları ve mali müşavir görüşü kontrol edilmelidir.
OpenCart e-Fatura entegrasyon hatası nasıl kontrol edilir?
Önce OpenCart sipariş numarası, sistem logu ve entegratör işlem kaydı karşılaştırılır. Hatanın API yetkisinden, eksik vergi bilgisinden, yanlış seri tanımından, uyumsuz vergi oranından veya ağ bağlantısından kaynaklanıp kaynaklanmadığı belirlenir. Belge oluşmuş olabileceği için aynı siparişi tekrar göndermeden önce entegratör panelindeki belge durumu kontrol edilir.
Tüm e-belgelerde geçerli havuz kontör, ücretsiz portal, aynı gün tanımlama. Sovos altyapısı.