E-Ticaret Kargo Entegrasyonu Nasıl Çalışır?

E-ticaret kargo entegrasyonu, gönderime uygun sipariş verisini taşıyıcıya ileten basit bir bağlantıdan daha fazlasıdır. Siparişten fulfillment kaydına, paketten gönderiye, etiketten ilk fiziksel taramaya ve teslimattan iadeye kadar oluşan nesneleri ve olayları tekil kimliklerle yönetir. Başarılı bir kurgu yalnız barkod üretmez; belirsiz API sonuçlarını çözer, mükerrer gönderiyi önler, ham taşıyıcı durumunu korur, kişisel veriyi sınırlar ve operasyon ile taşıma faturası arasında mutabakat kurar.

Bu rehber, 16 Temmuz 2026 yayın hedefi için 17 Temmuz 2026 tarihinde doğrulanan resmî kaynaklara dayanır. Etiket oluşturulması fiziksel teslimi, takip numarası alınması hareketi, tahmini teslim tarihi ise garantiyi göstermez. Taşıma sözleşmesi fiyatı ve hizmet koşullarını; fiziksel taşıma hizmeti paketin hareketini; entegrasyon ise veri, komut ve olay akışını yönetir.

E-ticaret kargo entegrasyonu nedir, ne değildir?

Entegrasyonun ana niyeti, siparişin gönderime uygun hâle gelmesinden teslimat veya iade mutabakatına kadar kargo verisini güvenli, izlenebilir ve hataya dayanıklı biçimde yönetmektir. Düşük hacimde manuel panel geçici olarak yeterli olabilir; sipariş sayısı, kanal, depo veya taşıyıcı arttıkça tekrar eden veri girişi, takip güncellemesi ve istisna yönetimi operasyon yüküne dönüşür. Entegrasyon bu işleri azaltır, fakat yanlış adresi kendiliğinden doğru yapmaz, taşıyıcı kapasitesini artırmaz, teslimatı garanti etmez ve hukuki iade kararını vermez.

Kavram	Asıl sorumluluk	Entegrasyonla ilişkisi
Kargo anlaşması	Tarife, desi, hizmet alanı, tazmin, operasyon ve SLA koşulları	API kullanımı için müşteri kodu veya ek sözleşme gerektirebilir.
Taşıma hizmeti	Paketin kabulü, ayrıştırılması, hareketi ve teslimi	Fiziksel olayları üretir; entegrasyon bunları görünür kılar.
Kargo entegrasyonu	Gönderi, etiket, takip, istisna ve iade verisinin akışı	Sözleşmenin veya fiziksel taşımanın yerine geçmez.
E-ticaret altyapısı	Sipariş, müşteri deneyimi ve ticari kurallar	Gönderim uygunluğu ve müşteri bildirimi için bağlam sağlar.

İş	Entegrasyon azaltabilir	Tek başına çözemez
Veri girişi	Adres ve paket verisinin kontrollü aktarımı	Kaynak verinin yanlış veya eksik olması
Etiket	Doğru şablonu isteme ve yazdırma kuyruğu	Yazıcı kalibrasyonu ve fiziksel etiketleme
Takip	Olayları toplama ve normalleştirme	Taşıyıcının tarama yapmaması
İade	RMA ile taşıyıcı kaydını ilişkilendirme	Cayma hakkı, kalite kararı ve geri ödeme onayı

Sipariş, fulfillment, paket, gönderi ve koli modeli

En yaygın mimari hata, bütün kavramları sipariş numarasına sıkıştırmaktır. Bir sipariş stok veya depo nedeniyle iki fulfillment kaydına; her fulfillment birden çok pakete; her paket taşıyıcı nezdinde bir gönderiye; bazı taşıyıcılarda gönderi de birden çok fiziksel parçaya ayrılabilir. Her nesnenin değişmez iç kimliği, dış sistem referansı, sahibi ve yaşam döngüsü ayrı tutulmalıdır. Sipariş müşteri taahhüdünün, paket ise fiziksel sevkin temelidir.

