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

Magento entegrasyonu nedir, hangi Magento türlerinde kurulur?

Magento entegrasyonu, sitenizi pazaryerleriyle ortak bir stok ve sipariş akışına bağlayan, yönetim panelinde sizin tanımladığınız bir API erişimiyle çalışan bağlantıdır. Magento bugün Adobe'nin ürün ailesinde dört farklı biçimde çalışır ve bağlantının nasıl kurulacağı, sitenizin hangi biçimde çalıştığına göre değişir. Kendi sunucusunda çalışan WooCommerce gibi açık kaynak altyapılarda olduğu gibi Magento Open Source'ta da barındırma, yama ve cron düzeni sizin sorumluluğunuzdadır.

Magento Open Source, Adobe Commerce ve Cloud Service arasındaki fark

Tablonun son satırı kurulum planını doğrudan etkiler: Adobe'nin kimlik ve erişim yönetimi belgesine göre Cloud Service ortamlarında entegrasyon anahtarı üretilmez, her istek bir IMS erişim belirteciyle imzalanır ve REST adresi de farklı bir biçim kullanır. Diğer üç biçimde ise yönetim panelinde oluşturulan entegrasyon kaydı yeterlidir.

Ekim 2026 itibarıyla Adobe Commerce sürüm destek takvimi

Adobe, her Adobe Commerce sürüm hattına genel kullanıma çıktığı tarihten itibaren üç yıllık standart destek verir; bu süre kalite düzeltmelerini ve güvenlik yamalarını kapsar. Adobe Commerce müşterileri için 2.4.6 ve 2.4.7'ye ücretsiz bir yıllık genişletilmiş destek, 2.4.4–2.4.6'ya da yalnız güvenlik düzeltmesi içeren tek seferlik bir geçiş dönemi tanınmıştır.

Bu takvim bir pazaryeri bağlantısı için neden önemli? Entegrasyon, sitenize süresiz bir erişim anahtarıyla bağlanır; desteği bitmiş bir sürümde kapanmamış bir güvenlik açığı, bu anahtarın açtığı her kapıyı da riske sokar. Adobe ayrıca bulut altyapısındaki mağazalar için zorunlu yükseltme tarihleri belirlemiştir: 2.4.4 ve 2.4.5 için 1 Haziran 2027, 2.4.6 ve 2.4.7 için 1 Haziran 2028. Adobe'ye göre desteklenmeyen bulut ortamlarında trafik askıya alınabilir.

Magento entegrasyonu için API erişimi nasıl verilir?

Magento entegrasyonunda erişim, yönetim panelindeki Sistem > Uzantılar > Entegrasyonlar (System > Extensions > Integrations) ekranında oluşturduğunuz bir entegrasyon kaydıyla verilir. Bu yöntemde yönetici şifreniz kimseyle paylaşılmaz ve erişim yalnız sizin işaretlediğiniz kaynaklarla sınırlı kalır. Adımlar Adobe'nin yönetim paneli belgesindeki sırayı izler:

1. Sistem > Uzantılar > Entegrasyonlar menüsünü açın ve yeni entegrasyon ekleme düğmesine tıklayın.
2. Kayda tanınabilir bir ad (ör. "Yox İş Ortağım") ve iletişim e-postası verin; istendiğinde kendi yönetici şifrenizle onaylayın.
3. Soldaki API sekmesinde Kaynak Erişimi (Resource Access) seçeneğini Özel (Custom) yapın; yalnız ürün, envanter ve sipariş kaynaklarını işaretleyin.
4. Kaydedin. Yeni kayıt listede Pasif görünür; Etkinleştir (Activate) bağlantısına, ardından sağ üstteki İzin Ver (Allow) düğmesine tıklayın.
5. Ekranda görünen entegrasyon anahtarlarını güvenli bir yere kopyalayıp Bitti (Done) deyin.
6. Anahtarları Yox İş Ortağım'daki Magento bağlantı ekranına girin; ürünleriniz panele okunmaya başlar.

