Opencart e-Arşiv Fatura: Otomatik Fatura Akışı Rehberi

Opencart ile e-Arşiv fatura kesme, sipariş bilgilerinin özel entegratör servisine otomatik aktarılması ve oluşan belgenin siparişe bağlanmasıyla yapılır. Akış; alıcı bilgisi, vergi, toplam tutar, belge türü ve gönderim durumunun kontrolünü içerir.

Bu rehber, OpenCart mağaza sahipleri, yazılım geliştiricileri ve mali müşavirler için hazırlanmıştır. Sipariş tetikleyicisini seçmeyi, müşteri verisini doğrulamayı, hataları ayırmayı ve e-Arşiv fatura kaydını muhasebe sürecine aktarmayı açıklar.

Opencart e-Arşiv Fatura nedir ve otomatik akış nasıl çalışır?

Opencart e-Arşiv Fatura, OpenCart siparişindeki satış bilgilerinin elektronik arşiv belgesine dönüştürülmesi demektir. Belge, manuel PDF düzenlemek yerine entegrasyon servisine gönderilen yapılandırılmış verilerle oluşturulur.

Otomatik akış genellikle siparişin belirli bir duruma geçmesiyle başlar. Sistem, sipariş numarası, müşteri bilgileri, ürün satırları, vergi tutarları ve ödeme toplamını entegrasyon katmanına gönderir.

Entegrasyon katmanı önce zorunlu alanları kontrol eder. Eksik vergi kimlik numarası, geçersiz e-posta, boş adres veya uyuşmayan toplam bulunursa belge oluşturulmadan hata döndürülmesi gerekir.

Alıcı bilgileri ve işlem türü uygun bulunduğunda servis, belgenin e-Arşiv olarak hazırlanmasını sağlar. Belge numarası ve gönderim sonucu, başarılı yanıttan sonra OpenCart siparişine kaydedilmelidir.

OpenCart burada mağaza ve sipariş yönetim katmanıdır. Elektronik belgenin resmi oluşturulması, imzalanması, iletilmesi veya arşivlenmesi ise kullanılan özel entegratörün sunduğu servis akışına bağlıdır.

Her siparişin otomatik faturalanması zorunlu değildir. Test siparişleri, iptal edilmiş işlemler, başarısız ödemeler ve eksik alıcı bilgileri ayrı kurallarla beklemeye alınmalı veya manuel incelemeye yönlendirilmelidir.

Opencart e-Arşiv fatura entegrasyonu için hangi bilgiler gerekir?

Opencart e-Arşiv fatura entegrasyonu için işletme hesabı, servis erişim bilgileri, mağaza alanları ve fatura kuralları birlikte hazırlanmalıdır. Sadece API anahtarı tanımlamak, doğru belge üretmek için yeterli değildir.

Öncelikle kullanılan özel entegratörden servis adresi, kimlik doğrulama yöntemi, test ortamı ve canlı ortam ayrımını öğrenin. Bu bilgiler sağlayıcıya göre değişebilir; adres veya parametreleri tahmin ederek bağlantı kurmayın.

OpenCart tarafında ürün kodu, ürün adı, miktar, birim fiyat, indirim, kargo, vergi sınıfı ve sipariş toplamı erişilebilir olmalıdır. Ürün varyantları kullanılıyorsa varyant kodunun da satır bilgisine taşınması gerekir.

Alıcı için ad-soyad veya unvan, vergi kimlik bilgisi gerektiğinde kimlik numarası, ülke, şehir, ilçe, açık adres, telefon ve e-posta alanlarını belirleyin. Her alanın zorunluluğu işlem türüne göre değişebilir.

İşletme bilgileri, fatura adresi, belge serisi ve numaralandırma tercihi mali müşavirle netleştirilmelidir. Seri tanımı, mağazadaki sipariş numarasıyla aynı olmak zorunda değildir; iki kayıt ayrı tutulmalıdır.

API erişim bilgilerini tema dosyalarına veya herkese açık JavaScript koduna yazmayın. Şifreleri sunucu tarafında koruyun, yönetici rollerini sınırlayın ve hata kayıtlarında müşteri verilerini gereksiz biçimde göstermeyin.

OpenCart siparişi e-Arşiv faturaya dönüştürme adımları nelerdir?

OpenCart siparişini e-Arşiv faturaya dönüştürmek için önce sipariş durumu, sonra veri doğrulaması, belge gönderimi ve sonuç kaydı sıralı biçimde uygulanmalıdır. Her adımın başarısı bir sonraki adıma geçiş koşulu olmalıdır.

