Kargo entegrasyonu nedir?
Kargo entegrasyonu, satış yaptığın programı ya da e-ticaret sitesini kargo firmasının sistemine bağlayan servis bağlantısıdır: gönderi bilgisi kargo firmasına gider, takip numarası ve gönderinin durumu geri gelir. Böylece adresi, takip kodunu ve "kargom nerede?" bilgisini iki ekran arasında elle taşımazsın.
Kargo entegrasyonu iki ayrı iş yapabilir ve ikisi sık karıştırılır:
- Gönderi kaydı ve etiket: Alıcının bilgisini kargo firmasının sistemine yazar, barkodlu etiketi alırsın. Yurtiçi Kargo'nun web servis tanımında gönderi oluşturma, iptal ve sorgulama işlemleri ayrı ayrı yer alır.
- Gönderi takibi: Elindeki takip numarasının durumunu kargo firmasından sorar; kargoya verildi, yolda, dağıtımda, teslim edildi gibi hareketleri getirir. ERP ya da ön muhasebe programlarında "kargo entegrasyonu" çoğunlukla bunu, yani sevk irsaliyesindeki takip numarasının izlenmesini anlatır.
Bir teklifte "kargo entegrasyonu var" yazıyorsa hangisini kastettiklerini sor. Bu yazı e-ticaret satıcısının kargo zincirini anlatıyor; sitenle pazaryerini nasıl bağladığını e-ticaret entegrasyonu nedir yazısında bulursun.
Gönderi kodu, takip numarası ve barkod aynı şey mi?
Üçü birbirine yakındır ama aynı şey değildir: takip numarasını kargo firması verir, gönderi kodunu (referans numarasını) sen verirsin, barkod ise bu numaranın etikette okunur hâlidir. Programdan takip kurarken "hangi numarayı yazıyorum?" sorusu bu yüzden sorulur.
| Terim | Ne Demek? | Kim Verir? |
|---|---|---|
| Takip numarası | Kargo firmasının gönderiye verdiği numara; durum sorgusu bununla yapılır. Aras'ta 13 haneli kargo takip numarası, PTT'de 13 haneli barkod, Sürat'ta 14 haneli kargo takip numarası kullanılır. | Kargo firması |
| Gönderi kodu (referans) | Gönderiyi açarken senin yazdığın kod. Aras buna Müşteri Özel Kodu, Sürat Web Sipariş Kodu der; Yurtiçi'nde kargo anahtarı sipariş ya da irsaliye numaranı, fatura anahtarı fatura numaranı taşır. | Sen |
| Barkod | Numaranın çizgili ya da karekodlu hâli. El terminali okutunca gönderi bulunur ve kargo yönlendirilir. | Etikette basılıdır |
| Etiket | Koliye yapıştırılan; alıcıyı, adresi, telefonu ve barkodu taşıyan kâğıt. | Kargo firması, pazaryeri ya da sen |
| Ortak barkod | Pazaryerinin anlaşmalı kargo için verdiği etiket. Trendyol'da TEX ve Aras, Hepsiburada'da HepsiJet ve Aras gönderilerinde verilir. | Pazaryeri |
| Desi | Kolinin hacim ağırlığı: en × boy × yükseklik (cm) ÷ 3.000. 30 × 40 × 25 cm'lik koli 10 desidir; ücret desi ile kilodan büyük olana göre alınır. | Kargo firması ölçer |
Kolinin desisini göndermeden önce desi hesaplama aracıyla bul; birkaç santimlik kutu farkı bedeli değiştirir. Barkod etiketi ve desi tanımları Sürat Kargo'nun kargo terimleri sayfasında da yazar.
Kargo entegrasyonu nasıl çalışır?
Kargo entegrasyonu, gönderinin takip numarasını bulup durumunu kargo firmasından düzenli aralıklarla sorarak çalışır. Bir gönderinin yolu şöyledir:
- Sipariş gelir ya da sevk irsaliyesi kesilir.
- Koli kargoya verilir ve gönderi bir takip numarası alır.
- Numara siparişe ya da irsaliyeye yazılır; kaynağa göre kendiliğinden gelir, elle de girilir.
- Program numarayı kargo firmasının servisinden (ya da siparişi veren sitenin ve pazaryerinin verdiği durumdan) sorar: kargoya verildi, yolda, teslim noktasında, dağıtımda, teslim edildi.
- Teslim, iade ya da iptal olunca gönderi kapanır. Teslim edilemeyen ya da günlerdir hareketi olmayan gönderi uyarı verir.
Örneğin 28.09.2026'da 3 desilik bir koli verdin ve takip numarasını onayladığın sevk irsaliyesine yazdın. Program gönderiyi açar ve aynı gönderiyi en erken 90 dakikada bir kargo firmasından sorar. Koli teslim edildiğinde sana bildirim gelir ve gönderi kapanır.
Kargo entegrasyonu nasıl yapılır?
Kargo entegrasyonunu kargo firmasından web servis kullanıcısı alıp bilgileri programın kargo ayarına yazarak yaparsın. Beş adımda toplanır:
- Anlaşma: Kargo firmasıyla kurumsal (anlaşmalı) müşteri ol. Yurtiçi Kargo ve PTT web servis bilgisini yalnız kurumsal müşterisine verir; öbür firmalar müşteri ya da cari numarasını ister.
- Web servis bilgisi: Kullanıcı adı ve şifreyi al. Bu şifre internet şubesi şifren değildir.
- Programa yaz: Bilgileri programın kargo ayarına gir; takip numarası türünü (kargonun verdiği numara mı, kendi referansın mı) gönderilerine yazdığın koda göre seç.
- IP izni: Bazı firmalar sorguların geleceği sunucu IP adresini izin listesine ekler; programın gösterdiği adresi müşteri temsilcine bildirirsin.
- Dene: Kaydedince bağlantı denenir. Önce tek gönderiyle bak. Test kullanıcısıyla deniyorsan test ortamı kutusunu işaretle; gerçek gönderiler test ortamında görünmez.
Firmalara göre istenen bilgiler 31.10.2026 itibarıyla şöyle:
| Firma | Ne İstenir? | Nereden Alınır? | Dikkat |
|---|---|---|---|
| Yurtiçi Kargo | Web servis kullanıcı adı ve şifresi | Müşteri temsilcin ya da çalıştığın şube | Sunucu IP adresi Yurtiçi'ye bildirilir. |
| Aras Kargo | XML servis kullanıcı adı, şifre ve müşteri kodu | esasweb'de Entegrasyon > Entegrasyon İşlemleri > XML Servisleri > Kayıt Ol; Service Metod olarak GetQueryJSON seçilir | IP istemez. Şifre esasweb giriş şifren değildir. |
| DHL eCommerce (MNG Kargo) | Müşteri numarası ve Online Şube şifresi | DHL eCommerce şuben ya da müşteri temsilcin | Kalıcı şifre kullan, geçici şifre çabuk biter. Sunucu IP adresi yetkilendirilir. |
| PTT Kargo | Kurumsal müşteri numarası ve web servis şifresi | Sözleşmeli olduğun PTT başmüdürlüğü (işletme dairesi) | PTT, bilgileri vermeden önce 3. taraf gizlilik taahhütnamesi imzalatır. |
| Sürat Kargo | 10 haneli cari kodu ve web servis şifresi | ekargo.suratkargo.com.tr > Profilim > Web Servis Şifre | Şifre, gönderi çıkarırken kullandığın cari şifresi değildir. |
Sitede ve pazaryerinde kargo entegrasyonu nasıl yapılır?
Sitede ya da pazaryerinde kargoyu iki yoldan biriyle kurarsın ve hangisini seçtiğin, programa ne geleceğini belirler:
- Pazaryerinin anlaşmalı kargosu: Etiketi pazaryeri verir, kendi kargo hesabını bağlamazsın. Kargo bedeli hakedişinden düşülür; Trendyol kargo faturalarını ödemelerle birlikte haftada iki kez keser.
- Kendi kargo anlaşman: Gönderi kaydını kargo firmasının kendi ekranında ya da sitenin kargo ayarında açarsın, takip numarasını siparişe yazarsın. Kargo firmasını sitenin yönetim panelinde nasıl bağlayacağın altyapıya göre değişir; ikas, Shopify ve WooCommerce'in kendi yardım sayfalarına bak.
Ön muhasebe tarafında durum şöyle: Shopify, ikas ve IdeaSoft'ta siparişe takip numarası ve kargo firması girilince bu bilgi programa gelir. WooCommerce takip numarasını vermez. ikas'ta kargo için programda ayrıca bir bağlantı kurmazsın; ayrıntıları ikas entegrasyonu sayfasında anlattık. Altyapılara göre farkı e-ticaret entegrasyonu sayfasında tabloda görürsün.
Kargo bilgisi faturaya ve irsaliyeye nasıl girer?
İnternetten mal satışında kargo bilgisi faturada zorunlu alandır. 509 Sıra No.lu VUK Genel Tebliği'ne göre e-Arşiv faturada "Bu satış internet üzerinden yapılmıştır." ifadesinin yanında satışın yapıldığı web adresi, ödeme şekli ve tarihi, gönderiyi taşıyanın adı ya da unvanı ve VKN/TCKN'si, malın gönderildiği tarih ve iade bölümü bulunur. Bu alanların ayrıntısı e-Arşiv fatura nasıl kesilir yazısında.
Paketin içinde de belge olmalı: sevk irsaliyesi, e-İrsaliyenin bir örneği, irsaliye yerine geçen faturanın kâğıt çıktısı ya da yazarkasanın fatura bilgi fişi. İrsaliye düzenlemiyorsan faturayı koli kargoya verilmeden önce kesmen gerekir. Kargo firmasının ya da pazaryerinin sana kestiği kargo faturası ise senin giderindir ve gerçek usuldeysen KDV'sini indirirsin; nasıl işleneceği için pazaryeri komisyon faturası nasıl işlenir yazısına bak.
Kargo entegrasyonunda hata aldıysan ne yapmalısın?
Kargo entegrasyonu hatasında ilk bakılacak yerler şifre türü, takip numarası türü ve IP iznidir. Belirtiye göre kontrol listesi şöyle:
| Belirti | Olası Neden | Ne Yaparsın? |
|---|---|---|
| Kullanıcı adı ya da şifre kabul edilmedi | İnternet şubesi şifresini yazmışsındır; web servis şifresi ayrıdır. DHL eCommerce'te geçici şifre bitmiş olabilir. | Firmanın verdiği web servis bilgilerini yaz; gerekirse yenisini iste. |
| Bağlantı kuruldu ama gönderi bulunamıyor | Takip numarası türü yanlış seçilmiştir ya da test ortamı kutusu işaretlidir. | Türü, gönderiye yazdığın koda göre seç; gerçek gönderiler için test kutusunu kapat. |
| Yurtiçi ya da DHL eCommerce erişimi reddediyor | Sorguların geldiği sunucu IP adresi izin listesinde değildir. | Programın gösterdiği IP adresini müşteri temsilcine bildir. |
| "Az önce sorgulandı" uyarısı | Yurtiçi aynı numarayı 1 dakikada bir kez yanıtlar. | Bir dakika bekleyip yeniden sorgula. |
| Durum değişmiyor | Koli henüz kargo tarafından teslim alınmamıştır ya da 30 gündür hareket olmadığı için takip bitmiştir. | Numarayı kargonun kendi sayfasında sorgula, gerekirse şubeyle görüş. |
| Gönderi "gecikti" görünüyor | Kargoya verilmiş ama 5 gündür yeni hareket yoktur. | Kargo firmasını ara; teslim edilemeyen gönderi panoda uyarı olarak görünür. |
"Kargo entegrasyonu yapıldı" ne demek?
Bu ifade kargo firmasına ya da panele göre değişir ve genel bir tanımı yoktur. Çoğu zaman gönderi bilgisinin kargo firmasının sistemine elektronik olarak iletildiğini gösterir; kolinin fiziksel olarak teslim alındığını göstermez. Emin olmak için numarayı kargo firmasının kendi sayfasında sorgula: orada şubeye ulaşma ya da teslim alma hareketi görünmedikçe koliyi yolda sayma.
Uygun Muhasebe'de kargo takibi nasıl çalışır?
Kargo bilgisi bir ön muhasebe programı içinde irsaliyeye ve siparişe bağlı durur. Uygun Muhasebe'de gönderi üç yoldan açılır: sevk irsaliyesi onaylanınca (takip numarası ve tanınan kargo firması varsa), pazaryeri ya da site siparişine takip numarası gelince, ya da elle. Yurtiçi Kargo, Aras Kargo, DHL eCommerce (MNG Kargo), PTT Kargo ve Sürat Kargo bağlantıları entegrasyonlar sayfasında "Hazır" görünür; hangi firmaların sunulduğunu Kargo ayarlarında görürsün. İlk kurulumu birlikte kontrol ederiz.
- İrsaliyedeki numara: Firmanın hesabını bağlarsan numara o firmanın servisinden sorgulanır, hareket geçmişi irsaliyede görünür. Hesap yoksa gönderi listede kalır ve "Kargo nerede?" bağlantısıyla firmanın sayfasından izlenir. Sevk irsaliyesi için e-İrsaliye programı sayfasına bak.
- Site ve pazaryeri siparişi: Durum siparişi veren yerden gelir, kargo firmasına ayrıca sorulmaz.
- Uyarılar: Teslim edilen ya da teslimde sorun çıkan gönderi bildirilir; teslim edilemeyen ve geciken gönderiler panoda görünür.
- Etiket: Seçtiğin siparişlerin etiketini 10x10 cm termal kâğıda ya da A4'e altı tane basarsın. Trendyol ve Hepsiburada'nın ortak etiketi de indirilir; ortak etiket her gönderide yoktur (Trendyol'da TEX ve Aras, Hepsiburada'da HepsiJet ve Aras).
- Yapmadığı: Kargo firmasında gönderi kaydı açmaz; kaydı firmanın ya da sitenin kendi ekranından açarsın.
Pazaryeri tarafındaki etiket ve kargo kuralları için pazaryeri entegrasyonu sayfasına bakabilirsin.
Bu yazı genel bilgi içindir; vergi ve hukuk kararlarında mali müşavirine danış. Mevzuat değiştikçe yazıyı güncelliyoruz; güncelleme tarihi başlığın altında.