Ticimax e-Fatura Entegrasyonu: Kurulum, Kontör Bağlantısı

Ticimax e-Fatura entegrasyonu, Ticimax mağazasındaki sipariş verilerinin e-belge hesabına aktarılıp uygun belgenin oluşturulması ve gönderilmesi demektir. Kurulum; hesap aktivasyonu, kontör tanımı, alan eşleştirme, test ve canlı gönderim adımlarından oluşur.

Bu işlem, internetten düzenli satış yapan işletmelerin sipariş bilgilerini tekrar girmeden fatura sürecine aktarmasına yardımcı olur. Ancak otomatik aktarım, vergi bilgileri ve müşteri alanları doğru tanımlanmadığında hatalı belge oluşturabilir.

Ticimax hesabınızda hazır e-belge bağlayıcısı veya API desteği bulunup bulunmadığını önce doğrulayın. Kullanılan paket, yetki seviyesi ve entegrasyon yöntemine göre ekran adları değişebilir. Kesin menü yolunu Ticimax destek dokümanından kontrol edin.

Genel akışta müşteri bilgileri, ürün satırları, vergi oranları, indirimler ve kargo bedeli eşleştirilir. Ardından siparişin hangi durumda faturaya dönüşeceği belirlenir. Son aşamada belge durumu, numarası ve gönderim yanıtı izlenir.

ERP kullanan işletmeler, farklı sistemlerdeki kurulum mantığını görmek için Logo Tiger e-Fatura entegrasyonu ve Luca e-Fatura entegrasyonu içeriklerini de karşılaştırabilir.

Bu yazı, Ticimax e-Fatura kurulumu sırasında hangi bilgilerin hazırlanacağını ve kontör bağlantısının nasıl kontrol edileceğini açıklar. Mevzuata bağlı seçimlerde güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

Ticimax e-Fatura kurulumu için hangi hazırlıklar gerekir?

Ticimax e-Fatura kurulumu için aktif e-belge hesabı, doğru şirket bilgileri, yetkili kullanıcı ve kontör bakiyesi hazırlanmalıdır. Bu dört unsurdan biri eksikse bağlantı kurulsa bile belge gönderimi tamamlanmayabilir.

Önce işletmenizin hangi e-belge türlerini kullanacağını belirleyin. E-Fatura, e-Arşiv fatura, e-İrsaliye veya başka bir belge türü için farklı tanımlar gerekebilir. Sadece e-Fatura gönderecekseniz gereksiz belge modüllerini açmanız şart değildir.

Şirketin vergi kimlik numarası, unvanı, adresi, vergi dairesi ve iletişim bilgileri iki sistemde aynı olmalıdır. Gerçek kişi işletmelerinde Türkiye Cumhuriyeti kimlik numarası ve ad-soyad bilgileri de doğru girilmelidir.

Ticimax tarafında yönetici yetkisine sahip bir kullanıcı, entegrasyon ayarlarına erişebilmelidir. E-belge hesabında da kullanıcı, şifre, firma kodu veya servis bilgileri gibi istenen bilgiler hazır bulunmalıdır.

• İşletmenin e-Fatura veya e-Arşiv kullanım durumu güncel olarak doğrulanmalıdır.
• Ticimax mağazasında şirket unvanı, vergi bilgisi ve fatura adresi kontrol edilmelidir.
• Ürün kartlarındaki KDV oranları ve birim bilgileri gözden geçirilmelidir.
• Siparişlerde alıcı adı, adresi, VKN veya TCKN alanlarının dolduğu test edilmelidir.
• Belge serisi, sıra numarası ve gönderim başlangıç ayarları mali müşavirle netleştirilmelidir.
• Kontör bakiyesi ve gelen belgelerin de hesaba katılacağı işlem hacmi birlikte planlanmalıdır.

Bu kontrol listesi tamamlanmadan canlı gönderimi açmak yerine önce küçük bir test siparişi kullanın. Özellikle çok sayıda ürün satan mağazalarda, ürün kartı verilerinin toplu olarak incelenmesi daha güvenlidir.

Ticimax e-Fatura hesabı ve entegrasyon yetkisi nasıl hazırlanır?

