Sipariş onaylandı, şimdi biri kargo firmasının paneline giriyor, alıcının adresini yeniden yazıyor, koliye göre desiyi hesaplıyor, gönderi kaydını açıyor, etiketi yazdırıyor ve takip numarasını müşteriye iletiyor. Günde on gönderide bu bir alışkanlıktır; yüz gönderide bir vardiyalık iştir. Kargo entegrasyonu, gönderi kaydının açılmasını, etiketin basılmasını ve takip bilgisinin sisteminize geri yazılmasını siparişten otomatik olarak yapan yazılım bağlantısıdır.
Bu rehberde kargo entegrasyonunun nasıl çalıştığını, hangi verileri taşıdığını, desi ve ücretlendirmenin entegrasyonda nasıl ele alındığını, birden fazla kargo firmasıyla çalışmayı, kapıda ödeme ve iade akışını, entegrasyon yöntemlerini, sık karşılaşılan sorunları ve altı adımlık kurulumu anlatıyoruz. Örnek rakamlar temsilîdir.
Kargo Entegrasyonu Nedir?
Kargo entegrasyonu, e-ticaret sitenizin, ERP'nizin ya da yönetim panelinizin kargo firmasının sistemiyle API üzerinden konuşmasıdır. Sisteminiz gönderi bilgisini kargo firmasına iletir, firma gönderi kaydını ve takip numarasını döner, etiket sisteminizden basılır ve teslim durumu zaman içinde size geri yazılır.
Entegrasyon yokken her gönderi ayrı bir ekranda elle girilir; adres, telefon ve desi bilgisi ikinci kez yazılır. Entegrasyonla ise sipariş verisi doğrudan gönderiye dönüşür ve müşteriye takip bilgisi otomatik gider.
Okumanızı öneririz: Entegrasyon ve API geliştirme hizmetimiz
Kargo Entegrasyonu Nasıl Çalışır?
Altı adımda çalışır: sipariş onaylanır, kargo firması seçilir, gönderi kaydı açılır, barkod ve etiket basılır, takip bilgisi müşteriye iletilir ve teslim durumu sisteme geri yazılır.
- Sipariş onayı: Ödeme alınan ya da onaylanan sipariş gönderi sürecini tetikler.
- Kargo firması seçimi: Desi, bölge ya da kapıda ödeme gibi kurallara göre firma belirlenir.
- Gönderi kaydı: Alıcı, adres ve koli bilgisi firmanın API'sine gönderilir; firma gönderi ve takip numarasını döner.
- Barkod ve etiket: Etiket sisteminizden yazdırılır; depo ekibi paketi etiketleyip teslim eder.
- Müşteri bildirimi: Takip numarası ve bağlantısı müşteriye ve gerekiyorsa pazaryerine iletilir.
- Durum geri yazımı: Yolda, teslim edildi, iade ya da hasar gibi hareketler siparişe işlenir.
Kargo Entegrasyonu Hangi Verileri Taşır?
Gönderi dört veri grubundan oluşur: alıcı, koli, hizmet ve referans. Kargo reddi ve teslimat sorunlarının çoğu bu verilerin eksik ya da hatalı olmasından çıkar.
| Veri grubu | Alanlar | Sık görülen sorun |
|---|---|---|
| Alıcı | Ad-soyad, telefon, il, ilçe, mahalle, açık adres | İl ve ilçe adının firmanın listesiyle eşleşmemesi; telefonun yanlış biçimde yazılması |
| Koli | Parça sayısı, ölçüler, desi, gerçek ağırlık | Desinin eksik ya da yanlış hesaplanması, ücret farkı çıkması |
| Hizmet | Kapıda ödeme tutarı, sigorta, teslim türü, firma ve servis kodu | Kapıda ödeme tutarının siparişle uyuşmaması |
| Referans | Sipariş numarası, gönderi numarası, takip numarası, barkod | İade ve tahsilat kayıtlarının gönderiye bağlanamaması |
Referans alanları bu yüzden önemlidir: sipariş numarası, gönderi numarası ve takip numarası sisteminizde birbirine bağlı tutulmalıdır. İade, hasar ve tahsilat kayıtları bu bağla eşleşir.
Desi ve Kargo Ücreti Entegrasyonda Nasıl Hesaplanır?
Kargo firmaları desi ile gerçek ağırlıktan büyük olanı ücretlendirir. Yurt içi gönderilerde desi, kolinin hacminin 3000'e bölünmesiyle bulunur; bölen firmaya ve hizmete göre değişebilir, anlaşmanızdaki değeri kullanın.
Örnek: 40 × 30 × 25 cm bir koli 30.000 ÷ 3000 = 10 desidir. Koli 4,5 kg gelse bile kargo firması 10 üzerinden ücretlendirir. 30 × 20 × 15 cm bir koli 9.000 ÷ 3000 = 3 desi, 50 × 40 × 30 cm bir koli 60.000 ÷ 3000 = 20 desidir.
Entegrasyonda ürünün ölçüleri ve ağırlığı ürün kartında tutulur; sistem sepete göre koliyi ve desiyi hesaplar, gönderiye yazar ve beklenen ücreti tarifeden çıkarır. Ölçüsü eksik ürün, yanlış ücret ve firmadan gelen fark faturası demektir. Desiyi ve kargo maliyetini hızlıca denemek için desi hesaplama aracımızı ve kargo ücreti hesaplama aracımızı kullanabilirsiniz (Turkish interface).
Birden Fazla Kargo Firmasıyla Nasıl Çalışılır?
Birden fazla firmayla çalışmak, her gönderi için firmayı bir kurala göre seçmek demektir. Kuralı elle uygulamak yerine entegrasyon bunu otomatik yapar.
| Kural | Örnek |
|---|---|
| Desi aralığı | Küçük koliler bir firmayla, büyük koliler anlaşmanın daha uygun olduğu firmayla gönderilir |
| Bölge | Belirli şehirlere teslimatta güçlü olan firma seçilir |
| Kapıda ödeme | Kapıda ödemeli siparişler bu hizmeti sunan firmaya yönlenir |
| Sipariş tutarı | Yüksek tutarlı siparişte sigortalı gönderi yapılır |
| Pazaryeri zorunluluğu | Pazaryeri anlaşmalı kargo kodu istiyorsa o koda göre gönderi açılır |
Kurallar önceliklidir; bir kural firmaya erişilemediğinde yedek firmayı da tanımlayabilir. Böylece bir firmanın API'si kısa süre kapandığında gönderiler beklemez.
Okumanızı öneririz: Pazaryeri entegrasyonu nedir? Ürün, stok ve siparişi tek yerden yönetme rehberi
Takip Bilgisi Müşteriye ve Pazaryerine Nasıl İletilir?
Takip bilgisi, gönderi kaydı açıldığı anda müşteriye iletilmelidir; müşteri "kargom nerede?" diye sormak zorunda kalmamalıdır. Entegrasyon takip numarasını ve bağlantısını sipariş durumuyla birlikte e-posta, SMS ya da hesap sayfası üzerinden gönderir.
Pazaryeri siparişlerinde ek olarak takip numarası ve kargo firması bilgisi pazaryerine geri yazılır. Süresinde bildirilmeyen sipariş satıcı performansını olumsuz etkileyebilir; bu nedenle geri yazım sorgulamaya bırakılmaz, gönderi kaydı başarılı olur olmaz otomatik yapılır. Teslim edildi durumu geldiğinde de sipariş otomatik kapanır ve gerekiyorsa müşteriye değerlendirme daveti gider.
Kapıda Ödeme ve Tahsilat Mutabakatı Nasıl Yapılır?
Kapıda ödemeli gönderilerde tahsilatı kargo firması yapar ve size sonradan öder; bu nedenle gönderi ile tahsilat tek tek eşleştirilmelidir. Mutabakat, beklenen tahsilatın firmadan gelen ödemeyle karşılaştırılmasıdır.
Örnek (temsilî): bir dönemde 40 kapıda ödemeli gönderi çıkmış, 38'i teslim edilip 2'si iade dönmüş olsun. Teslim edilenlerin her biri ₺850 ise beklenen tahsilat 38 × 850 = ₺32.300'dür. Firmadan gelen ödeme de ₺32.300 ise mutabıksınız; fark varsa gönderi numarasıyla hangi kaydın eksik ya da fazla olduğu bulunur.
Entegrasyon teslim durumunu geri yazdığı için hangi gönderilerin tahsil edildiği, hangilerinin iade olduğu otomatik görünür; tahsilat cari hesapla eşleşir. Muhasebe tarafındaki kayıt şekli için mali müşavirinize danışın.
İade ve Hasarlı Gönderiler Nasıl Yönetilir?
İade bir ek gönderidir ve kendi kaydı olmalıdır. Müşteri iade talebi açtığında iade gönderi kodu oluşturulur, kargo firması paketi alır ve teslim edilince stok ve cari kayıtlar düzelir.
- İade gönderisi: Orijinal siparişe ve gönderiye bağlanır; iade nedeni kaydedilir.
- Stok kararı: Paket depoya ulaşıp kontrolden geçince stoğa eklenir; hasarlıysa ayrı tutulur.
- Hasar ve kayıp: Kargo firmasına bildirim, gönderi numarası ve hasar fotoğrafıyla yapılır; tutar kargo sigortasıyla ya da firmayla uzlaşılarak çözülür.
Kargo Entegrasyonu Yöntemleri Nelerdir?
Üç yol vardır: kargo firmasının kendi API'sine doğrudan bağlanmak, birden fazla firmayı tek arayüzde toplayan hazır bir kargo aracını kullanmak ya da özel entegrasyon geliştirmek. Seçim, gönderi hacmine ve sistemlerinizin sayısına bağlıdır.
| Yol | Nasıl işler? | Ne zaman uygun? |
|---|---|---|
| Firmanın paneli | Gönderi firmanın kendi panelinde elle ya da toplu yüklemeyle açılır | Az gönderi; sistem entegrasyonu gerekmeyen küçük işletmeler |
| Hazır kargo aracı | Birden fazla firma tek panelden yönetilir; siparişler siteden gelir | Orta hacim; standart akış, birkaç firma |
| Özel entegrasyon | Sizin sisteminiz firmaların API'siyle doğrudan konuşur; kurallar sizin iş kurallarınıza göre yazılır | Yüksek hacim; ERP, depo, fatura ve pazaryeriyle aynı akışta ilerlemesi gereken işletmeler |
Kargo Entegrasyonunda Sık Karşılaşılan Sorunlar Nelerdir?
| Sorun | Neden olur? | Çözüm |
|---|---|---|
| Gönderi kaydı reddedilir | İl-ilçe adı eşleşmiyor ya da zorunlu alan eksik | Adresi firmanın listesiyle doğrulayın; hata listesine düşüp düzeltilsin |
| Aynı gönderi iki kez açılır | Cevabı gelmeyen istek yeniden denenir | Her gönderiyi benzersiz kimlikle işaretleyin; işlenmiş kimlik ikinci kez işlenmesin |
| Firmanın API'si kapanır | Bakım ya da kesinti | İstekleri kuyruğa alıp yeniden deneyin; yedek firma kuralı tanımlayın |
| Takip durumu geç gelir | Bildirim gelmiyor, sorgulama seyrek | Bildirim ve düzenli sorgulamayı birlikte kullanın |
| Ücret farkı çıkar | Desi ya da ölçü hatalı | Ürün kartındaki ölçüleri doğrulayın; farkları gönderi bazında raporlayın |
Gönderi kaydı başarı oranını izlemek veri kalitesini gösterir. Örnek: 1.000 gönderinin 985'i ilk denemede kabul edildiyse oran 985 ÷ 1.000 = %98,5'tir; kalan 15 gönderi hata listesinde bekler ve nedenleri sınıflandırılır.
Kargo Entegrasyonu Seçerken Hangi Sorular Sorulur?
- Hangi firmalara bağlanıyor? Anlaşmanız olan firmalar listede var mı?
- Kapıda ödeme ve iade gönderisini destekliyor mu?
- Kargo seçim kuralları yazılabiliyor mu? Desi, bölge ve tutara göre otomatik seçim var mı?
- Hata nerede görünür? Reddedilen gönderi listeleniyor ve sorumlu uyarılıyor mu?
- Etiket biçimleri uygun mu? Kullandığınız etiket yazıcısıyla çalışıyor mu?
- Pazaryeri kargo kodlarını destekliyor mu?
- Takip bilgisi müşteriye otomatik gidiyor mu? E-posta, SMS ya da pazaryeri üzerinden.
- Yeni firma eklemek kolay mı? Anlaşma değiştiğinde entegrasyon esnek mi?
Kargo Entegrasyonu Nasıl Kurulur? Altı Adımda Plan
Sağlıklı kurulum, kargo firmasından API erişimini almakla başlar ve veri alanlarını netleştirerek ilerler.
- Firma: Anlaşmalı firmalar belirlenir, her biri için API erişimi ve test hesabı alınır.
- Veri: Adres, koli ve desi alanlarının kaynakları tanımlanır; ürün kartlarındaki ölçüler tamamlanır.
- Kurallar: Firma seçimi, kapıda ödeme, iade gönderisi ve yedek firma kuralları yazılır.
- Geliştirme: Gönderi kaydı, etiket, takip, hata kuyruğu ve yeniden deneme yapıları kurulur.
- Test: Test ortamında standart, hatalı adresli, kapıda ödemeli ve iade gönderileri denenir.
- İzleme: Canlıya geçince kayıt başarı oranı, hata listesi ve geciken takip durumları izlenir.
Okumanızı öneririz: E-ticaret Sitesi Nasıl Kurulur? Altyapı, Yasal Gereklilikler, Maliyet ve Başabaş Rehberi
Okumanızı öneririz: API güvenliği nasıl sağlanır? Kimlik, yetki, token ve hız sınırı rehberi
Okumanızı öneririz: Sevkiyat planlama yazılımı nedir? Rota, araç doluluğu ve teslimat kanıtı
İnovabil ile Kargo Entegrasyonu
İnovabil olarak kargo entegrasyonunu yalnızca etiket basma işi olarak değil, siparişten tahsilata uzanan zincirin parçası olarak tasarlıyoruz. Projeye veri haritası ve kargo kurallarıyla başlıyor, entegrasyonu hata kuyruğu, yeniden deneme, kayıt ve izleme ile kuruyoruz.
Sürat Kargo için ön ödemeli kargo sistemi Kredili Kargo'yu geliştirdik; Faprika, NetKasam ve özel e-ticaret projelerimizde ödeme, kargo, e-Fatura ve pazaryeri bağlantıları kurduk. Kullandığınız firmaları ve gönderi sürecinizi birkaç cümleyle anlatın, size özel bir entegrasyon yol haritası hazırlayalım.
Okumanızı öneririz: E-ticaret yazılımı: pazaryeri, kargo ve ödeme entegrasyonlarıyla birlikte
Sık Sorulan Sorular
Kargo entegrasyonu nedir, kısaca ne işe yarar?
Kargo entegrasyonu, sisteminiz ile kargo firmasının sistemi arasında gönderi kaydının açılmasını, etiketin basılmasını ve takip bilgisinin geri yazılmasını otomatik yapar. Adres ve koli bilgisi ikinci kez yazılmaz.
Desi nasıl hesaplanır?
Desi, kolinin en, boy ve yüksekliğinin (cm) çarpımının 3000'e bölünmesiyle bulunur; bölen firmaya ve hizmete göre değişebilir. Kargo firması, desi ile gerçek ağırlıktan büyük olanı ücretlendirir.
Birden fazla kargo firmasıyla entegrasyon yapılabilir mi?
Evet. Her gönderi için firma, desi, bölge, kapıda ödeme ya da sipariş tutarı gibi kurallara göre otomatik seçilebilir; bir firmanın API'si kapandığında yedek firma tanımlanabilir.
Kapıda ödeme tahsilatı nasıl takip edilir?
Teslim edilen kapıda ödemeli gönderilerin toplamı beklenen tahsilatı verir; bunu firmadan gelen ödemeyle gönderi numarası üzerinden karşılaştırırsınız. Entegrasyon teslim durumunu geri yazdığı için bu eşleştirme otomatikleşir.
Kargo entegrasyonu ne kadar sürede kurulur?
Süre firma sayısına, API belgelerinin kalitesine ve kuralların karmaşıklığına bağlıdır. Test hesabı ve veri haritası hazırsa tek firmayla entegrasyon kısa sürede teste gelir; her yeni firma eklemek bundan sonra daha hızlıdır.