Shopify Uygulaması
Tarafından Talha MERT and Fatih ÇELEBİ
Tarafından Talha MERT and Fatih ÇELEBİ
Shopify'da Gönderi Nasıl Oluşturulur ?
Shopify mağazanızı Kargo Entegratör eklentimize entegre ettikten sonra, gönderi oluşturmak için aşağıdaki adımları takip edebilirsiniz: İlgili siparişin detay sayfasına gidin. Diğer İşlemler menüsünden Kargo Entegratör ile Gönderi Oluştur seçeneğini tıklayın. ⚠️ Dikkat: Gönderi oluşturma işleminin başarılı olması için ilgili siparişin durumunun "Gönderilmedi" olarak işaretlenmiş olması gerekmektedir. Barkod Oluşturma ve Gönderi Özelleştirme Barkod oluşturma aksiyonunu gerçekleştirdikten sonra, karşınıza gönderinizi özelleştirebileceğiniz ve barkod oluşturabileceğiniz bir ekran gelecektir. Bu ekranda aşağıdaki işlemleri gerçekleştirebilirsiniz: - Barkod Oluşturma: Gönderiniz için barkodu kolayca oluşturabilirsiniz. - Adres Düzenleme: Müşterinizin adres bilgilerinde bir hata varsa, bu alanları düzenleyebilirsiniz. - Kargo Firması Seçimi: Gönderinizi hangi kargo firmasıyla göndereceğinizi belirleyebilirsiniz. - Kargo Türü Belirleme: Kargonuzun türünü seçebilirsiniz (örneğin, normal gönderi, kapıda ödeme gibi). Bu ekran, gönderilerinizin detaylarını özelleştirmek ve doğru bir şekilde işleme koymak için ihtiyacınız olan tüm seçenekleri sunar.
Shopify Kargo Takip Sayfası Nasıl Oluşturabilirim ?
Kargo Entegratör sayesinde, kolayca bir Shopify kargo takip sayfası oluşturabilirsiniz. Bunun için Shopify üzerinden Kargo Entegratörü > Kargo Takip adımlarını takip etmeniz yeterli, daha sonrasında size hazır bir kargo takip sayfası oluşturacaktır. Daha sonra bu sayfayı özelleştirebilir, kendi marka tarzınıza göre düzenleyebilirsiniz.
Adres Metafield Eşleştirme ve Ayarları
Shopify mağazanızda standart veri alanlarının ötesine geçerek oluşturduğunuz Metafield (Özel Alan) verilerini, Kargo Entegratör altyapısına tanıtmanızı ve kargo barkodlarına otomatik olarak yansıtmanızı sağlayan özelliktir. Bu özellik, özellikle ödeme (checkout) sayfasını özelleştirebilen Shopify Plus kullanıcıları ve ürünlerinde özel desi/ebat bilgisi tutan mağazalar için geliştirilmiştir. Bu Özellik Ne İşe Yarar? Standart Shopify sipariş yapısında bulunmayan ancak sizin mağazanızda kullandığınız özel verileri kargo sürecine dahil etmenizi sağlar. - Örnek 1 (Adres Ayrıştırma): Shopify'da standart olarak "İlçe" alanı bazen adres satırının içinde gelir. Eğer checkout sayfanızda müşteriye "İlçe" bilgisini ayrı bir özel alan (metafield) olarak girdiriyorsanız, bu veriyi doğrudan kargo firmasının "İlçe" alanıyla eşleştirebilirsiniz. - Örnek 2 (Ürün Desisi): Ürünlerinizin ağırlığı yerine "Desi" bilgisini bir metafield olarak tutuyorsanız, bu veriyi entegrasyona tanıtarak kargo maliyetlerinizi doğru hesaplatabilirsiniz. Nasıl Kullanılır? Kargo Entegratör panelinizde Ayarlar > Metafield Ayarları sekmesine gidin. Karşınıza iki ana bölüm çıkacaktır: 1. Müşteri Metafield Ayarları (Customer Metafields) Sipariş veren müşterinin adres ve iletişim bilgilerini özelleştirdiğiniz alanlardır. Shopify Plus kullanıcıları için ödeme sayfasında (Checkout Extensibility) eklenen özel alanlar buraya tanımlanır. - Kullanımı: Eşleştirmek istediğiniz alanın altındaki kutucuğa, Shopify'daki metafield anahtarını key olarak yazmanız yeterlidir. örn: "ilce" - Eşleştirilebilir Alanlar: İsim, Soyisim, Telefon, E-posta, Adres, İlçe, İl, Ülke. İpucu: Örneğin; Shopify'da İlçe bilgisini custom namespace'i altında ilce key'i ile tutuyorsanız, paneldeki "İlçe" kutucuğuna ilce yazmalısınız. 2. Ürün Metafield Ayarları (Product Metafields) Ürünlerinize ait kargolama verilerini içerir. - Desi: Ürünlerinizin desi bilgisini Shopify ürün detaylarında bir Metafield olarak saklıyorsanız, ilgili anahtarı buraya girin. Böylece sipariş oluştuğunda sistem ağırlık yerine veya ağırlıkla birlikte bu desi bilgisini baz alacaktır. ⚠️ Önemli Dikkat Edilmesi Gerekenler 1. Veri Kontrolü: Shopify panelinizden Ayarlar > Özel Veriler (Custom Data) menüsüne giderek doğru anahtarı (key) aldığınızdan emin olun. 2. Boş Bırakma: Kullanmadığınız veya standart Shopify verisini kullanmak istediğiniz alanları boş bırakabilirsiniz.
Desi Hesaplama Ayarları
Kargo Entegratör, siparişlerinizdeki ürünlerin desi bilgilerini kargo firmasına iletirken artık iki farklı yöntem sunuyor. İş modelinize ve paketleme stratejinize göre desi hesaplama mantığını değiştirebilirsiniz. Bu Özellik Ne İşe Yarar? Standart işleyişte, bir siparişte birden fazla ürün varsa sistem bu ürünlerin desilerini toplayarak kargo firmasına iletir. Ancak yeni geliştirdiğimiz "En Büyük Desi Değeri" özelliği sayesinde, sepet toplamı yerine sadece o sepetteki en büyük hacme sahip ürünün desisini baz alabilirsiniz. Bu özellik genellikle şu durumlarda tercih edilir: - İç İçe Geçen Ürünler: (Örn: 5 adet plastik kova sipariş edildiğinde, kovalar iç içe geçtiği için kargo paketi 5 kat büyümez, tek bir kova boyutunda kalır.) - Sabit Paketleme: Küçük ürünlerin büyük bir ürünün yanına/içine eklenerek paket hacmini değiştirmediği durumlar. Nasıl Çalışır? Örnek Senaryo Bir müşterinizin mağazanızdan 2 adet aynı ürünü satın aldığını varsayalım. - Ürün: Dekoratif Vazo - Tekil Desi: 2 Desi 1. Varsayılan Durum (Ayar Kapalıyken) Sistem klasik mantıkla çalışır ve ürünlerin desilerini toplar. - Hesaplama: 2 Adet x 2 Desi = 4 Desi - Kargo firmasına iletilen değer 4 Desi olur. 2. Yeni Özellik Aktifken (Ayar Açıkken) Sistem sipariş içeriğindeki ürünlere bakar, adet sayısını veya toplamı dikkate almaz; sadece en yüksek desi değerini bulur ve onu kullanır. - Hesaplama: İçerikteki en büyük ürün 2 Desi. - Kargo firmasına iletilen değer 2 Desi olur. Nasıl Aktif Edilir? Bu ayarı kullanmak için Kargo Entegratör panelinizde aşağıdaki adımları izleyin: 1. Panelinizden Ayarlar -> Diğer Ayarlar sayfasına gidin. 2. Kutucuğu işaretleyerek ayarı aktif hale getirin ve kaydedin. Uyarı: Bu özellik aktif edildiğinde, siparişte 100 adet ürün olsa bile sistem sadece tek bir ürünün (en büyüğünün) desisini baz alacaktır. Eğer ürünleriniz yan yana paketleniyorsa ve hacim artıyorsa bu ayarı kapalı tutmanızı öneririz.
Shopify Easy COD Form Alan Eşleştirme Rehberi
Kargo Entegratör eklentimizde, Shopify Easy COD Form üzerinden alınan müşteri bilgilerinin doğru şekilde kargo sistemine aktarılabilmesi için form alan adlarının (field name) belirli isimlerle tanımlanması gerekmektedir. Eğer il, ilçe ve diğer teslimat bilgilerini COD form üzerinden almak istiyorsanız, aşağıdaki alan isimlerini birebir kullanmanız gerekmektedir. ⚠️ Önemli: Sistemimiz verileri input label’a göre değil, input’un name attribute değerine göre okumaktadır. Bu nedenle yalnızca görünen alan adı değil, teknik alan adı da aşağıdaki gibi olmalıdır. Alan Eşleştirmeleri COD formunuzdaki input alanlarının name değerleri aşağıdaki gibi olmalıdır: - Ad → Ad - Soyad → Soyad - Telefon → Telefon - Adres → Adres - İl → İl - İlçe → İlçe - E-posta → E-posta - Firma → Firma - Ülke → country Örnek Senaryo - İlçe alanı için input name="İlçe" olmalıdır. - İl alanı için input name="İl" olmalıdır. - Telefon alanı için input name="Telefon" olmalıdır. Eğer bu isimler farklı yazılırsa, sipariş oluşturulsa bile kargo etiketi oluşturulurken eksik veri problemi yaşanabilir.
Gönderim Profili Eşleştirme
Yakında.
Shopify Print Entegrasyonu ve Kargo Barkodu Kullanımı
Bu teknik doküman, Shopify Print uygulaması üzerinden hazırladığınız gönderi dökümanlarına ve paketleme fişlerine kargo barkodlarını dinamik olarak nasıl ekleyebileceğinizi açıklamaktadır. Bu entegrasyon ile kargo operasyonlarınızı tek bir döküman üzerinden yönetebilir ve süreçlerinizi hızlandırabilirsiniz. API Uç Noktaları (Endpoints) Kargo barkodlarını dökümanlarınıza çekmek için iki farklı API kanalı sunulmaktadır. İhtiyacınıza göre aşağıdaki uç noktalardan uygun olanı seçebilirsiniz: Kullanım AmacıAPI EndpointStandart Kargo Barkodu http://app.kargoentegrator.com/api/helpers/barcode-image/***team_id***/{{ order.id }} Tam Barkod Görseli (Hepsijet vb.) https://app.kargoentegrator.com/api/helpers/barcode-full-image/***team_id***/{{ order.id }}?api_key=***APIKEY*** Önemli Not: Hepsijet gibi kargo firmaları, barkodun yanı sıra ek gönderi bilgilerini içeren özel bir etiket yapısı kullanmaktadır. Bu tür firmalarla çalışıyorsanız, daha sağlıklı bir çıktı almak için barcode-full-image kanalını kullanmanız önerilir. Şablon Entegrasyon Kodları Shopify Print şablonunuzda (Liquid template) barkodun görünmesini istediğiniz bölüme aşağıdaki HTML kod bloklarını yerleştirebilirsiniz. 1. Standart Barkod Kullanımı Standart kargo barkodunu dökümana yerleştirmek için bu yapıyı kullanınız: 2. Tam Kargo Etiketi Kullanımı (API Key Gerekli) Hepsijet ve benzeri kapsamlı etiket yapısı gerektiren firmalar için bu yapıyı kullanınız: Parametre Açıklamaları - team_id: Kargo Entegratör panelinizde size özel tanımlanan ekip kimlik numarasıdır. https://app.kargoentegrator.com/user/profile adresimde team_id bilgisine ulaşabilirsiniz. - {{ order.id }}: Shopify tarafından her sipariş için otomatik atanan benzersiz kimliktir; sistem bu kod sayesinde doğru barkodu anlık olarak eşleştirir. - API_KEY: barcode-full-image kullanımında gerekli olan güvenlik anahtarınızdır. https://app.kargoentegrator.com/integration/api adresinden API Keyi alabilirsiniz.
Shopify Türkiye Adres Doğrulama Çözümleri Yardım Dökümanı ve Videosu
Shopify Türkiye Adres Doğrulama ve Kargo Entegrasyonu Shopify'ın küresel adres yapısı, Türkiye'deki il, ilçe ve mahalle formatıyla tam örtüşmediği için satıcılar sıklıkla eksik veya hatalı adres verileriyle karşılaşır. Bu durum, kargo şirketlerinin barkod oluştururken hata vermesine ve gönderim süreçlerinde aksamalara yol açar. Bu dökümanda, Shopify mağazanızda Türkiye standartlarına uygun adres verisi toplamanın ve Kargo Entegratör'ün akıllı çözümleriyle bu süreci otomatikleştirmenin yollarını bulacaksınız. Video anlatım: https://youtu.be/gWjyS6Uu7G4 1. Standart Shopify Mağazaları: "Adres 2" Alanını "İlçe" Yapma Shopify Plus kullanıcısı değilseniz ve yerleşik ilçe alanı henüz aktif değilse, ek yazılıma gerek kalmadan mevcut form alanlarını uyarlayabilirsiniz: 1. Ödeme ayarlarına girin: Yönetim panelinden Ayarlar (Settings) > Ödeme (Checkout) menüsüne gidin. 2. Dil ve içerik düzenleme: Sayfayı aşağı kaydırıp ödeme içeriği/dil verilerini düzenleyebileceğiniz alana gelin ve düzenleme seçeneğine tıklayın. 3. Etiketi değiştirin: Arama çubuğuna apartment veya address yazarak "Adres Satırı 2" alanını bulun. Alanın adını silip yerine İlçe yazın ve sayfayı güncelleyin. Sonuç: Müşterileriniz ödeme sayfasında "Adres Satırı 2" yerine "İlçe" alanını görür ve buraya ilçelerini girer. Kargo Entegratör bu veriyi otomatik olarak "İlçe" kabul edip kargo firmalarına hatasız iletir. 2. Yapay Zeka (AI) Destekli Otomatik Adres Düzenleme Müşteriler otomatik doldurma kullandığında, ilçeyi yanlış girdiğinde (örneğin hem il hem ilçe kısmına "Bursa" yazması) veya alanı boş bıraktığında kargo sistemleri hata verir. Kargo Entegratör paketleriyle gelen AI motoru bu sorunu kökten çözer: - İşleyiş: Sistem, Google Haritalar desteğiyle girilen adres verilerini analiz eder. Eksik veya hatalı kısımları saptayıp doğru il, ilçe ve mahalle bilgisini bulur ve günceller. (Örn: İlçe kısmındaki hatalı bir veriyi analiz edip doğrusu olan "Nilüfer" ile değiştirir.) - Kullanım seçenekleri: AI ile adres doğrulamayı tekli gönderi oluştururken panelden yapabilir; ayrıca toplu barkod oluşturma ekranından veya otomatik barkod ayarlarındaki "AI ile adres düzenleme" seçeneğini aktif ederek tamamen otomatik da kullanabilirsiniz. 3. "Thank You" (Teşekkür) Sayfası Adres Doğrulama Modülü Müşteri ödemeyi tamamladıktan sonra, sipariş kargoya verilmeden önceki son kontrol aşamasıdır. - Kurulum: Shopify Tema Editörü'nde Checkout > Thank You (Teşekkür Ederiz) sayfasını seçin. Uygulamalar kısmından Kargo Entegratör'ün "Adres Doğrulama" özelliğini bu sayfaya ekleyin. - İşleyiş: Müşteri siparişini tamamladığında ekranda son bir adres onaylama alanı çıkar. Checkout'ta girdiği verileri doğrudan gösterebilir veya önce yapay zekadan geçirip doğrulanmış halini müşterinin önüne getirebilirsiniz. - Avantajı: İl ve ilçe seçenekleri açılır liste (select box) olarak sunulduğu için yazım ve otomatik doldurma hataları tamamen engellenir. Müşteri adresi onayladığında bilgi Shopify panelinize güncellenmiş olarak yansır. Bu işlem zorunlu değildir; müşteri onaylamadan da sayfayı geçebilir. 4. Shopify Plus Kullanıcıları İçin Gelişmiş Entegrasyon Shopify Plus kullanıcıları ödeme sayfalarını tamamen özelleştirebildiği için kendi belirledikleri özel alanlarla ilçe verisi toplayabilir. - Çözüm: Kargo Entegratör, Plus mağazalarının esnek yapısıyla tam uyumlu çalışır. Ödeme sayfasında oluşturduğunuz ilçe alanına verdiğiniz ismi (input name), Kargo Entegratör panelindeki ilgili ayar alanına yazmanız yeterlidir. - Sonuç: Sistem, açtığınız özel alandan ilçe verisini otomatik okur ve kargo firmasının sistemine kusursuz entegre eder.