Shopify Kargo Takip Numarası Otomatik Oluşturma Nasıl Çalışır?

Shopify Kargo Takip Numarası Otomatik Oluşturma Nedir? Shopify kargo takip numarası otomatik oluşturma, kargo firmasının API’sinden dönen takip numarasının Shopify’ın Fulfillment kaydına otomatik yazılması ve bu bilgi doğrultusunda müşteriye SMS veya e-posta bildiriminin manuel işlem olmadan tetiklenmesi sürecidir.

Shopify Help Center dokümantasyonuna göre bir Fulfillment nesnesi, tracking_number ve tracking_url alanlarını taşır ve bu alanlar API üzerinden güncellendiğinde müşteri bildirim şablonu otomatik devreye girer (Shopify Help Center, 2025). Bu mekanizma, mağaza sahibinin her siparişte takip numarasını elle kopyalayıp müşteriye e-posta yazma ihtiyacını tamamen ortadan kaldırır. Otomasyon kurulduğunda takip numarası, kargo etiketi oluşturulduğu anda müşteriye ulaşır.

Bu sürecin merkezinde üç bileşen bulunur: Fulfillment API, kargo firmasından gelen webhook bildirimi ve Shopify Flow üzerinden kurulan otomasyon kuralı. Bu rehber üçünü ayrı ayrı ve birlikte nasıl çalıştığını adım adım açıklar.

Fulfillment API Takip Numarasını Nasıl İşler?

Fulfillment API, bir sipariş kargoya verildiğinde oluşturulan Fulfillment kaydına takip numarası ve takip URL’sini yazan Shopify Admin API bileşenidir; bu kayıt güncellendiği anda sipariş durumu “fulfilled” olarak değişir.

Bu API, kargo firmasının sistemi tarafından üretilen takip numarasının Shopify tarafına aktarılması için tek resmi kanaldır. Kargo entegrasyon uygulaması veya özel yazılım, kargo firmasından takip numarasını aldıktan hemen sonra bu API’ye bir POST isteği göndererek kaydı tamamlar.

Shopify dokümantasyonuna göre tracking_company alanı, takip URL’sinin doğru kargo firması sayfasına yönlendirilmesi için zorunlu bir parametredir; bu alan boş bırakılırsa müşteri bildirimindeki takip linki çalışmayabilir (Shopify Help Center, 2025). Kargo firması adının doğru yazılması, bu yüzden teknik bir detay değil bildirim kalitesini belirleyen bir zorunluluktur.

İpucu: tracking_company alanına kargo firmasının Shopify’ın tanıdığı resmi isim listesinden (örneğin “Yurtici Kargo”, “Aras Kargo”) birebir uyan bir değer girilmelidir. Farklı yazım (örneğin “yurtiçi kargo” küçük harfle ve Türkçe karakterle) bazı bildirim şablonlarında takip linkinin oluşmamasına neden olabilir.

Webhook Yapılandırması Nasıl Kurulur?

Webhook yapılandırması, kargo firmasının API’sinden gelen durum güncellemesinin (kargoya verildi, dağıtıma çıktı, teslim edildi) gerçek zamanlı olarak Shopify’a veya entegrasyon yazılımına iletilmesini sağlayan bildirim mekanizmasıdır.

İki yönlü webhook akışı burada devreye girer: Shopify tarafında sipariş oluşturulduğunda (orders/create) webhook kargo firmasına gönderilir; kargo firması tarafında durum değiştiğinde ise kendi webhook’u entegrasyon yazılımına bilgi döner. Bu iki akışın senkron çalışması, takip numarasının doğru zamanda oluşmasını garanti eder.

Kritik Not: Webhook uç noktası (endpoint) geçici olarak erişilemez durumdaysa (sunucu bakımı, zaman aşımı) kargo firması genelde birkaç kez yeniden deneme yapar ama sonsuza kadar beklemez. Kritik webhook’lar için bir yeniden deneme (retry) mekanizması veya kuyruk sistemi kurulmadığında bazı takip numaraları Shopify’a hiç ulaşmayabilir.

Müşteriye Otomatik SMS ve E-posta Bildirimi Nasıl Gönderilir?

Müşteriye otomatik bildirim, Shopify’ın Fulfillment kaydı takip numarasıyla güncellendiğinde varsayılan sipariş bildirim şablonunun tetiklenmesiyle gönderilir; SMS bildirimi için ayrıca bir SMS entegrasyon uygulaması gerekir çünkü Shopify’ın temel paketi yalnızca e-posta bildirimini yerleşik sunar.