Nesne	Tekil kimlik	Doğru source of truth	Kritik ilişki
Sipariş	order_id	E-ticaret veya OMS	Bir veya çok fulfillment
Fulfillment	fulfillment_id	Orkestrasyon katmanı	Sipariş kalemlerinin karşılanma planı
Paket	package_id	WMS veya paketleme servisi	Ölçü, ağırlık ve ürün içeriği
Gönderi	shipment_id ve external_reference	Kargo orkestrasyonu	Taşıyıcı booking kaydı
Parça veya koli	piece_id	Taşıyıcı ve depo mutabakatı	Tek gönderide fiziksel parça
Etiket	label_id ve sürüm	Etiket servisi	Gönderi kimliğine bağlı çıktı
Takip olayı	event_id	Değiştirilemez olay deposu	Ham ve normalize durum

Durum	Anlam	Müşteriye söylenecek ifade
READY_TO_SHIP	Ödeme, stok, iptal ve paket kontrolleri geçti	Siparişiniz gönderime hazırlanıyor.
LABEL_CREATED	Gönderi kaydı ve etiket üretildi	Etiket hazırlandı; henüz taşıyıcı kabulü olmayabilir.
HANDED_OVER	Fiziksel devir kanıtı var	Paket taşıyıcıya teslim edildi.
FIRST_SCAN	Taşıyıcının ilk operasyonel taraması alındı	Gönderi taşıyıcı ağında hareket etmeye başladı.
IN_TRANSIT	Taşıma olayları sürüyor	Gönderi yolda.
OUT_FOR_DELIVERY	Dağıtım turuna çıktı	Gönderi dağıtımda.
DELIVERED	Teslim olayı ve mümkünse kanıt alındı	Gönderi teslim edildi.

Gönderime uygunluk ve veri kalitesi kapısı

Gönderi oluşturma, sipariş geldiği anda değil, tanımlı bir uygunluk kapısından sonra çalışmalıdır. Ödeme yetkisi veya kapıda ödeme kuralı, stok rezervasyonu, fraud hold, müşteri iptali, ürün taşıma kısıtı, depo ataması, paket ölçüsü ve adres gereksinimleri birlikte kontrol edilir. Gönderim notu eksik adresin yerine geçmez. Adres standardizasyonu öneri üretir; sessiz değişiklik yapılmaz, kullanıcı veya yetkili operasyon onayı ve değişiklik kaydı tutulur.

Uluslararası adres modellemesinde UPU S42 bileşen ve ülkeye özgü şablon yaklaşımı için yararlı bir referanstır; Türkiye’de posta kodu kontrolü için PTT posta kodu sorgusu kullanılabilir. Bu kaynaklar taşıyıcıya özel zorunlu alanların yerine geçmez. İl, ilçe, mahalle, sokak, bina, daire, alıcı ve telefon alanları güncel taşıyıcı sözleşmesine göre doğrulanmalıdır.

Alan	Kontrol	Hata davranışı
Alıcı adı	Karakter, uzunluk, kurumsal/gerçek kişi kuralı	Kısaltmayı sessiz yapma; kullanıcıya göster.
Telefon	Ülke kodu, sayısal normalizasyon, maskeleme	Geçersizse booking durdur; loga açık yazma.
Posta kodu	İl, ilçe ve mahalleyle uyum	Öneriyi teyide sun; otomatik değiştirme.
Adres satırı	Taşıyıcı uzunluğu ve zorunlu bileşenler	Kesilen metni audit ile görünür kıl.
Teslimat notu	Hassas veri ve uzunluk kontrolü	Adresin yerine kullanma.
Ağırlık ve ölçü	Paketleme sonrası ölçüm	Ürün kataloğu değerini körlemesine kullanma.

Karar girdisi	Neden önemlidir	Örnek kural
Hizmet alanı	Şube ve posta kodu kapsamı değişir	Kapsam dışı rotayı ele.
Ağırlık/desi	Fiyat ve kabul koşulunu etkiler	Paket ölçümünden hesapla.
Ürün kısıtı	Sıvı, kırılabilir, tehlikeli ürün farklıdır	Uygun hizmet yoksa manuel inceleme.
Kapasite	Kesim saati ve günlük kota olabilir	Dolulukta kontrollü alternatif ara.
Geçmiş performans	Bölge bazlı başarı farklılaşır	Son 30 gün p95 ilk taramayı kullan.
İade ve COD	Her hizmet aynı yeteneği sunmaz	Müşteri vaadine göre uygun taşıyıcı seç.