Ticimax e-Fatura hesabı, işletmenin özel entegratör veya ilgili e-belge hizmeti üzerindeki firma kaydı aktive edilerek hazırlanır. Ticimax yalnızca sipariş kaynağıdır; belgenin resmi iletimi, kullanılan e-belge servisinin yetkili bağlantısı üzerinden gerçekleşir.

Hesap açılışında şirket bilgileri, yetkili kişi ve iletişim adresleri doğrulanır. Daha önce kullanılan bir e-belge hesabı varsa yeni bağlantı açmadan mevcut kullanıcıların entegrasyona izin verip vermediğini kontrol edin.

Entegrasyon için istenen bilgiler servis sağlayıcının yöntemine göre değişebilir. Kullanıcı adı, şifre, firma tanımı, servis adresi, entegrasyon anahtarı veya sertifika bilgisi istenmesi mümkündür. Destek ekibinden gelen alanları eksiksiz ve aynı formatta kullanın.

1. Hangi Ticimax mağazasının hangi e-belge hesabına bağlanacağını yazılı olarak belirleyin.
2. E-belge hesabındaki şirket bilgilerini vergi levhası ve resmi kayıtlarla karşılaştırın.
3. Ticimax ve e-belge servisindeki yönetici yetkilerini ayrı ayrı doğrulayın.
4. Gerekli kullanıcı veya API bilgilerinin canlı hesap yerine doğru ortamdan alındığını kontrol edin.
5. Belge serisi, gönderim tetikleyicisi ve müşteri veri eşleştirmesini tanımlayın.
6. Test sonucu olumlu olmadan otomatik canlı gönderim seçeneğini etkinleştirmeyin.

Benzer şekilde, muhasebe yazılımı ile e-belge servisi arasındaki yetki ayrımını Nebim e-Fatura entegrasyonu örneğinde de görebilirsiniz. Ticimax bağlantısında da mağaza yetkisiyle e-belge yetkisini karıştırmamak gerekir.

Şifre veya anahtar kabul edilmiyorsa bilgileri tekrar tekrar denemek yerine hesabın aktiflik durumunu ve IP, kullanıcı veya ortam kısıtlarını kontrol edin. Teknik ayrıntı belgelenmiyorsa güncel entegratör desteğine başvurun.

Ticimax kontör bağlantısı nasıl yapılır?

Ticimax kontör bağlantısı, e-belge hesabının kullanılabilir kontör bakiyesiyle ilişkilendirilmesi ve Ticimax gönderim kanalının bu hesaba yönlendirilmesiyle yapılır. Kontör hesabı ile Ticimax mağaza hesabı aynı kullanıcı hesabı olmak zorunda değildir.

İlk olarak e-belge servisindeki firma kaydının aktif olduğunu ve kontörlerin doğru firma hesabına tanımlandığını doğrulayın. Yanlış firmaya tanımlanan bakiye, Ticimax bağlantısı doğru görünse bile belge gönderimini karşılamayabilir.

Sonra entegrasyon ekranında servis sağlayıcının istediği kimlik bilgilerini girin. Bu bilgiler kullanıcı adı, şifre, firma kodu veya entegrasyon anahtarı olabilir. Alan adları ve servis adresleri için sağlayıcının güncel teknik bilgisini esas alın.

Bağlantı başarılı görünse bile bakiye sorgusunu ayrıca çalıştırın. Bazı paneller bağlantı testini yalnızca kimlik doğrulama olarak gösterir; kontör bakiyesi, belge yetkisi ve gönderim izni ayrı kontroller olabilir.

Uzman notu: Kontör bağlantısında en sık yapılan hata, Ticimax bağlantısını başarılı görüp belge gönderme yetkisinin ayrıca tanımlanmadığını fark etmemektir.

Kontör bağlantısını canlı siparişten önce bir belgeyle doğrulamak gerekir. Test sırasında hangi firmanın, hangi belge türünün ve hangi hesabın kullanıldığını not edin. Böylece yanlış hesaba yapılan tanımlama erken fark edilir.

Kontör bakiyesi yetersizse sistemin taslak oluşturması, gönderimi bekletmesi veya hata üretmesi kullanılan servise göre değişebilir. Bu davranışı varsaymayın; panel açıklamasını ve güncel hizmet koşullarını kontrol edin.

