Kargo firması web servisi bağlantısı
Firmanın web servisine gönderi açma, iptal etme ve sorgulama çağrıları bağlanır; yanıtlar ve hata kodları sipariş akışına doğru şekilde eşlenir.
Kurulumda
Kargo Entegrasyonu
Sipariş kargoya verilene kadar geçen her adım panelin içinde kalmalı.
Kargo firmasının web servisi ile mağazanız arasındaki bağ tarafımızca kurulur: gönderi sipariş ekranından açılır, barkod etiketi basılır, takip numarası siparişe yazılır ve durum kendiliğinden akar. Kargo firması biz değiliz; sözleşme ve tarife sizinle kargo firması arasında kalır.
Kargo firması entegrasyonları
Yurtiçi KargoArasMNGSüratPTT Kargo
Dolu işaretli firma için entegrasyon uçtan uca tarafımızca yazıldı ve çalışıyor. Kesik çizgili firmalar, o firmanın web servisi dokümanına göre aynı desenle kurulur.
Takip no siparişe yazıldıMüşteri kendi hesabından görüyor
Kapsam
Kargo entegrasyonu, takip numarası alanı açmaktan ibaret değildir.
Aşağıdaki altı iş birlikte ele alınır. Biri eksik kalırsa entegrasyon ilk gün çalışır görünür, sonra ya durum akışı sessizce durur ya da her sipariş için kargo firmasının kendi ekranına ayrıca girilmeye devam edilir.
Barkod ve gönderi etiketi
Code128 barkodu ve etiket görünümü kendi sunucunuzda üretilir; alıcı bilgisi barkod çizdirmek için hiçbir dış servise gönderilmez.
Kurulumda
Adres ve il/ilçe eşlemesi
Kargo firmasının beklediği il ve ilçe kodları mağaza adres verisiyle eşlenir; eşleşme bulunamadığında gönderi düşmez, adres tam metin olarak iletilir.
Kurulumda
Otomatik durum takibi
Kargo firması bildirim göndermiyorsa açık gönderiler düzenli aralıkla sorgulanır; durum değiştiğinde sipariş kendiliğinden güncellenir.
Sürekli
Müşteri bildirimi ve takip linki
Gönderi yola çıktığında ve teslim edildiğinde bildirim otomatik gider; takip numarası ve linki müşterinin kendi hesabında görünür.
Sürekli
Entegrasyon sağlık izlemesi
Takip döngüsünün son çalışma zamanı ve hata sayısı kayda geçer. Entegrasyon durursa bu sessiz kalmaz; siparişler birikmeden görülür.
Sürekli
Ayrıştığımız yer
Kargo anlaşması yapmak kolay.
Zor olan, onu sipariş akışına bağlamak.
Kargo firmasıyla sözleşme imzalamak bir iştir; her siparişte iki ayrı ekran arasında gidip gelmeyi bitirmek başka bir iştir. Aşağıdaki tablo bu iki yolun günlük işleyişte nerede ayrıştığını gösterir.
Elle yürütünce
Entegrasyonla
Gönderi açma
Elle yürütünce: Kargo firmasının ekranına ayrıca girilir, alıcı bilgisi elle yazılır
Entegrasyonla: Sipariş ekranından açılır, alıcı bilgisi siparişten gelir
Takip numarası
Elle yürütünce: Kopyalanıp siparişe elle yapıştırılır, yanlış siparişe düşebilir
Entegrasyonla: Gönderi numarası siparişin takip alanına kendiliğinden yazılır
Etiket
Elle yürütünce: Firmanın panelinden indirilir, sipariş ile elle eşleştirilir
Entegrasyonla: Barkod sunucunuzda üretilir, sipariş ekranından basılır
Durum güncellemesi
Elle yürütünce: “Kargom nerede” sorusu geldikçe tek tek sorgulanır
Entegrasyonla: Açık gönderiler düzenli sorgulanır, sipariş durumu kendiliğinden ilerler
Müşteri bildirimi
Elle yürütünce: Kargoya verildi bilgisi elle yazılır ya da hiç gitmez
Entegrasyonla: Yola çıktı ve teslim edildi bildirimleri otomatik gönderilir
Gönderi iptali
Elle yürütünce: Hem mağazada hem kargo firmasında ayrı ayrı iptal edilir
Entegrasyonla: Panelden yapılan iptal kargo firmasına da iletilir
Entegrasyon arızası
Elle yürütünce: Bağlantı koptuğunda fark edilmez; sipariş birikince anlaşılır
Entegrasyonla: Takip döngüsünün sağlık kaydı tutulur, durduğunda bildirilir
Nasıl çalışıyor
Kargo firmasının durum kodu,
siparişin durumuna çevrilir.
Entegrasyonun asıl işi burada görünür: firmanın döndürdüğü teknik durum kodu tek başına kimseye bir şey anlatmaz. Aşağıda bu kodların mağaza tarafında neye dönüştüğü yer alıyor.
Gönderi durumu → sipariş durumuYurtiçi Kargo örneği
NOPİşlem görmedi (şubeye ulaşmadı)
Gönderi açıldı, etiket basıldı; kargo henüz şubeye teslim edilmedi. Sipariş hazırlanıyor durumunda kalır.
ISRİşlem gördü
Gönderi fiilen yola çıktı. Sipariş otomatik olarak kargoya verildi işaretlenir ve müşteriye bildirim gider.
INDTeslimatta
Takip linki müşterinin hesabında görünür; “kargom nerede” sorusu destek kanalına düşmeden yanıtlanmış olur.
DLVTeslim edildi
Sipariş otomatik olarak teslim edildi durumuna geçer; iade süresi bu tarihten işlemeye başlar.
ŞubedeTeslim edilemedi, bekletiliyor
Başarısız teslim denemesi ayrıca tespit edilir. Kargo şubede takılı kalmışsa müşteriye ulaşılamamış demektir; bu durum ayrıca bildirilir.
CNL / ISCGönderi iptal edildi
İptal siparişe yansıtılır; yeniden gönderi açıldığında kargo firmasında anahtar çakışması yaşanmaz.
Yukarıdaki kodlar Yurtiçi Kargo'nun kendi durum kümesidir ve entegrasyonu yazarken firmanın test ortamına karşı doğrulanmıştır. Başka bir kargo firmasında kod kümesi değişir; kurulumda o firmanın kodları aynı yöntemle sipariş durumlarına eşlenir.
- 1Bildirim beklemek zorunda değilizKargo firması bildirim (webhook) sunmuyorsa açık gönderiler düzenli aralıkla toplu sorgulanır. Entegrasyonun çalışması firmanın bildirim altyapısına bağlı bırakılmaz.
- 2Hata bir siparişi durdurur, akışı değilSorgulama sırasında bir gönderide hata çıkarsa döngü durmaz; o kayıt bir sonraki turda yeniden denenir. Tek bozuk kayıt yüzünden bütün takip durmaz.
- 3Barkod dışarı çıkmazEtiket ve barkod kendi sunucunuzda üretilir. Alıcı adı, adresi ve telefonu barkod çizdirmek için üçüncü bir servise gönderilmez — KVKK açısından fark yaratan nokta budur.
- 4Adres eşleşmezse gönderi düşmezKargo firmasının beklediği il/ilçe kodu bulunamadığında gönderi hata verip iptal olmaz; adres tam metin olarak iletilir ve gönderi yine de açılır. Tek bir yazım farkı yüzünden sipariş beklemede kalmaz.
- 5Takip numarası mağazanın kendi alanına yazılırGönderi numarası siparişin standart takip alanına işlenir; hem yönetim panelinden hem müşteri hesabından aynı veriden okunur, iki yerde farklı bilgi oluşmaz.
Kurulum
Kargo firması hesabı hazırsa
entegrasyon günler içinde tamamlanır.
Süreç iki parçadır: kargo firmasının sözleşme ve web servisi kullanıcısı açma süresi ile bizim entegrasyonu kurup test etme süremiz. İkincisi bizim elimizde, birincisi değil.
1. adım
Keşif ve erişim
Kargo firması sözleşmesi, müşteri kodu ve web servisi kullanıcı bilgileri toplanır; firmanın test ortamına erişim açılır.
Çıktı: entegrasyon dosyası
2. adım
Entegrasyon ve etiket
Gönderi açma, iptal ve sorgulama çağrıları bağlanır; barkod etiketi ve il/ilçe eşlemesi kurulur.
Çıktı: test ortamında çalışan akış
3. adım
Test ve canlıya geçiş
Test ortamında gerçek bir gönderi açılır, sorgulanır ve iptal edilir; akış uçtan uca doğrulandıktan sonra canlıya alınır.
Çıktı: canlı kargo akışı
Sonrası
Takip ve izleme
Durum takip döngüsü ve sağlık kaydı devrededir; entegrasyon durur ya da firma tarafında bir değişiklik olursa bildirilir.
Çıktı: sürekli izlenen kargo akışı
Süre, bizim tarafımızın süresidir. Kargo firmasının sözleşme açma ve web servisi kullanıcısı tanımlama süresi bu takvimin dışındadır. Ayrıca bazı firmalar web servisi erişimini yalnızca belirli bir hacim taahhüdünden sonra veriyor — bu karar bize değil kargo firmasına aittir.
Paketler
Hangi paket, neleri kapsıyor?
Entegre edilen kargo firması sayısı ve izleme kapsamı paket bazında tanımlıdır. Kapsam dışı talepler ek hizmet olarak fiyatlandırılır.
Temel
Tek kargo firmasıyla gönderi açmayı panele taşımak isteyen mağazalar için.
1kargo firması entegrasyonu
Elledurum sorgulama
- ✓Gönderi açma ve iptal
- ✓Barkod ve gönderi etiketi
- ✓Adres / il-ilçe eşlemesi
- ✓Takip numarasının siparişe yazılması
- ✓E-posta desteği
En çok tercih edilen
Profesyonel
Durum takibini ve müşteri bildirimini elden çıkarmak isteyen mağazalar için.
1kargo firması entegrasyonu
30 dkdurum takip döngüsü
- ✓Temel paketteki her şey
- ✓Otomatik durum takibi ve sipariş güncellemesi
- ✓Kargoya verildi / teslim edildi bildirimi
- ✓Başarısız teslim denemesi tespiti
- ✓Entegrasyon sağlık izlemesi
- ✓Öncelikli destek
Kurumsal
Birden fazla kargo firmasıyla çalışan, gönderiyi kurala göre dağıtan mağazalar için.
2+kargo firması entegrasyonu
7/24izleme ve uyarı
- ✓Profesyonel paketteki her şey
- ✓Kural bazlı kargo firması seçimi (il, desi, tutar)
- ✓Firma servisi kesildiğinde alternatife düşme
- ✓Gecikmiş gönderi uyarı listesi
- ✓SLA'lı destek
Çalışma koşulları
1
Kargo ücreti ve tarife paket fiyatına dahil değildir.
Gönderi bedeli, sizinle kargo firması arasındaki sözleşmeye bağlıdır; paket bedeli yalnızca entegrasyon ve yönetim hizmetinin karşılığıdır.
2
Kargo firması sözleşmesi sizin adınıza kalır.
Müşteri kodu ve web servisi kullanıcısı size aittir; biz yalnızca entegrasyonu kurar ve işletiriz.
3
Fiziksel operasyon kapsam dışıdır.
Sipariş hazırlama, paketleme ve kargoya teslim etme sizde kalır. Depo hizmeti verilmez.
4
Kargo firmasının servis kesintisi taahhüt edilmez.
Firmanın web servisi durduğunda entegrasyon da durur; biz bunu tespit eder ve bildiririz, servisin kendisini garanti edemeyiz.
5
Talepler tek kanaldan iletilir.
İş günleri 09.00–18.00 arasında alınır; SLA yalnızca Kurumsal pakette geçerlidir.
6
Kapsam dışı talepler ek hizmettir.
Ek kargo firması entegrasyonu ve özel kural geliştirmeleri için birim fiyat listesi sözleşme ekinde yer alır.
Şeffaflık
Neler dahil değil?
Bu listeyi bilerek yayımlıyoruz
Aşağıdakiler kargo entegrasyonu kapsamında yer almıyor. Bir kısmı kargo firmasının web servisinin sunmadığı şeyler, bir kısmı ayrı bir hizmet kalemi — hangisi olduğunu görüşmede net söylüyoruz.
- —Canlı kargo ücreti hesaplama — kargo firması fiyat sorgulama servisi sunmuyorsa ücret panelde kurallı olarak tanımlanır
- —Anlaşmalı kargo fiyatı sağlama — tarife pazarlığı sizinle kargo firması arasındadır
- —İade gönderisi açma — bazı firmaların web servisi iade gönderisi oluşturmaya izin vermez; bu durumda iade elle yürütülür
- —Depo ve sipariş hazırlama (fulfillment) hizmeti — fiziksel operasyon kapsam dışıdır
- —Kargo firmasının kendi paneli üzerindeki işlemler — fatura, mutabakat ve itiraz süreçleri sizde kalır
- —Yurt dışı gönderi ve gümrük süreçleri — planlanmadı
Rakamlarla
Varan Yazılım
30+Aktif Müşteri · Tüm Hizmetler
Kasım 2021Kuruluş
AnkaraMerkez
Sıkça Sorulan Sorular
Kargo Entegrasyonu
Hakkında Merak Edilenler
Firma seçimi, ücretlendirme ve operasyonun kimde kaldığı konusunda en sık iletilen sorular.
Hangi kargo firmalarıyla entegrasyon yapabiliyorsunuz?
Yurtiçi Kargo entegrasyonu uçtan uca tarafımızca yazıldı ve çalışıyor. Diğer firmalar (Aras, MNG, Sürat, PTT Kargo) için entegrasyon, o firmanın web servisi dokümanına göre aynı desenle kurulur. Bir firma web servisi sunmuyorsa entegrasyon mümkün olmaz; bunu ilk görüşmede söyleriz.
Kargo ücretini sistem otomatik hesaplıyor mu?
Kargo firmasının web servisi fiyat sorgulama sunmadığı sürece hayır. Bu durumda kargo ücreti panelde kurallı olarak tanımlanır (tutara, desiye ya da bölgeye göre). Firmanın fiyat servisi varsa canlı hesaplama da bağlanabilir.
Paketleme ve kargoya verme işini siz mi yapıyorsunuz?
Hayır. Fiziksel operasyon — sipariş hazırlama, paketleme, kargoya teslim etme — sizde kalır. Biz sistem tarafını kurarız: gönderi açma, etiket, takip ve bildirim. Depo hizmeti isterseniz ayrı bir tedarikçiyle kurgulamanız gerekir.
Kargo anlaşmasını ve tarifeyi siz mi yapıyorsunuz?
Hayır. Sözleşme, müşteri kodu ve tarife sizinle kargo firması arasındadır. Biz o hesabı sisteminize bağlarız. Anlaşmanız yoksa hangi bilgileri istemeniz gerektiğini yazılı olarak veririz.
Kargo firması bildirim göndermiyorsa durum nasıl güncelleniyor?
Açık gönderiler düzenli aralıkla toplu olarak sorgulanır; durum değiştiğinde sipariş kendiliğinden ilerler. Yurtiçi Kargo kurulumumuzda bu döngü 30 dakikada bir çalışıyor. Firma bildirim sunuyorsa bildirim de bağlanır, sorgulama yedekte kalır.
Mevcut bir kargo entegrasyonumuz var ama sürekli takılıyor. Bakar mısınız?
Evet. Mevcut entegrasyon denetlenir; durum takibinin neden durduğu, hangi gönderilerin eşleşmediği ve hata kodlarının nerede yutulduğu tespit edilip düzeltilir.
Birden fazla kargo firmasını aynı anda kullanabilir miyiz?
Evet. Kurumsal pakette gönderi, kurala göre (il, desi, sipariş tutarı) uygun firmaya yönlendirilebilir; bir firmanın servisi kesildiğinde alternatife düşecek şekilde kurulur.
Önce mevcut akışınızı inceleyelim
Kargo adımını sistem yürütsün,
siz siparişe bakın.
Kargo firmanızı, sipariş hacminizi ve şu anda hangi adımın elle yapıldığını inceleyip entegrasyonun nereye kadar gitmesi gerektiğini söylüyoruz. Gereksiz entegrasyon eklemek ikimizin de işine yaramıyor.
Mevcut kargo akışı incelemesi✓
Kargo firması web servisi uygunluk kontrolü✓
Entegrasyon kapsamı önerisi✓
Kurulum takvimi önerisi✓