E-ticaret sitenize sipariş geldiğinde 3 yol var: (1) Manuel kargoya götür — günde 50 sipariş = 4 saat kayıp; (2) Yurtiçi panele tek tek gir — 30 sn × 50 = 25 dakika; (3) API entegrasyonu — sipariş gelince otomatik etiket bas, ekleyince son. Bu yazıda Yurtiçi Kargo API entegrasyonunu A'dan Z'ye anlatıyoruz.
Yurtiçi Kargo entegrasyon avantajları
- Sipariş geldiği anda etiket basılır (5 saniye)
- Takip kodu müşteriye otomatik SMS/e-posta
- Adres validasyonu (yanlış adres erken yakalanır)
- Çoklu kargo şirketi seçimi (kullanıcı tercih eder)
- Kapıda ödeme entegrasyonu
- İade işlemi otomatik
Yurtiçi sözleşme süreci
Adım 1: Müşteri hesabı
yurticikargo.com/kurumsal üzerinden kurumsal müşteri başvuru. Gerekenler:
- Vergi levhası
- İmza sirküleri
- Aylık tahmini gönderim sayısı
- Ürün tipi (kuru gıda, taze, tekstil vb.)
Adım 2: API erişimi
Sözleşme imzalanınca API key verilir. Test ortamı + canlı ortam ayrı.
Adım 3: Komisyon yapısı
| Aylık Gönderim | Standart Fiyat İndirimi |
|---|---|
| 0-50 | %0 (liste fiyatı) |
| 50-200 | %15-20 |
| 200-500 | %25-35 |
| 500+ | %40+ |
Aylık 50'den fazla gönderiyorsanız mutlaka sözleşme yapın — ciddi tasarruf.
API entegrasyon adımları
1. SOAP/REST API seçimi
Yurtiçi hem SOAP hem REST sunar. REST daha modern, JSON tabanlı. Yeni projeler REST kullansın.
2. Kimlik doğrulama
POST /api/auth
{
"username": "USER",
"password": "PASS",
"wskUserName": "WSK_USER",
"wskPassword": "WSK_PASS"
}
3. Gönderi oluşturma
Sitenizden sipariş geldiğinde:
POST /api/shipment/create
{
"senderInfo": {...},
"receiverInfo": {
"name": "Müşteri",
"address": "...",
"city": "İstanbul",
"phone": "+90..."
},
"shipmentInfo": {
"weight": 1.5,
"dimension": "30x20x15",
"productCode": "...",
"deliveryType": "STANDARD"
}
}
4. Etiket basımı
Cevap olarak PDF gönderir. Yazıcıya direkt bas, kutuya yapıştır.
5. Takip kodu
Cevapta trackingNumber var. Müşteriye SMS:
"Siparişiniz kargoya verildi. Takip: YK1234567890"
Çoklu kargo şirketi yönetimi
Tek kargo şirketine bağlı olmayın — bizim altyapımızda 4 entegrasyon hazır:
- Yurtiçi: en yaygın
- Aras: büyük şehirlerde hızlı
- MNG: küçük yerleşim
- Sürat: ekonomik
Müşteri checkout'ta tercih eder, fiyat farkı görür.
Kapıda ödeme
Türkiye'de hâlâ %25 sipariş kapıda ödemeli. Yurtiçi destekliyor:
- Hizmet bedeli: %2-3 sipariş tutarına
- Müşteri kart/nakit ödeyebilir
- Para 2 iş günü sonra hesabınıza
Soğuk zincir
Balık, et, taze gıda için Yurtiçi'nin Soğuk Zincir servisi var. -2°C ila +8°C teslim. Ek ücret %30-40.
Aras / MNG / Sürat alternatifleri
| Şirket | Avantaj | Dezavantaj |
|---|---|---|
| Yurtiçi | En yaygın, kalitelı | Standart fiyat yüksek |
| Aras | Büyük şehirde hızlı, soğuk zincir | Köyde zayıf |
| MNG | Küçük yerleşimde iyi | Hız orta |
| Sürat | Ekonomik | Kalite değişken |
İade yönetimi
Müşteri iade etmek istediğinde:
- Sitenizde "İade Et" butonu
- Sistem Yurtiçi'ye iade talebi gönderir
- Yurtiçi müşteriye iade kodu yollar
- Müşteri pakete iade kodu yapıştırır + kargoya verir
- Size geldiğinde inceleme + para iade
Bütçe
- API entegrasyonu (E-Ticaret paketinde dahil): 0₺
- Tek başına entegrasyon: 4.999₺ tek seferlik
- Çoklu kargo entegrasyonu: 7.999₺ tek seferlik
Sıkça Sorulan Sorular
Aylık az gönderim için API gerek mi?
Aylık 30'dan fazla gönderiyorsanız evet — manuel zaman kaybı.
Etiket yazıcısı şart mı?
Termal etiket yazıcısı 2.000-4.000₺. Aylık 100+ gönderim varsa amortismanı 1 ayda.
API çalışmazsa manuel girişe dönebilir miyim?
Evet — Yurtiçi paneli hâlâ açık. API yedek olarak kullanılır.
Sonuç
Kargo API entegrasyonu e-ticaret operasyonunu 10x hızlandırır. E-Ticaret paketimizde dahil.