Ticimax panelinde e-Fatura ayarları nasıl tanımlanır?

Ticimax panelinde e-Fatura ayarları, kullanılan bağlayıcıya göre belge servisi, gönderim koşulu, seri bilgisi ve veri alanları tanımlanarak yapılır. Kesin menü isimleri Ticimax sürümüne ve hesabınızda açık modüllere göre değişebilir.

Yönetim panelinde e-dönüşüm, e-belge, fatura veya entegrasyon başlıkları altında bir ayar alanı bulunabilir. Ekranı bulamıyorsanız rastgele farklı servis bilgileri girmeyin; Ticimax destek ekibinden hesabınıza uygun menü yolunu isteyin.

Servis sağlayıcı seçildikten sonra firma bilgileri ve bağlantı kimlikleri girilir. Ardından sipariş numarası, müşteri adı, vergi numarası, adres, ürün kodu, miktar, birim fiyat ve vergi oranı gibi alanlar eşleştirilir.

Belge serisi ve sıra numarası, muhasebe kayıtlarıyla uyumlu olmalıdır. Daha önce başka kanaldan kullanılan seriyi yeniden başlatmak, numara çakışması veya kayıt tutarsızlığı yaratabilir. Bu nedenle seri başlangıcını mali müşavirle belirleyin.

Gönderim tetikleyicisi de ayrı bir karardır. Sipariş oluşturulduğunda, ödeme alındığında, kargoya verildiğinde veya belirli bir yönetici onayından sonra gönderim seçenekleri bulunabilir. Seçim, işletmenin faturalama politikasına uygun olmalıdır.

Hazır bir e-ticaret bağlayıcısı kullanılıyorsa alanların otomatik eşleştiğini varsaymayın. Opencart e-Fatura entegrasyonu içeriğinde olduğu gibi, farklı mağaza yazılımlarında da bağlayıcı ayarları ayrı ayrı doğrulanmalıdır.

Otomatik gönderim açılmadan önce hata durumunda yeniden deneme, yönetici bildirimi ve belge durumu takibini kontrol edin. Bir siparişin iki kez faturalanmasını önlemek için sipariş numarası ile belge numarası arasındaki ilişkiyi kaydedin.

Ticimax sipariş verileri e-Fatura alanlarıyla nasıl eşleştirilir?

Ticimax sipariş verileri e-Fatura alanlarıyla, müşteri kimliği, adres, ürün satırı, vergi, indirim ve ödeme bilgilerinin karşılıkları belirlenerek eşleştirilir. Bu eşleştirme, belgenin resmi bilgilerle oluşturulmasını sağlar.

Kurumsal alıcılarda unvan, vergi kimlik numarası, vergi dairesi ve fatura adresi birlikte kontrol edilmelidir. Bireysel alıcılarda ad-soyad, TCKN gerekiyorsa kimlik bilgisi ve açık adres alanları kullanılmalıdır.

Ürün kartlarında ürün adı, stok kodu, miktar, birim, birim fiyat ve KDV oranı bulunmalıdır. İndirim, kargo, hediye ürün veya yuvarlama satırlarının faturaya nasıl aktarılacağı önceden belirlenmelidir.

Mahalle eczanesi işleten Ayşe Hanım, internetten kozmetik ürünleri satıyor olsun. Şirket müşterisi vergi numarasını girerse e-Fatura sorgusu yapılabilir; bireysel müşteri için alıcı türü ve e-Arşiv seçimi ayrıca değerlendirilir.

Ayşe Hanım ayrıca sipariş toplamı ile fatura toplamını karşılaştırmalıdır. Kargo bedeli sipariş ekranında bulunup faturaya aktarılmazsa tahsilat ile belge tutarı farklılaşır. Bu fark, muhasebe mutabakatında sonradan hata oluşturabilir.

Yanlış: Teslimat adresindeki kişi adını doğrudan vergi unvanı alanına taşımaktır. Doğru: Fatura adresi ile teslimat adresini ayırıp resmi alıcı bilgilerini ayrı alanlarda doğrulamaktır.