Gönderi oluşturma: idempotency, timeout ve read-back

Fiyat sorgulama ile gönderi oluşturma ayrı işlemlerdir. Teklif yanıtı rezervasyon veya taşıma kaydı değildir. Booking isteğine değişmez bir external shipment reference eklenmeli; aynı paket için eşzamanlı çağrılar kilitlenmeli; sağlayıcı destekliyorsa idempotency anahtarı kullanılmalıdır. Idempotency-Key bütün kargo API’lerinde zorunlu veya desteklenen evrensel bir alan değildir. Destek yoksa iş anahtarı, müşteri referansı, benzersiz veritabanı kısıtı ve sağlayıcıda sonuç sorgulama birlikte kullanılır.

Timeout belirsiz sonuçtur: taşıyıcı kaydı oluşturmuş, yanıt yolda kaybolmuş olabilir. Kör retry ikinci gönderi, ikinci etiket ve çift fatura üretebilir. Önce external reference ile read-back yapılır; kayıt bulunursa yerel işlem tamamlanır, bulunmazsa belirlenmiş bekleme ve tekrar sorgu penceresinden sonra kontrollü yeniden deneme yapılır. HTTP 200 yalnız taşıma katmanında yanıt alındığını gösterir; gövdedeki iş kodu, takip numarası, etiket bütünlüğü, read-back ve ilk tarama ayrıca doğrulanır.

Otomatik barkod, etiket ve baskı kalite güvencesi

Takip numarası taşıyıcının takip için verdiği değerdir; barkod bu veya başka veriyi makinece okunabilir biçimde kodlar; etiket ise barkodla birlikte adres, hizmet ve yönlendirme alanlarını taşıyan belgedir. PDF, ZPL, base64 içerik veya süreli indirme URL’si sağlayıcıya göre değişir. Evrensel 100 x 150 milimetre, sabit DPI veya tek termal yazıcı zorunluluğu yoktur; güncel taşıyıcı şablonu, lisans ve cihaz gereksinimi esas alınır.

GS1 Logistic Label Guideline lojistik birim bağlamında SSCC kullanımını ve fiziksel birimle elektronik bilginin tarama yoluyla bağlanmasını açıklar. Ancak SSCC veya GS1-128 her son kilometre tüketici kargo etiketinde zorunlu değildir. Uygulanabilirlik, iş ortağı ve taşıyıcı standardıyla doğrulanmalıdır. Olay görünürlüğü için GS1 EPCIS ve CBV ayrı bir standart bağlamıdır; taşıyıcıların bu modeli kullandığı varsayılmaz.

Manifest, fiziksel devir ve ilk tarama

Manifest, belirli kesim anında taşıyıcıya devredilecek paket grubunun operasyon kaydıdır; pickup talebi kurye veya araç çağrısıdır; handover fiziksel teslim kanıtıdır; first scan ise taşıyıcının ağındaki ilk operasyonel taramadır. Dördü aynı olay değildir. Paket listede göründüğü hâlde araçta olmayabilir; araçta olduğu hâlde ilk tarama gecikebilir. Bu nedenle etiket üretiminden ilk taramaya, devirden ilk taramaya ve kesim saatinden kabul olayına kadar süreler ayrı ölçülür.

Kargo takibi: webhook, polling ve durum normalizasyonu

Webhook düşük gecikmeli bildirim sağlayabilir, ancak olayların yalnız bir kez, sıralı ve eksiksiz geleceği varsayılmaz. Polling eksik olayları ve uzun süredir hareketsiz gönderileri bulabilir; yüksek frekans ise rate limit ve maliyet doğurur. En dayanıklı tasarım, imzalı webhook tüketimi, planlı polling, günlük mutabakat ve ham olay deposunu birlikte kullanır. Aynı event ID veya kararlı fingerprint mükerrer tüketimi önler; geç gelen eski olay mevcut durumu geriye götürmez, fakat geçmiş kaydında korunur.