Tetikleyici olarak ödeme onayı, sevkiyat hazırlığı veya işletmenin belirlediği tamamlanmış sipariş durumu seçilebilir. Tek bir evrensel doğru yoktur; ürünün teslim şekli, tahsilat zamanı ve mali müşavirinizin süreci değerlendirilmelidir.

1. OpenCart, faturalanacak siparişte test, iptal ve başarısız ödeme durumlarını eler.
2. Sistem, müşteri, adres, ürün, vergi, indirim, kargo ve toplam alanlarını kontrol eder.
3. Alıcının e-Fatura durumunu ve belge türünü kullanılabilir servis üzerinden doğrular.
4. Geçerli veri setini özel entegratörün e-Arşiv servisine gönderir.
5. Başarılı yanıttaki belge numarası, durum ve referans bilgilerini siparişe kaydeder.
6. Belge bağlantısını veya çıktı bilgisini yetkili kullanıcıların erişebileceği ekranda gösterir.

Gönderimden önce siparişe bir işlem kilidi koymak önemlidir. Aynı sipariş için iki yönetici ekranı veya iki arka plan görevi aynı anda çalışırsa çift belge oluşturma riski ortaya çıkabilir.

Başarısız gönderimde sipariş durumunu doğrudan tamamlandı yapmayın. Hata kodunu, son deneme zamanını ve yeniden gönderme hakkını kaydedin; düzeltilemeyen veriler için kullanıcıya açık bir işlem sunun.

Manuel faturalama seçeneği yalnızca kontrollü bir yedek akış olmalıdır. Manuel belge oluşturulduğunda OpenCart siparişine belge numarası ve işlem notu işlenmezse sonraki otomatik deneme tekrar belge üretebilir.

OpenCart e-Arşiv faturada müşteri ve alıcı bilgileri nasıl doğrulanır?

OpenCart e-Arşiv faturada müşteri doğrulaması, siparişteki kimlik, adres ve iletişim bilgilerinin belge kurallarına uygunluğunu kontrol etmek demektir. E-posta adresi tek başına alıcının ticari statüsünü kanıtlamaz.

Bireysel müşteride ad, soyad ve adres alanları; işletme müşterisinde unvan, vergi bilgisi ve fatura adresi öne çıkar. Hangi kimlik alanının kullanılacağı işlem ve belge tipine göre mali müşavirle netleştirilmelidir.

Alıcının e-Fatura kullanıcısı olup olmadığını yalnızca müşterinin seçtiği kutuya göre belirlemeyin. Vergi kimliği veya ilgili sorgu alanı üzerinden, yetkili servis ve güncel kurallarla doğrulama yapılmalıdır.

Adres verisi tek satırda tutuluyorsa şehir, ilçe ve ülke gibi alanları ayırmak faydalı olur. Eksik posta bilgisi, özel karakter veya aşırı uzun adres alanı servis doğrulamasında hata oluşturabilir.

Yanlış: Müşterinin e-posta adresi varsa alıcı bilgisi tamamdır. Doğru: E-posta, gönderim kanalıdır; kimlik, adres ve gerekiyorsa vergi bilgileri ayrıca doğrulanmalıdır.

Eksik veya çelişkili bilgi geldiğinde belgeyi otomatik göndermek yerine siparişi inceleme durumuna alın. Müşteri güncellemesi sonrasında doğrulama yeniden çalıştırılmalı ve önceki hata kaydı silinmemelidir.

OpenCart e-Arşiv faturada KDV, kargo ve indirim nasıl eşleştirilir?

OpenCart e-Arşiv faturada KDV, kargo ve indirim eşleştirmesi; sipariş ekranındaki satırların belge servisindeki vergi ve tutar alanlarına aynı mantıkla aktarılması demektir. Toplamlar gönderimden önce yeniden hesaplanmalıdır.

Ürün fiyatının vergi dahil mi hariç mi tutulduğunu belirleyin. OpenCart ayarı ile entegrasyon servisi farklı varsayım kullanırsa matrah, vergi ve genel toplam arasında kuruş farkı oluşabilir.

Kargo bedelini ürün fiyatına gizlemek, sipariş raporları ile fatura raporlarının ayrışmasına neden olabilir. İşletmenin muhasebe tercihine göre ayrı satır, masraf kalemi veya başka bir yöntem belirlenmelidir.

Yuvarlama kuralını da baştan kararlaştırın. Satır bazında yuvarlama ile belge toplamında yuvarlama farklı sonuç verebilir; kullanılan servis ve OpenCart hesaplaması aynı test senaryolarıyla karşılaştırılmalıdır.