E-posta bildirimi, Shopify Admin → Settings → Notifications altındaki “Shipping confirmation” şablonu üzerinden otomatik gönderilir ve bu şablon takip numarası ile takip linkini değişken olarak içerir. SMS bildirimi için ise ayrı bir uygulama kurulup aynı Fulfillment olayına bağlanması gerekir.

Peki bu iki kanal neden farklı kurulum gerektiriyor? Shopify’ın çekirdek altyapısı e-posta bildirimini doğrudan desteklerken SMS gönderimi üçüncü parti bir servis (SMS ağ geçidi) üzerinden faturalandırıldığı için platform dışı bir entegrasyon şart koşar.

Uzak Durulması Gereken Risk: Şablon düzenlemesi sırasında {{ fulfillment.tracking_number }} gibi değişkenlerin yanlış yazılması, e-postanın boş takip numarasıyla müşteriye gitmesine neden olur. Şablon değişikliği sonrası mutlaka bir test siparişiyle e-posta çıktısı kontrol edilmelidir.

Shopify Flow ile Otomasyon Nasıl Kurulur?

Shopify Flow ile otomasyon, “sipariş kargoya verildiğinde” tetikleyicisinin (trigger) “müşteriye özel bildirim gönder” veya “etiket ekle” gibi bir eylemle (action) bağlanmasıyla kurulur; kod yazmadan görsel arayüz üzerinden yapılandırılır.

Shopify Flow, temel bildirim şablonlarının ötesinde koşullu senaryolar kurmaya izin verir örneğin belirli bir kargo firmasıyla gönderilen siparişlere farklı bir mesaj şablonu uygulanabilir. Bu, tek tip bildirim yerine kargo firmasına özel iletişim kurmak isteyen mağazalar için işlevseldir.

1. Shopify Admin → Apps → Shopify Flow açılır ve “Create workflow” seçilir.
2. Tetikleyici olarak “Order fulfilled” (sipariş kargoya verildi) seçilir.
3. Koşul olarak istenirse kargo firması veya sipariş tutarına göre filtre eklenir.
4. Eylem olarak “Send internal email” veya bağlı bir SMS uygulamasının aksiyonu seçilir.
5. Workflow etkinleştirilir ve test siparişiyle tetiklenip tetiklenmediği doğrulanır.

İpucu: Shopify Flow, yalnızca Shopify ve Shopify Plus planlarında tam kapsamlı kullanılabilir; bazı temel planlarda workflow sayısı sınırlıdır. Kurulum öncesi mevcut plan üzerindeki Flow limiti kontrol edilmelidir.

Otomasyon Yurtiçi Kargo Entegrasyonuyla Nasıl Bütünleşir?

Kargo takip otomasyonu, Yurtiçi Kargo gibi bir sağlayıcının Shopify’a bağlanmasından sonraki adımdır; entegrasyon kurulmadan takip numarası üretilecek bir kaynak olmaz, bu yüzden iki süreç birbirini tamamlar.

Yurtiçi Kargo entegrasyonu tamamlandıktan sonra API’den dönen takip numarasının Fulfillment kaydına yazılması, bu makalede anlatılan webhook ve Flow adımlarıyla otomatikleştirilir. Yurtiçi Kargo’nun API anahtarı alma süreci ve adres eşleştirme detayları Shopify yurtiçi kargo entegrasyonu rehberinde anlatılır.

Genel kargo entegrasyon yöntemleri ve beş büyük kargo firmasının karşılaştırması için Shopify kargo entegrasyonu rehberine bakılabilir. Ödeme onayından kargoya kadar uzanan sipariş akışının başlangıç noktası olan ödeme entegrasyonu ise Shopify ödeme entegrasyonu rehberinde işlenir.

Takip Numarası Formatı Kargo Firmasına Göre Nasıl Değişir?

Takip numarası formatı, her kargo firmasının kendi barkod sisteminden gelir ve karakter uzunluğu ile ön ek yapısı firmadan firmaya değişir; bu format farkı, tracking_company alanının doğru eşleşmesi kadar entegrasyon aracının regex doğrulamasını da etkiler.

Yurtiçi Kargo takip numaraları genelde 11 haneli sayısal bir dizi kullanırken, Aras Kargo ve MNG Kargo kendi kurumsal barkod aralıklarından üretilen alfanümerik kodlar döndürebilir. Bir entegrasyon aracı, tek bir sabit karakter uzunluğu bekleyecek şekilde kodlanmışsa farklı firmadan gelen bir takip numarasını hatalı biçimde reddedebilir.