Taşıyıcının ham kodu, açıklaması, taşıyıcı zaman damgası, sistemin alma zamanı, saat dilimi, payload özeti ve eşleme sürümü saklanır. İç durumlar işletmenin önerdiği canonical modeldir; evrensel taşıyıcı kodları değildir. RFC 3339 biçimi zaman gösterimini tutarlılaştırır, ancak kaynağın saat doğruluğunu garanti etmez. Sipariş durumu paket durumuna bire bir eşitlenmez; iki paketten biri teslim edildiğinde sipariş “kısmi teslim” olabilir.

API sözleşmesi, HTTP ve güvenilir entegrasyon deseni

Kargo bağlantısı REST/JSON, SOAP/XML, dosya/SFTP veya sağlayıcıya özgü bir yöntem olabilir. OpenAPI Specification 3.2.0, HTTP API tanımı için dil bağımsız bir belge biçimidir; belgenin varlığı güvenlik, doğru örnek, değişiklik politikası, sandbox veya SLA garantisi değildir. CloudEvents 1.0.2 olay zarfı tasarımında değerlendirilebilen genel bir standarttır; taşıyıcıların bunu kullanması zorunlu değildir.

RFC Editor üzerinden HTTP Semantics 9110, Caching 9111, Problem Details 9457, HTTP Message Signatures 9421, Digest Fields 9530, internet zaman damgaları 3339, URI sözdizimi 3986 ve ek HTTP durum kodları 6585 kontrol edilmiştir. Bunlar birlikte okunmalıdır: örneğin 429 yanıtı RFC 6585 bağlamında kapasite sınırını ifade edebilir; Retry-After desteği sağlayıcı sözleşmesinden doğrulanır. Problem Details standart hata gövdesi sağlayabilir, fakat iş hata sözlüğünün yerini tutmaz.

Webhook, dosya ve kişisel veri güvenliği

OWASP API Security ve OWASP REST Security rehberleri, HTTPS, uç bazlı yetkilendirme, girdi ve içerik türü doğrulaması, güvenli hata ve audit yaklaşımını destekler. Webhook için TLS, taşıyıcı destekliyorsa mTLS, kimlik doğrulama, mesaj imzası, digest, timestamp, dar replay penceresi, nonce veya event ID, şema doğrulama ve idempotent tüketim birlikte ele alınır. IP allowlist yalnız ek savunma katmanıdır; tek başına kimlik doğrulama değildir.

Etiket ve POD URL’leri süreli, tahmin edilemez ve yetki kontrollü olmalıdır. Uzak URL alanlarında SSRF savunması; indirilen dosyada izinli şema ve host, yönlendirme, MIME, sihirli bayt, boyut, checksum, zararlı içerik taraması ve güvenli depolama uygulanır. Loglarda alıcı adı, telefon, tam adres, takip tokenı, API anahtarı ve teslim kanıtı açık tutulmaz. Secret değerleri kasada, en az yetkiyle, döndürülebilir ve geri alınabilir biçimde yönetilir.

KVKK, posta ve tüketici mevzuatı sınırı

Alıcı adı, telefon, açık adres ve POD içeriği kişisel veri içerebilir. KVKK yurt dışına aktarım rehberi, Kanunun 9. maddesi kapsamındaki aktarım mekanizmalarını açıklamak için güncel başvuru kaynağıdır. Satıcı, taşıyıcı, entegratör ve diğer sağlayıcıların veri sorumlusu veya veri işleyen rolü unvana göre otomatik atanmaz; somut işleme amacı, karar yetkisi ve sözleşmeye göre belirlenir. 2022/277 ve 2021/603 sayılı Kurul kararları kendi olay bağlamında okunmalı, bütün kargo ilişkilerine evrensel hüküm yapılmamalıdır.

Saklama süresi “sonsuz” veya tek bir genel sayı değildir. Taşıma sözleşmesi, uyuşmazlık, muhasebe, tüketici işlemi, güvenlik ve ispat amaçları için ayrı süre matrisi hazırlanır; amaç bittiğinde silme, yok etme veya anonimleştirme uygulanır. Yurt dışındaki log, bildirim veya yapay zekâ hizmetine veri gidiyorsa aktarım haritası ve uygun mekanizma ayrıca doğrulanır. Bu rehber hukuki danışmanlık değildir.

