Shopify Uygulaması

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.

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.

Shopify Order Print Entegrasyonu ve Kargo Barkodu Kullanımı

Shopify Order Printer'a Kargo Barkodu Entegrasyonu https://www.youtube.com/watch?v=_D6Hpqft4Rk Bu doküman, Shopify Order Printer uygulamasıyla hazırladığınız irsaliye ve paketleme fişlerine KargoEntegrator üzerinden dinamik olarak kargo barkodu eklemenizi anlatır. Böylece tek bir belge hem paketleme fişi hem de kargo firmasının okutabileceği geçerli bir kargo etiketi olarak kullanılabilir. Ne İşe Yarar? Kendi tasarladığınız paketleme fişi veya irsaliye şablonuna KargoEntegrator'ın ürettiği barkodu gömerek: - Ayrı ayrı kargo etiketi bastırma ihtiyacını ortadan kaldırırsınız. - Paketleme ve sevkiyat sürecini tek bir çıktı üzerinden yönetirsiniz. - Kargo firmasının barkod okuyucusuyla doğrudan işlem yapabilecek bir belge elde edersiniz. API Uç Noktaları İhtiyacınıza göre iki farklı barkod uç noktası sunuyoruz: 1. Standart Barkod — Çoğu kargo firması için yeterli olan sade barkod görselidir. https://app.kargoentegrator.com/api/helpers/barcode-image/TEAM_ID/{{ order.id }} 2. Tam Kargo Etiketi — Hepsijet gibi barkodun yanında gönderici, alıcı, ürün gibi ek bilgi bloklarını da içeren kapsamlı etiket yapısıdır. API anahtarı gerektirir. https://app.kargoentegrator.com/api/helpers/barcode-full-image/TEAM_ID/{{ order.id }}?api_key=APIKEY Not: Hepsijet ve benzeri firmalarla çalışıyorsanız barcode-full-image uç noktasını kullanmanız, kargo firmasının sistemleriyle uyumlu bir çıktı almanız için gereklidir. Adım Adım Kurulum 1. Order Printer'da şablonu açın Shopify yönetim panelinden Order Printer uygulamasına girin ve düzenlemek istediğiniz şablonu seçin (örneğin Packing Slip). Şablonlar Liquid tabanlıdır ve tamamen özelleştirilebilir. 2. Barkod kodunu şablona ekleyin Barkodun görünmesini istediğiniz yere, kullandığınız kargo firmasına göre aşağıdaki iki koddan uygun olanı yapıştırın. Standart barkod için: <img src="https://app.kargoentegrator.com/api/helpers/barcode-image/TEAM_ID/{{ order.id }}" width="300"> Tam kargo etiketi (Hepsijet vb.) için: <img src="https://app.kargoentegrator.com/api/helpers/barcode-full-image/TEAM_ID/{{ order.id }}?api_key=APIKEY" width="400"> 3. Team ID ve API Key değerlerini girin Yapıştırdığınız kodda TEAM_ID (ve gerekiyorsa APIKEY) alanlarını kendi bilgilerinizle değiştirin. Sipariş numarası ({{ order.id }}) Shopify tarafından her sipariş için otomatik doldurulur — bu değere dokunmanıza gerek yoktur. 4. Kaydedin ve test edin Şablonu kaydedip bir siparişin çıktısını aldığınızda, barkod otomatik olarak fişin üzerinde görünecektir. width değerini değiştirerek barkodun boyutunu ve şablon içindeki yerleşimini istediğiniz gibi ayarlayabilirsiniz. Parametreler | Parametre | Açıklama | Nereden alınır? | | ---------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | TEAM_ID | KargoEntegrator hesabınıza özel ekip kimlik numarası | app.kargoentegrator.com/user/profile | | {{ order.id }} | Shopify'ın her siparişe otomatik atadığı benzersiz kimlik | Otomatik — dokunmayın | | APIKEY | barcode-full-image uç noktası için gereken güvenlik anahtarı | app.kargoentegrator.com/integration/api | Sık Karşılaşılan Durumlar - Barkod görünmüyor: TEAM_ID değerinin doğru girildiğinden ve URL'de TEAM_ID yazısının kaldığı bir yer olmadığından emin olun. - Hepsijet barkodu okunmuyor: Standart barkod uç noktasını değil, barcode-full-image uç noktasını kullandığınızdan emin olun. - barcode-full-image boş dönüyor: API anahtarının geçerli olduğunu ve URL sonuna ?api_key=... olarak eklendiğini kontrol edin. Sorun devam ederse destek ekibiyle iletişime geçebilirsiniz.

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.

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.

Gönderim Profili Eşleştirme

