Hızlı Arama

ShopPHP’de her pazaryeri ayrı bir entegrasyon modülü olarak çalışır. Kurulum; modülün yüklü olması, ilgili ayar panelinde API bilgilerinin girilmesi, ürün/kategori hazırlığı ve sunucuda cron (zamanlanmış görev) tanımlanması adımlarından oluşur.

1. Ön koşullar

2. Genel kurulum akışı (tüm pazaryerleri)

1. API bilgilerini alın
   Her pazaryerinin satıcı panelinde “Entegrasyon / API” bölümünden anahtarları alın ve ShopPHP’deki ilgili ayar sayfasına girin.
2. Ayar panelini açın ve kaydedin
   Kimlik bilgileri kaydedildikten sonra sayfa üstünde Ürün Servisini Test Et ve Sipariş Servisini Test Et butonları görünür (API bilgileri doluysa).
3. Ürünleri hazırlayın
   Çoğu pazaryerinde her ürün/varyasyonda barkod (GTIN/EAN), fiyat, stok ve en az bir görsel gerekir. Ürün düzenleme ekranında XML / API sekmesinden pazaryeri ayarlarını yapın.
4. Kategorileri eşleyin
   Kategori düzenlemede ilgili pazaryerinin kategori kodu alanını doldurun. OpenAI API anahtarı tanımlıysa bazı panellerde AI ile Kategorileri Eşleştir seçeneği vardır.
5. Cron (otomatik görev) kurun
   Ürün/stok güncelleme ve sipariş çekimi için hosting panelinizden (cPanel, Plesk, DirectAdmin, CyberPanel vb.) aşağıdaki adresleri 5–15 dakikada bir çağırın. Önerilen sıklık: 5 dakikada bir.
   • Ürün ve stok: https://SITENIZ.com/cron/cron-[pazar].php
   • Sipariş çekme: https://SITENIZ.com/cron/cron-[pazar].php?siparis=true
   • Müşteri soruları (isteğe bağlı): https://SITENIZ.com/cron/cron-pazar-mesaj.php
   Cron kurulum rehberi: Cron adresini sunucuma nasıl eklerim?
   Panelinizde cron yoksa harici servis: cron-job.org
6. IPN / webhook (isteğe bağlı)
   Pazaryeri panelinde webhook/bildirim URL alanı varsa https://SITENIZ.com/ipn-pazar.php?pazar=[kod] adresini yapıştırın. Sipariş cron’unu kurduysanız bu adımı atlayabilirsiniz.

3. Ayar paneli adresleri

Müşteri soruları (Trendyol, N11, Hepsiburada, ÇiçekSepeti, Pazarama, ePttAVM): s.php?f=pazarMesajlari.php

4. Pazaryerine göre kurulum

Trendyol

1. partner.trendyol.com → Hesap Bilgilerim → Entegrasyon Bilgileri: Tedarikçi ID, API Key, API Secret
2. User-Agent: örn. 123456 - SelfIntegration (Trendyol API zorunlu tutar)
3. Her üründe XML ürün kodu (model no), barkod (varyasyonlar dahil) ve piyasa fiyatı olmalı
4. Kargo firması Trendyol sözleşmenizle uyumlu seçilmeli
5. Panelden güncellenen sipariş durumları Trendyol’a iletilir

N11

1. N11 Satıcı Paneli → Hesabım → API Hesapları: App Key ve App Secret
2. N11 panelinde Bilgilerim → Teslimat Bilgileri bölümünde teslimat şablonları oluşturun; ShopPHP’deki üç şablon alanına adları birebir yazın (teslimat şablonu rehberi)
3. Katalog kodu olmayan tüm ürün ve varyasyonlarda barkod tanımlı olmalı

Hepsiburada

1. Hepsiburada Satıcı Paneli → Merchant ID ve Servis Anahtarı
2. Her ürün/varyasyonda ayrı barkod (GTIN); ilk katalog girişinden sonra hbSKU değeri üründeki HB Barkod / barkodNo_HB alanına yazılır
3. Rutin senkron için Ürün güncelleme alanında Sadece fiyat ve stok seçin; Tüm bilgileri güncelle katalog talebi açar
4. HB Soru Senkronu, API doğrulanana kadar kapalı bırakılmalı

ÇiçekSepeti

1. Tedarikçi panelinden API Key
2. User-Agent: örn. SatıcıId veya SatıcıId-EntegratörAdı
3. Panelden kargoya verildi / teslim gibi durumlar ÇiçekSepeti’ne bildirilir

Pazarama

1. İş Ortağım / Pazarama: clientId, clientSecret, Satıcı GUID (Tedarikçi ID)
2. Her üründe barkod ve liste/satış fiyatı olmalı

ePttAVM

1. PTT satıcı paneli → Hesap Ayarları → Entegrasyon Bilgileri → Pazaryeri Entegratör → listeden ShopPHP seçin
2. PTT’nin ürettiği token, kullanıcı adı ve şifreyi ShopPHP ePttAVM ayarlarına yapıştırın — API Key siz doldurmazsınız
3. Kategori düzenlemede PTTAvm Kodu alanına PTT’deki en alt kategori numarasını yazın
4. Kargo barkodu shipment.pttavm.com üzerinden oluşturulur; ShopPHP’den basılmaz
5. PTT Soru Senkronu kapalı bırakılmalı (resmi ayrı soru servisi dokümante değil)

Amazon SP-API

1. Profesyonel satıcı hesabı ve ShopPHP Amazon modülü gerekli
2. Zorunlu alanlar: Satıcı ID, LWA Client ID, LWA Client Secret, LWA Refresh Token, Bölge (Türkiye: Avrupa / eu)
3. Her üründe barkod veya Amazon Barkod, görsel, fiyat, stok; kategoride Amazon Kodu (product type)
4. Gönderim sonuçları: s.php?f=amzRaporlari.php

Temu

1. partner.temu.com: App Key, App Secret, Access Token
2. Avrupa varsayılan gateway: openapi-b-eu.temu.com; ABD için gateway URL alanına ABD adresi yazılır
3. Her üründe barkod, marka, Temu kategori kodu ve görsel gerekli

5. Ürün hazırlığı (ortak kurallar)

• Barkod / GTIN: Pazaryeri entegrasyonunda boş bırakılmaması önerilir; özellikle N11, Hepsiburada, Trendyol, Pazarama, Amazon, Temu, ePttAVM için zorunludur
• Ürün kodu: XML servisi veya pazaryeri API kullanımında manuel ürünlere ürün kodu eklenmesi önerilir
• Pazaryeri sekmesi: Ürün düzenleme → XML / API sekmesinden pazaryeri stok koruması, gönderim ayarları ve log kayıtları yönetilir
• Bir ürünü pazaryerine göndermemek için ilgili pazaryeri sekmesinde -1 girilebilir veya pazaryeri dışı bırakılabilir

6. Kurulum sonrası kontrol

7. Sık karşılaşılan durumlar