Posta hizmetlerinin düzenleyici çerçevesi için BTK Posta Sektörü sayfası ve 6475 sayılı Kanun ile güncel ikincil düzenlemeler; tüketici işlemleri için Ticaret Bakanlığı 6502 mevzuat sayfası ve güncel Mesafeli Sözleşmeler Yönetmeliği kontrol edilmelidir. Kargo entegrasyonu cayma hakkını, iade masrafını veya geri ödeme zamanını otomatik belirlemez; iş kuralı hukuk ve sözleşme incelemesinden sonra sisteme çevrilir.

Teslimat istisnaları, NDR, kayıp ve hasar

NDR, teslim edilememe raporu için kullanılan genel bir operasyon terimidir; taşıyıcı kodları aynı değildir. Adres yetersiz, alıcı bulunamadı, teslim reddi, hasar, kayıp, gecikme, şube bekleme ve kapasite sorunları ayrı nedenlerdir. Her neden için sahip, müşteri iletişim süresi, yeniden deneme hakkı, taşıyıcı eskalasyonu ve terminal karar tanımlanır. ETA yalnız tahmindir; hizmet bölgesi, ilk tarama, yoğunluk ve istisnalarla değişir.

RTO, müşteri iadesi, RMA ve geri ödeme devri

RTO, teslim edilemeyen veya reddedilen giden gönderinin göndericiye dönmesidir. Müşteri iadesi ise teslim edilmiş ürün için ticari veya hukuki talep akışıdır. RMA işletmenin iade yetkilendirme kaydıdır; taşıyıcı iade etiketi veya kodu değildir. RMA onayı, taşıyıcı return booking, etiket/kod, fiziksel kabul, kalite kontrol, stok kararı ve geri ödeme devri ayrı aşamalardır. Kısmi iadede siparişin tamamı değil, ilgili kalem, adet, paket ve ödeme payı ilişkilendirilir.

ERP, OMS, WMS ve kanal sınırları

E-ticaret altyapısı müşteri siparişini ve deneyimi; OMS kanal siparişlerini ve fulfillment kararlarını; WMS fiziksel toplama, paketleme ve ölçümü; ERP finansal ve kurumsal kayıtları; kargo orkestrasyonu ise taşıyıcı booking, etiket ve olay bağlantısını yönetir. Bu sınırlar ürüne göre birleşebilir, fakat veri sahipliği yine açık olmalıdır. Kargo entegrasyonu fatura, e-Fatura veya e-Arşiv oluşturduğu varsayımıyla tasarlanmaz; belge devri ayrı sözleşmedir.

Gözlemlenebilirlik, KPI ve mutabakat

Log, metric, trace ve audit farklı amaçlara hizmet eder. Log teknik olayın ayrıntısını; metric zaman serisini; trace dağıtık çağrı zincirini; audit ise kimin hangi iş kararını ne zaman verdiğini gösterir. Correlation ID, order_id, package_id, shipment_id ve taşıyıcı referansı PII içermeden ilişkilendirilir. Ortalama tek başına yeterli değildir; p95 ve p99 gecikmeler, duplicate oranı, event freshness, first-scan latency, NDR, RTO, teslimat ve mutabakat farkı birlikte izlenir.

Ayrıntılı operasyon senaryoları

120 maddelik uygulama kontrol listesi

Yönetişim ve kapsam

• Kontrol 1: Taşıma sözleşmesi ile entegrasyon kapsamını ayır; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 2: Her taşıyıcı için hesap ve sözleşme sahibini belirle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 3: Üretim ve sandbox hesaplarını ayır; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 4: Destek ve eskalasyon sahiplerini yaz; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 5: P1 olay tanımını onayla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 6: Veri sahipliği matrisini çıkar; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 7: Değişiklik duyuru kanalını kaydet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 8: Çıkış ve veri dışa aktarma planını hazırla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 9: Paket bazlı source of truth belirle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 10: Hukuk ve KVKK inceleme sahibini ata; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Sipariş uygunluğu

