PrestaShop Akıllı Sipariş & ERP Senkronizasyon Modülü
Sipariş, stok, fatura ve kargo durumlarını Logo, Mikro, Nebim, Dia ve özel REST ERP sistemleriyle Transactional Outbox + idempotent webhook kuyruğu üzerinden sıfır kayıpla eşitleyen kurumsal modül.
PrestaShop Akıllı Sipariş & ERP Senkronizasyon Modülü, çok kanallı ve yüksek sipariş hacimli e-ticaret mağazalarında manuel veri aktarımı, çift düşen stoklar ve zaman aşımına uğrayan ödeme adımlarını ortadan kaldırmak için sıfırdan Symfony + Doctrine DBAL mimarisiyle geliştirilmiştir.
Mimari Yaklaşım: Ödeme Akışını Asla Bloklamayan Outbox Kuyruğu
Klasik entegrasyon eklentileri sipariş onay anında harici ERP API’sine senkron HTTP çağrısı yapar. Karşı sunucu 6 saniye yavaşladığında müşteri ödeme ekranında hata alır. Bu modül, hookActionValidateOrder ve hookActionOrderStatusPostUpdate kancalarında yalnızca yerel ps_tt_erp_outbox tablosuna benzersiz bir idempotency_key ile kayıt yazar (<2 ms) ve aktarımı arka plan işçisine devreder.
# Symfony Console ile arka plan işçisini çalıştırma
php bin/console tt:erp:consume --limit=100 --memory-limit=128M
# Başarısız kayıtları (Dead-Letter Queue) inceleme ve yeniden tetikleme
php bin/console tt:erp:dlq:retry --since="-24 hours"
Desteklenen Akışlar ve Teknik Garantiler
| Modül Yeteneği | Teknik Mekanizma | Operasyonel Fayda |
|---|---|---|
| Sipariş & Cari Aktarımı | Transactional Outbox + X-Idempotency-Key |
Ağ kopmalarında bile mükerrer fatura veya kayıp sipariş sıfırlanır |
| Atomik Stok Kilitleme | InnoDB koşullu UPDATE ... WHERE quantity >= :qty |
Kampanya anlarında negatif stok ve aşırı satış (overselling) engellenir |
| Çoklu Mağaza (Multistore) | id_shop ve depo kodu bazlı ayrı kanal eşleştirme |
B2B ve B2C mağazalar tek ERP üzerinde hatasız ayrıştırılır |
| Gözlemlenebilirlik | JSON yapısal log + HMAC imzalı webhook doğrulama | Hata teşhisi saatlerden saniyelere iner |
Kurulum ve Yapılandırma
- Modül paketini
/modules/tt_erp_syncdizinine yükleyin veya Back Office → Modül Yöneticisi üzerinden kurun. - ERP uç nokta URL’si, Bearer/HMAC gizli anahtarı ve depo/vergi eşleştirmelerini modül ayarlarından tanımlayın.
- Sunucu cron veya systemd servisiyle
tt:erp:consumeişçisini dakikada bir çalışacak şekilde etkinleştirin.
Sürüm Geçmişi (Changelog)
- v2.4.0: PrestaShop 9 çekirdek uyumluluğu,
SKIP LOCKEDparalel kuyruk desteği ve toplu stok delta senkronizasyonu eklendi. - v2.2.0: Shopier / iyzico taksit farkı muhasebe satırı eşleştirmesi ve Dead-Letter Queue tek tık tekrar ekranı eklendi.
- v2.0.0: Legacy
ObjectModelkancalarından tamamen Symfony Service Decoration mimarisine geçildi.