Ne işe yarar?
Trendyol, Hepsiburada, Amazon, N11 ve diğer pazaryeri veya e-ticaret kanallarının satıcı hesabını FastEntegre’ye bağlamak. Bağlantı sonrası sipariş, stok ve (ayarlarınıza göre) fatura akışı bu mağaza kaydı üzerinden yürür.
Neden önemli?
Entegrasyon olmadan panelde o kanala ait sipariş görünmez; etiket, stok düşümü ve otomatik fatura tetiklenmez.
Detaylı açıklama
Mağaza bağlantısı yalnızca kimlik bilgisi girişi değildir: sipariş çekim aralığı, otomatik fatura/stok seçenekleri ve kargo eşlemesi birlikte yapılandırılmalıdır.
Her pazaryeri farklı kimlik ister: Trendyol’da API Key/Secret + Supplier ID, Hepsiburada’da Merchant ID, N11’de App Key/Secret, Amazon/Etsy’de OAuth, WooCommerce’de site URL + REST anahtarı. Platform satıcı panelindeki değeri birebir kopyalayın; satır sonu boşluğu ve test/canlı karışımı en sık 401 nedenidir. Bağlantı testi yeşil olmadan sipariş çekmeyin.
Ön koşul
- Panelde en az bir ana mağaza olmalı. Yoksa önce Ana mağaza oluşturma adımlarını tamamlayın.
- Pazaryeri satıcı panelinde API erişimi veya uygulama yetkisi açık olmalı (platforma göre API anahtarı, satıcı ID, OAuth uygulaması vb.).
Adımlar (Menü > Entegrasyon)
- Sol menüden Entegrasyon sayfasına gidin (
/integration/dashboard). Bu ekran pazaryeri ve diğer entegrasyon kartlarını listeler; ayarlar menüsünün altında değildir. - Bağlamak istediğiniz platform kartına tıklayın. Sizi
mainStore/addStore?platformId=…formuna yönlendirir. - Formda Ana mağaza seçin (URL’de
mainStoreIdvarsa alan önceden dolu gelir). - Mağaza adı girin (panelde görünecek tanınır isim; çoğu pazaryerinde zorunlu).
- Platforma özel alanları doldurun (ör. API key / secret, satıcı ID, mağaza URL’si). Alan adları entegrasyona göre değişir; değerleri ilgili satıcı panelinden kopyalayın.
- Ekle ile kaydedin.
- API ile bağlanan pazaryerlerinde kayıt genelde doğrudan tamamlanır; hata varsa ekranda uyarı görünür.
- OAuth ile bağlanan kanallarda (ör. Shopify, WooCommerce, İdeasoft, İkas, Joom, Faire, eBay) Ekle veya …’e Bağlan sonrası platformun yetkilendirme sayfası açılır; izin verip panele dönün. Sekmeyi kapatmadan akışı bitirin.
- Menü > Mağazalar (
/store) listesinde yeni mağazayı kontrol edin. - İlk siparişler için Sipariş senkronizasyonu makalesindeki adımları uygulayın (geçmiş çekim, test siparişi, log kontrolü).
Bağlantı doğrulama
- Mağaza detayında Bağlantıyı test et ile API yanıtını doğrulayın.
- Test başarılıysa tek sipariş çekimini manuel tetikleyin.
- Mağaza logunda 401/403 yoksa token geçerlidir.
- İlk 24 saatte sipariş, stok ve (varsa) fatura akışını ayrı ayrı kontrol edin.
Mevcut bağlantıyı güncelleme
API anahtarı yenilendi veya form hatalı kaydedildiyse mağaza satırındaki Entegrasyon Güncelle ile aynı forma dönebilirsiniz. Ayrıntı: Entegrasyonu yeniden bağlama.
Kontrol listesi
- API anahtarı platform panelinde aktif.
- Bağlantı testi yeşil.
- Sipariş senkron aralığı tanımlı.
- Kargo ve fatura entegrasyonları (gerekiyorsa) ayrıca bağlandı.
Sık karşılaşılan hatalar
| Durum | Ne yapmalı? |
|--------|-------------|
| Ana mağaza bulunamadı uyarısı | Önce ana mağaza oluşturun; yetkiniz yoksa yöneticiyle görüşün. |
| Platform seçilmedi | Entegrasyon kartından tekrar girin; doğrudan addStore URL’sine platformId olmadan gitmeyin. |
| Kayıt sonrası sipariş gelmiyor | Mağaza logunu kontrol edin; 401/403 için anahtar ve izinleri platformda yenileyip Entegrasyon Güncelle ile kaydedin. |
| OAuth ekranı açılmıyor veya yarım kalıyor | Pop-up engelleyiciyi kapatın; aynı tarayıcıda yetkilendirmeyi sonuna kadar tamamlayın. |
| Test / canlı karışıklığı | Platformun test ve canlı API ortamlarının anahtarlarını karıştırmayın; Test ve canlı ortam notlarına bakın. |
API hata kodları için: Entegrasyon hata kodları.
Sık sorulan sorular
Aynı pazaryerinden iki mağaza ekleyebilir miyim?
Evet, ayrı satıcı hesaplarıysa ayrı kayıt açın. Aynı Supplier/Merchant ID’yi iki kez yapıştırmayın.
OAuth penceresi açılmıyor
Pop-up engeli ve üçüncü taraf çerez. Amazon/Etsy için tarayıcıda izin verin.
İlgili rehberler
Hâlâ çözülmedi?
- Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, platform adı, ekran görüntüsü ve tam hata metnini ekleyin.
- WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
- Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.