• Kontrol 11: Ödeme veya COD kuralını doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 12: Stok rezervasyonunu kontrol et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 13: Fraud hold durumunu kontrol et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 14: İptal penceresini kontrol et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 15: Depo atamasını doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 16: Ürün taşıma kısıtını uygula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 17: Paket hazır olayını zorunlu tut; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 18: Kesim saati politikasını sürümle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 19: Müşteri vaadini taşıyıcı seçimine bağla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 20: Manuel override yetkisini sınırla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Nesne modeli

• Kontrol 21: Order kimliğini değişmez tut; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 22: Fulfillment kimliğini ayrı üret; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 23: Package kimliğini fiziksel pakete bağla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 24: Shipment kimliğini booking kaydına bağla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 25: Piece kimliğini çok kolide sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 26: Label sürümünü kaydet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 27: Tracking event kimliğini sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 28: Manifest kimliğini paketlerle ilişkilendir; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 29: External reference benzersizliğini zorla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 30: Nesne silmek yerine durum geçmişi tut; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Adres ve paket

• Kontrol 31: Telefonu ülke koduyla normalize et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 32: Telefonu loglarda maskele; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 33: Posta kodunu yerleşimle doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 34: Türkçe karakterleri uçtan uca test et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 35: Adres uzunluk sınırını doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 36: Kesilen alanı görünür kıl; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 37: Teslimat notunu adres yerine kullanma; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 38: Adres önerisini kullanıcıya teyit ettir; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 39: Paketleme sonrası ağırlığı ölç; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 40: Paketleme sonrası boyutları ölç; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Booking ve tekillik

• Kontrol 41: Fiyat sorgusunu booking sayma; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 42: Package bazlı iş anahtarı üret; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 43: Eşzamanlı booking çağrısını kilitle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 44: Sağlayıcı idempotency desteğini doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 45: External reference gönder; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 46: Timeout sonucunu belirsiz kabul et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 47: Retry öncesi read-back yap; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 48: 409 yanıtında mevcut kaydı ara; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 49: HTTP 200 gövdesini doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 50: Booking ile etiketi ayrı tamamla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Etiket ve baskı

• Kontrol 51: Desteklenen formatı doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 52: İndirme URL süresini doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 53: Dosya checksum kaydet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 54: MIME ve magic byte kontrol et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 55: Dosya boyutu sınırı uygula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 56: Yüzde yüz baskı ölçeğini sabitle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 57: Quiet zone kontrol et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 58: Kontrast testi yap; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 59: Rulo sonrası kalibrasyon yap; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 60: Gerçek tarayıcıyla örnekle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Manifest ve devir

• Kontrol 61: Manifest kesim kuralını tanımla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 62: Manifestte paket sayısını doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 63: Etiketsiz paketi manifestten çıkar; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 64: Pickup kimliğini sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 65: Kurye talebi kabulünü doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 66: Fiziksel sayımı kaydet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 67: Handover kanıtını yetkilendir; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 68: İlk tarama zamanını ölç; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 69: İlk taramasız paket alarmı kur; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 70: Devir farkını günlük mutabakata al; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Takip olayları

• Kontrol 71: Ham taşıyıcı kodunu sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 72: Ham açıklamayı sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 73: Carrier timestamp sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 74: Received timestamp sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 75: Saat dilimini açık kaydet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 76: Mapping sürümünü sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 77: Event ID ile dedup yap; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 78: Sırasız olayı geçmişte koru; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 79: Terminal durumu geriye döndürme; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 80: Polling mutabakatı planla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Bildirim ve deneyim

• Kontrol 81: Etiket hazır ile kargoya verildi ifadelerini ayır; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 82: Takip linkinde token süresi kullan; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 83: Müşteri mesajını paket bazlı üret; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 84: Aynı olay mesajını dedup et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 85: Kısmi teslimatı açık göster; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 86: ETA bilgisini tahmin olarak etiketle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 87: İstisnada aksiyon sahibi göster; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 88: POD erişimini rol bazlı yap; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 89: Geri alınan durumda açıklama sun; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 90: Bildirim tercihlerini uygula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

