Shopify Mikro Entegrasyonu

Shopify Mikro entegrasyonu, Mikro'daki ürün, stok ve fatura verisini Shopify'a bağlayan bir köprüdür. Mikro'nun birden fazla ürün hattı vardır (Run, Jump, Fly, Müşavir); entegrasyon API'si bunlardan özellikle Jump hattında net tanımlıdır ve erişim otomatik gelmez, ürün bazlı başvuru formuyla açılır. Kurulumun ilk adımı bu yüzden bağlantı kurmak değil, hangi Mikro ürününü kullandığınızı ve API erişiminizin açık olup olmadığını netleştirmektir.

Kurulum için görüşün Entegrasyonu incele

200+ aktif marka
Nodus Works ile Shopify'da büyüyor

Shopify Mikro entegrasyonu nedir?

Shopify Mikro entegrasyonu, mağazanızdaki sipariş ve stok hareketini Mikro'daki cari, fatura ve depo kayıtlarına yazan bir bağlantıdır. Mikro kendi Shopify uygulamasını yayınlamıyor; köprüyü, Mikro'nun resmi entegrasyon arayüzü üzerinden çalışan bir entegrasyon aracı kurar.

Kurulum kod yazmakla değil erişimle başlar. Mikro API erişimi ürün bazlı açılıyor; Jump, Run, Fly veya Müşavir hattından hangisini kullandığınızı ve API lisansınızın aktif olup olmadığını önce netleştirmeniz gerekiyor. Bu adımı atlayan kurulumlar bağlantı aşamasında kimlik doğrulama hatasıyla tıkanır.

Bağlantı çalışmaya başladığında Shopify siparişi Mikro'da cari harekete dönüşür, stok iki yönde güncellenir ve kesilen faturanın bilgisi siparişe geri yazılır. Ürün hattınıza göre entegrasyon aracınızı doğru seçmek için Nodus Works'ün Shopify entegrasyon ve özel uygulama geliştirme hizmetinden destek alabilirsiniz.

VERİ AKIŞI

Shopify ve Mikro arasında neler eşitlenir

Mikro ile Shopify arasında altı veri grubu düzenli olarak gidip gelir. Hangi verinin Mikro'nun hangi bölümünden okunup yazıldığını bilmeden kurulan entegrasyonlar bu altı başlıktan en az birinde tıkanır.

Shopify siparişlerinin Mikro'ya aktarımı

Sipariş, entegrasyon aracının Mikro'da açtığı oturum üzerinden cari hareket olarak yazılır. Alıcı Mikro'da kayıtlı değilse önce yeni bir cari kart açılır, sipariş bu karta işlenir.

Mikro Shopify stok senkronizasyonu

Mikro'daki depo miktarı belirli aralıklarla okunup Shopify'a yazılır, Shopify'daki satış da Mikro'da stoktan düşer. Bu tarama anlık değildir; aralığı entegrasyon aracının ayarı belirler.

Fiyat ve kampanya aktarımı

Shopify'daki satış fiyatı Mikro'daki fiyat listelerinden birinden gelir. İnternet satışı için ayrı bir liste seçilmezse mağazadaki indirimli fiyat da siteye taşınır.

Ürün ve varyant aktarımı

Mikro'daki stok kartı Shopify'da ürüne, renk ve beden kombinasyonları varyanta dönüşür. Bu dönüşümde iki tarafı birbirine bağlayan alan barkoddur.

Kargo ve takip bilgisi

Etiket ve takip numarası Mikro'dan değil, anlaşmalı kargo firmanızın entegrasyonundan gelir. Mikro'da oluşan sevk kaydı ise Shopify'da siparişin gönderildi durumuna geçmesini sağlar.

Fatura ve iade akışı

Fatura Mikro'da kesilir ve e-fatura ya da e-arşiv olarak GİB'e iletilir. Shopify'da yapılan iptal veya iade Mikro'daki cari kaydı kendiliğinden düzeltmez.

STOK

