Magento / Adobe Commerce entegrasyonu:
siteniz ve pazaryerleri aynı stokta.

Magento entegrasyonu: Adobe Commerce sitenizi pazaryerlerine bağlamanın pratik rehberi

Magento entegrasyonu, Magento Open Source ya da Adobe Commerce üzerinde çalışan sitenizin stok, fiyat ve sipariş verisini pazaryerlerindeki ilanlarınızla aynı kaynaktan yönetmeniz demektir. Magento esnek ama kurulumu teknik bir altyapıdır; çok kaynaklı envanter, satılabilir miktar ve API yetkileri doğru ayarlanmadan yapılan bağlantılar fazla satışa yol açar. Bu bölümde Magento tarafında neyi hazırlamanız gerektiğini, stok mantığının nasıl çalıştığını ve sık yapılan hataları adım adım anlatıyoruz.

Magento entegrasyonu neden diğer altyapılardan farklıdır?

Hazır kiralık altyapılarda stok tek bir sayıdır: ürünün kaç adet olduğu yazar ve biter. Magento'da durum farklıdır. Platform, Inventory Management (MSI) modülüyle stoğu kaynaklara (depo, mağaza, tedarikçi) ve stoklara (satış kanalına bağlanan kaynak grupları) ayırır. Müşterinin görebildiği rakam ise kaynaklardaki fiziksel adet değil, satılabilir miktardır (salable quantity).

Bu ayrımın pazaryeri tarafında önemli bir sonucu var: Magento'da sipariş verildiğinde ürün hemen kaynak adedinden düşmez, önce bir rezervasyon oluşur ve satılabilir miktar azalır. Fiziksel adet ancak gönderi oluşturulduğunda kaynaktan düşülür. Pazaryerine fiziksel adedi gönderen bir bağlantı, kargolanmamış siparişleri hesaba katmadığı için aynı ürünü iki kez satmanıza neden olabilir.

• Tek depolu sitelerde varsayılan kaynak (Default Source) ve varsayılan stok (Default Stock) kullanılır; hesaplama sadedir.
• Birden fazla deposu olan sitelerde hangi kaynakların pazaryeri satışına açık olduğuna önceden karar verilmelidir.
• Yapılandırılabilir (configurable) ürünlerde stok ana üründe değil, her basit alt üründe (beden, renk) tutulur.
• Paket (bundle) ve gruplu ürünlerin adedi, içerdikleri basit ürünlerden gelir; bunları pazaryerinde set olarak satacaksanız ayrı barkodlu bir ilan gerekir.

Bağlantıdan önce Magento'da neler hazırlanmalı?

Magento entegrasyonunun büyük kısmı bağlantı kurulmadan önce, sitenizin yönetim panelinde yapılan düzenlemedir. Katalog ne kadar düzenliyse eşleştirme o kadar az elle kontrol gerektirir.

Magento'da SKU ve barkod (GTIN) düzeni

Ürünler panele okunduğunda pazaryeri ilanlarıyla barkod veya stok koduyla eşleştirilir. Magento'da SKU zorunludur ve her üründe farklı olmalıdır, ancak barkod (GTIN/EAN) için varsayılan bir alan yoktur; çoğu mağaza bunun için özel bir ürün özelliği açar. Pazaryerine verdiğiniz barkod hangi özellikte duruyorsa, her alt üründe dolu olduğundan emin olun.

Magento katalog kontrol listesi

• Her basit ürünün SKU'su pazaryerindeki stok koduyla aynı mı ya da barkod alanı dolu mu?
• Pasif (devre dışı) ürünler ve görünürlüğü kapalı alt ürünler ayıklandı mı?
• Fiyatlar KDV dahil mi hariç mi girilmiş; pazaryerinde aynı mantık mı kullanılıyor?
• Birden çok mağaza görünümü (store view) varsa hangi görünümün fiyatı esas alınacak?
• Stok yönetimi (Manage Stock) ürün bazında kapatılmış ürünler var mı?

Magento (Adobe Commerce) API erişimi nasıl verilir?

Magento'ya dışarıdan erişim, resmî REST API üzerinden ve sizin tanımladığınız bir entegrasyon kaydıyla yapılır. Yönetici şifrenizi kimseyle paylaşmanız gerekmez; erişim, yetkisini sizin seçtiğiniz bir anahtarla sınırlıdır ve istediğiniz an iptal edilebilir.

1. Yönetim panelinde Sistem > Uzantılar > Entegrasyonlar (System > Extensions > Integrations) menüsünü açın ve yeni entegrasyon ekleyin.
2. Ad ve e-posta girin, kendi yönetici şifrenizle onaylayın.
3. Sol menüdeki API sekmesinde kaynak erişimini Özel seçin; yalnız ürün, envanter ve sipariş kaynaklarına yetki verin.
4. Kaydedin, listede entegrasyonu bulup Etkinleştir ve ardından İzin ver deyin.
5. Ekranda görünen erişim anahtarlarını güvenli bir yere kopyalayıp Bitti deyin. Yeni anahtar gerektiğinde entegrasyonu Yeniden yetkilendir (Reauthorize) bağlantısıyla yenileyebilirsiniz.