Vergi oranı, istisna, tevkifat veya özel işlem içeren siparişlerde otomatik eşleştirme tek başına yeterli olmayabilir. Bu tür işlemler için güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

Ticimax e-Fatura entegrasyonu test faturası nasıl doğrulanır?

Ticimax e-Fatura entegrasyonu test faturası, örnek sipariş oluşturulup belge alanları, gönderim yanıtı ve muhasebe kaydı karşılaştırılarak doğrulanır. Test ortamı mevcutsa önce orada çalışın; canlı ortamda oluşturulan belgenin gerçek işlem sayılabileceğini unutmayın.

Test için gerçek müşteri yerine işletmenin belirlediği kontrollü bir kayıt kullanın. Ürün fiyatı, KDV oranı, indirim, kargo, ödeme yöntemi ve alıcı türü bilerek seçilmelidir. Böylece her alanın çıktısı incelenebilir.

1. Test ürününde stok kodu, birim fiyatı ve vergi oranının doğru olduğunu kontrol edin.
2. Kurumsal veya bireysel alıcı bilgilerinin ilgili fatura alanlarına geldiğini doğrulayın.
3. Siparişin hangi durumunda fatura oluşturulacağını gözlemleyin.
4. Belge serisi, numarası, tarihi ve para biriminin doğru göründüğünü inceleyin.
5. Gönderim sonrasında belge durumunu ve servis yanıtını kaydedin.
6. Ticimax sipariş toplamı ile oluşan belge toplamını satır satır karşılaştırın.

Belge başarılı görünüyorsa yalnızca PDF görüntüsüne bakmayın. Belgenin e-belge durumunu, alıcıya iletim sonucunu ve entegratör hesabındaki gelen-giden kayıtlarını da kontrol edin.

Canlı panelde deneme yaparken gerçek müşteriye belge gönderilmesini önlemek gerekir. Yanlış alıcı bilgisiyle oluşturulan gerçek belge için düzeltme veya iptal yöntemi, belgenin türüne ve durumuna göre değişebilir.

Test sonucunu ekran görüntüsü, belge numarası ve sipariş numarasıyla kayıt altına alın. Daha sonra aynı senaryoyu farklı müşteri tipleri ve farklı vergi oranlarıyla tekrarlayın.

Testte hata alınırsa sadece hata mesajını kapatmayın. Hatanın hangi alanı, hangi siparişi ve hangi servis yanıtını işaret ettiğini belirleyin. Gerekirse kayıtları Ticimax ve e-belge destek ekiplerine birlikte iletin.

Ticimax e-Fatura ve e-Arşiv seçimi nasıl yapılır?

Ticimax e-Fatura ve e-Arşiv seçimi, alıcının e-Fatura kayıt durumuna ve işlemin mevzuat kapsamına göre yapılır. Alıcı e-Fatura kullanıcısıysa e-Fatura, kayıtlı değilse işlem uygunsa e-Arşiv tercih edilir.

e-Fatura, kayıtlı kullanıcılar arasında elektronik ortamda düzenlenip iletilen resmi fatura demektir. e-Arşiv fatura, e-Fatura kullanıcısı olmayan alıcılara veya mevzuatın izin verdiği işlemlere elektronik ortamda düzenlenen fatura demektir.

Ticimax bağlantısında alıcı türünü yalnızca müşterinin seçtiği kutuya göre belirlemeyin. VKN veya TCKN bilgisini kontrol edin ve gerekiyorsa e-Fatura kullanıcı sorgusunu çalıştırın.

Belge türlerinin kapsamını ve güncel uygulama şartlarını e-Fatura ürün sayfası ile e-Arşiv fatura ürün sayfasında karşılaştırabilirsiniz. Mevzuata bağlı istisnalarda güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

İade, red, iptal veya yeniden düzenleme süreçlerinde ilk belgenin durumu önemlidir. Ticimax siparişini silmek, resmi e-belge kaydını otomatik olarak ortadan kaldırmaz. İşlemi belge durumuna göre yürütün.

Ticimax kontör kullanımında gelen ve giden belgeler nasıl hesaplanır?

