Yurtiçi Kargo entegrasyonu: sözleşmeden etikete, desiden pazaryerine giden takip numarasına
Yurtiçi Kargo entegrasyonu, Yurtiçi Kargo ile yaptığınız kurumsal sözleşmeyi sipariş yönetim panelinize bağlayarak siparişten gönderi kaydı açmayı, takip numarasını ve etiketi almayı, bu numarayı da siparişin geldiği satış kanalına iletmeyi otomatik hâle getiren bağlantıdır. Bu rehberde Ekim 2026 itibarıyla Yurtiçi Kargo'nun kendi sayfalarında yazan gönderi kurallarını satıcı gözüyle bir araya getirdik. Yox İş Ortağım'da kurulumun hangi sırayla ilerlediğini, pazaryerinin anlaşmalı Yurtiçi kargosu ile kendi sözleşmeniz arasındaki farkı ve hangi pakette kaç kargo firması bağlayabileceğinizi tablolarla anlatıyoruz.
Yurtiçi Kargo entegrasyonu nedir ve sipariş akışında neyi değiştirir?
Yurtiçi Kargo entegrasyonu, siparişteki alıcı, adres ve paket bilgisinin bir yazılım üzerinden Yurtiçi Kargo sistemine aktarılması ve karşılığında gönderi kodunun geri alınmasıdır. Yurtiçi Kargo 1982'de Arıkanlı Holding çatısı altında kuruldu; firmanın hakkımızda sayfasına göre 81 ilde ve KKTC'de, 18 bölge müdürlüğü, 33 aktarma merkezi ve 1.200'den fazla birimle hizmet veriyor. Bu yaygınlık, firmayı hem kendi sözleşmesiyle gönderen satıcıların hem de pazaryerlerinin kargo listelerinde karşınıza çıkaran bir adres yapıyor.
Yox İş Ortağım'da Yurtiçi bağlantısı, firmanın sözleşmeli müşterilerine açtığı web servis üzerinden çalışır ve dört iş üstlenir:
- Sipariş hazır olduğunda Yurtiçi Kargo tarafında gönderi kaydı açar, dönen takip numarasını siparişe yazar.
- Yurtiçi etiketi döndürdüğünde barkodlu etiketi panelden basılabilir hâle getirir.
- Gönderinin durumunu Yurtiçi'den sorgular; kargoya verildi, yolda, teslim edildi bilgisi siparişin üzerinde görünür.
- Takip numarasını ve kargo firmasını siparişin geldiği pazaryerine ya da sitenize iletir; pazaryerinin kendi kargo kuralı her zaman önce gelir.
Elle çalışmak ile panel üzerinden çalışmak arasındaki fark
| İş | Entegrasyon olmadan | Yox İş Ortağım ile |
|---|---|---|
| Alıcı ve adres bilgisi | Pazaryeri ekranından kopyalanıp Yurtiçi ekranına yazılır | Siparişten gönderi kaydına aktarılır |
| Takip numarası | Her kanalın paneline tek tek girilir | Siparişin geldiği kanala iletilir |
| Etiket | Her gönderi için Yurtiçi ekranından ayrı alınır | Yurtiçi döndürdüğünde panelden basılır; toplu etiket alınabilir |
| Kargo durumu | Gönderi koduyla Yurtiçi sitesinden sorgulanır | Sipariş listesinde görünür |
| Birden çok kargo firması | Her firmanın ekranı ayrı açılır | Birincil kargo seçilir, kayıt seçilen hesapta açılır |
Fark sipariş sayısı arttıkça büyür: elle çalışan bir satıcıda yanlış yazılmış tek bir hane, koli yolda olduğu hâlde siparişin kanalda geç gönderilmiş görünmesine yol açabilir. Kurye çağırma gibi işler Yurtiçi'nin kendi kanallarında kalır.
Yurtiçi Kargo'da sözleşmeli müşteri olmak: bağlantının ön şartı
Web servis bilgileri, Yurtiçi Kargo ile imzalı sözleşmesi olan işletmeye tanımlanır; şubeye gidip tek tek kargo veren bireysel bir gönderici bu bilgileri almaz. Yurtiçi'nin kargo terimleri sözlüğü sözleşmeli müşteriyi, hizmetin kapsamı ve koşulları karşılıklı imzayla belirlenmiş müşteri olarak tanımlar. Aynı sözlük iki temel ödeme tipini de ayırır: ücreti göndericinin ödediği Peşin Ödemeli (P.Ö.) ve alıcının ödediği Alıcı Ödemeli (A.Ö.). E-ticarette gönderilerin büyük kısmı ücreti satıcının üstlendiği P.Ö. tipinde açılır; hangisini kullanacağınız sözleşmede yazar.
Yurtiçi, Self Servis ve tahsilatlı gönderi gibi kurumsal hizmetler için başvuru adresi olarak bölge müdürlüklerindeki satış yetkililerini gösterir. Web servis talebini de aynı kişiye ya da çalıştığınız şubenin kurumsal müşteri temsilcisine iletirsiniz.
Satış yetkilisiyle görüşmede netleştirmeniz gerekenler
- Gönderilerin hangi ödeme tipinde açılacağı (peşin ödemeli, alıcı ödemeli, tahsilatlı) ve her tip için ayrı kullanıcı tanımı gerekip gerekmediği
- Kolilerin hangi adresten ve hangi şube üzerinden çıkacağı; birden fazla deponuz varsa her çıkış noktası için ayrı müşteri kodu açılıp açılmayacağı
- Bağlantıda IP adresi kısıtı uygulanıp uygulanmadığı
- Canlıya geçmeden önce kullanılabilecek bir test kullanıcısı olup olmadığı
- Desi başına ücretin, hat farkının ve ek hizmet bedellerinin sözleşmede nasıl yazıldığı
Sözleşmeniz yoksa nereden başlarsınız?
Yurtiçi'nin sitesindeki şube sorgulama aracıyla deponuza en yakın şubeyi bulup kurumsal satış ekibine yönlendirilmeyi isteyebilir ya da 444 99 99 çağrı merkezinden bölge müdürlüğünüzün iletişim bilgisini alabilirsiniz. Görüşmeye aylık tahmini gönderi adedinizi, ortalama koli ölçünüzü ve hangi pazaryerlerinden satış yaptığınızı götürmek, size uygun tarifenin hızlı çıkmasını kolaylaştırır.
Web servis, Self Servis ve internet şubesi: hangi bilgi nerede kullanılır?
Panelde istenen bilgi web servis kullanıcı adı ve web servis şifresidir; Self Servis ya da Bireysel İnternet Şubesi giriş bilgilerinin bununla aynı olduğunu varsaymayın. Yurtiçi, kurumsal müşterilerine üç ayrı giriş noktası sunar ve bunlar sık karıştırılır. Self Servis, Yurtiçi'nin tanımıyla internet bağlantısı olan her yerden kargo hizmetlerine ulaşılan çevrim içi yönetim ekranıdır; sipariş girişi, barkod basma, tahsilat yönetimi, e-posta bilgilendirme, tek tuşla kurye çağırma, rapor ve adres yönetimi burada yapılır.
| Giriş noktası | Kim kullanır | Ne işe yarar | Entegrasyondaki yeri |
|---|---|---|---|
| Web servis | Sözleşmeli müşterinin kullandığı yazılım | Gönderi kaydını yazılımın açması, durum sorgusu | Yox İş Ortağım bu bilgilerle bağlanır |
| Self Servis | Kurumsal müşteriler | Elle ya da toplu gönderi girişi, barkod, kurye çağırma, rapor | Kurye ve raporlar için kullanmayı sürdürürsünüz |
| Bireysel İnternet Şubesi | Bireysel göndericiler | Tek tek gönderi oluşturma ve takip | Entegrasyonda kullanılmaz |
Elinizdeki bilginin hangisi olduğundan emin değilseniz panele girip test etmek en kısa yoldur: bilgi yanlışsa bağlantı testi başarısız olur ve canlı siparişe dokunulmadan düzeltirsiniz. İki yöntem birbirini dışlamaz; birçok satıcı gönderi kaydını panelden açar, kurye çağrısını ve dönem sonu raporlarını Self Servis'ten yürütür.
Kapıda ödemeli siparişleriniz varsa: tahsilatlı gönderi
Yurtiçi'nin tahsilatlı gönderi hizmetinde ürün bedeli teslimat anında alıcıdan alınır ve göndericiye aktarılır. Bunun için ayrı bir tahsilatlı gönderi sözleşmesi gerekir ve siparişlerin Yurtiçi'ye web entegrasyonu ya da Self Servis üzerinden iletilmesi şarttır. Firmanın açıklamasına göre nakit tahsilatlar mali kontrolden sonra 3 iş günü içinde hesabınıza geçer; kartla tahsilat İş Bankası ile geliştirilen bir uygulamayla teslimatta yapılır. Kapıda ödeme kullanıyorsanız kurulumdan önce bunu bize iletin; hangi gönderi tipiyle çalışacağınızı birlikte netleştiririz.
Yox İş Ortağım'da Yurtiçi Kargo entegrasyonu adım adım kurulum
Web servis bilgileriniz elinize ulaştığında Yurtiçi Kargo entegrasyonunu canlıya almak birkaç adımlık bir iştir; isterseniz her adımı ekran paylaşımıyla birlikte yaparız. Sıralama şöyle:
- Yox İş Ortağım'a başvurun ve 3 günlük ücretsiz denemeyi başlatın; ön görüşmede hangi kanallardan sipariş aldığınızı ve Yurtiçi ile hangi ödeme tipinde çalıştığınızı konuşuruz.
- Satış kanallarınızı kanalların resmî API anahtarlarıyla bağlayın; pazaryeri mağaza şifrenizi kimseyle paylaşmazsınız.
- Panelin Kargo bölümünde Yurtiçi Kargo'yu seçip web servis kullanıcı adını ve şifresini girin.
- Bağlantıyı test et düğmesiyle bilgilerin doğrulandığını görün; hata alırsanız önce fazladan boşluk ve harf hatasına, sonra temsilcinizin tanımladığı kullanıcı tipine bakın.
- Birden çok kargo hesabınız varsa siparişlerin hangi hesapla gideceğini belirleyen birincil kargoyu seçin.
- İlk gerçek siparişte gönderi kaydını, etiketi ve kanala giden takip numarasını kontrol edin.
İlk siparişte kontrol edilecek üç nokta
Birincisi, Yurtiçi tarafında açılan kaydın alıcı adı, ilçe ve telefonla siparişe birebir uyması. İkincisi, basılan etiketin yazıcınızda okunaklı çıkması ve etiketteki gönderi kodunun siparişteki numarayla aynı olması. Üçüncüsü, takip numarasının siparişin geldiği kanalda görünmesi. Bu üçü tuttuğunda aynı akış sonraki siparişlerde değişmeden tekrarlanır.
Yurtiçi'yi ikinci kargo firmasıyla birlikte kullanmak
Bazı satıcılar ağır ya da büyük ölçülü ürünlerde bir firmayı, küçük kolilerde başka bir firmayı tercih eder. Panelde birden fazla kargo hesabı bağlıysa birincil kargoyu siz seçersiniz; siparişin hangi firmayla gideceğine siz karar verirsiniz, panel kendiliğinden firma değiştirmez. Yurtiçi'nin yanında ikinci bir hesap düşünüyorsanız Aras Kargo entegrasyonu sayfasında aynı kurulumun Aras tarafını bulabilirsiniz.
Pazaryeri siparişlerinde Yurtiçi: anlaşmalı kargo mu, kendi sözleşmeniz mi?
Bir pazaryeri siparişinin Yurtiçi Kargo ile gitmesi iki ayrı anlaşmadan birine dayanır: pazaryerinin Yurtiçi ile yaptığı anlaşma ya da sizin Yurtiçi ile imzaladığınız sözleşme. Trendyol'un geliştirici dokümanındaki kargo firmaları listesinde Yurtiçi, YKMP koduyla Yurtiçi Kargo Marketplace adıyla yer alır. Bu kayıt Trendyol'un anlaşmasıdır; web servis bilgileriniz bu gönderilerde kullanılmaz.
| Konu | Pazaryerinin anlaşmalı Yurtiçi kargosu | Kendi Yurtiçi sözleşmeniz |
|---|---|---|
| Anlaşmanın tarafları | Pazaryeri ve Yurtiçi Kargo | Siz ve Yurtiçi Kargo |
| Trendyol'daki model | Trendyol öder; listede YKMP kodu | Satıcı öder |
| Etiketin kaynağı | Pazaryerinin ortak etiket servisi | Yurtiçi web servisinden dönen etiket |
| Takip numarası | Siparişle birlikte gelir | Yox İş Ortağım, Yurtiçi'den aldığı numarayı kanala iletir |
| Kargo ücreti | Pazaryerinin kargo kesintisi kuralına göre yansır | Yurtiçi'nin size kestiği faturayla ödenir |
| Web servis bilgisi | Gerekmez | Gerekir |
Trendyol'da durumları kim günceller?
Trendyol'un sipariş servisleri dokümanına göre Trendyol öder modelinde etiket ortak etiket servisinden alınır ve siparişle gelen takip numarası kullanılır. Satıcı öder modelinde etiketi satıcı üretir, takip numarasını da Trendyol'a kendisi bildirir. Her iki modelde de kargoya verildi ve teslim edildi durumlarını satıcı değil, kargo firmasından gelen bilgi değiştirir; koli kargo firmasına teslim edilip okutulduktan sonra müşteri siparişi iptal edemez. Trendyol ayrıca gönderide kullanılan firmanın, anlaşmanızda onaylı firmayla eşleşmesini ister; eşleşmezse ürünleriniz yayınlanmayabilir. Kanalın diğer kurallarını Trendyol entegrasyonu sayfasında topladık.
Hepsiburada, n11 ve diğer kanallar
Hepsiburada ve n11 de satıcılarına anlaşmalı kargo seçenekleri sunar; Yurtiçi'nin bu kanallarda hangi modelle açık olduğu ve kendi sözleşmenizle gönderime izin verilip verilmediği mağaza ve kategori ayarına göre değişebilir. Güncel durumu satıcı panelinizin kargo ayarlarından kontrol edin. Kanal ayrıntıları için Hepsiburada entegrasyonu ve n11 entegrasyonu sayfalarına bakabilirsiniz.
Yurtiçi Kargo ücreti nasıl hesaplanır: desi, hat ve ücrete esas ağırlık
Yurtiçi Kargo'da ücret, ücrete esas ağırlık ile gönderinin gideceği hattın kesiştiği satırdan okunur; gerçek ağırlık ile hacimden bulunan ağırlıktan büyük olanı esas alınır. Yurtiçi'nin fiyat rehberi ve sık sorulan sorular sayfası bu hesabın kurallarını açıkça yazar:
| Kural | Yurtiçi Kargo'nun açıklaması |
|---|---|
| Hacim | En x boy x yükseklik (cm) / 1.000 = dm³ |
| Hacimsel ağırlık (desi) | Yurt içinde dm³ değeri 3'e bölünür; cm çarpımını 3.000'e bölmekle aynı sonucu verir |
| Ücrete esas ağırlık | Gerçek ağırlık (kg) ile hacimsel ağırlıktan büyük olanı |
| Çok parçalı gönderi | Her parça ayrı hesaplanır, sonuçlar toplanır |
| Küsurat | 0,10–0,49 atılır; 0,50–0,99 bir üst tam sayıya yuvarlanır |
| Hat | Aynı şehir merkezi şehir içi; 1–200 km yakın, 201–600 km kısa, 601–1.000 km orta, 1.000 km üzeri uzun hat |
| 50'nin üzeri | 50'lik satırın ücretine, aşan her birim için o hattın beher (+) ücreti eklenir |
| Standart kapsam | Tek parçada 100 kg ya da 900 dm³ hacim ve 3 m uzunluğa kadar; üzeri özel taşıma |
Örnek hesap: iki koli, iki farklı sonuç
Koli A 40 x 30 x 25 cm ölçülerinde ve 4 kg geliyor: 40 x 30 x 25 = 30.000 cm³, yani 30 dm³; 30 / 3 = 10. Ücrete esas ağırlık 10 olur, çünkü hacim gerçek ağırlığı geçiyor. Koli B 30 x 20 x 15 cm ve 3,6 kg: 9.000 cm³ = 9 dm³; 9 / 3 = 3. Bu kez gerçek ağırlık büyük, 3,6'nın küsuratı 0,50'yi geçtiği için ücrete esas ağırlık 4 olur. Koli ölçüsünü küçültmek çoğu zaman tartıdan daha çok kazandırır. Kendi ölçülerinizi desi hesaplama aracıyla deneyebilir, kargo bedelinin ürün başına kârınıza etkisini kâr hesaplama aracında görebilirsiniz.
Kargo takibi, teslim edilemeyen gönderi ve şube saatleri
Yurtiçi Kargo'da bir gönderi, faturada yer alan 12 haneli gönderi kodu başta olmak üzere fatura numarası, ambar tesellüm numarası ya da çağrı numarasıyla sorgulanır. Alıcı aynı sorguyu 444 99 99 çağrı merkezinden ya da 4343'e NEREDE yazıp boşluk bırakarak numarayı göndererek de yapabilir. Panelde bu adıma gerek kalmaz: Yurtiçi'den sorgulanan durum siparişin üzerinde görünür, müşteriniz sorduğunda cevabı sipariş listesinden verirsiniz.
Alıcı adreste yoksa: 3 günlük bekleme süresi
Teslim edilemeyen gönderide adrese ihbar notu bırakılır. Yurtiçi'nin açıklamasına göre kargo, teslimat şubesine geldiği tarihten itibaren 3 gün şubede bekletilir; alıcı almazsa göndericiye iade edilir. Bu süre kısadır: durum siparişte teslim edilemedi olarak göründüğünde alıcıyı aramak, gereksiz bir iade yolculuğunu ve ikinci kargo bedelini önleyebilir.
Şubeye teslim saatleri ve aynı gün çıkış
Şubelere gönderi hafta içi 18.00'e, cumartesi 17.00'ye kadar teslim edilebilir; pazar ve resmî tatillerde şubeler kapalıdır. Pazaryerlerinin kargoya verme süreleri işgünü üzerinden işlediği için etiket basım saatinizi şube kapanışına göre planlamak, siparişin geç kargolanmış sayılmasını önlemenin en basit yoludur.
İade ve Kolay İade hizmeti
Yurtiçi'nin Kolay İade hizmeti, firmayla iade anlaşması yapmış e-ticaret sitelerinin müşterilerine iadeyi teslim noktalarına ve akıllı kargo dolaplarına bırakma imkânı verir. Bu, web servis bağlantısından ayrı konuşulan bir anlaşmadır; iade düzeninizi sözleşme görüşmesinde ayrıca sorun.
Yurtiçi Kargo bağlantısı hangi Yox İş Ortağım paketinde, kaç firma bağlanır?
Kargo entegrasyonu Büyüme paketiyle başlar; Başlangıç paketinde kargo bağlantısı yoktur ve takip numarası siparişe elle girilir. Panelde 57 kargo ve lojistik firması tanımlıdır, Yurtiçi Kargo kullanıma hazır firmalardandır ve paketinizdeki kargo firması hakkından birini kullanır.
| Paket | Aylık fiyat | Kargo firması bağlantısı | Satış kanalı | Aylık sipariş |
|---|---|---|---|---|
| Başlangıç | ₺499 | Yok (takip numarası elle) | 1 | 100 |
| Büyüme | ₺999 | 1 firma | 3 | 500 |
| Profesyonel | ₺1.999 | 2 firma | 5 | 2.000 |
| Kurumsal | ₺3.999 | 5 firma | Sınırsız | 5.000 |
| Enterprise | ₺7.999 | Sınırsız | Sınırsız | Sınırsız |
Yıllık ödemede %20 indirim uygulanır. Yurtiçi'yi tek kargo firması olarak kullanacaksanız Büyüme paketi yeterlidir; ikinci bir firmayla bölge ya da ürün tipine göre ayırma yapacaksanız Profesyonel paketten itibaren iki firma bağlanır. Kargo bedelinin sipariş kârına etkisini izlemek isterseniz ürün ve kanal bazında kâr ile kesinti raporları Profesyonel paketten itibaren açılır. Paketlerin bütün limitlerini paket karşılaştırmasında görebilirsiniz.
Yurtiçi Kargo entegrasyonunda canlıya geçiş kontrol listesi ve sık hatalar
Canlıya geçmeden önce kontrol listesi
- Sözleşmedeki ödeme tipi ile panele girdiğiniz web servis kullanıcısı aynı tipe mi ait?
- Gönderici adresi ve çıkış şubesi sözleşmedeki bilgiyle eşleşiyor mu?
- Bağlantıyı test et başarılı sonuç verdi mi?
- Birincil kargo doğru hesap olarak seçildi mi?
- Pazaryerinin anlaşmalı kargosuyla çıkacak siparişler ile kendi sözleşmenizle çıkacaklar ayrıldı mı?
- Etiket yazıcınızda deneme etiketi okunaklı çıkıyor mu?
Satıcıların en sık düştüğü hatalar
- Self Servis giriş bilgisini web servis bilgisi sanmak ve testte takılmak
- Etiketi basıp koliyi şubeye geç teslim etmek: numara kanala gider ama kargo hareket görmez
- Ölçüsü büyük koliyi tartıya göre fiyatlamak; ücrete esas ağırlık hacimden gelir
- Teslim edilemedi durumunu 3 günlük bekleme süresi dolana kadar fark etmemek
- Web servis şifresi değiştiğinde paneldeki bilgiyi güncellemeyi unutmak
Bu listeyi kurulum görüşmesinde sizinle birlikte tek tek geçebiliriz; Yurtiçi temsilcinizden gelen bilgilerin hangisinin panele girileceğinden emin değilseniz bize yazın. Diğer kargo, pazaryeri ve muhasebe bağlantılarının tamamı entegrasyon sayfamızda listelidir. Hiçbir ilan ya da sipariş, siz onaylamadan değişmez; Yurtiçi bağlantısını kendi siparişlerinizle 3 günlük denemede görebilirsiniz.
Son kontrol: 13 Ekim 2026
