Anasayfa Shopify Uygulaması

Shopify Uygulaması

Talha MERT Fatih ÇELEBİ
Tarafından Talha MERT and 1 diğer
• 8 makaleler

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.

Son güncelleme tarihi Feb 05, 2026

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.

Son güncelleme tarihi Feb 05, 2026

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=API_KEY Ö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ı - EKIP_ID: Kargo Entegratör panelinizde size özel tanımlanan ekip kimlik numarasıdır. - {{ 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.

Son güncelleme tarihi Apr 29, 2026