Ticimax kontör kullanımında gelen ve giden belgelerin her biri ayrı değerlendirilir; efaturakontor.com kullanım kuralına göre gelen belge 1, giden belge de 1 kontör düşürür. Bu kural, yalnızca giden faturaları sayan planlamalardan farklıdır.

Örneğin bir işletme belirli bir dönemde 80 giden e-belge ve 12 gelen belge alırsa toplam kullanım 92 kontör olur. Bu örnek, paket seçimi değil, gelen ve giden hareketlerin birlikte izlenmesi gerektiğini gösterir.

Ticimax panelindeki sipariş sayısı doğrudan kontör tüketimi anlamına gelmez. Faturaya dönüşmeyen siparişler, iptal edilen taslaklar veya tekrar denenen işlemler için kullanılan servisin güncel düşüm kuralını ayrıca kontrol edin.

Özellikle otomatik yeniden deneme seçeneği açıksa aynı siparişin iki belgeye dönüşüp dönüşmediğini belge numarasıyla inceleyin. Bir sipariş için birden fazla başarılı gönderim görünüyorsa destek kaydı açmadan önce durum geçmişini saklayın.

Yanlış: Sadece müşterilere gönderilen belgeleri hesaplamaktır. Doğru: Gelen belgeleri, giden belgeleri ve tekrar oluşabilecek gönderimleri ayrı sütunlarda izlemektir.

Kontör bakiyesi azaldığında gönderim davranışı kullanılan sisteme göre değişebilir. Belgenin beklemesi, hata vermesi veya taslakta kalması mümkündür. Bu nedenle bakiye kontrolünü günlük operasyon raporuna ekleyin.

Gelen belgeler için portalın gelen kutusunu, giden belgeler için giden kutusunu karşılaştırın. Her kayıt için belge numarası, tarih, sipariş bağlantısı ve kontör hareketini tutmak, ay sonu kontrolünü hızlandırır.

Ticimax e-Fatura entegrasyon hataları nasıl çözülür?

Ticimax e-Fatura entegrasyon hataları, önce hata kodu veya açıklaması alınarak, ardından ilgili sipariş alanı ve bağlantı kaydı incelenerek çözülür. Rastgele ayar değiştirmek yerine tek bir hata kaynağını izole etmek gerekir.

En yaygın veri hataları eksik VKN veya TCKN, hatalı adres, boş vergi dairesi, geçersiz KDV oranı ve ürün biriminin bulunmamasıdır. Siparişi düzeltmeden yeniden göndermek, aynı hatanın tekrar oluşmasına yol açar.

Kimlik doğrulama hatalarında kullanıcı adı, şifre, firma kodu ve servis ortamını kontrol edin. Hesabın aktifliği, entegrasyon yetkisi veya IP kısıtı değişmiş olabilir. Şifreyi güvenli kanaldan yenileyin ve eski bilgileri kaldırın.

Belge iki kez oluşuyorsa sipariş numarası eşleştirmesini ve otomatik tekrar deneme ayarını inceleyin. Belge oluştuğu halde Ticimax siparişi güncellenmiyorsa gönderim değil, durum geri bildirim bağlantısı sorunlu olabilir.

• Alıcı bilgisi eksikse müşteri kartını düzeltip belge öncesi doğrulama kuralı ekleyin.
• Seri hatasında kullanılan seri ve son numarayı muhasebe kaydıyla karşılaştırın.
• KDV hatasında ürün kartı, indirim satırı ve kargo satırını birlikte inceleyin.
• Yetki hatasında e-belge hesabının ilgili firma ve kullanıcı için aktif olduğunu doğrulayın.
• Tekrarlanan belgede sipariş numarası, belge UUID bilgisi ve gönderim zamanını destek ekibine iletin.

Hata çözümünde benzer sistemlerin akışını incelemek yararlı olabilir; ancak Hepsiburada e-Fatura entegrasyonu gibi marketplace akışlarını Ticimax siparişleriyle birebir kopyalamayın.

Vergi, senaryo, tevkifat veya belge iptali gibi mevzuat konularında güncel GİB duyurusunu ve mali müşavirinizi kontrol edin. Teknik hata ile muhasebe kararını birbirinden ayırın.

Ticimax e-Fatura entegrasyonunda güvenlik ve arşiv nasıl yönetilir?