Yanlış: OpenCart toplamını değiştirmeden servise göndermek her zaman yeterlidir. Doğru: Satır, vergi, indirim, kargo ve genel toplam yeniden kontrol edilerek belgeye aktarılmalıdır.

OpenCart e-Arşiv fatura alıcısı e-Fatura kullanıcısıysa ne olur?

OpenCart e-Arşiv fatura akışında alıcının e-Fatura kullanıcısı olduğu doğrulanırsa belge türü e-Arşiv olarak zorla gönderilmemelidir. Alıcı statüsü, işlem türü ve güncel GİB kuralları birlikte değerlendirilmelidir.

Genel akışta kayıtlı bir e-Fatura alıcısı için e-Fatura senaryosu, kayıtlı olmayan alıcı için e-Arşiv senaryosu gündeme gelir. Ancak istisnalar ve işlem bazlı yükümlülükler bulunduğundan kesin karar güncel kaynaklarla verilmelidir.

Bu nedenle OpenCart modülünde alıcı türünü elle seçtiren tek bir kutu yerine sorgu sonucunu saklayan bir yapı daha güvenlidir. Sorgu yapılamıyorsa sistem varsayım üretmek yerine siparişi incelemeye alabilir.

Vergi kimliği değişikliği, yeni şirket hesabı veya farklı fatura adresi alıcı statüsünü etkileyebilir. Müşteri hesabında eski sonuç tutuluyorsa her siparişte yeniden kontrol veya belirlenmiş geçerlilik süresi uygulanmalıdır.

Belge türü kararı, yalnızca e-posta teslimine göre verilemez. E-posta ile PDF gönderilmesi, belgenin otomatik olarak e-Arşiv olduğu anlamına gelmez; resmi belge akışı yetkili servis üzerinden yürütülmelidir.

e-Fatura ve e-Arşiv ayrımının temel kavramlarını [e-Fatura ürün sayfasında](/urun/e-fatura), e-Arşiv belge özelliklerini ise [e-Arşiv Fatura sayfasında](/urun/e-arsiv-fatura) ayrıca karşılaştırabilirsiniz. Güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

OpenCart'ta otomatik e-Arşiv fatura hangi sipariş durumunda kesilmelidir?

OpenCart'ta otomatik e-Arşiv fatura, işletmenin ödeme, teslimat ve muhasebe kontrolüyle uyumlu tek bir sipariş durumunda tetiklenmelidir. Bu durum, her mağazada aynı olmak zorunda değildir.

Ödeme onaylandı durumu, tahsilatı önceleyen mağazalarda uygun olabilir. Sipariş tamamlandı veya sevk edildi durumu ise faturayı ürün hazırlığıyla ilişkilendiren işletmelerde tercih edilebilir; mali süreç belirleyici olmalıdır.

Bekleyen ödeme, başarısız ödeme, şüpheli işlem ve iptal durumları otomatik faturaya gönderilmemelidir. Kart provizyonu ile kesin tahsilat arasındaki fark, ödeme sağlayıcısının işleyişiyle birlikte incelenmelidir.

Her siparişe fatura gönderildi işareti ekleyin. Bu işaretin yanında belge numarası, servis yanıtı, oluşturulma zamanı ve son hata bilgisi bulunmalıdır; yalnızca yeşil renkli bir ekran bildirimi yeterli değildir.

İade veya iptal edilen siparişlerde yeni belge oluşturmak yerine uygulanacak düzeltme süreci ayrıca tanımlanmalıdır. Belge türü, işlem zamanı ve güncel mevzuat bakımından mali müşavirinizin yönlendirmesi gerekir.

Örneğin küçük bir eczane, çevrim içi siparişini ödeme onayından sonra faturaya bağlayabilir. Bir kafe ise teslim tamamlandıktan sonra belge düzenlemek isteyebilir; iki işletmenin stok ve tahsilat akışı aynı değildir.

OpenCart e-Arşiv fatura API hataları nasıl yönetilir?

OpenCart e-Arşiv fatura API hataları, veri doğrulama, kimlik doğrulama, bağlantı, yetki ve servis yanıtı olarak sınıflandırılmalıdır. Her hata türü aynı şekilde yeniden denenmemeli veya kullanıcıya aynı mesaj gösterilmemelidir.

Eksik müşteri alanı, geçersiz vergi bilgisi veya hatalı vergi sınıfı bir veri hatasıdır. Bu durumda veriyi düzeltmeden otomatik tekrar denemek aynı hatayı çoğaltır ve işlem kayıtlarını gereksiz yere büyütür.

Zaman aşımı, geçici bağlantı kesintisi veya servis yoğunluğu teknik hata olabilir. Siparişe ait benzersiz işlem anahtarı korunarak kontrollü tekrar denenmeli, başarılı yanıt alınmadan yeni belge isteği üretilmemelidir.

