Mersin Toptan Ticaret + e-Fatura UBL-TR Entegrasyonu: Pratik Rehber

E-Fatura Zorunluluğu ve UBL-TR: Mersin Perspektifi

Gelir İdaresi Başkanlığı (GİB), belirli ciro eşiklerini aşan tüm firmaları e-Fatura sistemine dahil ediyor. Mersin'de toptan ticaret yapıyorsanız—özellikle ithalat/ihracat, tekstil, gıda, inşaat malzemeleri gibi sektörlerdeyseniz—bu zorunluluk sizin için de geçerli.

UBL-TR nedir? Universal Business Language - Türkiye standardı. E-Faturanın XML formatında, makineler arası okunabilir halidir. PDF gönderip işi bitirdiğiniz dönem geride kaldı; şimdi her fatura GİB'in belirlediği şema yapısında, belirli etiketlerle (cbc:InvoiceID, cac:AccountingSupplierParty vb.) gönderilmek zorunda.

Mersin özelinde neden bu kadar kritik?

• MIP ve Taşucu Limanı: Uluslararası ticaret yoğun. Gümrük, nakliye ve muhasebe süreçleri senkron çalışmalı. Bir konteynerde 50 farklı ürün varsa, 50 fatura satırı da UBL-TR formatında hatasız gitmeli.
• Tarsus OSB: Tekstil, gıda ve kimya üreticileri yoğun. Üretim hattından çıkan ürün anında faturalanıp GİB'e bildirilmezse, denetimde sorun yaşarsınız.
• Silifke, Anamur muz üreticileri: Tarımsal ihracat hızlı işler. E-Fatura gecikirse, alıcı ödemeyi bekletir.

Sonuç: Mersin'de e-Fatura sürecini otomatize etmezseniz, ya insan kaynağınızı yakarsınız ya da compliance riskine girersiniz.

---

GİB Entegrasyon Süreci: Adım Adım

GİB entegrasyonu kulağa teknik gelse de, doğru sırayla ilerlerseniz 2-3 hafta içinde canlıya alınabilir. İşte yol haritası:

1. GİB e-Fatura Mükellefi Olma

• Başvuru: GİB Mükellefiyet Sistemi üzerinden e-Fatura mükellefi olarak kayıt olun.
• Kullanıcı Kodu ve Parola: GİB size özel bir kullanıcı kodu (TCKN/VKN) ve parola verir. Test ve canlı ortam için farklı bilgiler alacaksınız.
• Test Ortamı Erişimi: Canlıya geçmeden önce GİB Test Portalı'nda deneme faturalar gönderin.

Mersin ipucu: Mersin Vergi Dairesi'nden (Akdeniz Vergi Dairesi, Mezitli Vergi Dairesi) e-Fatura konusunda yerel destek alabilirsiniz. Online başvuru sırasında sorun yaşarsanız, vergi dairenize gidip fiziksel destek almak bazen daha hızlı çözüm sağlıyor.

2. UBL-TR Şemasını Anlamak

UBL-TR 2.1 şeması GİB'in belirlediği standarttır. Temel elemanlar:

• cbc:ID: Fatura numarası (örn: MRS2025001234)
• cbc:IssueDate: Düzenleme tarihi
• cac:AccountingSupplierParty: Satıcı bilgileri (VKN, adres, vergi dairesi)
• cac:AccountingCustomerParty: Alıcı bilgileri
• cac:InvoiceLine: Fatura satırları (ürün, miktar, birim fiyat, KDV)
• cac:TaxTotal: Toplam vergi tutarı