İade ve istisna

• Kontrol 91: NDR nedenlerini ayrı kodla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 92: RTO ile müşteri iadesini ayır; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 93: RMA ile iade kodunu ayır; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 94: İade kodu süresini sakla; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 95: Tek kullanımlılığı doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 96: Paket sayısı kapsamını göster; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 97: Inbound first scan ölç; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 98: Kalite kontrol sonucunu kaydet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 99: Kısmi iadeyi kalem bazlı yönet; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 100: Refund komutunu idempotent yap; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Güvenlik ve gizlilik

• Kontrol 101: Yalnız HTTPS kullan; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 102: mTLS desteğini sağlayıcıyla doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 103: Webhook imzasını doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 104: Digest değerini doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 105: Replay penceresi uygula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 106: IP allowlisti ek katman say; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 107: Şema ve content type doğrula; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 108: Secret değerini kasada tut; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 109: Secret rotasyonunu test et; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 110: PII alanlarını logdan çıkar; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

Operasyon ve maliyet

• Kontrol 111: p95 booking gecikmesini izle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 112: p99 olay tazeliğini izle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 113: Duplicate oranını izle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 114: First-scan p95 izle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 115: NDR ve RTO oranını izle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 116: MTTD ve MTTR ölç; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 117: Taşıma desi farkını uzlaştır; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 118: Etiket sarf maliyetini izle; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 119: Connector bakım maliyetini bütçele; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.
• Kontrol 120: İlk 24 saat, 7 gün ve 30 gün gözden geçir; kanıtı, sorumlusu ve son kontrol tarihi kayıt altına alınmalıdır.

PoC ve UAT test matrisi

Taşıyıcı veya entegrasyon sağlayıcısına sorulacak sorular

50 kırmızı bayrak ve sık hata

Toplam sahip olma maliyeti ve seçim kararı

TCO yalnız yazılım lisansı değildir. Taşıma tarifesi, entegratör ücreti, özel connector geliştirme ve bakım, sandbox erişimi, etiket yazıcısı ve sarf, mesajlaşma, gözlemleme altyapısı, güvenlik, destek, manuel istisna işçiliği, taşıyıcı değişimi ve veri çıkışı birlikte hesaplanır. Doğrudan entegrasyon daha fazla kontrol sağlayabilir; entegratör çoklu taşıyıcıyı hızlandırabilir. Karar hacim, farklılaşma, ekip yetkinliği, SLA ve çıkış maliyetine göre verilmelidir.

Uygulama yol haritası ve canlıya geçiş

1. Keşif: Hacim, depo, paket, taşıyıcı, iade, veri ve mevzuat envanterini çıkarın.
2. Sözleşme: API, etiket, durum, iade, destek, rate limit ve değişiklik kapsamını yazılı doğrulayın.
3. Model: Sipariş, fulfillment, paket, gönderi, etiket, manifest ve olay kimliklerini ayırın.
4. PoC: Gerçek taşıyıcı hesabı, gerçek yazıcı, first scan ve iade örnekleriyle kritik akışı kanıtlayın.
5. UAT: Timeout, duplicate, sıra bozukluğu, NDR, RTO, kısmi iade ve güvenlik testlerini çalıştırın.
6. Go/no-go: Başarı eşiği, açık risk, veri migrasyonu, destek vardiyası ve rollback kararını imzalayın.
7. Kademeli geçiş: Taşıyıcı, depo veya sipariş yüzdesi bazında kontrollü trafik artırın.
8. İzleme: İlk 24 saat, 7 gün ve 30 günde KPI, mutabakat, maliyet ve müşteri etkisini gözden geçirin.

Yapay zekâ ve arama görünürlüğü nerede ayrılır?

Yapay zekâ adres önerisi, taşıyıcı performans tahmini, NDR neden sınıflandırması ve anomali önceliklendirmesinde yardımcı olabilir. Ancak adresi veya taşıyıcıyı ölçüm ve insan onayı olmadan değiştirmemeli; kişisel veriyi onaysız dış servise aktarmamalı; operasyon kararını açıklanamaz bir skora bırakmamalıdır. Öneri, kullanılan özellikler, güven düzeyi, kullanıcı kararı ve gerçekleşen sonuç audit döngüsüne alınmalıdır.

