Kargo & E-Fatura Entegrasyonu Çözümü
Siparişin onayından teslimata kadar geçen zinciri otomatikleştirir: kargo etiketi ve takibi, desi ağırlık hesabı ve GİB e-Belge kesimi tek akışta çalışır.
Pazaryeri operasyonunda maliyet ve müşteri memnuniyeti, çoğu zaman siparişin çıkışı ile faturanın kesimi arasındaki dakikalarda belirlenir. Bu sayfa; e-ticaret, operasyon, lojistik ve muhasebe ekipleri için sipariş → kargo → e-fatura otomasyonunun kapsamını, hesaplama formüllerini, mevzuat çerçevesini ve seçim kriterlerini derli toplu anlatır.
Çözüm neyi kapsar?
- Kargo API: Gönderi oluşturma, etiket/barkod (ZPL/PDF), takip numarası, teslim durumu webhook’u.
- Desi & ağırlık: Hacimsel ağırlık hesabı, taşıyıcı bazlı katsayı, ücretlendirilen ağırlık.
- e-Belge kesimi: GİB e-Fatura / e-Arşiv / e-İrsaliye’nin alıcı mükellefiyetine göre otomatik seçimi.
- İade & değişim: Ters kargo etiketi, iade faturası/dekont, stok geri yazımı, muhasebe eşleme.
- İzlenebilirlik: Tek gönderi kaydında etiket, takip, teslim kanıtı (POD) ve belge numarası.
Desi ve ücretlendirilen ağırlık
Kargo ücretinin temeli, gerçek ağırlık değil çoğu zaman hacimdir. Hacimsel (desi) ağırlık şöyle bulunur: Hacimsel ağırlık = (En × Boy × Yükseklik cm) / 3000. Faturalanan değer ise ikisinden büyük olanıdır: Ücretlendirilen ağırlık = max(gerçek ağırlık, desi ağırlık). Bölen olan 3000 yurt içinde yaygındır; ancak taşıyıcıya göre değişebildiğinden entegrasyon, her kargo firmasının katsayısını ayrı tutmalı ve gönderi anında doğru olanı uygulamalıdır.
Teslimat taahhüdü de basit bir toplamla planlanır: Teslimat SLA = hazırlık süresi + transfer süresi + son mil. Otomasyon bu üç bileşeni ayrı ölçtüğünde, gecikmenin depoda mı yoksa taşıyıcıda mı olduğunu ayırt edebilirsiniz.
Kargo ücret bileşenleri
| Bileşen | Açıklama |
|---|---|
| Ücretlendirilen ağırlık | max(gerçek, desi) ağırlık; fiyat kademesini belirler. |
| Mesafe / bölge | Çıkış-varış ili ve bölge kademesine göre değişen taban ücret. |
| Hizmet tipi | Standart, ertesi gün, aynı gün veya soğuk zincir gibi seçenekler. |
| Ek hizmet | Kapıda ödeme, sigorta/teminat, adres teslim, randevulu teslimat. |
| Yakıt / bölgesel farklar | Taşıyıcının dönemsel olarak uyguladığı ek katsayılar. |
Bileşenler ve ağırlıklandırma taşıyıcı sözleşmesine göre değişir; buradaki liste yapıyı gösteren temsili bir çerçevedir.
Hangi e-Belge, ne zaman?
| Belge türü | Ne zaman kullanılır |
|---|---|
| e-Fatura | Alıcı da e-Fatura mükellefiyse; belge GİB üzerinden karşı tarafın sistemine iletilir. |
| e-Arşiv Fatura | Alıcı e-Fatura mükellefi değilse (nihai tüketici/kayıtsız firma); internetten satışta yaygın olarak zorunludur. |
| e-İrsaliye | Malın fiziksel sevkine eşlik eden elektronik sevk irsaliyesi; faturadan bağımsız düzenlenir. |
Sistem, sipariş anında alıcının GİB mükellefiyet sorgusunu yapıp doğru belge türünü otomatik seçmeli; yanlış tür, hem iade/iptal akışını hem de mutabakatı zorlaştırır.
Mevzuat çerçevesi
- GİB e-Belge sistemi: e-Fatura, e-Arşiv ve e-İrsaliye kapsamı ve zorunluluk eşikleri Vergi Usul Kanunu genel tebliğleriyle (509 sıra no’lu tebliğ ve güncellemeleri) belirlenir. Brüt satış hasılatı eşiğini aşan ve internet üzerinden satış yapan mükellefler kapsama girer; eşikler zaman içinde düşürülmüştür, bu yüzden güncel sınır her yıl GİB üzerinden teyit edilmelidir.
- 6563 sayılı Elektronik Ticaretin Düzenlenmesi Hakkında Kanun: Aracı hizmet sağlayıcı (ATHS) ve hizmet sağlayıcı (ETHS) yükümlülükleri, sipariş ve teslimat sürecinde bilgilendirme esasları bu kanunla çerçevelenir.
- ETBİS (Elektronik Ticaret Bilgi Sistemi): Pazaryeri ve satıcıların kayıt/bildirim yükümlülüğü; gönderi ve teslimat verisinin bu çerçeveyle uyumlu tutulması beklenir.
- KVKK 6698: Alıcı adı, adresi ve iletişim bilgisi kargo etiketinde işlenir; veri, yalnızca teslimat amacıyla ve taşıyıcıyla veri işleme sözleşmesi çerçevesinde paylaşılmalıdır.
Ölçek verileri: otomasyonu zorunlu kılan rakamlar
Sipariş-kargo-fatura zincirini elle yönetmenin sınırı, sektörün kendi hacim verilerinde görülür. Ticaret Bakanlığı'nın Türkiye'de E-Ticaretin Görünümü raporuna göre perakende e-ticaret işlem sayısı 2024 yılında 1 milyar 850 milyon adede ulaşmıştır (Ticaret Bakanlığı, 2025) — her işlem, potansiyel bir gönderi ve en az bir e-belge demektir. Aynı bakanlığın ETBİS verilerine dayanan 2025 raporu ise toplam e-ticaret hacminin yüzde 52,2 artışla 4,57 trilyon TL'ye çıktığını ve e-ticaretin genel ticaretteki payının yüzde 19,3'e yükseldiğini gösterir (Ticaret Bakanlığı ETBİS, 2025). Belge tarafında da tablo aynıdır: GİB e-Belge sistemine kayıtlı e-Fatura kullanıcı sayısı 2024 başı itibarıyla 1,17 milyonu aşmıştır (GİB e-Belge kayıtlı kullanıcı verisi, 2024).
Bu ölçekte binde birlik bir hata oranı bile günde onlarca yanlış etiket, eksik belge veya tutarsız stok kaydı üretir. Otomasyonun amacı yalnızca hız değil; insan elinin değmediği her adımda hata olasılığını sıfıra yaklaştırmak ve hata oluştuğunda onu mutabakat ekranında görünür kılmaktır.
Temsili proje kapsamı
Aşağıdaki kapsam temsilidir; gerçek kapsam, keşifte çıkarılan sipariş hacmi, taşıyıcı ve e-belge entegratörü envanterine göre netleşir ve fiyat bilgisi içermez. Orta ölçekli bir e-ticaret operasyonu için tipik bir kargo + e-fatura otomasyon projesi şu bileşenlerden oluşur:
- Keşif ve envanter: Mevcut sipariş kaynakları (site, pazaryerleri), taşıyıcı sözleşmeleri, e-belge entegratörü ve muhasebe sistemi haritası.
- Taşıyıcı-bağımsız gönderi modeli: Tek gönderi şeması üzerinde iki kargo firması entegrasyonu; etiket, takip ve durum webhook'ları.
- Desi ve ücret motoru: Taşıyıcı bazlı katsayı tablosu, ücretlendirilen ağırlık hesabı ve kural bazlı taşıyıcı seçimi.
- e-Belge otomasyonu: GİB mükellefiyet sorgusuna göre e-Fatura/e-Arşiv seçimi, e-İrsaliye akışı, seri/sıra ve iptal-düzeltme yönetimi.
- İade akışı: Ters kargo etiketi, depo kabulünde stok geri yazımı, belge düzeltme ve muhasebe eşlemesi.
- Mutabakat ve izleme: Kargo faturası-gönderi eşleştirme, hata kuyruğu, kesinti telafi ekranı ve operasyon panosu.
- Devir: Ekip eğitimi, teknik dokümantasyon ve kaynak kodunun teslimi.
Seçim ve şartname kriterleri
- Taşıyıcı-bağımsız gönderi modeli: yeni kargo firması eklemek kod değişikliği gerektirmemeli.
- Durum webhook’u ve yeniden deneme (retry) mantığı; teslim/iade olayları kaçırılmadan işlenmeli.
- e-Belge tarafında GİB mükellefiyet sorgusu, seri/sıra yönetimi ve iptal/itiraz akışı.
- İdempotan çağrı ve mutabakat: aynı sipariş için çift etiket veya çift fatura üretilmemeli.
- İade/değişim için ters kargo, stok geri yazımı ve muhasebe eşlemesinin uçtan uca kapalı olması.
- Denetim izi, hata kuyruğu (dead-letter) ve taşıyıcı/GİB kesintisinde manuel telafi ekranı.
Kendi pazaryerinizi kuruyorsanız bu akış nasıl değişir?
Tek satıcılı bir operasyonda kargo ve fatura akışı tektir: gönderen sizsiniz, faturayı siz kesersiniz. Kendi pazaryerinizi işlettiğinizde ise her sipariş birden fazla satıcıya bölünebilir; kargo maliyetinin kimde kalacağı, iade sürecini kimin yürüteceği ve faturanın satıcı adına mı platform adına mı düzenleneceği yasal rolünüze göre belirlenir. Aracı hizmet sağlayıcı konumundaki bir platformun yükümlülükleri, kendi malını satan bir işletmeninkinden farklıdır.
Bu ayrımı ve ödeme/hakediş tarafını pazaryeri ödeme altyapısı ve mevzuat sayfasında; hangi modelde hangi sorumluluğun doğduğunu iş modelleri karşılaştırmasında ayrıntılı anlattık.
Sipariş, kargo ve fatura akışınızı birlikte inceleyip mevcut taşıyıcı ve muhasebe sisteminize uygun entegrasyon kapsamını netleştirelim. Aşağıdaki formdan operasyon hacminizi ve kullandığınız kargo/GİB sağlayıcılarını iletmeniz yeterli.
Merak edilenler
Desi (hacimsel ağırlık) nasıl hesaplanır ve neden önemlidir?
Hacimsel ağırlık, paketin kapladığı yeri ağırlığa çevirir: (En × Boy × Yükseklik cm) / 3000. Kargo firması, gerçek ağırlık ile desi ağırlığından hangisi büyükse onu ücretlendirir (ücretlendirilen ağırlık = max(gerçek, desi)). Bu yüzden hafif ama hacimli ürünlerde fiyat, terazi değerinin değil desinin üstünden çıkar. Bölen (3000) taşıyıcıya göre değişebilir; entegrasyon her taşıyıcının katsayısını ayrı tutmalıdır.
e-Fatura, e-Arşiv ve e-İrsaliye arasındaki fark nedir?
e-Fatura, alıcı da e-Fatura mükellefiyse düzenlenen elektronik faturadır ve GİB üzerinden karşı tarafa iletilir. e-Arşiv Fatura, alıcı e-Fatura mükellefi değilse (nihai tüketici veya kayıtsız firma) düzenlenir; internetten satışta e-Arşiv yaygın olarak zorunludur. e-İrsaliye ise malın sevkine eşlik eden elektronik sevk irsaliyesidir, faturadan bağımsızdır. Sistem, alıcının GİB mükellefiyet sorgusuna göre doğru belge türünü otomatik seçmelidir.
İade ve değişimde fatura ve stok nasıl düzeltilir?
İadede iki yol vardır: alıcı e-Fatura mükellefiyse iade faturası keser; nihai tüketici iadesinde ise satıcı gider pusulası veya iade dekontu ile işlemi belgeler ve satış e-Arşiv faturasını iptal/düzeltme akışına alır. Otomasyon, iade onayında ters kargo (return label) oluşturur, ürün depoya ulaştığında stok hareketini geri yazar ve muhasebe kaydını eşler; böylece stok, kasa ve GİB belgesi tutarlı kalır.
Kargo API entegrasyonu hangi işlevleri kapsamalı?
Asgari kapsam: gönderi oluşturma, etiket/barkod (ZPL veya PDF) üretimi, takip numarası (tracking) döndürme, durum webhook’u (yola çıktı, şubede, teslim, iade), toplu gönderi ve ters kargo. Ek olarak desi/hacimsel ağırlık alanları, teslim edilemeyen gönderi bildirimi ve teslim kanıtı (POD) beklenir. Tek bir taşıyıcıya bağlı kalmamak için entegrasyon, taşıyıcı-bağımsız bir gönderi modeliyle çalışmalıdır.
Birden fazla kargo firmasıyla (multi-carrier) çalışmak neden önemlidir?
Tek taşıyıcıya bağımlılık üç riski birden taşır: fiyat pazarlığında elinizin zayıflaması, bölgesel performans farklarını telafi edememek ve taşıyıcı tarafındaki bir kesintide tüm sevkiyatın durması. Multi-carrier kurguda sistem; desi, bölge, hizmet tipi ve güncel performansa göre her gönderi için en uygun taşıyıcıyı kural bazlı seçebilir, bir taşıyıcı kesintisinde otomatik olarak alternatife yönlendirir. Bunun ön koşulu, entegrasyonun taşıyıcı-bağımsız tek bir gönderi modeli üzerine kurulmasıdır; yeni firma eklemek kod değişikliği değil, yapılandırma işi olmalıdır.
Kapıda ödeme (tahsilatlı gönderi) akışı entegrasyonda nasıl ele alınır?
Kapıda ödemede kargo firması tahsilat aracısına dönüşür; entegrasyonun gönderi kaydında tahsilat tutarı, tahsilat tipi (nakit/kart) ve tahsilatlı gönderi işareti ayrı alanlar olarak taşınmalıdır. Kritik nokta mutabakattır: taşıyıcının periyodik tahsilat raporu ile sistemdeki sipariş kayıtları otomatik eşleştirilmeli, eksik veya fazla ödemeler bir mutabakat ekranında görünür olmalıdır. Teslim anında alıcının ürünü reddetmesi (kapıda iade) senaryosu da akışta tanımlı olmalı; gönderi iade statüsüne düşerken fatura iptal/düzeltme ve stok geri yazımı otomatik tetiklenmelidir.
Kendi pazaryerinizi size özel geliştirelim.
Pazaryeri fikrinizi ya da mevcut ihtiyacınızı yazın; iş modelinden geliştirmeye tek elden değerlendirip 1 iş günü içinde dönelim. Hazır paket değil — kaynak kodu sizin, size özel.
Talep Oluştur