Mikro'daki stok Shopify'a nasıl yazılır?

Mikro'da depoda duran adet ile Shopify'da satışa açılacak adet farklı sayılardır; aradaki fark hesaplanmadan yazılan stok, olmayan ürünün satılmasına yol açar.

Siparişe ayrılan adet satışa açılmaz

Mikro'da bir müşteri siparişine ayrılmış ya da rezerve edilmiş ürün depo miktarında görünmeye devam eder. Shopify'a gönderilecek sayı, bu ayrılmış miktar düşüldükten sonra kalan adettir.

Shopify'a bağlanacak depoların seçimi

Mikro'da birden fazla depo tanımlıysa yalnız internet satışına açılacak depolar Shopify lokasyonlarıyla eşlenir. Bu seçimi canlıya geçtikten sonra değiştirmek, geçmiş hareketlerle bugünkü stok arasında açıklanamayan farklar bırakır.

Tarama aralığında gelen eş zamanlı siparişler

Stok, entegrasyon aracı Mikro'yu her taradığında güncellenir. İki tarama arasında hem mağazada hem sitede satılan son ürün iki kez satılmış olur; aralık kısaldıkça bu ihtimal azalır.

Barkod iki tarafın ortak anahtarı

Mikro stok kartı ile Shopify varyantını birbirine bağlayan alan barkoddur. Aynı barkodun iki karta yazıldığı ya da hiç girilmediği varyant stok aktarımına katılmaz.

İade faturasıyla stoğa dönen ürün

Mikro'da iade faturası işlendiğinde ürün yeniden satılabilir stoğa girer. Bu artış Shopify'a aktarılmadığında site, depoda duran ürünü tükendi olarak göstermeye devam eder.

ÇOK KANALLI SATIŞ

Fiziksel mağaza ile site aynı stoğu nasıl paylaşır?

Mağazası olan markalarda online sipariş depodan çıkabileceği gibi bir mağazanın rafından da gönderilebilir. Bunun Shopify'da doğru görünmesi için Mikro'daki her gönderim noktasının Shopify'da karşılığı olan bir lokasyon olarak tanımlanması gerekir.

Mağaza kasasından yapılan satış ya da kasaya getirilen iade sitedeki stoğu da değiştirir. Bu hareket Mikro'dan Shopify'a aktarılmıyorsa site, mağazada çoktan satılmış ürünü satmaya devam eder.

Tek bir Shopify siparişi iki farklı noktadan karşılanabilir. Bu durumda Mikro tarafında aynı sipariş için birden fazla sevk kaydı oluşabileceğini kurulum aşamasında planlayın.

KURULUM

Shopify Mikro entegrasyonu nasıl yapılır?

Aşağıdaki altı adım, ürün hattı tespitinden ilk siparişin Mikro'ya düşmesine kadar kurulumun tamamını kapsıyor. İlk adım Mikro'ya özgü: API erişimi otomatik gelmez, ürün bazlı başvuru gerekir.

Mikro ürün hattınızı ve API erişiminizi tespit edin

Mikro'nun birden fazla ürün hattı var: Run, Jump, Fly, Müşavir. Resmi API dokümantasyonu özellikle Jump hattı için net tanımlı; diğer hatlarda entegrasyon yöntemi değişebilir. API erişimi varsayılan gelmez, Mikro'ya ürün bazlı başvuru formuyla talep edilir.

Bağlantı ve kimlik bilgilerinizi alın

Mikro'nun entegrasyon arayüzü firma kodu, size özel erişim anahtarı, kullanıcı kodu ve şifrenizle oturum açar; açılan oturum sonraki bütün aktarımlarda kullanılır. Bu bilgileri bayinizden veya Mikro destek hattından alırsınız.

Bağlantı adresi ve sürüm uyumunu teyit edin

Bazı üçüncü taraf kaynaklar farklı bir bağlantı adresi ve "V17 ve üzeri" şartı belirtiyor; bu, Mikro'nun resmi v16 dokümanıyla tam örtüşmüyor. Kurulumdan önce kullandığınız Mikro sürümünün hangi bağlantı adresini desteklediğini bayinizle teyit edin, varsayım üzerine kurmayın.