Google ürün yapılandırılmış veri belgeleri arama sonuçlarında ürün ve kargo/iade politikası görünürlüğüyle ilgilidir; taşıyıcı API booking, etiket üretme veya takip olaylarını yönetmez. Bu makale JSON-LD üretmez. Operasyonel kargo entegrasyonu ile arama motoru yapılandırılmış verisi ayrı iş akışlarıdır.

SoloCommerce kapsamında nasıl değerlendirilir?

17 Temmuz 2026 canlı kontrolünde Solofor paketler sayfası Büyüme paketinde “kargo ve iade süreç görünürlüğü” ifadesini; karşılaştırma tablosunda fulfillment ve iade için Başlangıçta kapsam olmadığını, Büyümede temel, Profesyonel ve Enterprise düzeyinde gelişmiş kapsam bulunduğunu gösteriyordu. Özel entegrasyon Profesyonel ve Enterprise için teklif ile, SLA ise Enterprise için dahil olarak listeleniyordu. Bu nedenle otomatik barkod, belirli taşıyıcı, etiket biçimi, iade, limit, destek ve SLA bütün paketlerde aynı kabul edilmemelidir.

Solofor SSS sayfasındaki Aras, Yurtiçi ve MNG gibi taşıyıcılarla otomatik barkod ve gönderim takibi ifadesi pazarlama kapsam bilgisidir; canlı taşıyıcı hesabı, paket, API uçları, etiket biçimi ve sözleşmeyle ayrıca doğrulanmalıdır. İşletme sipariş, kargo, iade, stok, fatura, pazaryeri ve raporlama gereksinimlerini birlikte değerlendirerek kargo operasyonuna uygun e-ticaret paketlerini karşılaştırabilir. Belge akışı doğal bir ihtiyaçsa e-Fatura çözüm kapsamı ayrıca incelenmeli; kargo entegrasyonunun fatura ürettiği varsayılmamalıdır.

Sıkça Sorulan Sorular

E-ticaret kargo entegrasyonu nedir?

Entegrasyonun ana niyeti, siparişin gönderime uygun hâle gelmesinden teslimat veya iade mutabakatına kadar kargo verisini güvenli, izlenebilir ve hataya dayanıklı biçimde yönetmektir.

Kargo takibi nasıl yapılır?

Webhook düşük gecikmeli bildirim sağlayabilir, ancak olayların yalnız bir kez, sıralı ve eksiksiz geleceği varsayılmaz. Polling eksik olayları ve uzun süredir hareketsiz gönderileri bulabilir; yüksek frekans ise rate limit ve maliyet doğurur.

Uygulamaya Geçmeden Önce

Sağlam bir e-ticaret kargo entegrasyonu, “etiketi aldım” noktasında bitmez. Paket tekilliği, belirsiz booking sonucunun çözümü, taranabilir baskı, manifest ve fiziksel devir, ilk tarama, güvenli olay tüketimi, ham durumun korunması, istisna ve iade ayrımı, KVKK kontrolleri ve düzenli mutabakat aynı tasarımın parçalarıdır. Başarı, otomasyon vaadiyle değil; duplicate oranı, first-scan gecikmesi, olay tazeliği, teslimat, NDR, RTO, maliyet ve müşteri etkisiyle ölçülür.

İhtiyaçlarınızı nesne modeli, taşıyıcı sözleşmesi, PoC sonuçları ve toplam sahip olma maliyetiyle netleştirdikten sonra sipariş ve kargo operasyonunu birlikte planlayan e-ticaret paketlerini inceleyin. Solofor e-ticaret paketleri sayfasında sipariş, ödeme, kargo, iade, stok, fatura, pazaryeri, B2B, yapay zekâ ve raporlama ihtiyaçlarınıza uygun seçenekleri karşılaştırın; taşıyıcı, barkod, etiket, takip, iade, özel entegrasyon ve SLA kapsamını seçilecek paket için ayrıca doğrulayın.