Ticimax e-Fatura entegrasyonunda güvenlik, servis bilgilerini sınırlı kullanıcılarla paylaşarak ve gönderim kayıtlarını düzenli saklayarak yönetilir. Yönetici şifresini mağaza çalışanlarının tamamına vermek yerine görev bazlı yetki kullanın.

API anahtarı, kullanıcı adı, şifre ve sertifika bilgilerini sipariş notlarına veya ortak mesajlaşma kanallarına yazmayın. Yetkili personel değiştiğinde eski kullanıcının erişimini kaldırın ve entegrasyon bilgilerinin yenilenmesi gerekip gerekmediğini sorun.

E-belge kayıtlarının saklanması, yalnızca PDF dosyasını bilgisayara indirmekten ibaret değildir. Belge numarası, XML veya servis kaydı, gönderim durumu ve alıcı bilgisi birlikte korunmalıdır.

Ücretsiz e-Fatura portalında gelen-giden kutusu ve 10 yıl güvenli saklama sunulabilir. Bu hizmet, işletmenin kendi muhasebe ve yasal saklama yükümlülüklerini ortadan kaldırmaz; erişim ve yedekleme prosedürleri ayrıca belirlenmelidir.

Ayda en az bir kez Ticimax siparişlerini, giden belgeleri ve muhasebe kayıtlarını karşılaştırın. Gelen belgelerde ise belgeyi gönderen işletme, tarih, toplam ve ilgili satın alma kaydı kontrol edilmelidir.

Küçük bir kafe sahibi, günlük sipariş yoğunluğunda yalnızca başarılı ödeme kayıtlarına bakarsa faturasız veya iki kez oluşmuş belgeleri fark etmeyebilir. Gün sonu raporu, belge durumu ve kontör hareketi birlikte incelenmelidir.

Mali müşavirle paylaşılacak raporda sipariş numarası, belge numarası, tarih, alıcı türü, toplam tutar ve hata durumu bulunmalıdır. Böylece teknik bağlantı ile muhasebe kontrolü aynı kayıt üzerinden ilerler.

ERP kullanan işletmelerde görev ayrımını Luca e-Fatura entegrasyonu ve Nebim e-Fatura entegrasyonu örnekleriyle karşılaştırabilirsiniz; her yazılımda yetki alanları farklıdır.

Özet: 5 maddede Ticimax e-Fatura entegrasyonu

Ticimax e-Fatura entegrasyonu, e-belge hesabı ile mağaza sipariş akışının kontrollü biçimde bağlanmasıdır. Başarılı kurulum için teknik bağlantı kadar müşteri verisi, belge türü, kontör ve muhasebe kontrolü de birlikte planlanmalıdır.

• Önce e-Fatura veya e-Arşiv hesabınızın aktifliğini ve şirket bilgilerinin doğruluğunu kontrol edin.
• Ticimax panelinde kullanılan bağlayıcıya uygun servis bilgilerini ve entegrasyon yetkilerini tanımlayın.
• Müşteri, ürün, vergi, indirim, kargo ve ödeme alanlarını faturadaki karşılıklarıyla eşleştirin.
• Canlı gönderimden önce test siparişi, belge durumu, numara ve toplam tutarı karşılaştırın.
• Gelen ve giden belgelerin her biri için 1 kontör düşebileceğini raporlama planına ekleyin.

Kurulum tamamlandıktan sonra günlük belge durumu, aylık kontör kullanımı ve muhasebe mutabakatı izlenmelidir. Menü adları veya servis alanları değişirse Ticimax teknik dokümanını, entegratör açıklamalarını ve güncel GİB duyurularını kontrol edin.

Mevzuata bağlı istisna, tevkifat, iptal ve iade işlemlerinde mali müşavirinizden teyit alın. Teknik entegrasyonun çalışması, düzenlenen belgenin her işlem için otomatik olarak doğru olduğu anlamına gelmez.

İhtiyacınız varsa 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ı kullanılabilir.

Kontörler Sovos altyapısına aynı gün tanımlanır; paketlerde 12-18 ay kullanım süresi bulunur, güncel koşulları satın almadan önce kontrol edin.