Yanıt gövdesinde belge numarası varsa ancak OpenCart bağlantısı kesilmişse önce servis üzerinde belge oluşup oluşmadığını kontrol edin. Sonucu bilmeden yeniden gönderim yapmak çift belge riskini artırır.

Yanlış: Her API hatasında aynı isteği sınırsızca yeniden göndermek güvenlidir. Doğru: Hata türünü kaydedin, geçici hataları sınırlı biçimde deneyin, veri hatalarında kullanıcı düzeltmesini bekleyin.

Uzman notu: Sipariş numarası ile belge numarasını aynı alan olarak kullanmayın; iki sistemi bağlayan ayrı bir referans kaydı tutun.

Hata günlüklerinde istek zamanı, sipariş referansı, hata sınıfı ve servis yanıtı tutulabilir. Kimlik numarası, adres, e-posta ve API anahtarı gibi bilgileri gereksiz ayrıntıyla kaydetmeyin; erişimi sınırlayın.

OpenCart e-Arşiv fatura numarası ve saklama süreci nasıl yönetilir?

OpenCart e-Arşiv fatura numarası, başarılı belge yanıtından alınmalı ve sipariş kaydına değiştirilemez işlem geçmişiyle bağlanmalıdır. OpenCart sipariş numarası, resmi belge numarasının yerine otomatik olarak kullanılmamalıdır.

Belge durumu tasarımında en az taslak, gönderim bekliyor, başarılı, hata ve manuel inceleme gibi ayrımlar bulunabilir. Kullanılan servis farklı durum adları sunuyorsa eşleştirme tablosu oluşturmak gerekir.

PDF görünümü müşteri iletişiminde kullanılabilir; ancak resmi süreçte kullanılan elektronik veri, servis yanıtı ve arşiv kaydı ayrıca değerlendirilmelidir. PDF dosyasını tek başına resmi belgenin bütün kaydı kabul etmeyin.

Müşteriye belge gönderimi e-posta, portal veya işletmenin belirlediği başka bir kanal üzerinden yapılabilir. E-posta teslim hatası, belgenin oluşturulamadığı anlamına gelmez; belge durumu ile iletişim durumu ayrı tutulmalıdır.

OpenCart sipariş geçmişinde belge numarası ve bağlantı gösterilirken yönetici rolleri dikkate alınmalıdır. Müşteri ekranında yalnızca gerekli belge bilgilerini paylaşın; tüm teknik servis yanıtını herkese açmayın.

Saklama süresi, erişim yöntemi ve yedekleme sorumluluğu kullanılan hizmet ile mevzuat çerçevesinde yazılı olarak kontrol edilmelidir. Ayrıca satış raporu, belge raporu ve banka tahsilatı düzenli aralıklarla karşılaştırılmalıdır.

OpenCart e-Arşiv fatura entegrasyonu nasıl test edilir?

OpenCart e-Arşiv fatura entegrasyonu, canlıya geçmeden önce başarılı sipariş, eksik veri, indirim, kargo, iade ve tekrar gönderim senaryolarıyla test edilmelidir. Tek bir örnek sipariş başarılı sonuç için yeterli değildir.

Sağlayıcı test ortamı sunuyorsa önce test kimlik bilgileriyle çalışın. Test ve canlı servis adreslerinin, kullanıcılarının ve belge numarası ayarlarının karışmaması için ortam bilgilerini ayrı yapılandırma alanlarında tutun.

1. Vergisiz veya farklı vergi sınıfına sahip ürünlerin satırlarını test edin.
2. İndirimli siparişte satır ve genel toplamın aynı sonucu verdiğini kontrol edin.
3. Kargo bedelinin belgeye seçilen yöntemle yansıdığını doğrulayın.
4. Bireysel ve işletme alıcısı için zorunlu alan davranışını inceleyin.
5. e-Fatura kullanıcı sorgusu yapılamadığında sistemin ne yaptığını gözlemleyin.
6. Bağlantı kesildiğinde tekrar denemenin çift belge üretmediğini doğrulayın.
7. İptal ve iade durumlarının otomatik akışı durdurduğunu kontrol edin.

• Test siparişi ile gerçek sipariş kayıtlarının birbirinden ayrıldığı doğrulanmalıdır.
• Başarılı belge numarasının OpenCart siparişinde görüldüğü doğrulanmalıdır.
• Hatalı kaydın kullanıcıya anlaşılır bir açıklama ve düzeltme adımı sunduğu doğrulanmalıdır.
• API anahtarlarının tarayıcı ekranında veya hata çıktısında görünmediği doğrulanmalıdır.
• Belge ve sipariş raporlarının aynı tarih, tutar ve referansla eşleştiği doğrulanmalıdır.