Bağlantıyı kurup cari ve depo eşlemesini yapın

Oturum açıldıktan sonra entegrasyon aracına geçilir; hangi Mikro deposunun Shopify'a bağlanacağı ve yeni siparişlerin hangi cari koduyla açılacağı bu adımda tanımlanır.

Varyant, barkod ve fiyat listesi kurgusunu tanımlayın

Mikro'daki renk/beden kombinasyonları Shopify varyantlarına barkod üzerinden eşlenir; hangi fiyat listesinin internet satışına ait olduğu burada seçilir.

Deneme siparişiyle akışı doğrulayın

Tek bir siparişle akışı baştan sona izleyin: siparişin Mikro'da doğru cariye işlendiğini, stoğun iki tarafta da düştüğünü ve kesilen faturanın bilgisinin Shopify'a döndüğünü görün.

Kurulumda hangi adımda kaldınız?

Kataloğunuzu ve mevcut Mikro kurulumunuzu anlatın, Shopify Mikro entegrasyonunun sizin ürün hattınızda nasıl kurulacağını birlikte çıkaralım. Form doldurmanız gerekmiyor, telefon, e-posta veya WhatsApp'tan doğrudan bize ulaşın.

İletişime geçin 0850 888 2815 hub@nodusworks.com WhatsApp

ANLAŞMA VE ERİŞİM

Mikro entegrasyon bilgilerini nereden alırsınız?

Bu sorunun cevabı Mikro'da ürün hattınıza bağlı. Resmi API dokümantasyonu (apidocs.mikro.com.tr) özellikle Jump hattı için firma kodu, erişim anahtarı, kullanıcı kodu ve şifreyle çalışan bir giriş akışı tanımlıyor; bu bilgileri bayinizden veya Mikro'nun kendi destek kanalından alırsınız.

API erişimi otomatik gelmez. Mikro, API kullanımını ürün bazlı bir başvuru formuyla veriyor; lisansınızda bu erişim açık değilse entegrasyon kurulumundan önce bu başvuruyu tamamlamanız gerekir. Bu adımı atlayıp doğrudan entegrasyon aracı satın alan kurulumlar, kimlik doğrulama aşamasında beklenmedik bir gecikmeyle karşılaşır.

Üçüncü taraf kaynaklarda farklı bir bağlantı adresi ve sürüm şartı ("V17 ve üzeri") geçiyor; bu, Mikro'nun resmi v16 dokümanıyla birebir örtüşmüyor. Hangi sürümde hangi bağlantı adresinin çalıştığını varsaymak yerine bayinizle veya Mikro destek hattıyla teyit etmeniz, kurulumun en başında zaman kaybını önler.

EN SIK YAPILAN HATALAR

Shopify Mikro entegrasyonunda en sık yapılan hatalar

API erişimini teklif sonrasına bırakmak

Mikro API erişimi başvuru gerektirdiği için bu süreci entegrasyon aracı seçildikten sonra başlatmak, kurulum takvimini belirsiz bir bekleme süresine bağlar.

Ürün hattını teyit etmeden entegrasyon aracı satın almak

Run, Jump, Fly ve Müşavir arasındaki API farkını bilmeden alınan bir entegrasyon paketi, kurulum sırasında yanlış bağlantı adresine bağlanmaya çalışır.

Mağaza fiyat listesini siteye açmak

Mikro'da mağaza için tanımlanmış liste internet satışına da bağlanırsa, kasada uygulanan kampanya ve personel indirimi Shopify fiyatına yansır.

Barkodu boş varyantı aktarılmış saymak

Barkodu girilmemiş ya da başka bir kartta tekrar eden varyant Mikro ile eşleşmez. Bu varyantın stoğu Shopify'da hiç güncellenmez ve fark ancak stoksuz satış olduğunda anlaşılır.

