Shopify Rehberi

Shopify Easy COD Form – Alan Eşleştirme Rehberi

Fatura Entegratör eklentimizde, Shopify Easy COD Form üzerinden alınan müşteri verilerinin doğru şekilde okunabilmesi için form alan adlarının (field name) belirli isimlerle tanımlanması gerekmektedir. Eğer il, ilçe ve diğer fatura bilgilerini COD form üzerinden almak istiyorsanız, aşağıdaki alan isimlerini birebir kullanmanız gerekmektedir. ⚠️ Önemli: Sistemimiz, verileri alan isimlerine (name attribute) göre okumaktadır. Bu nedenle input label değil, input name değeri aşağıdaki şekilde olmalıdır. 1. Ad → Ad 2. Soyad → Soyad 3. Telefon → Telefon 4. Adres → Adres 5. İl → İl 6. İlçe → İlçe 7. E-posta → E-posta 8. Firma → Firma 9. Ülke → country 10. VKN / TCKN → VKN/TCKN 11. Vergi Dairesi → Vergi Dairesi COD formunuzdaki input alanlarının name değerlerini aşağıdaki gibi ayarlamanız gerekmektedir: Örneğin: - COD formunuzda ilçe alanı varsa, input name değeri "İ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 farklı bir isim kullanılırsa (örneğin district, city_name vb.), sistemimiz bu alanı okuyamaz ve veri fatura sistemine aktarılmaz.

Shopify Mağazanız için Tüm Vergi Ayarları