Uzak Durulması Gereken Risk: Entegrasyon aracının takip numarası alanına sabit bir karakter uzunluğu doğrulaması (validation) yazılması, birden fazla kargo firmasıyla çalışan mağazalarda bazı geçerli takip numaralarının sistem tarafından reddedilmesine yol açar. Doğrulama kuralı, her kargo firmasının kendi formatına göre ayrı tanımlanmalıdır.

Peki bu format farkı pratikte nereye çıkıyor? Birden fazla kargo firmasıyla çalışan bir mağazada entegrasyon aracı, her firmanın API yanıtındaki takip numarası alanını kendi formatına göre ayrı ayrı işlemeli; aksi halde bazı geçerli takip numaraları hatalı biçimlendirme nedeniyle Fulfillment kaydına hiç yazılmayabilir.

Yoğun Kampanya Günlerinde Takip Numarası Oluşturma Nasıl Ölçeklenir?

Yoğun kampanya günlerinde takip numarası oluşturma, sipariş hacminin normalin birkaç katına çıktığı anlarda API isteklerinin kuyruğa alınıp sırayla işlenmesiyle ölçeklenir; senkron (anlık) işleme modeli bu yoğunlukta zaman aşımı ve kayıp istek riski taşır.

Kargo firmasının API’si veya entegrasyon aracı, dakika başına belirli sayıda isteğe izin veren bir rate limit (istek sınırı) uygular. Kampanya günü binlerce siparişin aynı anda kargoya verilmesi gerektiğinde bu sınır aşılırsa, sınırı aşan istekler reddedilir ve o siparişlerin takip numarası oluşturulamaz.

Bu senaryo, Shopify’ın kendi API rate limit yapısıyla da doğrudan ilişkilidir; stok ve sipariş senkronizasyonunda yaşanan benzer tıkanma noktaları Shopify API rate limit ve stok senkronizasyon hataları rehberinde daha geniş teknik çerçevede ele alınır.

1. Kargo etiketi oluşturma istekleri bir kuyruk sistemine (queue) yazılır, doğrudan API’ye anlık gönderilmez.
2. Kuyruktaki istekler, kargo firmasının izin verdiği dakikalık limit içinde kademeli olarak işlenir.
3. Reddedilen veya zaman aşımına uğrayan istekler otomatik olarak yeniden denenir (exponential backoff ile artan bekleme süresi).
4. İşlenemeyen siparişler bir hata listesine düşer ve operasyon ekibi tarafından manuel kontrol edilir.

İpucu: Kampanya öncesi entegrasyon aracının kuyruk ve yeniden deneme kapasitesi test edilmelidir. Geçmiş yıllarda normalin 5 katı sipariş alan mağazalarda, kuyruk mekanizması olmayan entegrasyonlarda yüzlerce siparişin takip numarası kampanya bitiminden saatler sonra oluşabilmiştir.

Kuyruk Tıkanıklığı Nasıl İzlenir?

Kuyruk tıkanıklığı izleme, bekleyen istek sayısının belirli bir eşiği aştığında operasyon ekibine otomatik uyarı gönderen bir izleme (monitoring) katmanı kurulmasıyla yapılır; bu katman olmadan kuyruktaki birikme ancak müşteri şikayetleri arttığında fark edilir.

Basit bir izleme kurulumu, kuyrukta bekleyen istek sayısını her 5 dakikada bir kontrol edip sayı 100’ü geçtiğinde e-posta veya Slack bildirimi gönderecek şekilde yapılandırılabilir. Bu eşik değeri, mağazanın günlük ortalama sipariş hacmine göre ayarlanmalıdır; düşük hacimli bir mağazada 100 istek zaten anormal bir birikimi işaret ederken yüksek hacimli bir mağazada bu sayı normal seyir olabilir.

Erken uyarı mekanizması kurulduğunda operasyon ekibi, kargo firmasının API’sinde yaşanan bir kesintiyi kampanya günü ortasında fark edip manuel müdahaleye (örneğin geçici olarak ikinci bir kargo firmasına yönlendirme) daha hızlı geçebilir.

Takip Sayfası Müşteri Deneyimini Nasıl Etkiler?

Takip sayfası, müşterinin kargo durumunu gördüğü arayüzdür ve Shopify’ın varsayılan “Track your order” sayfası yerine markalı bir takip sayfası kullanılması müşteri destek talebi hacmini azaltır; takip numarası doğru oluşturulsa bile sunum şekli müşteri deneyimini belirler.