İptal edilen siparişi Mikro'da açık bırakmak

Shopify'da iptal edilen sipariş Mikro'daki cari hareketi kendiliğinden geri almaz. Bu bağ kurulmadığında müşterinin cari bakiyesi gerçekte olmayan bir borç gösterir.

Üçüncü taraf bağlantı bilgisine sorgusuz güvenmek

Resmi dokümantasyonla çelişen bir bağlantı adresi veya sürüm bilgisini teyit etmeden kurmak, canlıya geçtikten sonra kimlik doğrulama hatasıyla sonuçlanabilir.

VARYANT VE BARKOD

Renk ve beden matrisi Shopify'a nasıl çevrilir?

Mikro v17'de varyant yapısı değişti: renk ve beden alanları stok kartından çıkarılıp ayrı bir varyant yapısına taşındı. v15/v16'dan yükseltilen bir kurulumda eski alan yapısıyla entegrasyon kurmaya çalışmak, kaydın reddedilmesine yol açar; önce hangi sürümde olduğunuzu teyit edin.

Barkod tarafında eşleşme Mikro'daki barkod tanımları üzerinden kurulur: her barkod kaydı belirli bir renk ve beden kombinasyonuna bağlanır. Shopify tarafındaki varyant barkodu bu kombinasyonla birebir eşleşmezse, o varyant stok senkronunun dışında kalır.

FATURA

Mikro'da internet satışı faturası nasıl kesilir?

Mikro v15 ve üzeri sürümlerde şube bazlı farklı e-fatura serisi tanımlanabiliyor; internet satışı kanalınızı ayrı bir şubeye bağlamak, fatura serisini mağaza içi satıştan ayırmanın standart yolu.

Şube kodu önce tanıtım kartında açılır

Şube tanıtım ekranında (ekran 501800) yeni bir şube kodu tanımlanır; internet satış kanalınız bu şubeye bağlanır.

Aynı şube kodu e-Mikro Portal'da eşlenir

Portal'daki "Hesap bilgileri > Şubeler" sekmesinde aynı kod tanımlanır ve o şubeye ait e-fatura serisi burada belirlenir.

Fatura, girişi yapan şubenin serisini kullanır

Hangi şubeye fatura girilecekse o şube koduyla oturum açılmalı; yanlış şubeden girilen fatura yanlış seriden çıkar.

STATION

Shopify Mikro entegrasyonu

Stok, fiyat, sipariş ve fatura akışını tek panelden yürütmek için geliştirdiğimiz araç Station. Mikro'ya bağlı mağazanıza pazaryeri kanalları eklendiğinde de her siparişin hangi şube serisinden faturalanacağı tek yerden yönetilir.

Entegrasyonu incele Kurulum için görüşün

SSS

Sıkça Sorulan Sorular

Mikro'nun resmi bir Shopify uygulaması var mı?

Hayır. Mikro kendi Shopify uygulamasını yayınlamıyor; bağlantı Mikro'nun resmi entegrasyon arayüzü üzerinden çalışan üçüncü taraf bir entegrasyon aracıyla kurulur.

Hangi Mikro ürün hattı Shopify entegrasyonuna en uygun?

Resmi API dokümantasyonu özellikle Jump hattı için net tanımlı. Run, Fly veya Müşavir kullanıyorsanız entegrasyon yöntemi değişebilir, bayinizle teyit edin.

API erişimi için ücret ödemem gerekiyor mu?

API erişimi Mikro'nun ürün bazlı başvuru süreciyle açılıyor; bu sürecin ücretli olup olmadığı ve koşulları bayinizden veya Mikro destek hattından teyit edilmeli.

v17'ye geçtim, eski entegrasyonum neden bozuldu?

v17'de renk ve beden alanları stok kartından ayrı bir varyant yapısına taşındı. Eski alan yapısına göre kurulmuş bir entegrasyon, bu değişiklikten sonra kayıt reddi ile karşılaşabilir; entegrasyon aracınızın v17 varyant yapısını desteklediğini teyit edin.