Shopify entegrasyonu, mağazanızın tek başına çalışan bir site olmaktan çıkıp işletmenin diğer sistemleriyle aynı veriyi paylaşmasıdır. Sipariş Shopify'a düştüğünde ERP'de satış kaydı açılır, kargo firmasında gönderi oluşur, e-fatura kesilir. Depodaki stok değiştiğinde Shopify ve pazaryerlerindeki stok güncellenir.
Entegrasyon, Shopify ajansı olarak verdiğimiz hizmetlerin en teknik parçasıdır. Bu bağlantıların bir kısmı için App Store'da yayında olan kendi uygulamalarımız var. Bir kısmı ise her işletmede farklı kurgulandığı için özel geliştirme gerektirir. Aşağıdaki matris, Shopify entegrasyon ihtiyacınız için hangi yolun uygun olduğunu gösterir. Uygulamalarımızın tam listesi Shopify uygulamalarımız sayfasında.
Shopify entegrasyon matrisi
| Sistem | Hazır uygulamamız | Özel geliştirme ne zaman gerekir |
|---|---|---|
| Yurtiçi Kargo | Var: Yurtiçi Kargo Entegrasyonu | Çoklu depo, özel etiket ya da toplu gönderim kuralı varsa |
| Hepsijet, Aras, MNG, PTT | Yok | Her durumda; kargo firmasının API'sine göre kurulur |
| Paraşüt e-fatura | Var: Paraşüt E-Fatura Entegrasyonu | Fatura ERP'den kesiliyorsa ya da özel satır kuralı varsa |
| Diğer e-fatura entegratörleri | Yok | Her durumda; entegratörün API'sine göre |
| Trendyol, Hepsiburada, N11, Amazon, Çiçeksepeti | Yok; App Store'da üçüncü taraf uygulamalar var | Stok ERP'den yönetiliyorsa, kanal bazlı fiyat kuralı ya da birden çok mağaza varsa |
| Nebim V3 | Yok; canlıda çalışan özel entegrasyonumuz var | Her durumda |
| Logo, Odoo ve diğer ERP'ler | Yok | Her durumda |
| Tedarikçi XML'inden ürün ve stok | Var: ProXI Product XML Import | Standart dışı XML yapısı ya da özel eşleştirme kuralı varsa |
| Dış sistemlere XML ürün akışı | Var: XML Product Export & XML Feed | Alıcı sistem özel bir şema istiyorsa |
| Siparişi tedarikçiye göre bölme | Var: SupplySync Split Orders | Tedarikçinin kendi API'siyle konuşmak gerekiyorsa |
| iyzico, PayTR | Sağlayıcının kendi Shopify uygulaması | Ödeme bilgisinin ERP'ye özel eşleştirmesi gerekiyorsa |
| Meta ve Google | Meta'nın ve Google'ın resmi satış kanalı uygulamaları | Sunucu tarafı olay eşleştirmesi ya da özel ürün akışı gerekiyorsa |
Hazır uygulama mı, özel entegrasyon mu?
| Kriter | Hazır uygulama | Özel entegrasyon |
|---|---|---|
| Kurulum süresi | Saatler ya da birkaç gün | Kapsama göre haftalar |
| Maliyet yapısı | Aylık abonelik | Geliştirme bedeli, ardından sunucu ve bakım |
| Esneklik | Uygulamanın sunduğu ayarlarla sınırlı | İş kurallarınıza göre yazılır |
| Veri | Uygulama sağlayıcısının sunucusundan geçer | Belirlediğiniz sunucuda çalışır |
| Güncelleme | Sağlayıcı yapar | Bakım kapsamında yapılır |
| Uygun olduğu durum | Standart akış, tek kanal, az istisna | ERP merkezli stok, çok kanal, özel fiyat ve fatura kuralları |
Pratik bir kural: Hazır uygulamanın ayarları iş akışınızı karşılıyorsa önce onu deneyin. Ekibiniz her gün Excel'le el ile düzeltme yapmaya başladıysa özel entegrasyonun maliyeti, harcanan iş gücünün yanında küçük kalmaya başlar.
Ürün, stok, fiyat, sipariş, iade ve fatura verileri nasıl akar?
| Veri | Yön | Tetikleyici | Dikkat edilecek nokta |
|---|---|---|---|
| Ürün ve varyant | ERP ya da tedarikçiden Shopify'a | Zamanlanmış toplu iş ya da değişiklik bildirimi | SKU ve barkod eşleşmesi; Shopify'da ürün başına en fazla üç seçenek |
| Stok | ERP ya da depodan Shopify ve pazaryerlerine | Değişiklikte ya da kısa aralıklarla | Shopify lokasyonlarının depo karşılığı, tampon stok |
| Fiyat | ERP'den Shopify ve pazaryerlerine | Fiyat listesi değiştiğinde | İndirimli fiyat (compare-at), kanal bazlı komisyon farkı |
| Sipariş | Shopify ve pazaryerlerinden ERP'ye | Sipariş webhook'u | Ödeme durumu, kapıda ödeme, indirim ve kargo bedeli satırları |
| İptal ve iade | Shopify'dan ERP'ye ve fatura sistemine | İade webhook'u | Stoğun geri alınması, iade belgesi, kısmi iade |
| Fatura | Shopify'dan e-fatura sistemine | Ödeme alındığında ya da kargo çıkışında | Mükellef sorgusu, fatura numarasının siparişe geri yazılması |
| Kargo takip | Kargo firmasından Shopify'a | Gönderi oluştuğunda | Takip numarası, müşteriye bildirim, teslim durumu |
Entegrasyona başlamadan önce en önemli karar ana veri kaynağıdır: Ürün ve fiyat ERP'de mi yönetilecek, Shopify'da mı? Aynı alanın iki sistemde düzenlenmesi, hangi verinin geçerli olduğunu belirsiz bıraktığı için sık karşılaştığımız bir sorundur.
Trendyol, Hepsiburada ve diğerleri için Shopify pazaryeri entegrasyonu
Shopify'ın kendi pazaryeri kanalı (Marketplace Connect) Türkiye pazaryerlerini kapsamaz. App Store'daki Trendyol ve Hepsiburada uygulamaları üçüncü taraf geliştiricilere aittir; tek mağaza ve standart akış için yeterli olabilirler. Shopify Trendyol entegrasyonunu ya da Hepsiburada bağlantısını özel kurduğumuzda şu başlıkları ele alırız:
- Pazaryerleri her kategori için renk, beden, materyal gibi zorunlu özellikler ister. Shopify'daki ürün türü, etiketler ve meta alanlar bu özelliklere eşlenir.
- Her varyant benzersiz bir barkodla listelenir, marka adı da pazaryerinin marka listesiyle eşleşmelidir. Yeni ürünler pazaryerinin içerik onayından geçer.
- Komisyon ve kargo maliyeti için kanal bazlı bir fiyat kuralı tanımlanır. Örneğin Shopify fiyatının üzerine belirli bir oran eklenir.
- Aynı stok birden çok kanalda satılırken bir kanaldaki satış diğerlerine geç yansırsa fazla satış olur. Kısa aralıklı senkron ve kanal bazlı tampon stok bunu önler.
- Pazaryeri siparişleri Shopify'a ayrı bir kaynak etiketiyle aktarılır ya da doğrudan ERP'ye gönderilir. Kargo etiketi çoğunlukla pazaryerinin anlaşmalı kargosundan alınır.
- Pazaryerinde başlayan iade ve iptaller stok ve fatura sistemine yansıtılır.
N11, Amazon ve Çiçeksepeti için de aynı mantık geçerlidir; her pazaryerinin API'si ve ürün onay süreci farklıdır.
Kargo entegrasyonu
Kargo entegrasyonu gönderinin kargo firmasında açılması, barkod ve etiketin basılması, takip numarasının Shopify siparişine yazılması ve müşteriye kargo bildirimi gitmesi demektir. Yurtiçi Kargo için bunu yukarıdaki uygulamamız tek tıkla yapar. Bir Shopify mağazasında Hepsijet gönderimlerini hazır bir uygulamayla kurup ayarladık. Aras, MNG ve PTT için aynı akışı firmanın API'sine göre kurarız. Kapıda ödemeli siparişlerde tahsilat tutarının gönderiye doğru yazılması ve desi bilgisinin ürünlerden gelmesi ayrıca test edilir.
E-fatura ve e-arşiv için Shopify fatura entegrasyonu
Alıcı e-fatura mükellefiyse e-fatura, değilse e-arşiv fatura kesilir; entegrasyon bu ayrımı mükellef sorgusuyla yapar. Paraşüt kullanıyorsanız uygulamamız siparişleri otomatik olarak faturaya çevirir. Başka bir özel entegratör kullanıyorsanız ya da faturayı ERP kesiyorsa bağlantıyı o sisteme göre kurarız. Fatura numarasının ve belge bağlantısının Shopify siparişine geri yazılması, müşteri hizmetlerinin işini ciddi biçimde kolaylaştırır.
Nebim V3, Logo ve Odoo ile Shopify ERP entegrasyonu
ERP entegrasyonu en kapsamlı bağlantıdır, çünkü ürün, stok, fiyat, cari ve sipariş aynı anda iki yönlü akar. Canlıda çalışan Shopify ve Nebim V3 entegrasyonumuzda siparişler Nebim'e aktarılıyor; kargo bedeli ayrı hizmet satırı, indirimler satır indirimi olarak taşınıyor. Stok ve ürün bilgisi Nebim'den Shopify'a geliyor. Nebim oturumu sona erdiğinde entegrasyon yeni oturum açıp işlemi tekrarlıyor.
Logo ve Odoo'da yöntem aynıdır, bağlantı noktası farklıdır: Odoo'da sistemin kendi API'si, Logo'da ise kullandığınız ürüne ve sürüme göre sunulan servisler kullanılır. Her ERP projesinde şu soruları baştan netleştiririz:
- Bireysel müşteriler ERP'de tek tek cari olarak mı açılacak, ortak bir perakende carisine mi yazılacak?
- Shopify'daki ödeme yöntemleri (kart, kapıda ödeme, havale) ERP'de hangi ödeme tipine karşılık geliyor?
- Hangi depo hangi Shopify lokasyonuna bağlı?
- Fatura ERP'den mi, e-fatura uygulamasından mı kesilecek?
Shopify dışındaki ERP ihtiyaçları için özel ERP yazılımı sayfamıza, tüm sistemleri kapsayan entegrasyon hizmetimiz için e-ticaret ve ERP entegrasyonu sayfamıza bakabilirsiniz.
Ödeme entegrasyonu
iyzico ve PayTR, Shopify'a kendi uygulamalarıyla bağlanır; kurulumu Shopify mağaza kurulumu kapsamında yaparız. Entegrasyon tarafındaki asıl iş, ödeme bilgisinin ERP'ye ve muhasebeye doğru aktarılmasıdır: taksitli satışlar, sağlayıcı komisyonu ve iadelerin mutabakatı. Kapıda ödemede tahsilat kargo firmasından geldiği için bu siparişler ayrıca izlenir.
Hangi entegrasyonun gerektiğini birlikte çıkaralım
Kullandığınız ERP'yi, kargo firmasını ve satış kanallarını yazın; hazır uygulamayla mı, özel entegrasyonla mı ilerlemek gerektiğini netleştirelim. Teklif alın
Entegrasyon süreci
- Veri haritası. Hangi verinin hangi sistemden hangi sisteme, hangi tetikleyiciyle gideceğini tablo olarak çıkarırız.
- Alan eşleştirme. Ürün, müşteri, ödeme tipi, depo ve vergi alanlarının iki sistemdeki karşılığını belgeleriz.
- Test ortamı. Geliştirme mağazası ve ERP ya da kargo firmasının test hesabıyla çalışırız.
- Geliştirme. Kuyruk, hata kaydı ve izleme ekranı entegrasyonla birlikte yazılır.
- Pilot. Sınırlı bir ürün ya da sipariş grubuyla canlıda deneme yapar, sonuçları ERP'de sizinle birlikte kontrol ederiz.
- Canlı ve izleme. Tüm akış açılır, ilk haftalarda hata listesi yakından izlenir.
Hazır uygulamalarımızla kargo ya da e-fatura bağlantısı, hesap bilgileriniz hazırsa kısa sürede kurulur. Tek bir ERP ile iki yönlü özel entegrasyon ise kapsamına göre 4-8 hafta sürer.
Entegrasyon maliyetini belirleyen kalemler
- Bağlanacak sistem sayısı ve her birinin API kalitesi
- Akışın yönü: tek yönlü (yalnızca sipariş) ya da iki yönlü (ürün, stok, fiyat, sipariş)
- Ürün, varyant ve günlük sipariş hacmi
- Özel iş kuralları: kanal bazlı fiyat, depo önceliği, set ürünler
- Karşı sistemde test ortamı olup olmaması
- İzleme, raporlama ve bakım kapsamı
Canlıda çalışan Shopify entegrasyonlarımız
- Shopify ve Nebim V3 arasında sipariş, stok ve ürün aktarımı
- Yurtiçi Kargo gönderimleri
- Paraşüt e-fatura
- Tedarikçi XML'lerinden ürün, stok ve fiyat aktarımı; pazaryerleri ve Google Merchant Center için ürün akışları
- Meta Conversions API ile sunucu tarafı satış olayları
- WooCommerce'ten Shopify'a geçiş
Webhook, kuyruk, hata yönetimi ve izlemeye dayalı mimari
Özel entegrasyonları Laravel ile yazıyoruz. Bir entegrasyonun asıl sınavı ilk gün değil, ERP'nin yavaşladığı ya da kampanya gününde sipariş sayısının katlandığı gündür. Bu yüzden şu ilkelerle çalışırız:
- Shopify sipariş, iade ve ürün değişikliklerini webhook ile anında bildirir. Her bildirimin gerçekten Shopify'dan geldiği HMAC imzasıyla doğrulanır.
- Bildirim alınır alınmaz kuyruğa yazılır. ERP ya da kargo servisi yavaş cevap verse bile Shopify tarafında zaman aşımı yaşanmaz.
- Başarısız işler artan aralıklarla yeniden denenir. Aynı webhook iki kez gelebileceği için her sipariş kimliği bir kez işlenir ve ERP'de çift kayıt oluşmaz.
- Webhook'lar gecikebilir ya da hiç gelmeyebilir. Bu yüzden periyodik bir mutabakat işi Shopify ile karşı sistemi karşılaştırır ve eksik kayıtları tamamlar.
- Shopify GraphQL Admin API, sorgu maliyetine göre sınır uygular. Büyük kataloglarda bu sınır için toplu işlemler (bulk operations) kullanılır.
- Hatalı kayıtlar bir listede toplanır ve düzeltildikten sonra yeniden gönderilebilir. Hata biriktiğinde uyarı bildirimi gider.
- Shopify her çeyrekte yeni bir API sürümü yayınlar ve her sürümü en az 12 ay destekler. Entegrasyonu bakım kapsamında desteklenen sürümde tutarız.
- KVKK kapsamında kayıtlardaki müşteri adı, telefon ve adres gibi kişisel veriler maskelenir, saklama süresi sınırlanır.
Kavramlara yabancıysanız API nedir yazımız iyi bir başlangıçtır; teknik ekipler için Laravel ile modern API tasarımı yazımızda yaklaşımımızı daha ayrıntılı anlattık.
SSS