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?
- 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.
- 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.
- 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?
- Teşekkür / sipariş durumu sayfasındaki form kullanıldıysa müşterinin seçtiği tip (Kurumsal / Bireysel) geçerlidir.
- Ek ayrıntılarda Fatura Tipi (veya Fatura Türü) yazılmışsa o değer kullanılır.
- 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):
- Shopify B2B şirket konumu vergi kayıt numarası (yalnızca vergi numarasını ezer).
- 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.
- Metafield eşleştirmesi – eşleştirilen sipariş/müşteri metafield'ındaki dolu değerler.
- Shopify ödeme sayfasındaki vergi numarası alanı (Türkiye için Vergi numarası alanı; yalnızca vergi numarasını ezer).
- Sepet ek ayrıntıları (bu makaledeki anahtarlar).
- 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?
- Mağazanızda test siparişi verin, fatura alanlarını doldurun.
- 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.
- 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.