Magento erişim anahtarları ne kadar süre geçerli?

Adobe, entegrasyonun erişim belirtecinin tek başına Bearer token olarak kullanılmasını varsayılan olarak kapatmıştır; ayar Mağazalar > Yapılandırma > Servisler > OAuth > Tüketici Ayarları altında durur ve Adobe, ele geçirilen süresiz bir belirtecin fark edilmeden kalıcı erişim sağlayabileceği gerekçesiyle açılmasını önermez. Bağlantıyı tamamen kesmek için kaydı silmeniz yeterlidir.

Magento Web API sınırları büyük kataloglarda senkronu nasıl etkiler?

Adobe Commerce, Web API isteklerine giriş sınırları koyabilir; bu sınırlar varsayılan olarak kapalıdır ve Mağazalar > Ayarlar > Yapılandırma > Servisler altındaki Web API sınırları bölümünde Enable Input Limits seçeneğiyle açılır. Güvenlik sıkılaştırması yapılmış sitelerde açık olabilecekleri için geniş bir katalogu bağlamadan önce durumlarını öğrenin.

Sayfa boyutu ve dizi sınırları

• Azami sayfa boyutu (Maximum Page Size): sınırlar açıldığında sayfalı sonuçlarda varsayılan üst değer 300 kayıttır.
• Varsayılan sayfa boyutu (Default Page Size): REST sorgularında sayfa başına 20 kayıt.
• Girdi listesi sınırı (Input List Limit): bir istek gövdesindeki dizi için eşzamanlı isteklerde 20, asenkron isteklerde 5.000 öğe.
• Değerler genel olarak, web sitesi ya da mağaza görünümü düzeyinde ayrı ayrı ayarlanabilir.

Sınırların düşük tutulması bağlantıyı koparmaz, ancak aynı katalogu okumak için gereken istek sayısını artırır. Bu nedenle değerleri değiştirmeden önce entegrasyon tarafını haberdar etmek, ilk ürün aktarımının ve sonraki toplu güncellemelerin planlı ilerlemesini sağlar.

Asenkron uç noktalar, cron ve dizinleyiciler

Magento, toplu işler için standart uç noktanın önüne /async eki gelen asenkron uç noktalar sunar: istek mesaj kuyruğuna yazılır ve async.operations.all tüketicisi tarafından sırayla işlenir. Tüketici çalışmıyorsa kuyruktaki işler bekler. Adobe ayrıca dizinleyicilerin Zamanlanmış Güncelleme (Update by Schedule) modunda çalışmasını önerir; bu modda değişikliklerin vitrine yansıması cron görevine bağlıdır ve cron aksarsa vitrin bir süre eski adedi gösterebilir. Sistem > Araçlar > Dizin Yönetimi ekranındaki "Reindex Required" uyarısı genellikle cron yapılandırmasına bakmanız gerektiğini gösterir.

Magento stok mantığı: kaynak, stok ve satılabilir miktar

Magento'nun envanter modülü (Inventory Management) stoğu iki katmanda tutar: kaynak (source) ürünün fiziksel olarak durduğu ve gönderildiği yerdir, stok (stock) ise bir ya da birden çok kaynağın satış kanalına açılan sanal toplamıdır. Tek kaynaklı sitelerde Varsayılan Kaynak ile Varsayılan Stok kullanılır; ikinci bir kaynak tanımlandığında site çok kaynaklı moda geçer. Her web sitesi yalnız bir stoğa bağlanabilir.

Satılabilir miktar ve rezervasyon ne zaman devreye girer?

Müşterinin gördüğü sayı, kaynaklardaki adet değil satılabilir miktardır (Salable Quantity): stoğa atanmış kaynakların toplamından rezervasyonlar ve eşik değeri düşülerek bulunur. Sipariş verildiğinde Magento sipariş adedi kadar rezervasyon girer ve satılabilir miktar hemen azalır; kaynak başına adet ise ancak gönderi oluşturulduğunda düşer. Adobe rezervasyonlar için bir Web API sunmadığından pazaryerine yansıyacak adedi düşünürken kargolanmamış siparişleri de hesaba katan satılabilir miktar esas alınmalıdır.

