SSS

Sık sorulan sorular. Spesifik bir konu yoksa: [email protected]

Genel

API base URL nedir?https://api.entegrasyoner.com/v1/... — tüm istekler bu prefix ile, JSON gövdesiyle gider.

Authentication nasıl çalışır? Portal'a (app.entegrasyoner.com) tarayıcıyla bir kere giriş yap → API Bağlantıları → Yeni Bağlantı → "Web Servis (API)" → bağlantı adı (örn. "Mikro ERP") gir → açılan modal'da gösterilen entgr_xxxxx anahtarını tek seferlik kopyala → ERP config'ine yapıştır. Sonraki tüm isteklerde Authorization: Bearer entgr_xxxxx header'ı ile çağır. Detay: Authentication.

Anahtarın süresi ne kadar? Süresiz — portal'dan "Anahtarı Yenile" veya "Bağlantıyı Sil" deyene kadar geçerli. Süre yenilemek gerekmez. Sızıntı şüphesinde tek tık ile yenilersin (eski anahtar derhal 401 alır). İstersen portalde opsiyonel bir bitiş tarihi de verebilirsin.

Anahtarımı kaybedersem? Plain text anahtar veritabanında sadece SHA-256 hash olarak tutulur — biz bile geri çıkartamayız. Portal'da ilgili bağlantı → "Anahtarı Yenile" ile yeni anahtar üret, eski derhal devre dışı kalır.

Test ortamı (sandbox) var mı? Şu an yok. Geliştirme sırasında küçük adet ürünle production tenant'ında çalışman önerilir; pazaryerine publish tetiklemeden master katalogda her şeyi test edebilirsin.

Rate limit var mı? Şu an açık değil. İleride tenant başına 60 req/min planlanıyor — devreye girince burada duyurulur.

Versiyonlama nasıl? URL'de v1. Geriye uyumsuz değişiklikler için v2 açılır, eski sürüm en az 6 ay yaşar.

Yanıt formatı nedir? Tüm yanıtlar JSON. Hata formatı standarttır: { "message": "...", "errors": { ... } }. Detay: Hata Formatı.

Tarih/saat hangi timezone'da? Tüm timestamp'ler UTC, ISO 8601 (2026-05-27T10:00:00Z).

Ürün & Katalog

Marka veya kategori yoksa otomatik oluşturur musunuz? Evet. brand_name veya category_paths gönderirsen sistem yoksa oluşturur, varsa eşler. Detay: products.

Aynı SKU iki kere gönderilirse ne olur? İkinci istek update semantiği ile çalışır — sku + tenant_id unique key. Idempotent davranış için PUT /v1/products/{id} tercih et.

Fiyatı KDV dahil mi hariç mi göndereyim? İkisi de olur: price (KDV hariç) veya price_with_vat (KDV dahil). Sistem tax_rate ile aralarında dönüşüm yapar.

Stok birden fazla mağaza için nasıl gönderilir?quantity default depo, attribute_bag içinde mağaza kodu → adet eşlemesi. Detay: Pazaryerleri → Çoklu mağaza.

Pazaryeri Entegrasyonu

Pazaryeri API'sini direkt çağırabilir miyim? Hayır. Master endpoint'lerimizi kullan — biz arkada hallederiz. Bu sayede pazaryerinin throttle, format ve sürüm değişikliklerinden etkilenmezsin.

Credential'larım sizde mi tutuluyor? Evet, şifrelenmiş olarak. Sadece outbound job çalışırken decrypt edilir; hiçbir endpoint credential'ı listelemez veya geri döndürmez.

Bir mağaza nasıl eklenir? Portal → Pazaryerleri → Yeni Bağlantı. API'dan mağaza yaratamazsın — credential girişi UI flow'una bağlı.

Aynı ürün birden fazla pazaryerine farklı fiyatla gönderilebilir mi? Evet, her pazaryeri bağlantısının markup yüzdesi ayrı. Detay: Pazaryerine özel fiyat.

Pazaryerinin ürünüm için döndürdüğü hatayı nasıl görürüm? Portal → Ürün detay → Pazaryeri sekmesinde son yayın durumu ve hata mesajı görünür. Hata kategorisi (validation/stok/fiyat) ve retry sayısı eşleme kaydındadır.

Webhook'u kendi sistemime nasıl alırım? Şu an webhook bize gelir; biz tenant event akışına yazarız. Senin sistemine webhook forward edilmesi için: [email protected].

Yeni bir pazaryeri ekleyebilir misiniz? Talep için: [email protected]. Geliştirme süresi pazaryerinin API olgunluğuna bağlı (genelde 2–6 hafta).

Toplu İşlemler

Excel/CSV ile toplu içe aktarma yapabilir miyim? Evet. POST /v1/bulk-operations/import ile dosya yüklersin, iş kuyruğa girer (202). Detay: Bulk Operations.

Bir batch'te kaç ürün gönderebilirim? Tek dosyada 10.000 satıra kadar test edildi. Daha büyük datasetler için dosyayı böl.

İçe aktarma hatasını nereden görürüm? Bulk job sonuç response'unda satır-bazlı hata listesi döner; başarısız satırları düzeltip tekrar gönderebilirsin.