Shopify ile Uygun Muhasebe arasında neler eşitlenir?
Shopify senin kendi mağazan; Uygun Muhasebe ona Shopify'ın Admin API'siyle bağlanır. Aşağıdaki tablo bağlantının bugün gerçekte yaptığını gösterir. "Kısmen" yazan satırlarda bilgi yalnız tek yönde akar.
| Konu | Durum | Nasıl çalışır |
|---|---|---|
| Siparişler | Evet | Mağazayı kaydettiğin anda son 14 günün siparişleri, sonra 15 dakikada bir yenileri gelir. Yalnız ödemesi alınmış siparişler (Paid, Partially paid, Partially refunded) alınır. |
| Sipariş durumu | Evet | Ödeme durumu, kargoya verildiyse gönderinin durumu siparişin yanında görünür. |
| Fatura taslağı ve müşteri carisi | Evet | Her yeni siparişe satış faturası taslağı açılır (bu ayarı kapatabilirsin); alıcı cari olarak eklenir ya da var olan carisiyle eşleşir. |
| Faturanın Shopify'a işlenmesi | Hayır | Fatura Shopify'daki siparişe yazılmaz; e-Arşiv fatura müşterinin e-postasına gider. |
| Stok | Evet | Ayardan açarsan Uygun Muhasebe'den Shopify'a; SKU'su eşleşen varyantlara, mağazanın ana konumuna yazılır. |
| Fiyat | Evet | Ayardan açarsan Uygun Muhasebe'den Shopify'a; ürün kartındaki satış fiyatı + KDV. |
| Ürün yayınlama ve ürün alma | Hayır | Shopify'da yeni ürün açılmaz, Shopify ürünleri de ürün kartı olarak alınmaz; iki taraf SKU ile eşleşir. |
| Müşteri soruları | Hayır | Bu bağlantı müşteri mesajı ya da sorusu almaz. |
| İptal ve iade | Kısmen | Shopify'daki iptal ve iadeler okunur, fatura taslağı buna göre düzelir; Uygun Muhasebe'den Shopify'da iade başlatılmaz. |
| Kargo | Kısmen | Shopify'da girdiğin takip numarası ve gönderi durumu gelir; Uygun Muhasebe'den Shopify'a takip numarası yazılmaz. |
| Komisyon ve hakediş | Hayır | Bu bağlantıda hakediş ya da ödeme ekstresi okunmaz. |
Siparişler Shopify'da son değiştiği tarihe göre istenir. Bu yüzden bağlamadan önce verilmiş bir sipariş, sonradan Shopify'da değişirse o da gelebilir. Faturasını daha önce başka yerde kestiysen bu siparişin taslağını silmen yeter; taslağı silinen siparişin ürünleri stoktan düşülmez. Bütün pazaryeri ve site bağlantıları pazaryeri entegrasyonu sayfasında.
Dev Dashboard uygulaması: Client ID ve Client Secret
Shopify'da özel uygulamalar artık Dev Dashboard'da oluşturuluyor; mağaza panelinden yalnız 01.01.2026'dan önce açılmış eski özel uygulamalar yönetiliyor (Shopify Yardım Merkezi). Bu yüzden Uygun Muhasebe senden sabit bir erişim anahtarı değil, uygulamanın Client ID ve Client Secret bilgisini ister.
Uygun Muhasebe bu iki bilgiyle Shopify'ın client credentials yöntemiyle 24 saat geçerli bir erişim anahtarı alır ve süresi bitmeden kendiliğinden yeniler; senin her gün bir şey yapman gerekmez. Shopify bu yöntemi yalnız uygulama ile mağaza aynı Shopify organizasyonundaysa çalıştırır (Shopify geliştirici belgesi). Uygulamayı mağaza sahibi ya da mağazanın organizasyonunda uygulama geliştirme izni olan personel açar; bir ajansın kendi organizasyonunda açtığı uygulama mağazana bu yolla ulaşamaz.
01.01.2026'dan önce açılmış eski bir özel uygulaman varsa (anahtarı shpat_ ile başlar) onunla da bağlanabilirsin: Client ID kutusunu boş bırakıp anahtarı Client Secret kutusuna yazarsın.
İzinler: siparişler için read_orders yeter. Stok ve fiyat da göndereceksen read_products, write_products, read_inventory, write_inventory ve read_locations gerekir. Bir izin eksikse Uygun Muhasebe hata iletisinde gereken izinleri Türkçe sıralar. Bağlama adımlarında menü adları Shopify'ın İngilizce panelindeki gibidir; panelin Türkçeyse aynı sırayı izle.
Shopify siparişine e-Arşiv mi, e-Fatura mı kesilir?
Belge türünü senin ve alıcının e-Fatura durumu belirler. Sen e-Fatura kullanıcısıysan ve alıcının vergi numarası Gelir İdaresi'nin e-Fatura kayıtlı kullanıcıları arasında çıkıyorsa fatura e-Fatura olarak gider. Bireysel müşteriye ya da e-Fatura kullanıcısı olmayan şirkete e-Arşiv kesilir. Uygun Muhasebe bu sorguyu fatura onaylanırken kendisi yapar. e-Fatura'ya geçmen gerekip gerekmediğini e-Fatura zorunluluğu yazısında bulursun.
Alıcının bilgileri Shopify siparişindeki fatura adresinden gelir; şirket alanı doluysa unvan olarak o yazılır ve sipariş kurumsal sayılır. Vergi numarası için sepet sayfana özel bir alan (cart attribute) eklediysen, adında "vergi", "VKN", "TCKN", "kimlik" ya da "tax" geçen alanın değeri vergi numarası, adında "vergi dairesi" geçen alanın değeri vergi dairesi olarak alınır. Kurumsal siparişte numara gelmediyse faturayı onaylamadan önce carinin kartına ekle; e-Fatura sorgusu bu numarayla yapılır. Hangi numaranın ne olduğu için VKN ve TCKN maddesine bakabilirsin.
İnternetten satışın e-Arşiv faturasındaki ek bilgiler de siparişten doldurulur: satışın internetten yapıldığı, web adresi, ödeme şekli ve tarihi, gönderim tarihi ve taşıyıcı. Ödeme şekli Shopify'daki ödeme yönteminin adından çıkarılır: adında "Cash on Delivery" ya da "kapıda" geçen kapıda ödeme, "Bank Deposit", "havale" ya da "EFT" geçen havale/EFT, diğerleri kart sayılır. Bu bilgilerin ne olduğu e-Arşiv fatura nasıl kesilir yazısında.
Onayladığın fatura, e-Belge ayarında otomatik gönderim açıksa kendiliğinden, değilse tek tıkla GİB'e gönderilir. e-Arşiv fatura gönderilince müşterinin e-postasına bağlantıyla da iletilir (bu ayar varsayılan olarak açık). Akışın tamamı e-Arşiv fatura programı sayfasında.
KDV, indirim ve kargo ücreti faturaya nasıl geçer?
- KDV dahil ya da hariç fiyat: Shopify'da Settings > Taxes and duties altındaki "Include sales tax in product price and shipping rate" seçeneğine göre sipariş KDV dahil ya da hariç gelir (Shopify vergi ayarı). Uygun Muhasebe bunu her siparişte okur ve faturayı müşterinin ödediği tutara göre kurar.
- KDV oranı: Satırdaki Shopify vergi oranı en yakın KDV oranına (%1, %10, %20) yuvarlanır. Shopify o satırda vergi hesaplamamışsa oran Uygun Muhasebe'deki ürün kartından alınır; ürün de eşleşmemişse taslağa %20 yazılır ve sen bakana dek toplu onaylanmaz.
- İndirim ve kupon: Satıra düşen indirim satırın tutarından düşülür; fatura indirimli fiyatla çıkar.
- Kargo ücreti: Müşteriden alınan kargo ücreti faturaya ayrı satır olarak girer; Shopify'da vergi oranı yoksa %20 yazılır. Ücretsiz kargo faturaya satır olarak girmez.
- Para birimi: Tutarlar Shopify'daki mağaza para biriminden alınır; müşteri başka para biriminde ödese de bu değişmez. TL, USD ve EUR desteklenir; USD ve EUR'da kayıtlı TCMB kuru yazılır. Başka para birimindeki sipariş uyarıyla gelir.
- Yurt dışı siparişi: Bu bağlantı siparişin yurt dışına gittiğini ayırt etmez; taslak yurt içi satış gibi açılır. Yurt dışına satıyorsan bu faturaların nasıl kesileceğini mali müşavirine sor, taslağı onaylamadan önce düzelt.
Fatura toplamı siparişte ödenenle tutmazsa ya da siparişte uyarı varsa taslak toplu onaya girmez; sipariş listesinde nedeniyle görünür. Örneğin 1.250,00 TL ödenmiş siparişin taslağı 1.200,00 TL çıkarsa fark sana gösterilir, kargo ve indirim satırlarını kontrol edersin.
Stok ve fiyat gönderirken dikkat et
- SKU tek ve doğru olsun: Shopify'daki varyantın SKU'su, Uygun Muhasebe'deki ürünün stok koduyla aynı olmalı. Tutmayanları Ürün eşleştirme sayfasında bir kez eşleştirirsin. Aynı SKU'yu iki varyantta kullanırsan ikisine de aynı stok yazılır.
- Önce stoğu gir: Stok takibi açık olup Uygun Muhasebe'de stoğu girilmemiş ürün Shopify'a 0 olarak gider. Hiç stok kaydın yokken stok gönderimi açılmaz; önce ürünlerin açılış stoğunu gir.
- Yalnız ana konum: Stok, Shopify mağazanın ana konumuna yazılır. Birden çok konumun varsa diğerlerine dokunulmaz.
- "Track quantity" açık olsun: Shopify'da stoğu izlenmeyen varyanta Uygun Muhasebe stok göndermez.
- Stoğu tek yerden yönet: Gönderilen sayı Shopify'daki sayının üzerine yazılır. Shopify'da elle değiştirdiğin stok bir sonraki gönderimde Uygun Muhasebe'deki sayıyla değişir.
- Açık siparişler düşülür: Son 30 günde gelip faturası henüz onaylanmamış siparişlerdeki ürünler, gönderilen stoktan düşülür; satılmış ürün yeniden stokta görünmez.
- Fiyat: Ürün kartındaki satış fiyatına KDV eklenerek gider; Shopify fiyatları KDV hariç tutuyorsa KDV'siz gönderilir. Yalnız farklı olan fiyat güncellenir, karşılaştırma fiyatına (compare-at price) dokunulmaz.
- Zamanlama: Siparişleri kendiliğinden çekilen mağazada gönderim günde bir kez yapılır; istediğin an Stok ve fiyat güncelleme sayfasından tek tıkla da gönderirsin.
Depo, sayım ve kritik stok uyarısı için stok takip programı sayfasına bak.
İptal, iade ve kargo nasıl yansır?
Shopify'da iptal edilen, ödemesi geçersiz sayılan (Voided) ya da tamamı iade edilen sipariş Uygun Muhasebe'de iptal olur. Faturası taslaktaysa taslak kendiliğinden silinir. Fatura onaylanmışsa sipariş listesinde uyarı çıkar; faturayı iptal etmek ya da iade kaydı açmak sana kalır.
Kısmi iadede taslak, kalan ürünlerle ve iadeden sonraki tutarla yeniden hazırlanır; "Siparişte 450,00 TL iade var" gibi bir uyarıyla gelir ve sen kontrol etmeden toplu onaylanmaz. Fatura onaylandıktan sonra iade olursa faturada "Müşteri iade etti" ile iade kaydı açarsın. Bireysel ve kurumsal müşteride hangi belgenin düzenleneceği iade faturası nasıl kesilir yazısında.
Siparişi Shopify'da gönderirken takip numarasını ve kargo firmasını girersen bu bilgi siparişle birlikte gelir. Kargo takibi bölümü açıksa gönderi orada açılır. Durumu (yolda, dağıtımda, teslim edildi gibi) Shopify'daki gönderi durumundan alınır; Uygun Muhasebe bu gönderiyi kargo firmasına ayrıca sormaz.
Pazaryerinden farkı: komisyon ve çok kanallı satış
Pazaryerinde satış bedeli sana hakediş olarak, komisyonu düşülmüş hâlde gelir. Shopify'da ise ödemeyi kendi ödeme kuruluşun ya da bankan alır; kesintisini gider olarak işlersin (POS komisyonu). Shopify'a ödediğin abonelik ve uygulama ücretlerinin nasıl kaydedileceğini mali müşavirine sor.
Shopify'ın yanında Trendyol ya da n11'de de satıyorsan siparişler aynı ekranda toplanır; bir mağazanın siparişi, bütün mağazalara giden stoktan düşülür. Trendyol tarafındaki fatura kuralları için Trendyol siparişine fatura yazısına, sektöre özel ipuçları için e-ticaret satıcıları sayfasına bakabilirsin.
Shopify bağlantısı adım adım
- 1
Dev Dashboard'da uygulama aç
Shopify yönetim panelinde Settings > Apps > Develop apps > Build apps in Dev Dashboard yolunu izle. Create app'e bas; Start from Dev Dashboard bölümünde uygulamaya bir ad ver (ör. Uygun Muhasebe) ve Create'e bas.
- 2
İzinleri seç ve sürümü yayımla
Uygulamanın sürümünü oluştur: URLs bölümünde uygulama adresi için Shopify'ın önerdiği varsayılan adresi (https://shopify.dev/apps/default-app-home) kullan. Access bölümüne read_orders yaz; stok ve fiyat da göndereceksen read_products, write_products, read_inventory, write_inventory ve read_locations ekle. Release'e bas.
- 3
Uygulamayı mağazana yükle
Dev Dashboard'da uygulamayı aç, Installs bölümünde Install app'e bas. Birden çok mağazan varsa mağazanı seç ve Install'a bas.
- 4
Client ID ve Client Secret'ı kopyala
Dev Dashboard'da uygulamanın Settings sayfasındaki Client ID ve Client Secret'ı kopyala.
- 5
Uygun Muhasebe'de mağazayı bağla
Pazaryeri > Mağazalar > Mağaza bağla'da "Kendi siten mi var?" kartından Shopify'ı seç. Mağaza adresini (magazam.myshopify.com), Client ID ve Client Secret'ı yazıp kaydet; bağlantı denenir ve son 14 günün siparişleri hemen gelir. 01.01.2026'dan önce açılmış eski uygulamanın shpat_ anahtarıyla bağlanıyorsan ilk dört adımı atla: Client ID'yi boş bırakıp anahtarı Client Secret kutusuna yaz.
- 6
Stok ve fiyat gönderimini aç
İstersen mağaza ayarında Stok miktarlarını mağazaya gönder ve Satış fiyatlarını mağazaya gönder seçeneklerini işaretle; stok göndermeden önce ürünlerin açılış stoğunu gir. SKU'su stok koduyla tutmayan ürünleri Ürün eşleştirme sayfasında eşleştir.
Pazaryeri ve platform adları ile logoları sahiplerinin markasıdır. Pazaryerinin kuralları değişebilir; güncel koşullar için satıcı panelindeki duyurulara bak.