Yapılandırılabilir, paket ve gruplu ürünlerde stok

• Basit (simple) ürün: tek SKU'lu fiziksel üründür; diğer türler bileşen olarak basit ürünleri kullanır.
• Yapılandırılabilir (configurable) ürün: beden, renk gibi her seçenek kendi SKU'su olan ayrı bir basit üründür; stok ve pazaryeri eşleşmesi bu düzeyde yürür.
• Gruplu (grouped) ürün: tek başına satılabilen ürünlerin bir arada gösterimidir.
• Paket (bundle) ürün: müşterinin seçeneklerden kendi paketini kurduğu türdür; Adobe, birlikte gönderilecek paketlerde bütün bileşenlerin aynı kaynağa atanmasını ister.

Magento sipariş durumları ve tek sipariş listesi

Magento'da her siparişin bir durumu (status) vardır ve bu durumlar pazaryerlerinin sipariş aşamalarıyla birebir örtüşmez; kargo sırasını belirlerken durumun gerçekte ne anlattığını bilmek, ödemesi doğrulanmamış bir siparişin paketlenmesini önler. Adobe'nin belgesindeki varsayılan durumlardan pazaryeri satıcısını en çok ilgilendirenler şunlardır:

Yox İş Ortağım'da Magento siparişleri pazaryeri siparişleriyle aynı listede Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim aşamalarıyla izlenir; ekibiniz siteden ve pazaryerinden gelen siparişleri tek ekranda, aynı sırayla hazırlar.

Gönderi kaydı ve takip numarası

Magento'da bir sipariş, gönderi (shipment) kaydı oluşturulduğunda kargolanmış sayılır. Adobe'nin REST örneğinde gönderiye takip numarası, kargo firması adı ve taşıyıcı kodu eklenir; tam gönderiden sonra sipariş Complete durumuna geçer, kısmi gönderide ise Processing'de kalır. Takip numarasını kimin, hangi ekranda gireceğini işe başlamadan kararlaştırın: aynı siparişe iki ayrı yerden numara yazılması, müşteriye birbirini tutmayan kargo bildirimleri gitmesine yol açar.

Yox İş Ortağım ile Magento entegrasyonu nasıl kurulur?

Yox İş Ortağım'da Magento siteniz, pazaryerleriyle aynı ürün kartını paylaşan bir satış kanalı olarak çalışır: ürünler siteden panele aktarılır, satış hangi kanaldan gelirse gelsin adet her yerde düşer, siparişler tek listede kargo ve faturayla yönetilir. Kurulum sırası şöyledir ve siz onaylamadan hiçbir ürün ya da ilan değişmez:

1. Siteyi bağlayın: Magento'da oluşturduğunuz entegrasyon kaydının erişim anahtarlarını panele girin; ürünleriniz ve mevcut pazaryeri ilanlarınız panele okunur.
2. Eşleşmeyi kontrol edin: Ürünler barkod ya da stok koduyla mevcut ilanlarla eşleşir; eşleşmeyen ya da çakışan kayıtlar stok çakışmaları listesinde görünür.
3. Kategorileri eşleştirin: Pazaryerinde yeni açacağınız ürünler için Magento kategorilerini pazaryerinin kategori ve özellikleriyle eşleştirin.
4. Fiyat kuralını belirleyin: Her kanal için yüzde ya da tutar farkı tanımlayın; sitedeki fiyatınız değişmeden kalır.
5. Kanalları açın: Aynı ürünleri Trendyol, Hepsiburada ve dilediğiniz diğer pazaryerlerinde satışa açın; adet tek karttan yönetilir.

