PrestaShop Varyant Stok Entegrasyonu: Doğru Kombinasyon ve Mağaza Kontrolü
Depoda raflardaki saklama kutularını birlikte kontrol eden iki kadın
Temsili stok fotoğrafı: Centre for Ageing Better / Pexels. Görseldeki kişiler Entegrino müşterisi olarak tanıtılmamaktadır.

PrestaShop varyant stok entegrasyonunda yalnızca ürün kodunu kontrol etmek yeterli değildir. Ürün, kombinasyon, stok kaydı ve mağaza bağlamının aynı satış seçeneğini gösterdiğini doğrulayın. Aksi halde bir ürünün toplam stoğu doğru görünürken müşterinin seçtiği renk veya hacim yanlış miktarla satışa açık kalabilir.

Bu rehber PrestaShop 9’un klasik Webservice yapısını esas alır. Farklı sürüm veya modüllerde işlemi kendi kurulumunuzla karşılaştırın. Aşağıdaki işletme örneği ve kontrol akışı, bağlantı geliştiren ekip ile mağaza yöneticisinin birlikte kullanması için hazırlanmıştır.

Ürün kimliği ile stok kaydı kimliğini ayırın

Resmî stok kaynağında id_product, id_product_attribute, id_shop, id_shop_group ve quantity alanları ayrı tanımlanır. Bu ayrım, aktarımın hangi ürün seçeneğine ve mağazaya ait olduğunu kontrol etmeyi sağlar. Kaynak: PrestaShop stok kaynak şeması.

PrestaShop rehberi, kombinasyon oluşturulduğunda karşılık gelen bir stok kaydı oluştuğunu açıklar. Miktar güncellemesi için önce ilgili stok kaydı bulunur; güncellemede bu kaydın kimliği kullanılır. Çoklu mağazada ise stok paylaşım düzenine göre mağaza veya mağaza grubu bağlamı önem taşır. Kaynak: PrestaShop Webservice ürün ve stok rehberi.

Kozmetik mağazası örneği: toplam doğru, hacim yanlış

Varsayımsal bir mağaza aynı parfümün 50 ml ve 100 ml seçeneklerini satıyor olsun. Depoda 50 ml üründen 8, 100 ml üründen 3 adet bulunsun. Entegrasyon toplam 11 adedi iki kombinasyona da gönderirse mağaza her seçenek için 11 adet gösterir. Fiziksel toplam değişmemiştir; ancak satışa sunulan seçenekler yanlış miktarla eşleşmiştir.

Kontrolü ürün toplamından başlayıp orada bitirmeyin. Her kombinasyonun kodunu, hacmini ve miktarını ayrı satırda inceleyin. Beklenen sonuç 50 ml için 8, 100 ml için 3 olmalıdır. Bir kombinasyonun stoğunu düzelttiğinizde diğerinin değişmediğini de doğrulayın.

Eşleştirme tablosunda tutulacak bilgiler

  • İşletmenin stok kodu ve açıklaması.
  • PrestaShop ürün ve kombinasyon kimlikleri.
  • İlgili stok kaydının kimliği.
  • Mağaza veya paylaşılan stok grubunun referansı.
  • Kaynak miktar, gönderilen miktar ve işlem zamanı.
  • Aktarım sonrası okunan değer ve kontrol sonucu.

Ürün adı değiştiğinde eşleştirme bozulmamalıdır. “Parfüm büyük boy” gibi açıklamalar ekip için yararlı olabilir; otomatik aktarımın hangi kombinasyonu hedeflediğini kanıtlamaz. Kimlikleri sayısal olarak birbirine benziyor diye eşit kabul etmeyin.

Yanlış aktarımı bulmak için beş adım

  1. Tek örnek seçin. Sorunlu kombinasyonu ve etkilenen mağazayı belirleyin. Başlangıç miktarını kaydedin.
  2. Kaynak veriyi inceleyin. Aktarılan sayı fiziksel stok mu, satışa ayrılan miktar mı? İşletmenin hangi değeri esas aldığını netleştirin.
  3. Hedef eşleşmeyi okuyun. Ürün ve kombinasyonun yanında stok kaydı ile mağaza bağlamını karşılaştırın.
  4. Sonucu geri okuyun. İstek başarılı göründükten sonra hedef kayıttaki miktarı yeniden kontrol edin. Yalnızca gönderilen dosyayı incelemekle yetinmeyin.
  5. Vitrini kontrol edin. Müşterinin seçtiği kombinasyonda görünen bulunabilirliği ve stok dışı satış ayarını ayrıca inceleyin.

Stok değeri doğru olduğu halde ürün satın alınabiliyorsa sorun doğrudan miktar aktarımı olmayabilir. Stok dışı sipariş davranışını ve mağazadaki modülleri kontrol edin; miktarı rastgele değiştirerek sorunu örtmeyin.

Eşzamanlı satış ve eski dosya riski

Örnekte 50 ml seçeneği için 8 adetlik dosya hazırlanmışken bir satış gerçekleşip miktar 7’ye düşebilir. Eski dosyanın daha sonra uygulanması güncel değeri geri yükseltebilir. Entegrasyon tasarımında veri zamanını ve aktarım sırasını izleyin; hangi sistemin esas stok kaynağı olduğunu belirleyin.

Güvenli test ortamında iki kombinasyonu farklı miktarlarla deneyin. Aynı veri yeniden işlendiğinde sonuç değişiyor mu, eski veri yenisini eziyor mu, yanlış mağaza güncelleniyor mu kontrol edin. Beklenen ve gerçekleşen değerleri kayıt altına almadan toplu aktarıma geçmeyin.

Doğru varyant eşleştirmesi sipariş ve fatura sistemine de taşınmalıdır. Depo doğru ürünü seçerken belge taslağında başka hacim görünüyorsa yalnızca stok bağlantısını düzeltmek yeterli değildir. Başka kanallardaki kimlik ayrımları için Amazon SKU ve ASIN eşleştirme rehberini inceleyebilirsiniz.

Sık sorulan sorular

Ürün toplam stoğu doğruysa entegrasyon tamam mıdır?

Hayır. Her kombinasyonun miktarını ve doğru mağazada güncellendiğini ayrı kontrol edin.

Tek mağazada mağaza bağlamını kaydetmek gerekir mi?

Eşleştirme kaydında bağlamı açık tutmak, ileride mağaza eklendiğinde veya kayıtlar incelendiğinde belirsizliği azaltır. Gönderilecek teknik alanları kurulumunuzun şemasıyla doğrulayın.

Bu kontroller hazır bir Entegrino bağlantısını mı anlatıyor?

Yazı PrestaShop stok aktarımının kontrolünü anlatır. Kullanılacak bağlantının sürüm, kombinasyon ve çoklu mağaza desteği ayrıca doğrulanmalıdır.

Kaynak kontrol tarihi: 16 Ekim 2026. Sayılar varsayımsaldır; iş akışı editoryal öneridir.