Shopify Türkiye Vergi Ayarları https://www.youtube.com/watch?v=tXZPL30vbN0 Bu rehber, Shopify mağazanızda vergi mevzuatına uygun bir yapılandırma gerçekleştirmeniz için hazırlanmıştır. Türkiye’deki e-ticaret operasyonlarınızda ürün ve kargo vergilerini doğru yönetmek, mali uyumluluk açısından kritik öneme sahiptir. Aşağıdaki adımları takip ederek teknik yapılandırmayı tamamlayabilirsiniz. 1. Giriş ve Temel Navigasyon Vergi ayarlarına erişmek için Shopify yönetici panelindeki standart navigasyon yollarını izleyin: 1. Shopify yönetici panelinin sol alt köşesinde yer alan Ayarlar (Settings) ikonuna tıklayın. 2. Sol taraftaki menü listesinden Vergiler (Taxes and duties) sekmesini seçin. 3. "Ülkeler/bölgeler" listesi altından Türkiye seçeneğine tıklayarak detaylı yapılandırma ekranına giriş yapın. 2. Genel Vergi Oranının Yapılandırılması Türkiye’deki standart KDV oranı (mevcut durumda %20) mağazanızın temel vergi matrahını oluşturur. - Ülke ayarları ekranında bulunan temel oran alanına geçerli vergiyi (örn. %20) girin. - Önemli: Herhangi bir dışlama (override) eklemeden önce mutlaka sağ üst köşedeki Kaydet (Save) butonuna tıklayın. Bu işlem, ana oranın sisteme tanımlanmasını sağlar. Dikkat Edilmesi Gerekenler: - Tanımladığınız bu ana oran, aksi belirtilmediği sürece tüm ürünleriniz ve kargo ücretleriniz için varsayılan "base rate" olarak uygulanacaktır. 3. Kargo Ücretleri İçin Vergi Ayarları Shopify sisteminde kargo ücretlerinin vergilendirilmesi, ürün satışından bağımsız bir tercih olarak sunulmaktadır. Senaryo: Müşterilerinizden sipariş bazlı kargo ücreti tahsil ediyorsanız, bu bedelin de vergiye tabi olması yasal bir gerekliliktir. Sayfanın alt kısmında yer alan "Kargo için satış vergisi al" (Charge sales tax on shipping) kutucuğunu işaretleyerek, kargo bedelinin de vergi hesaplamasına dahil edilmesini sağlayın. 4. Vergi Dışlamaları ve Özel Oran Tanımlama Türkiye pazarında bazı ürün grupları düşük vergi diliminde (örn. %1 veya %10) yer alırken, kargo hizmeti genellikle standart orandan (%20) vergilendirilir. Eğer ürününüzün vergi oranı ile kargo vergi oranınız farklıysa "Tax Overrides" özelliğini kullanmanız gerekir. İşlem Adımları: 1. Sayfanın altındaki "Add override" (Dışlama ekle) butonuna tıklayın. 2. Açılan modal (açılır pencere) üzerinden Kargo (Shipping) seçeneğini işaretleyin. 3. Türkiye standartlarına uygun olan oranı (örn. %20) girin ve ekleyin. | Tanımlama Türü | Uygulanan Oran | Durum | | ----------------------------- | ------------------ | -------------------------- | | Genel Ürün Vergisi (Base) | %10 | Özel oranlı ürünler için | | Kargo Vergisi (Override) | %20 | Mevzuata uygun kargo oranı | 5. Kategori (Koleksiyon) Bazlı Vergilendirme Farklı vergi dilimlerine ürün gruplarınız (örneğin gıda için %1, tekstil için %10 gibi) varsa, bu ayrımı koleksiyonlar üzerinden yönetebilirsiniz. Ön Hazırlık: Bu adımı uygulamadan önce Ürünler (Products) > Koleksiyonlar (Collections) sekmesinden ilgili ürün gruplarını oluşturmuş olmanız gerekmektedir. - "Add override" butonuna tıklayın ve bu kez "Select collection" (Koleksiyon seç) opsiyonunu kullanın. - Önceden hazırladığınız koleksiyonu (örn. "Tişörtler") listeden aratarak seçin. - Bu gruba özel oranı tanımlayın. Örnek Yapılandırma Kombinasyonu: - Tişört Koleksiyonu: %10 vergi oranı - Temel Gıda Koleksiyonu: %1 vergi oranı 6. Üçüncü Taraf Uygulamalarla Entegrasyon Notu Önemli Uyarı: Mağazanızda Easy Sell Cod Form veya benzeri "Kapıda Ödeme" (Cash on Delivery) form eklentileri kullanıyorsanız, Shopify'ın ana vergi ayarları bu uygulamalara otomatik olarak yansımayabilir. Bu tür eklentiler kendi vergi motorlarını kullanabilirler. Bu nedenle, kullandığınız uygulamanın ayarlar içerisinden vergilendirme seçeneğinin aktif olduğunu ve oranların doğruluğunu mutlaka manuel olarak teyit edin. 7. Yapılandırma Özeti Tablosu Aşağıdaki tablo, Shopify Türkiye panelinde karşılaşacağınız senaryoların uygulama özetidir: | Senaryo Türü | Yapılacak İşlem | Hedef Vergi Oranı Örneği | | ------------------------- | --------------------------------- | ---------------------------- | | Genel Satış Vergisi | Ana oran girişi ve Kaydet | Otomatik (örn. %20) | | Kargo Vergilendirmesi | "Kargo için satış vergisi" seçimi | Ana oran ile aynı (%20) | | Farklı Kargo Oranı | Override > Kargo Seçimi | Sabit %20 (Üründen bağımsız) | | Özel Ürün Grubu | Override > Koleksiyon Seçimi | Mevzuata göre %1 veya %10 |

Shopify – Faturada Farklı Ürün Adı Gösterme (Fatura Adı Alanı)