Canlıya geçişte küçük bir sipariş grubu izlenebilir. İlk başarılı kayıtların ardından belge numarası, müşteri bilgisi ve toplam tutar mali müşavir veya yetkili kullanıcı tarafından kontrol edilmelidir.

OpenCart e-Arşiv fatura akışı ERP ve pazaryeri entegrasyonundan nasıl ayrılır?

OpenCart e-Arşiv fatura akışı, mağazadaki siparişin elektronik belgeye çevrilmesine odaklanır. ERP entegrasyonu muhasebe, stok ve cari hesapları; pazaryeri entegrasyonu ise farklı satış kanallarından gelen siparişleri yönetebilir.

Mağaza tek satış kanalıysa siparişten belgeye doğrudan akış daha anlaşılır olabilir. Birden fazla kanal varsa aynı siparişin iki sistemden faturalanmasını önlemek için tek bir belge sahibi ve ortak referans yapısı belirlenmelidir.

ERP kullanan işletmelerde OpenCart siparişi önce ERP sistemine, ardından fatura servisine gidebilir. Bu yapıda stok, cari hesap ve muhasebe kodlarının hangi sistemde kesinleştirileceği baştan yazılmalıdır.

Odoo kullanan ekipler için [Odoo e-Fatura entegrasyonu rehberi](/blog/odoo-e-fatura-entegrasyonu-nasil-yapilir-kurulum-ve-kontor-baglantisi), Logo Tiger kullananlar için [Logo Tiger e-Fatura entegrasyonu yazısı](/blog/logo-tiger-e-fatura-entegrasyonu-nasil-yapilir-kurulum-ve-kontor-baglantisi) farklı sistemlerdeki bağlantı mantığını karşılaştırmaya yardımcı olabilir.

OpenCart ile İkas gibi başka bir satış altyapısını birlikte değerlendiren işletmeler, [İkas e-Fatura entegrasyonu rehberinde](/blog/ikas-e-fatura-entegrasyonu-nasil-yapilir-kurulum-ve-kontor-baglantisi) sipariş, kontör ve entegrasyon başlıklarını karşılaştırabilir. Bu yazılar OpenCart modülünün teknik sözleşmesinin yerine geçmez.

Doğru mimariyi seçerken marka adı değil, veri sahipliği, tekrar gönderim kontrolü, stok senkronizasyonu ve muhasebe aktarımı incelenmelidir. Entegrasyon sözleşmesi, hata durumları ve sorumluluklar yazılı hale getirilmelidir.

Özet: 5 maddede Opencart e-Arşiv fatura

Opencart e-Arşiv fatura otomasyonu, sipariş verisini doğrulayıp uygun belge servisine gönderen ve sonucu siparişle eşleştiren kontrollü bir entegrasyon sürecidir. Başarı, yalnızca faturanın oluşmasıyla değil, kayıtların izlenebilirliğiyle ölçülür.

• OpenCart sipariş durumu, ödeme ve teslimat sürecine uygun bir fatura tetikleyicisiyle eşleştirilmelidir.
• Müşteri, adres, vergi, ürün, indirim, kargo ve toplam bilgileri belge gönderilmeden önce doğrulanmalıdır.
• Alıcının e-Fatura statüsü, yalnızca e-posta veya müşteri seçimiyle değil, yetkili sorgu ve güncel kurallarla değerlendirilmelidir.
• API hataları veri, bağlantı ve servis türlerine ayrılmalı; tekrar gönderimlerde benzersiz referans ve işlem kilidi kullanılmalıdır.
• Belge numarası, durum, sipariş referansı ve muhasebe kayıtları düzenli olarak karşılaştırılmalı, mevzuat değişiklikleri takip edilmelidir.

Entegrasyon kararında OpenCart sürümü, kullanılan modül, özel entegratör servisi ve mali müşavirinizin işlem akışı birlikte incelenmelidir. Teknik bağlantı tamamlandıktan sonra canlı siparişlerde kademeli izleme yapılması güvenli bir geçiş sağlar.

Efaturakontor.com'da tüm e-belgelerde geçerli havuz kontör paketleri 100'den 500.000 kontöre kadar sunulur; gelen ve giden belgelerin her biri bir kontör düşürür.

Ücretsiz e-Fatura portalı, 10 yıl güvenli saklama, Sovos altyapısına aynı gün tanımlama ve 12-18 ay kullanım süresi ayrıntıları için [paketleri](/paketler) inceleyebilirsiniz.