Varsayılan Shopify bildirim e-postası, takip linkini doğrudan kargo firmasının kendi sitesine yönlendirir. Bazı mağazalar bunun yerine bir “sipariş takip” uygulamasıyla kendi domainlerinde markalı bir takip sayfası sunar; bu sayfa aynı Fulfillment API verisini kullanır ama görsel deneyimi mağazanın kontrolündedir.

Peki bu fark neden önemli? Müşteri kargo firmasının sade ve marka dışı sayfasına yönlendirildiğinde mağazayla bağını kaybeder; markalı takip sayfası ise aynı ekranda ek ürün önerisi veya destek linki göstererek ikinci bir satış fırsatı yaratabilir.

Kritik Not: Markalı takip sayfası kuran mağazalar, Fulfillment API’den gelen tracking_url alanını kendi sayfalarına yönlendirecek şekilde ayrıca yapılandırmalıdır. Bu yönlendirme kurulmazsa müşteri hem markalı sayfayı hem orijinal kargo linkini karışık şekilde görebilir.

Markalı takip sayfası kullanan mağazalarda destek ekibine gelen “siparişim nerede” tipi talep hacminin düştüğü gözlemlenir; müşteri, e-posta içindeki tek bir linke tıklayıp kendi markasının arayüzünde net bir durum çubuğu (sipariş alındı, hazırlanıyor, kargoda, teslim edildi) gördüğünde ek soru sorma ihtiyacı azalır. Bu etkinin büyüklüğü mağazadan mağazaya değişir, ama destek yükünü azaltan bir yönü olduğu saha gözlemlerinde tutarlı şekilde görülür.

Takip Numarası Oluşturulmadığında Hata Ayıklama Süreci Nasıl İşler?

Takip numarası oluşturulmadığında hata ayıklama, önce webhook loglarının kontrol edilmesiyle başlar; sorun genelde üç noktadan birinde bulunur: kargo firması API’sinden yanıt gelmemesi, entegrasyon aracının yanıtı işleyememesi veya Shopify Fulfillment API’sine yazma isteğinin reddedilmesi.

İlk kontrol adımı, kargo firmasının API’sine giden isteğin gerçekten gönderilip gönderilmediğidir. Log kaydında istek görünüyor ama yanıt boşsa, sorun kargo firması tarafındaki geçici bir kesintiden kaynaklanıyor olabilir. İstek hiç loglanmamışsa, sorun genelde entegrasyon aracının tetikleyici olayı (sipariş kargoya verildi) hiç yakalamadığı anlamına gelir.

1. Sipariş detayında “Fulfillment” sekmesi açılıp takip numarası alanının boş olup olmadığı kontrol edilir.
2. Entegrasyon uygulamasının log panelinden ilgili sipariş numarasıyla eşleşen istek/yanıt kaydı aranır.
3. Kargo firmasının kendi kurumsal panelinden aynı sipariş için bir gönderi kaydı oluşup oluşmadığı doğrulanır.
4. Kayıt kargo firmasında varsa ama Shopify’a yansımamışsa, sorun API yazma adımındadır; kayıt kargo firmasında da yoksa sorun daha önceki bir adımda, sipariş verisinin kargo firmasına hiç iletilmediği noktadadır.
5. Kök neden bulunduktan sonra ilgili sipariş manuel olarak tracking_number alanı girilerek düzeltilir ve müşteriye bildirim elle tetiklenir.

İpucu: Her kargo entegrasyon aracının, son 30 günün istek/yanıt loglarını sipariş numarasına göre aranabilir tutması operasyonel açıdan zaman kazandırır. Log tutmayan veya loglarını 7 günden kısa süre saklayan bir entegrasyon aracı, geriye dönük hata ayıklamayı imkansız hale getirir.

Sahada sık karşılaşılan bir örnek şudur: bir mağaza, kampanya gününde 40 siparişte takip numarasının oluşmadığını fark etmiş ve kök neden entegrasyon aracının o gün kargo firmasının API’sinde yaşanan 20 dakikalık bir kesintiyi yeniden deneme mekanizması olmadan sessizce atlaması olmuştur. Yeniden deneme mekanizması eklendikten sonra aynı tür kesintilerde sipariş kaybı sıfıra inmiştir.

İade Kargosu için Ayrı Bir Takip Numarası Nasıl Yönetilir?

