Pazaryerleri ve Hedefler

Entegrasyoner bir master katalog / dağıtım merkezidir: ürün, stok ve fiyat verisini tek noktada (bizde) tutarsın, biz desteklenen kanallara dağıtırız. Pazaryeri API'larını doğrudan çağırmazsın — tüm trafik bizim üzerimizden gider.

Bağlandığımız kanallar üç tiptir:

• Pazaryerleri — Trendyol, TrendyolGo. Ürün/stok/fiyat yayını + sipariş çekimi. Bizim adapter'lerimizle push edilir.
• E-ticaret siteleri — OpenCart. Çift yönlü: müşterinin sitesi kaynak (ürünleri bize push eder) ya da hedef (biz siteye yazarız) olabilir.
• ERP / muhasebe / kendi yazılımın — bu REST API ile bağlanır: ürünü POST /products ile bize gönderir, siparişleri GET /orders ile çeker. Yani ürün kaynağın veya sipariş tüketicin bu API üzerinden entegre olur.

Genel akış

1. Ürünü Entegrasyoner'a yaz (POST /v1/products, portal veya OpenCart kaynak senkronu).
2. Portal'dan hedef bağlantısını ekle (pazaryeri/e-ticaret credential + ayarlar).
3. Yayın bizde otomatik tetiklenir: Yayın Kuralları (PublishRule) koşulları sağlanınca ürün ilgili kanala gönderilir. Manuel "Şimdi Yayınla" tetiği yalnızca portaldedir — public API'de /products/{id}/publish ucu yoktur.
4. Biz kanala adapter üzerinden push ederiz; sonuç eşleme tablosunda görünür, hata varsa retry/cooldown otomatik.

Desteklenen kanallar

Kanal	Tip	Ürün/stok/fiyat	Sipariş
Trendyol	Pazaryeri	✅	✅
TrendyolGo	Pazaryeri	✅ (async batch)	✅ (polling)
OpenCart	E-ticaret	✅ (çift yönlü — kaynak veya hedef)	✅ (kaynak)
ERP / muhasebe / özel yazılım	REST API	✅ (POST /products)	✅ (GET /orders)

Yeni kanal (pazaryeri / e-ticaret altyapısı / ERP) ihtiyacı için: [email protected]

Çoklu mağaza

Bir tenant'ın birden fazla mağazası olabilir (TrendyolGo'da farklı şehirler, birden fazla OpenCart kurulumu vs.). Master katalog tek ürün tutar; stok mağaza başına ayrı (StockLocation).

API'da attribute_bag ile mağaza-kodu → stok eşleştirilir:

{
  "name": "Example Product",
  "quantity": 50,
  "attribute_bag": {
    "TR-IST-01": 20,
    "TR-ANK-01": 30
  }
}

quantity genel (varsayılan lokasyon) stoğudur; attribute_bag'deki key'ler StockLocation.code ile eşleşir. Aktif mağaza kodlarını sorgulamak için: GET /v1/stock-locations (bkz. products.md).

Hangi ürünün hangi mağazaya gideceği yayın kuralları ile yönetilir — portal'da tanımlanır, API'dan ham mağaza eşlemesi yapmazsın.

Pazaryerine özel fiyat (markup)

Her pazaryeri bağlantısı için fiyat markup yüzdesi tanımlanabilir. Sistem yayın anında master fiyatın üzerine uygular:

Master price_with_vat	Pazaryeri markup	Pazaryerine giden fiyat
100	+0%	100
100	+15%	115
100	+25%	125

Markup, o pazaryerindeki tüm ürünlere uygulanan bağlantı varsayılanıdır (portal ayarı). Marka/kategori kuralları ve ürün-özel override bunu ezer.

Ürün-özel fiyat: Tek bir ürünü o pazaryerine farklı fiyat/stokla göndermek istersen — mutlak (örn. 130 TL) veya kendi %'si — bunu üründe tanımlarsın:

• API: POST /products → channel_overrides (hedef credential_id ile; bkz. products → channel_overrides).
• Portal: Ürün formu → "Pazaryeri Fiyatları" paneli.

Öncelik: ürün override → marka/kategori kuralı → bağlantı markup'ı.

Kanalları keşfet — GET /v1/channels

channel_overrides'ta hedeflemek için pazaryeri bağlantılarının credential_id'sine ihtiyacın var. Bu uç, tenant'ının aktif yayın hedefi bağlantılarını listeler:

GET /v1/channels
Authorization: Bearer <API_KEY>

Response — 200 OK:

{
  "data": [
    {"credential_id": 5, "platform": "trendyol-go", "platform_label": "Trendyol Go", "label": "Mağazam TGo"},
    {"credential_id": 7, "platform": "trendyol", "platform_label": "Trendyol", "label": "Mağazam Trendyol"}
  ]
}

Dönen credential_id'yi doğrudan POST/PUT /products payload'ındaki channel_overrides[].credential_id alanında kullan. (Kaynak bağlantılar — örn. OpenCart — burada listelenmez; yalnız yayın hedefleri.)

Webhook'lar

Pazaryeri tarafından gönderilen webhook'lar (sipariş, iade, ürün durum güncellemesi) bize ulaşır; biz tenant'ın sentetik event akışına yazarız. Sen pazaryerinin webhook URL alanına bizim verdiğimiz URL'i kaydedersin:

https://entegrasyoner.com/api/entegre/webhook/{platform}/{token}

URL'in tamamı ve pazaryerinin istediği auth bilgileri (API key, secret, HMAC vs.) portal → Pazaryeri Bağlantısı → Webhook sekmesinde otomatik üretilir. Kopyala, pazaryeri panelinde ilgili alana yapıştır.

Token bir pazaryeri bağlantısına bağlıdır (tek bağlantı = tek token). Token sızdığını düşünürsen portal'dan yenileyebilirsin — eski token devre dışı kalır.

Sık sorulan sorular için: SSS.