Shopify mağazanızın ödeme (checkout) sayfasında müşterilerinizin seçtiği kargo yöntemine göre kargo firması, kargo hesabı ve paket tipi otomatik olarak eşleştirilir. Böylece ister otomatik barkod ister manuel barkod oluşturun, her sipariş için tekrar kargo firması seçmenize gerek kalmaz; entegrasyon işlemi sizin yerinize otomatik tamamlar. Nasıl Çalışır? 1. Shopify Seçimi: Müşteriniz checkout sayfasında bir kargo yöntemi seçer (Örn: DHL, Aras Kargo, hepsiJET). 2. Kargo Entegratör Eşleşmesi: Entegratör, müşterinizin seçtiği kargo adını tanımladığınız profille eşleştirir. 3. Otomatik Barkod: Sipariş barkodu oluşturulurken doğru kargo hesabı, paket tipi ve ödeme bilgileri doğrudan atanır. Kurulum Adımları Adım 1: Shopify Tarafındaki Kargo Adını Kontrol Edin Shopify panelinizde Ayarlar > Kargo ve teslimat bölümüne gidin. Ödeme sayfasında müşterilerinize sunduğunuz kargo yönteminin adını (Örn: Aras Kargo) tam olarak nasıl yazdıysanız not edin. Adım 2: Kargo Entegratöründe Eşleştirme Oluşturun 1. Kargo Entegratörü paneline giriş yapın. 2. Ayarlar sekmesine tıklayın ve üst menüden Gönderim Profil Eşleştirmeleri sayfasını seçin. 3. + Ekle butonuna basarak yeni bir eşleştirme satırı oluşturun. 4. Alanları kargo firmalarınıza göre uygun doldurun Videomuzu İnceleyin: https://youtu.be/ij-zU-Z8u48

3. Parti Uygulamalar ile Gönderi Verisinin Paylaşılması (Shopify Metafield ile)

Kargo Entegratör tarafından Shopify siparişleriniz için oluşturulan kargo barkod bilgilerine, 3. parti uygulamalar üzerinden Shopify Admin GraphQL API'si ile ulaşabilirsiniz. Bu doküman, ilgili ayarın nasıl açılacağını, sorgunun nasıl yapılacağını ve dönen yanıtın nasıl okunacağını adım adım açıklar. 1. İlgili Ayarı Aktif Edin Barkod bilgisinin siparişin metafield alanına yazılabilmesi için öncelikle ilgili ayarın açık olması gerekir. 1. Kargo Entegratör panelinde Ayarlar bölümüne gidin. 2. Diğer Ayarlar sekmesini açın. 3. "Barkod oluşturduktan sonra siparişin özel alanını (metafield) güncelle" seçeneğini işaretleyin. Bu seçenek aktif edildiğinde; üçüncü parti uygulamaların okuyabilmesi için, barkod ve kargo firması bilgileri siparişin özel alanına (metafield) eklenir. Bu veriye kargo_entegrator isim alanı (namespace) üzerinden erişilebilir. ⚠️ Dikkat: Bu ayar aktif değilken oluşturulan gönderilerin barkod bilgisi metafield alanına yazılmaz. Ayarı açtıktan sonra oluşturulan gönderiler için barkod verisi paylaşılmaya başlanır. 2. Barkod Verisi Nerede Tutulur? Kargo Entegratör, oluşturduğu her gönderinin barkod bilgisini ilgili siparişin metafield alanında saklar. Bu veriye erişmek için aşağıdaki namespace ve key kullanılır: - Namespace: kargo_entegrator - Key: shipment_data Bu metafield içerisinde gönderiye ait shipment_id, barcode ve cargo_company (kargo firması) bilgileri yer alır. 3. Barkod Verisini Çekmek İçin Sorgu Aşağıdaki GraphQL sorgusu ile bir siparişe ait kargo barkod bilgisine ulaşabilirsiniz. Sorgudaki sipariş ID'sini (gid://shopify/Order/...) kendi siparişinizin ID'si ile değiştirmeniz yeterlidir. { order(id: "gid://shopify/Order/6176180273389") { name id metafield(namespace: "kargo_entegrator", key: "shipment_data") { id jsonValue } } } ⚠️ Dikkat: Sorgudaki order(id: ...) alanındaki değeri, barkod bilgisini almak istediğiniz siparişin kendi ID'si ile güncellemeyi unutmayın. 4. Örnek Yanıt Sorgu başarıyla çalıştığında, aşağıdakine benzer bir yanıt dönecektir. Barkod bilgisi metafield içindeki jsonValue alanında bulunur. { "data": { "order": { "name": "#1017", "id": "gid://shopify/Order/6176180273389", "metafield": { "id": "gid://shopify/Metafield/40713851109613", "jsonValue": [ { "shipment_id": "72049", "barcode": "953932585239", "cargo_company": "Dummy Kargo" } ] } } }, "extensions": { "cost": { "requestedQueryCost": 2, "actualQueryCost": 2, "throttleStatus": { "maximumAvailable": 2000, "currentlyAvailable": 1998, "restoreRate": 100 } } } } 5. Yanıttaki Alanların Anlamı Dönen yanıtta yer alan barkod bilgisini şu şekilde okuyabilirsiniz: - shipment_id → Gönderiye ait benzersiz kimlik numarası (örnek: 72049) - barcode → Kargo firması tarafından oluşturulan gönderi barkodu (örnek: 953932585239) - cargo_company → Gönderinin oluşturulduğu kargo firması (örnek: Dummy Kargo) 💡 Not: jsonValue alanı bir liste (array) olarak döner. Bir siparişte birden fazla gönderi/paket bulunuyorsa, her paket için ayrı bir barkod kaydı bu listede yer alır.