İade kargosu için ayrı bir takip numarası, müşterinin ürünü geri gönderdiği sevkiyatın orijinal siparişin takip numarasından bağımsız olarak izlenmesini sağlar; bu ikinci takip numarası genelde Shopify’ın standart Fulfillment akışının dışında, ayrı bir iade yönetim aracı veya kargo firmasının iade portalı üzerinden oluşturulur.

Standart Shopify Fulfillment nesnesi tek yönlü sevkiyat (mağazadan müşteriye) için tasarlanmıştır; iade sevkiyatının (müşteriden mağazaya) takip numarası bu nesneye doğrudan yazılmaz. Bu yüzden iade takibi genelde sipariş notuna elle eklenir veya ayrı bir iade yönetim uygulaması üzerinden takip edilir.

Peki bu ayrım operasyonda ne anlama geliyor? Depo ekibi, gelen iade paketini karşılarken paket üzerindeki iade takip numarasıyla hangi siparişe ait olduğunu eşleştirmek zorunda kalır; bu eşleştirme otomasyona bağlanmazsa iade işleme süresi manuel kontrol nedeniyle uzar.

İpucu: İade hacmi yüksek olan mağazalar, kargo firmasının sunduğu “ters lojistik” (reverse logistics) API’sini kullanarak iade takip numarasını da sipariş kaydına otomatik yazan bir entegrasyon kurmalıdır. Bu, depo tarafında elle eşleştirme ihtiyacını ortadan kaldırır.

Bir mağazanın iade sürecinde iade takip numarasını sipariş notuna otomatik yazan bir kural tanımlaması, destek ekibinin müşteriye “iade kargonuz nerede” sorusuna Shopify panelinden anında yanıt vermesini sağlar; bu kural olmadan destek ekibi kargo firmasının ayrı iade portalına manuel giriş yapmak zorunda kalır.

Sık Sorulan Sorular

Shopify kargo takip numarasını otomatik oluşturmak için kod yazmak gerekir mi? Hayır, Shopify Flow ve hazır entegrasyon uygulamaları kod yazmadan görsel arayüzle kurulabilir. Özel iş kuralları gerektiren senaryolarda geliştirici desteği faydalı olur.

Takip numarası müşteriye neden gitmiyor? En sık neden tracking_company alanının boş veya hatalı yazılmasıdır. İkinci sık neden ise bildirim şablonundaki değişkenin yanlış yazılmasıdır.

SMS bildirimi Shopify’da varsayılan olarak var mı? Hayır, Shopify’ın temel paketi yalnızca e-posta bildirimini yerleşik sunar. SMS için ayrı bir uygulama kurulup Fulfillment olayına bağlanmalıdır.

Shopify Flow hangi planlarda kullanılabilir? Flow, Shopify ve üzeri planlarda tam kapsamlı çalışır; bazı giriş seviyesi planlarda workflow sayısı sınırlı olabilir. Kurulum öncesi mevcut plan kontrol edilmelidir.

Birden fazla kargo firması kullanılırsa otomasyon nasıl ayarlanır? Shopify Flow’da koşullu filtre eklenerek her kargo firmasına özel bir workflow kurulabilir. Bu, farklı firmalar için farklı bildirim şablonu kullanmayı mümkün kılar.

Takip numarası oluşturulduktan sonra değiştirilebilir mi? Evet, Fulfillment API üzerinden takip numarası güncellenebilir ama bu genelde manuel düzeltme gerektiren istisnai bir durumdur. Doğru kurulmuş bir entegrasyonda bu ihtiyaç nadiren doğar.

Kargo firması değiştirildiğinde eski takip numaraları ne olur? Eski siparişlerin Fulfillment kaydındaki takip numarası ve tracking_company bilgisi olduğu gibi kalır, geriye dönük değişmez. Yeni siparişler değişiklik sonrası aktif olan kargo firmasının formatıyla oluşturulur.

Takip numarası oluşmadan önce müşteriye bildirim gider mi? Hayır, standart Shopify akışında “kargoya verildi” bildirimi ancak Fulfillment kaydı takip numarasıyla güncellendiğinde tetiklenir. Takip numarası olmadan erken bildirim gönderilmesi, entegrasyonun yanlış yapılandırıldığı anlamına gelir.

Sonraki Adım

Kargo takip otomasyonu kurulduktan sonra sürecin baştan sona doğru çalıştığını görmek için hangi kargo firmasıyla entegrasyon yapıldığına bağlı olarak ilgili kurulum rehberine dönülmelidir. Genel kargo entegrasyon yöntemleri ve firma karşılaştırması için Shopify kargo entegrasyonu rehberi başlangıç noktası olarak kullanılabilir.