Adobe'nin belgelerine göre entegrasyon anahtarlarının süresi dolmaz, siz iptal edene kadar geçerlidir. Bu anahtarların tek başına taşıyıcı (Bearer) belirteç olarak kullanılması ise güvenlik nedeniyle varsayılan olarak kapalıdır; ayar Mağazalar > Yapılandırma > Servisler > OAuth > Tüketici Ayarları altında durur ve Adobe açılmasını önermez. Bağlantı yetki hatası veriyorsa ilk bakılacak yerlerden biri bu ayardır; hangi kimlik doğrulama yönteminin kullanılacağını kurulumda birlikte netleştirmek işinizi kolaylaştırır.

Magento stok ve fiyat senkronu nasıl çalışır?

eticaretcim'de her ürün için tek stok kartı bulunur; Magento siteniz ve bağlı pazaryerleri bu karttaki adedi kullanır. Sitenizde bir satış olduğunda adet kartta düşer ve diğer kanallara yansır, pazaryerinde satış olduğunda da aynısı sitenize uygulanır. Ayrıntılı işleyişi stok ve fiyat senkronu sayfasında bulabilirsiniz.

Fiyat tarafında Magento'daki satış fiyatını temel alıp kanal başına yüzde veya tutar farkı tanımlayabilirsiniz. Örneğin sitede 1.000 TL olan bir ürünü, komisyon ve kargo kesintisini karşılamak için bir pazaryerinde %12 farkla 1.120 TL'ye listeleyebilirsiniz. Doğru farkı bulmak için kesintileri komisyon ve kargo kesintisi hesaplama rehberindeki örnekle çıkarmanızı öneririz.

Magento sipariş durumları pazaryeri siparişleriyle nasıl eşleşir?

Magento'nun kendi sipariş durumları vardır: Beklemede (pending), İşleniyor (processing), Tamamlandı (complete), Kapatıldı (closed, iade/kredi notu sonrası), İptal edildi, Askıda ve şüpheli ödeme gibi özel durumlar. Pazaryerlerinin durum adları bunlarla birebir örtüşmez.

eticaretcim'de site ve pazaryeri siparişleri tek listede Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim aşamalarıyla izlenir. Böylece Magento'daki işleniyor siparişini ve pazaryerindeki yeni siparişi aynı ekranda, aynı sırayla hazırlarsınız. Geciken sipariş uyarısı, toplu fatura ve etiket gibi araçlar için sipariş yönetimi sayfasına göz atabilirsiniz.

• Askıya alınan ya da ödeme incelemesindeki site siparişlerini kargo sırasına almayın.
• Kısmi gönderimde sipariş, bütün ürünler gönderilene kadar İşleniyor durumunda kalır; kısmi iadede (kredi notu) iade edilen ürünün stoğa geri eklenip eklenmediğini ayrıca kontrol edin.
• Takip numarasının hangi sistemde girildiğini ekip içinde netleştirin, iki yerde elle giriş hata üretir.

Magento ile pazaryerine açılırken sık yapılan hatalar

Magento kullanan mağazaların katalogları çoğu zaman geniştir; küçük bir ayar hatası yüzlerce ürüne birden yansır. Bağlantının ilk haftalarında en çok şu hatalara dikkat edin:

• Fiziksel kaynak adedini pazaryerine göndermek; kargolanmamış siparişler nedeniyle fazla satış.
• Yapılandırılabilir ürünün ana SKU'sunu pazaryeri ilanıyla eşleştirmek; doğru eşleşme alt ürün düzeyindedir.
• Tüm API kaynaklarına yetki vermek; yalnız gereken kaynakları açmak daha güvenlidir.
• İndeksleyicileri zamanlanmış güncelleme (Update by Schedule) modunda çalışan sitelerde cron görevlerini aksatmak; stok değişikliği sitede geç görünür.
• Kritik stokta güvenlik payı bırakmamak; son birkaç adedi tek kanala ayırmak iade ve iptal karmaşasını azaltır.

Eşleşmeyen ya da çakışan ürünler panelde stok çakışmaları listesinde, pazaryerinin reddettiği ilanlar ise sebebiyle birlikte senkron sağlığı ekranında görünür. Fazla satışı önlemeye yönelik genel kontrol listesi için çok kanallı stokta aşırı satışı önlemek rehberini okuyabilirsiniz.

Magento entegrasyonu fiyatı: hangi paket uygun?

Başlangıç paketi tek kanallıdır ve bu kanal Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM veya idefix'ten biri olmalıdır. Magento sitenizi en az bir pazaryeriyle birlikte bağlamak istiyorsanız, 80 kanaldan herhangi üçünü seçebildiğiniz Büyüme paketi ilk uygun seçenektir: örneğin Magento, Trendyol ve Hepsiburada.

Ürün sayısı 5.000'i, aylık sipariş 500'ü aşan kataloglarda Profesyonel ya da Kurumsal paketin limitleri daha uygundur; birden çok deposu olan Magento mağazaları için Kurumsal paketteki depo yönetimi de değerlendirilebilir. Güncel limitleri fiyatlar ve paketler sayfasında karşılaştırabilirsiniz. 3 günlük ücretsiz denemede kendi ürünlerinizle eşleşmeyi görebilir, isterseniz kurulumu bizimle birlikte yapabilirsiniz.