PrestaShop Projelerinde Sipariş, Webhook ve ERP Stok Entegrasyonunun İncelikleri
Çok kanallı PrestaShop mağazalarında ERP, pazaryeri, ödeme geçitleri (Shopier vb.) ve kargo sistemleriyle hatasız, imzalı ve idempotent veri senkronizasyonu kurmanın mimari kuralları.
E-ticaret hacmi büyüdükçe mağaza ile depo/ERP arasındaki manuel Excel aktarımları veya kırılgan cron betikleri ilk çöken halka haline gelir. Çift düşen stoklar, iptal edilen siparişler ve kayıp kargo barkodları hem müşteri güvenini hem operasyon kârlılığını eritir.
1. Tek Kaynak Gerçeği (Single Source of Truth) Belirleme
Entegrasyon kodunu yazmadan önce her veri alanı için “otorite sistem” netleştirilmelidir. Örneğin:
- Stok & Maliyet Otoritesi: Fiziksel depo/ERP yazılımı.
- Zengin İçerik, Görsel & SEO Otoritesi: PrestaShop / PIM katmanı.
- Sipariş & Ödeme Otoritesi: PrestaShop + imzalı ödeme geçidi geri bildirimi (Callback / OSB Webhook).
Aynı alanın iki sistem tarafından birbirinden habersiz çift yönlü ezilmesi kaçınılmaz olarak yarış durumları (race condition) üretir.
2. Webhook ve OSB Geri Bildirimlerinde Kriptografik İmza Doğrulaması
Ödeme geçitlerinden (örneğin Shopier OSB veya sanal POS callback uçları) gelen sipariş bildirimlerinde yalnızca IP kontrolüne güvenmek yeterli değildir. Gelen yükün bütünlüğü mutlaka paylaşılan gizli anahtar ve sabit zamanlı (hash_equals) HMAC-SHA256 karşılaştırmasıyla doğrulanmalıdır:
<?php
declare(strict_types=1);
$expected = hash_hmac('sha256', $rawPayload . $osbUsername, $osbSecretKey);
if (!hash_equals(strtolower($expected), strtolower($receivedHash))) {
http_response_code(403);
exit('invalid_signature');
}
3. Sipariş Durum Makinesi ve Yeniden Deneme (Retry) Matrisi
ERP entegrasyonlarında geçici ağ kesintileri (502/504/timeout) normal kabul edilmeli ve sistem buna göre tasarlanmalıdır:
| Durum | Sistem Davranışı | Kurtarma Stratejisi |
|---|---|---|
| HTTP 2xx | Kayıt synced işaretlenir, ERP belge numarası kaydedilir |
Gerekmez |
| HTTP 429 / 5xx / Timeout | Geçici hata sayılır, üstel geri çekilme (1m → 5m → 15m) uygulanır | Aynı Idempotency-Key ile otomatik tekrar |
| HTTP 400 / Şema Hatası | Kalıcı hata olarak Dead-Letter Queue’ya alınır | Yönetici uyarısı + veri düzeltme sonrası tek tık tekrar |
4. Gece Mutabakatı (Reconciliation Job)
Gerçek zamanlı webhook’lar %99,9 güvenilir olsa bile, günde bir kez çalışan hafif bir mutabakat görevi son 24 saatin sipariş ve stok özetlerini ERP ile karşılaştırarak olası tekil sapmaları sıfıra indirir.