Fatura Entegratör uygulamamızda, Shopify'daki ürün adınız ile faturada görünmesini istediğiniz adın aynı olması zorunlu değildir. Örneğin ürününüzün adı Frambuazlı Cheesecake olabilir, ancak faturada yalnızca Tatlı yazmasını isteyebilirsiniz. Bu ayar sayesinde her fatura oluştururken adı elle düzeltmek yerine, ürünün üzerinde bir kez tanımlarsınız; Fatura Entegratör bundan sonra o üründen kesilen her faturada bu adı kullanır. Nasıl çalışır? Ürünlerinize Shopify tarafında faturaentegrator.faturaadi adında bir alan (metafield) eklersiniz. Bir üründe bu alan doluysa faturaya o değer yazılır. Boş bıraktığınız ürünlerde hiçbir şey değişmez; faturada Shopify'daki ürün adı kullanılmaya devam eder. ⚠️ Önemli: Sistemimiz veriyi alan adına (namespace ve anahtar) göre okumaktadır. Bu nedenle alanın görünen adı değil, faturaentegrator.faturaadi değeri birebir aşağıdaki şekilde tanımlanmalıdır. Adım 1 — Shopify'da alanı tanımlayın Bu adımı yalnızca bir kez yapmanız yeterlidir. 1. Shopify yöneticinizde Ayarlar → Özel veriler (Custom data) bölümüne gidin. 2. Ürünler'e tıklayın. 3. Tanım ekle düğmesine basın. 4. Ad alanına Fatura Adı yazın. 5. Ad alanının hemen altında custom.fatura_adi gibi bir namespace ve anahtar değeri belirir. Yanındaki düzenleme (kalem) simgesine tıklayın ve değeri şu şekilde değiştirin: faturaentegrator.faturaadi 6. Tür olarak Tek satırlık metin'i seçin. 7. Kaydet'e basın. ⚠️ Bu değeri harfi harfine yazmanız gerekmektedir. Küçük bir yazım farkı olması durumunda (örneğin faturaentegrator.fatura_adi) sistemimiz alanı okuyamaz ve faturada Shopify'daki ürün adı kullanılmaya devam eder. Adım 2 — Fatura Entegratör'de ayarı açın 1. Fatura Entegratör uygulamasında Ayarlar sayfasını açın. 2. Faturadaki Ürün Adı kartını bulun. 3. Ürün adını metafield'dan oku kutucuğunu işaretleyin. 4. Altta açılan Ürün Metafield Alanı kutusuna faturaentegrator.faturaadi yazın. 5. Kaydet'e basın. Kutuyu boş bırakmanız durumunda da varsayılan olarak faturaentegrator.faturaadi okunur. Farklı bir alan kullanmak isterseniz kendi namespace.anahtar değerinizi yazabilirsiniz. Adım 3 — Ürünlere fatura adını girin 1. Shopify yöneticinizde Ürünler'e gidin ve düzenlemek istediğiniz ürünü açın. 2. Sayfanın en altındaki Metafield alanları bölümüne inin. 3. Fatura Adı kutusuna faturada görünmesini istediğiniz adı yazın (örneğin Tatlı). 4. Kaydet'e basın. Bu ürün için bundan sonra kesilecek faturalarda ürün adı Tatlı olarak görünecektir.

Shopify'da müşterilerden aldığım kurumsal bilgiler ile fatura kesebilir miyim?