İsterseniz bu adımları sizinle birlikte yapıyoruz. Bağlanabilen kanalları ve firmaları entegrasyon listesinde görebilirsiniz.

Paneller arasında elle yönetim ile Yox İş Ortağım karşılaştırması

Magento entegrasyonu hangi pakette, fiyat farkı nasıl kurulur?

Magento, Yox İş Ortağım'da Başlangıç paketinde yer almaz; Başlangıç'ın tek kanalı yalnız Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ya da idefix olabilir. Magento sitesini iki pazaryeriyle birlikte bağlamak için ilk uygun seçenek, 80 satış kanalından herhangi üçünü seçebildiğiniz Büyüme paketidir.

Magento'da çok kaynaklı envanter kullanan, birden fazla deposu olan mağazalar için Kurumsal paketteki depo yönetimi ayrıca değerlendirilebilir. Yıllık ödemede %20 indirim uygulanır; kargo ve e-Fatura haklarıyla birlikte ayrıntılı tablo paket karşılaştırmasında yer alır.

Örnek fiyat farkı hesabı

Sitede pazaryeri komisyonu ödemediğiniz için Magento fiyatını pazaryeri fiyatının altında tutmak yaygın bir tercihtir. Örnek olarak 1.250 TL'lik bir ürüne %15 fark uygulanırsa pazaryeri fiyatı 1.437,50 TL, +150 TL tutar farkı uygulanırsa 1.400 TL olur; aynı kurallar 3.000 TL'lik üründe 3.450 TL ve 3.150 TL verir. Oranlar örnektir, herhangi bir pazaryerinin komisyonu değildir. Yüzde farkı fiyat yükseldikçe büyür, tutar farkı sabit kalır; kategori komisyonunu ve kargo kesintisini hesaplamadan kural koymayın. Kesintiyi komisyon hesaplama aracıyla çıkarabilirsiniz.

Magento entegrasyonundan önce kontrol listesi ve sık yapılan hatalar

Magento entegrasyonunda yaşanan aksaklıkların büyük bölümü bağlantıdan değil, sitedeki veri ve ayar düzensizliğinden doğar. İlk aktarımdan önce yapılan kısa bir kontrol, sonradan yüzlerce üründe tek tek düzeltme yapma ihtiyacını ortadan kaldırır.

Bağlamadan önce kontrol edin

• Her basit ürünün ve her seçeneğin SKU'su tekil mi; barkod (GTIN/EAN) değeri pazaryerine verdiğinizle aynı mı? Kontrol hanesini barkod hesaplama aracıyla doğrulayabilirsiniz.
• Pazaryerine açılacak ürünlerde Manage Stock açık, Backorders kapalı mı?
• Çok kaynaklı yapıda pazaryeri satışına hangi kaynakların açık olacağı belli mi?
• Cron ve kuyruk tüketicileri düzenli çalışıyor, Dizin Yönetimi ekranında bekleyen uyarı yok mu?
• Sürümünüz Adobe'nin destek takviminde mi; yükseltme yoğun satış dönemine denk geliyor mu?
• Birden çok mağaza görünümünüz varsa hangisinin fiyatının esas alınacağı ve fiyatların KDV dahil girilip girilmediği netleşti mi?

Sık yapılan hatalar

• Entegrasyon kaydına Kaynak Erişimi olarak Tümü (All) vermek: müşteri, içerik ve yapılandırma alanları da gereksiz yere açılır.
• Süresiz geçerli anahtarı e-postayla ya da ortak bir belgede paylaşmak; sızma şüphesinde kaydı hemen yeniden yetkilendirin.
• Bearer ayarını gerekmediği halde açmak.
• Yapılandırılabilir ürünün ana kaydını pazaryeri ilanına bağlamak; eşleşme seçenek düzeyindeki basit üründe olmalıdır.
• Aynı ürünün adedini hem Magento'ya kurulu bir pazaryeri eklentisinden hem panelden göndermek: iki sistem aynı stoğa yazarsa adetler birbirini ezer.