E-Ticaret & PrestaShop 18 Ağustos 2026 · 8 dk okuma

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ı.

PrestaShop Projelerinde Sipariş, Webhook ve ERP Stok Entegrasyonunun İncelikleri

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.

← Tüm Yazılara Dön Bu Konuda İletişime Geç ↗

İlgili Yazılar