Shopify müşterilerinizden aldığınız kurumsal (firma) ya da bireysel fatura bilgilerini Fatura Entegratör otomatik olarak faturaya aktarır. Bilgi üç farklı yoldan toplanabilir; bu makalede her yolun nasıl çalıştığı, hangi anahtarların tanındığı ve birden fazla kaynak varsa hangisinin geçerli olduğu anlatılır. Fatura bilgisi hangi yollarla toplanır? 1. Teşekkür / sipariş durumu sayfasındaki fatura bilgisi formu – Fatura Entegratör uygulamasıyla gelen form; müşteri ödeme sonrası Kurumsal/Bireysel seçip unvan, VKN/TCKN ve vergi dairesini girer. Ek kurulum gerektirmez. 2. Sepet ek ayrıntıları (cart attributes) – Temanızdaki sepet formuna ya da kullandığınız kapıda ödeme / fatura bilgisi uygulamasına (CompliTR, Easy COD vb.) eklenen alanlar. Shopify bu alanları siparişin Ek ayrıntılar bölümüne yazar, Fatura Entegratör buradan okur. Bu makalenin ana konusu budur. 3. Metafield eşleştirmesi – Sipariş ya da müşteri metafield'larında tuttuğunuz vergi bilgilerini Ayarlar → Metafield Ayarları → Fatura bilgilerini metafield'dan oku ile eşleştirirsiniz. Sepet ek ayrıntılarında tanınan anahtarlar Anahtar eşleştirmesi büyük/küçük harfe duyarsızdır, baştaki ve sondaki boşluklar yok sayılır. Aynı bilgi için listedeki anahtarlardan herhangi biri kullanılabilir; ilk eşleşen dolu değer alınır. Fatura (vergi) bilgileri | Faturadaki alan | Tanınan anahtarlar | Açıklama | | --- | --- | --- | | Fatura tipi | Fatura Tipi, Fatura Türü | Değer Kurumsal ya da Bireysel olmalıdır. Yazılmışsa tahmin yapılmaz. | | Firma unvanı | Firma, Firma Ünvanı, Firma Unvanı, Firma Adı | Kurumsal faturada zorunludur. Boşsa fatura adresindeki Şirket alanı kullanılır. | | Vergi / TC kimlik numarası | VKN/TCKN, TCKN/VKN, Vergi No, Vergi Numarası, VKN, TCKN, TC No, TC Kimlik, TC Kimlik No, TC Kimlik Numarası, T.C. Kimlik No, T.C. Kimlik Numarası | Yalnızca rakam. VKN 10 hane, TCKN 11 hane. Boşsa faturaya 11111111111 yazılır. | | Vergi dairesi | Vergi Dairesi | Kurumsal faturada zorunludur. | Fatura adresi / iletişim bilgileri (isteğe bağlı) Bu anahtarlar doluysa siparişin fatura adresindeki ilgili alanın yerine kullanılır. Boşsa Shopify fatura adresi kullanılır. | Faturadaki alan | Tanınan anahtar | | --- | --- | | Ad | Ad | | Soyad | Soyad | | Telefon | Telefon | | E-posta | E-posta | | Adres | Adres | | İlçe | İlçe | | İl | İl | Öneri: Yeni bir entegrasyon kuruyorsanız her alan için tek anahtar seçin ve tutarlı kullanın: Fatura Tipi, Firma Unvanı, VKN/TCKN, Vergi Dairesi. Kurumsal fatura için gereken alanlar | Anahtar | Örnek değer | Zorunlu mu? | | --- | --- | --- | | Fatura Tipi | Kurumsal | Önerilir (yoksa aşağıdaki kurala göre tahmin edilir) | | Firma Unvanı | Örnek Gıda Sanayi ve Ticaret A.Ş. | Evet | | VKN/TCKN | 1234567890 | Evet (10 haneli VKN) | | Vergi Dairesi | Kadıköy | Evet | Şahıs firması: Vergi numarası olarak 11 haneli TCKN kullanılır. Vergi Dairesi dolu olduğu sürece sipariş kurumsal kabul edilir ve fatura firma adına kesilir. | Anahtar | Örnek değer | | --- | --- | | Fatura Tipi | Kurumsal | | Firma Unvanı | Ayşe Yılmaz (veya tabela unvanı) | | VKN/TCKN | 12345678901 | | Vergi Dairesi | Beşiktaş | Bireysel fatura için gereken alanlar Bireysel faturada firma unvanı ve vergi dairesi gerekmez. Ad ve soyad siparişin fatura adresinden alınır. | Anahtar | Örnek değer | Zorunlu mu? | | --- | --- | --- | | Fatura Tipi | Bireysel | Önerilir | | TC Kimlik No | 12345678901 | Hayır; boşsa faturaya 11111111111 yazılır | Fatura Tipi olarak Bireysel yazılmışsa, Vergi Dairesi dolu olsa bile sipariş bireysel kabul edilir. Formunuzda bireysel seçildiğinde vergi dairesi ve unvan alanlarını gizlemeniz ya da boş göndermeniz önerilir. Fatura tipi nasıl belirlenir? 1. Teşekkür / sipariş durumu sayfasındaki form kullanıldıysa müşterinin seçtiği tip (Kurumsal / Bireysel) geçerlidir. 2. Ek ayrıntılarda Fatura Tipi (veya Fatura Türü) yazılmışsa o değer kullanılır. 3. Hiçbiri yoksa tahmin yapılır: - Vergi numarası 10 haneli ise → Kurumsal - Vergi dairesi dolu ise → Kurumsal (11 haneli TCKN ile şahıs firması) - Aksi halde → Bireysel Yanlış tahmin riskini sıfırlamak için Fatura Tipi anahtarını her zaman gönderin. Birden fazla kaynak varsa hangisi geçerli? Öncelik sırası (yüksekten düşüğe): 1. Shopify B2B şirket konumu vergi kayıt numarası (yalnızca vergi numarasını ezer). 2. Teşekkür / sipariş durumu sayfasındaki fatura formu – müşteri burada bilgi girdiyse diğer tüm kaynaklar yok sayılır. Önce o siparişe girilen kayıt, yoksa aynı müşterinin en son girdiği kayıt kullanılır. 3. Metafield eşleştirmesi – eşleştirilen sipariş/müşteri metafield'ındaki dolu değerler. 4. Shopify ödeme sayfasındaki vergi numarası alanı (Türkiye için Vergi numarası alanı; yalnızca vergi numarasını ezer). 5. Sepet ek ayrıntıları (bu makaledeki anahtarlar). 6. Varsayılanlar – unvan için fatura adresindeki Şirket alanı, vergi numarası için 11111111111. Sepet ek ayrıntıları nasıl eklenir? - Hazır uygulama kullanıyorsanız: CompliTR, Easy COD gibi uygulamalar bu bilgileri yukarıdaki anahtarlarla siparişe yazar; ek ayar gerekmez. Farklı bir uygulama kullanıyorsanız yazdığı anahtar adlarının listeyle eşleştiğini kontrol edin. Eşleşmeyen bir anahtar varsa bize bildirin, listeye ekleyelim. - Tema geliştiriciniz varsa: Sepet sayfasına ya da sepet çekmecesine, yukarıdaki anahtar adlarını taşıyan sepet özniteliği (cart attribute) alanları eklemesi yeterlidir. Alanların değerleri siparişin Ek ayrıntılar bölümünde görünüyorsa kurulum doğrudur. - Shopify Plus / Checkout Extensibility: Checkout eklentisi aynı anahtar adlarıyla sipariş özniteliği yazabilir; sipariş tarafında aynı şekilde okunur. Nasıl test edilir? 1. Mağazanızda test siparişi verin, fatura alanlarını doldurun. 2. Shopify Yönetici → Siparişler → siparişi açın → Ek ayrıntılar bölümünde anahtar ve değerlerin göründüğünü doğrulayın. 3. Fatura Entegratör'de siparişten Fatura Oluştur deyin ve ön izlemede müşteri tipinin (Firma / Şahıs), unvanın, VKN/TCKN ve vergi dairesinin doğru geldiğini kontrol edin. Sık karşılaşılan sorunlar Fatura bireysel kesildi ama müşteri kurumsal istemişti. Fatura Tipi gönderilmemiş, vergi numarası 11 haneli ve vergi dairesi boş. Çözüm: Fatura Tipi olarak Kurumsal gönderin veya vergi dairesini doldurun. Faturada vergi numarası 11111111111 görünüyor. Vergi numarası anahtarı tanınan listede değil (ör. Vergi Kimlik No) ya da değer boş gönderilmiş. Anahtar adını listedekilerden biriyle değiştirin. Unvan yerine müşterinin adı soyadı yazıldı. Firma Unvanı boş gelmiş ve fatura adresindeki Şirket alanı da boş. Unvan alanını formda zorunlu yapın. Ek ayrıntılardaki bilgi faturaya yansımadı. Müşteri teşekkür sayfasındaki fatura formunu doldurmuş ya da metafield eşleştirmesi aktif ve dolu olabilir; bu kaynaklar ek ayrıntılardan önceliklidir. Değerler siparişin Ek ayrıntılar bölümünde hiç görünmüyor. Alanlar sepet formunun dışında kalmış ya da sepet özniteliği olarak gönderilmiyor. Tema geliştiricinizle kontrol edin. Özet tablo | Senaryo | Fatura Tipi | Firma Unvanı | VKN/TCKN | Vergi Dairesi | | --- | --- | --- | --- | --- | | Şirket | Kurumsal | Zorunlu | 10 haneli VKN | Zorunlu | | Şahıs firması | Kurumsal | Zorunlu | 11 haneli TCKN | Zorunlu | | Bireysel | Bireysel | Boş | 11 haneli TCKN (isteğe bağlı) | Boş | Ödeme sayfası adres alanlarıyla toplama (alternatif yöntem) Kurumsal bilgileri Shopify ödeme sayfasında müşterilerinizden aşağıdaki şekilde alırsanız Fatura Entegratörün AI özelliği ile doğru alanlara bu bilgileri dağıtabilir, faturanızı kurumsal olarak kesebilirsiniz. AI özelliğimiz tüm alanları kontrol edip doğru yerlere yerleştirerek fatura kesmenize yardımcı olacaktır.