Bu şemayı kendiniz kodlamak zorunda değilsiniz. Entegrasyon yazılımınız (D'Cloud gibi) bu XML'i otomatik oluşturur. Sizin göreviniz: ERP'nizdeki veriyi doğru formatta sağlamak.

3. ERP/Muhasebe Yazılımı ile Köprü Kurma

Mersin'de yaygın kullanılan muhasebe yazılımları: Logo, Netsis, Mikro, Zirve, SAP. Bu yazılımlar genelde kendi e-Fatura modüllerini satar ama entegrasyon maliyeti yüksek olabilir veya esneklik sınırlıdır.

Alternatif yaklaşım: Bağımsız bir API katmanı kurmak. D'Cloud Software olarak şunu yapıyoruz:

1. ERP'nizden fatura datasını REST API veya CSV export ile alıyoruz.
2. Bu datayı UBL-TR XML'e çeviriyoruz (mapping).
3. GİB Web Servislerine SOAP çağrısı ile gönderiyoruz.
4. GİB'den dönen onay (veya hata) mesajını ERP'nize geri yazıyoruz.

Bu sayede ERP'nizde hiçbir değişiklik yapmadan e-Fatura otomasyonu kazanıyorsunuz.

4. Test Senaryoları

GİB Test Portalı'nda şu senaryoları mutlaka deneyin:

• Temel fatura: 1 ürün, standart KDV
• Çok satırlı fatura: 20+ ürün (Tarsus OSB'deki bir parti sevkiyat gibi)
• İstisna/İade fatura: KDV istisnası veya iade bildirimi
• Yabancı alıcı: İhracat faturası (MIP Liman senaryosu)

Her test için GİB'den XML response gelecek. "KABUL" veya "RED" durumunu kontrol edin. Red detayında hangi alanın hatalı olduğu yazar (örn: "cbc:PostalZone boş olamaz").

5. Canlı Ortama Geçiş

Test sonuçları temizse:

• GİB canlı ortam bilgilerinizi alın (Production endpoint: https://efatura.gib.gov.tr/…).
• İlk 5-10 faturayı manuel kontrol edin.
• Onay süresini izleyin (genelde 1-2 saniye).

Canlıya geçtikten sonra ilk 15 gün ücretsiz hata düzeltme garantimiz devreye girer. Herhangi bir GİB red hatası yaşarsanız, ekibimiz anında müdahale eder.

---

Tarsus OSB ve MIP Liman: Gerçek Entegrasyon Senaryoları

Senaryo 1: Tarsus OSB'de Pamuk İhracatı

Firma: Tarsus'ta pamuk işleme tesisi. Aylık 200 konteyner ihracat yapıyor.

Sorun: Her konteyner için ortalama 15 fatura satırı var (farklı kalite kodları). Manuel UBL-TR düzenleme imkansız hale geldi.

Çözüm: ERP'den (Netsis) günlük export alındı. Her konteyner sevkiyatında otomatik fatura oluşturuldu. GİB'e toplu gönderim yapıldı. İşlem süresi 4 saatten 15 dakikaya düştü.

Dikkat edilen nokta: İhracat faturalarında "cac:Delivery/cac:DeliveryLocation" alanı doğru doldurulmalı (liman bilgisi). MIP Liman için "TR-MIP" kodu kullanıldı.

Senaryo 2: Mersin Limanında Soğuk Hava Deposu

Firma: MIP'te soğuk hava deposu işleten lojistik şirketi. Müşterilere aylık depolama faturası kesiyor.

Sorun: Fatura tarihi ile ödeme vadesi arasında 60 gün var. GİB'e zamanında iletilmezse, vade farkı hesaplanıyor.

Çözüm: Her ay 1. gününde otomatik toplu fatura kesimi. UBL-TR içinde "cbc:DueDate" alanı doğru set edildi. GİB'den onay alınır alınmaz müşteriye PDF + XML gönderildi.

Sonuç: Vade takibi %100 doğru hale geldi. Müşteri memnuniyeti arttı.

---

Yaygın Hatalar ve Çözümleri

Hata 1: "UBLTR-00001 - cbc:PostalZone alanı zorunludur"

Neden: GİB adres bilgilerinde posta kodu eksik.

Çözüm: ERP'de müşteri kartlarına posta kodu ekleyin. Mersin merkez için 33000, Tarsus için 33400 gibi.

Hata 2: "UBLTR-00123 - cac:TaxTotal tutarı uyumsuz"

Neden: Fatura satırlarındaki KDV toplamı ile TaxTotal uyuşmuyor.

Çözüm: Mapping sırasında KDV hesaplamasını double-check edin. Özellikle indirim/iskonto varsa, net tutar üzerinden KDV hesaplanmalı.

Hata 3: "Web servis timeout"

Neden: GİB sunucuları yoğun saatlerde yavaş yanıt verebilir.

Çözüm: Retry mekanizması kurun. 3 deneme, aralarında 5 saniye bekleme. Hala başarısız olursa, log kaydedin ve manuel inceleme için işaretle.

Hata 4: "Mükerrer fatura numarası"

Neden: Aynı fatura numarasıyla iki kez gönderim yapıldı.

Çözüm: ERP'den gelen fatura numaralarını veritabanında unique constraint ile kontrol edin. Gönderim öncesi "bu numara daha önce kullanıldı mı?" kontrolü yapın.

---

Mersin'de e-Fatura Sürecini Hızlandırma İpuçları

1. Toplu işlem saatleri: Sabah 08:00-10:00 arası GİB sunucuları nispeten boştur. Büyük toplu gönderimlerinizi bu saate planlayın.

2. Yerel muhasebe desteği: Mersin'de e-Fatura konusunda deneyimli mali müşavirler var. Entegrasyon öncesi danışın. Özellikle sektörel KDV istisnaları (tarım, ihracat) konusunda yerel bilgi değerli.

3. Lojistik entegrasyonu: MIP veya Taşucu üzerinden sürekli sevkiyat yapıyorsanız, kargo/nakliye firmanızın da e-İrsaliye kullanmasını sağlayın. İrsaliye + Fatura senkronizasyonu, gümrük süreçlerini hızlandırır.

4. Mobil onay: Sahada çalışan satış ekibiniz varsa, mobil uygulama ile fatura onayı alın. Tarsus'ta üretim tesisinde kesilen bir faturayı, MIP'te bekleyen müdürünüz anında onaylayabilir.

5. Dashboard izleme: Günlük kaç fatura gönderildi, kaçı kabul edildi, kaçı reddedildi? Bunu anlık görebileceğiniz bir dashboard kurun. Sorunları reaktif değil proaktif çözün.

---

Sık Sorulan Sorular

e-Fatura entegrasyonu kaç günde tamamlanır?

GİB'den mükellefiyet onayı aldıktan sonra, ERP entegrasyonu ortalama 10-15 iş günü sürer. Mersin'de yerinde olduğumuz için ilk keşif görüşmesini 1-2 gün içinde yapıyoruz. Test süreci 5 iş günü, canlıya geçiş 3-5 iş günü. Toplam süre ERP'nizin karmaşıklığına bağlı. Logo veya Netsis gibi yaygın yazılımlarda hızlı ilerleriz; özel yazılımda biraz daha fazla sürebilir.

UBL-TR entegrasyonu için fiyat ne kadar?

Proje bazlı fiyatlandırma yapıyoruz. Fatura hacminiz (aylık kaç adet), ERP türü, özel gereksinimler (toplu gönderim, mobil onay vb.) üzerinden teklif hazırlanır. Keşif görüşmesinde detaylı analiz yaptıktan sonra sabit fiyat teklifi sunuyoruz—sözleşmede yazılı, sonradan sürpriz maliyet yok. Genel aralık: orta ölçekli bir toptan ticaret firması için entegrasyon bedeli değişkendir, ancak aylık işletme maliyeti düşüktür. Net rakam için bizimle iletişime geçin.

Hangi ERP yazılımları ile çalışıyorsunuz?

Mersin'de en yaygın olanlar: Logo Tiger, Netsis, Mikro, Zirve. Bunların hepsiyle entegrasyon deneyimimiz var. SAP kullanıyorsanız, biraz daha fazla hazırlık gerekir ama yine mümkün. Özel yazılım kullanıyorsanız, REST API veya veritabanı erişimi yeterli. JSON veya XML formatında veri alışverişi yapabiliyorsak, entegre edebiliriz.

GİB test ortamında hata alıyorum, ne yapmalıyım?

GİB'in hata kodları bazen kriptik olabilir. Size önerimiz: hata kodunu ve XML'in ilgili satırını bize gönderin. İlk 15 gün içinde ücretsiz destek sağlıyoruz. Genelde sorun, adres alanlarının eksik doldurulması veya KDV hesaplamasında virgül kaymasıdır. Birkaç saatte düzeltilebilir.

e-Arşiv ve e-Fatura farkı nedir?

e-Arşiv, e-Fatura mükellefi olmayan son kullanıcılara (bireysel müşteriler) kesilen faturadır. UBL-TR formatında GİB'e iletilir ama karşı taraf sadece PDF alır. e-Fatura ise iki mükellef arasında XML bazlı karşılıklı iletimdir. Mersin'de toptan ticaret yapıyorsanız, B2B işlemlerde e-Fatura, perakende satışlarda e-Arşiv kullanırsınız. İkisi de aynı entegrasyon altyapısı ile yönetilebilir.

Entegrasyon sonrası destek süreci nasıl işler?

İlk 15 gün tüm hatalar ücretsiz düzeltilir—bu garantimizdir. Sonrasında aylık destek paketleri sunuyoruz (e-posta/WhatsApp desteği, minor güncellemeler, GİB şema değişikliklerine uyum). Acil durumlarda—örneğin GİB sunucularının beklenmedik şekilde değişmesi—aynı gün müdahale ediyoruz. Mersin'de yerelde olduğumuz için gerekirse yerinde destek de sağlayabiliriz.

---

Sonuç: e-Fatura Artık Rekabet Avantajı

Mersin'de toptan ticaret hızla dijitalleşiyor. MIP Liman'dan gelen yük anında faturalanıp muhasebeleşiyor, Tarsus OSB'deki üretim hattından çıkan ürün dakikalar içinde GİB'e bildiriliyor. UBL-TR entegrasyonu bu hız ve uyumu sağlayan temel altyapı.

Manuel e-Fatura süreçleri sadece zaman kaybettirmekle kalmıyor, hata riskini de artırıyor. GİB red bildirimi aldığınızda hem ödeme gecikiyor hem de müşteri güveni sarsılıyor. Otomasyonla bu riskleri ortadan kaldırabilir, ekibinizin verimliliğini artırabilir, nakit akışınızı hızlandırabilirsiniz.

Biz D'Cloud Software olarak Mersin'de, sizinle aynı coğrafyada çalışıyoruz. Vergi dairenizle, liman operasyonlarınızla, OSB dinamiklerinizle tanışığız. Entegrasyonunuzu sadece teknik bir proje olarak görmüyoruz—işinizin büyümesi için dijital altyapı kuruyoruz. Sabit fiyat, sözleşmede yazılı, sürpriz yok. İlk 15 gün hata düzeltme garantisiyle başlayın, risksiz deneyin.

Ücretsiz online keşif görüşmesi için bizimle iletişime geçin. Mersin'de e-Fatura entegrasyonunu birlikte doğru yapalım.

---

Yazar: Doğuhan Bulut
Kategori: Entegrasyonlar & GİB
Tarih: 2025