Hızlı Arama

Kargo API entegrasyonu ile sipariş bilgilerinizi anlaşmalı kargo firmanıza otomatik iletebilirsiniz. Barkodu yazdırdığınızda firma tarafında sipariş kaydı hazır olur; müşteriniz de Önceki Siparişlerim ekranından kargo durumunu anlık takip edebilir.

Kurulum tamamlandıktan sonra desteklenen firmalarda süreç otomatik işler: kargo firmasından gelen duruma göre sipariş durumu güncellenir, müşteriye e-posta ve (SMS modülü kuruluysa) SMS bilgilendirmesi gider.

Ne işe yarar?

• Siparişi kargo firmasına tek tıkla gönderirsiniz; elle web paneline tekrar girmeniz gerekmez.
• Takip numarası ve kargo bağlantısı siparişe işlenir.
• Müşteri hesap panelinden kargonun nerede olduğunu görür.
• Cron desteği olan firmalarda teslimat / yolda durumu siparişe otomatik yansır.

Kurulum adımları

1. Kargo > Kargo Firmaları menüsünden kullanacağınız kargo firmasını ekleyin (veya mevcut kaydı düzenleyin). Firma adı, sitede ve sipariş ekranında görünen isimdir.
2. Kargo > Kargo API Entegrasyon sayfasına gidin. İlgili firmanın sekmesini açın; kargo firmasından aldığınız kullanıcı / şifre / token bilgilerini girin.
3. Aynı sekmede Kargo Firma alanından, 1. adımda tanımladığınız firmayı seçin ve kaydedin.
4. Anlaşmanız olmayan sekmeleri boş bırakabilirsiniz. Her sekmenin üstünde o firmaya özel kısa kurulum notu vardır.

Not: Aras, Yurtiçi ve eski DHL (MNG) SOAP bağlantısı için sunucuda SOAP desteği açık olmalıdır. Yurtiçi gibi bazı firmalar yalnızca izin verilen IP adreslerinden bağlantı kabul eder; sunucu IP’nizi görmek için sitenizdeki ip.php sayfasını kullanabilirsiniz.

Siparişi kargo firmasına gönderme

1. Siparişler > Gelen Siparişler (veya ilgili sipariş düzenleme) ekranını açın.
2. Gönderilen Kargo Firması alanından API kurulumunu yaptığınız firmayı seçin.
3. Açılan Kargo API Gönderim formunda firmanın istediği ek bilgileri doldurun (gönderim tipi, desi, ödeme tipi vb.).
4. Kargo API Gönder düğmesine tıklayın. Sonuç anında ekranda görünür; başarılıysa takip numarası siparişe yazılır.

Bu adımdan sonra müşteriler sipariş takip / önceki siparişler bölümünden kargolarını izleyebilir.

Otomatik sipariş durumu güncelleme (Cron)

Bazı kargo entegrasyonlarında otomatik durum güncelleme vardır. İlgili cron-*.php dosyasını sunucu cron servisinize ekleyerek (önerilen aralık: 15 dakikada bir) yolda / teslim edildi durumlarını siparişe işletebilirsiniz.

Cron desteği bulunan entegrasyonlar:

• Aras Kargo → /cron/cron-aras.php
• DHL (MNG) Kargo → /cron/cron-mng.php
• Sürat Kargo → /cron/cron-surat.php
• Yurtiçi Kargo → /cron/cron-yurtici.php
• PTT Kargo → /cron/cron-ptt.php
• Sendeo (Kolay Gelsin) → /cron/cron-sendeo.php
• UPS Kargo → /cron/cron-ups.php
• Bolt Kargo → /cron/cron-bolt.php
• Hepsijet → /cron/cron-hepsijet.php
• Kargonomi → /cron/cron-kargonomi.php
• Basit Kargo → /cron/cron-basit.php

Hosting cron veya cron-job.org ile şu adresi çağırabilirsiniz:

Örnek:
https://<domain-adınız>/cron/cron-surat.php

Kullandığınız her kargo firması için kendi cron adresini ayrı ayrı tanımlayın. cPanel, Plesk, DirectAdmin ve diğer panellerde komut örnekleri yukarıdaki yardım sayfasında yer alır.

Desteklenen kargo API’leri

Panelde şu entegrasyon sekmeleri bulunur: Aras, Basit Kargo, Bolt, Entegra, Hepsijet, Kargonomi, Loomis, Mikro, DHL (MNG), Postman (Deposerileti), PTT, Sendeo, Sürat, UPS, Yurtiçi.

Her firmanın API bilgileri o firmanın şubesi / kurumsal paneli / destek birimi tarafından verilir. Anlaşmanız yoksa ilgili sekmeyi doldurmanıza gerek yoktur.

Sık karşılaşılan noktalar

• Önce Kargo Firmalarında firma kaydı, sonra Kargo API Entegrasyonda o firmayı seçmek gerekir; seçim yapılmazsa sipariş ekranında API formu açılmaz.
• Hepsijet alanları Hepsiburada satıcı girişi değil; Hepsijet’in verdiği API ve depo kodlarıdır.
• Sendeo için API kullanıcısı sube.kolaygelsin.com üzerinden tip API olarak açılır.
• UPS’te müşteri no / kullanıcı / şifreyi kaydedip sayfayı yeniledikten sonra Semt / Şehir listesi dolar.
• Cron çalışmazsa sipariş durumları otomatik ilerlemez; müşteri takibi için takip numarası yine siparişte kalır, ancak “teslim edildi” gibi güncellemeler elle yapılır.
  
  Cron kurulum rehberi: Cron nasıl eklenir?