Entegrasyon Kütüphanesi
Mikro ERP – WooCommerce Stok Entegrasyonu: Mimari ve Kontrol Listesi
Mikro ERP ile WooCommerce arasında stok verisi aktarımını planlarken veri eşleştirme, senkronizasyon ve hata yönetiminde dikkat edilecek noktalar.
- Mikro ERPAna kayıtlar ve ticari kurallar
- Yetkili entegrasyon servisiEşleştirme, kuyruk ve sonuç kontrolü
- WooCommerceİzinli görünüm ve işlem talebi
Bir e-ticaret mağazasında müşterinin gördüğü stok ile ERP'deki gerçek stok birbirinden farklıysa sipariş iptali, gecikme ve manuel düzeltme işlemleri artar. Mikro ERP ile WooCommerce arasında stok entegrasyonu tasarlarken ilk karar, hangi sistemin stok için esas kaynak olacağıdır. Bu rehber, entegrasyonun kendiliğinden mevcut olduğunu değil, teknik bir çözümün nasıl değerlendirilebileceğini açıklar.
Sistemlerin sunduğu veri erişimi
Mikro'nun resmî MikroAPI dokümanında StokListesiV2 ile kayıtlı stokların listelenmesi ve StokKaydetV2 ile stok kaydı oluşturulması belgeleniyor. WooCommerce REST API ise ürün kayıtlarının okunup güncellenmesini destekliyor. Bu yetenekler entegrasyon için bir başlangıç noktasıdır; depo bazlı kullanılabilir miktarın nasıl elde edileceği ayrıca test edilmelidir.
Önerilen veri akışı
- Her iki taraftaki ürünleri ortak SKU veya açık bir eşleştirme tablosuyla ilişkilendirin.
- Ürün kodu, varyant, birim, depo ve aktif/pasif durumlarını eşleştirin.
- ERP'de kullanılabilir stok hesabının formülünü tanımlayın: fiziksel stok, ayrılmış stok ve açık siparişler ayrı değerlendirilmeli.
- Sadece değişen kayıtları aktarabilmek için olay mekanizması veya kontrollü periyodik sorgu seçin.
- WooCommerce tarafında güncelleme sonuçlarını kayıt altına alın; başarısız işlemler yeniden deneme kuyruğuna düşsün.
- Gün sonunda uzlaştırma raporuyla eksik veya uyuşmayan SKU'ları belirleyin.
Pilot test matrisi
| Senaryo | Beklenen davranış |
|---|---|
| Yeni SKU | Eşleşme bulunamazsa inceleme listesine düşer |
| Varyantlı ürün | Ana ürün ile varyant kodları karışmaz |
| Eşzamanlı sipariş | Ayrılmış stok hesaba katılır |
| Kesilen bağlantı | Son başarılı senkronizasyon saklanır |
| Aynı olay iki kez gelir | İdempotent işlem çift güncelleme yapmaz |
En çok karşılaşılan tasarım kararları
Çift yönlü mü, tek yönlü mü? Stokun esas kaynağı ERP ise WooCommerce'den geri stok yazmak tutarsızlık yaratabilir. Birden fazla depo var mı? Mağazada görünen miktar yalnızca satışa açık depoları içermeli. Senkronizasyon sıklığı ne olmalı? İş hacmi ve API kapasitesine göre ölçülmeli, keyfî bir “gerçek zamanlı” vaadi verilmemeli.
Ne zaman özel entegrasyon gerekir?
Tek depo ve basit ürün kataloğu olan işletmeler hazır bir köprüyle ihtiyacını karşılayabilir. Özel fiyat listeleri, bayi bazlı stok, çoklu depo, onay akışları veya özel ERP kuralları devreye girdiğinde tasarıma ihtiyaç artar.
Eşleşen ürünün stoku neden yine yanlış olabilir?
Örnek senaryo: ERP'de KOLİ-01 bir koli, mağazada aynı ürün tek adet olarak satılıyor. Yalnız ürün kodunu eşlemek yeterli değildir; koli içi miktar ve hangi birimin stoktan düşeceği belirlenmelidir. Benzer biçimde ana ürünün stok alanını güncellemek, ayrı stok tutulan varyantın miktarını güncellemiş sayılmaz.
| Veri | Ana kaynak | Aktarım kuralı |
|---|---|---|
| Ürün/SKU eşlemesi | Onaylı eşleştirme listesi | Bilinmeyen kod otomatik ürün açmaz |
| Satılabilir miktar | ERP'nin üzerinde uzlaşılan hesabı | Seçili depo ve rezervasyon kuralı uygulanır |
| Mağaza siparişi | WooCommerce | Sabit dış referansla ERP kabulü izlenir |
| İptal veya iade | İş kuralına göre | Tekrarlanan olay stok miktarını iki kez artırmaz |
Stok eşitleme, tek başına aşırı satışı engelleme garantisi değildir. Mağaza ve ERP'de eşzamanlı satışın hangi anda rezerve edildiği test edilmelidir. Başlangıç düzeni için stok Excel şablonu, yetkilendirme sorunu için WooCommerce 401 rehberi kullanılabilir.
Kaynaklar ve doğrulama
- apidocs.mikro.com.tr — resmî doküman
- developer.woocommerce.com — resmî doküman
- developer.woocommerce.com — resmî doküman
Örnek akışlar mimari öneridir; tamamlanmış müşteri projesi veya üretici iş ortaklığı iddiası değildir. Teknik kaynak kontrolü: 17 Ekim 2026. Kurulumun sürümü, lisansı ve izinleri ayrıca doğrulanır.
İşletmenizdeki akışa uyarlayın
ERP entegrasyonu planlama rehberi. B2B portal geliştirme kapsamını inceleyebilir, mevcut sürecinizi birlikte değerlendirebiliriz.
İhtiyacınızı konuşalım →