Teknosa, Mirakl pazaryeri altyapısını kullanır. Pazarus bağlantısıyla siparişleriniz otomatik çekilip onaylanır, stok ve fiyat değişiklikleri mağazanıza iletilir, barkodu Teknosa kataloğunda bulunan ürünler satışa açılır; iade, fatura ve müşteri mesajları da panelden yönetilir. Kurulum için tek bir API anahtarı yeterlidir.
Ön koşullar
- Aktif bir Teknosa satıcı hesabınız olmalı.
- Teknosa Mirakl satıcı panelinde sağ üstteki profil menüsünden Profil → API anahtarı bölümüne gidin ve Yeni bir anahtar oluştur ile anahtarı kopyalayın.
Adım adım
- Entegrasyonlar → Pazaryeri Ayarları sayfasını açın ve Teknosa kartındaki Entegrasyonu Kur butonuna tıklayın.
- Teknosa Bağlantı Ayarları bölümünde Ortam alanını Canlı (Production) bırakın. Test (Development) ortamı için Teknosa'dan özel erişim talep edilmesi gerekir. Panel adresi Pazarus'ta tanımlıdır; ayrıca adres girmeniz istenmez.
- API Anahtarı alanına Mirakl panelinden kopyaladığınız anahtarı yapıştırın.
- Aktif açık kalsın. Senkronizasyon Modu ilk kurulumda Senkronize Etme olsun; ürünler bağlandıktan sonra Fiyat + Stok, Sadece Fiyat veya Sadece Stok seçeneğine geçin.
- Kaydet butonuna basın, ardından Bağlantıyı Test Et ile "Teknosa Mirakl API ile başarıyla bağlantı kuruldu." bildirimini alın.
- Üstteki Kategorileri Senkronize Et butonuna tıklayın. İşlem bittiğinde "Kategori Senkronu Tamamlandı" bildirimi kaç kategorinin ve nitelik şemasının güncellendiğini gösterir. Mirakl kategori ve nitelik listelerini saatte bir yenilemeye izin verir; butona art arda basmayın.
- Sipariş Senkronizasyonu bölümünde Siparişleri Otomatik Çek anahtarını açın; siparişler otomatik çekilir (varsayılan 5 dakikada bir; planınıza göre değişebilir) ve otomatik onaylanır. Kargoya verdiğinizde kargo ve teslim bilgisi Teknosa'ya bildirilir.
- Müşteri Mesajları bölümündeki Müşteri Sorularını Otomatik Çek anahtarını açarsanız cevaplanmamış müşteri mesajları otomatik panele düşer (varsayılan 10 dakikada bir).
- Kaydet ile ayarları saklayın. Ürün göndermek için ürünlerinizin barkodunun Teknosa kataloğunda kayıtlı olması gerekir; katalogda bulunan barkodlar için teklif açılır ve stok, fiyat gönderilir.
Sık karşılaşılan sorunlar
- Belirti: Bağlantı testi "HTTP 401" ile başarısız. Çözüm: API anahtarını Mirakl panelinden yeniden kopyalayın; anahtar başına "Bearer" gibi bir ek yazmayın, yalnızca anahtarın kendisini girin.
- Belirti: Ürün gönderiminde "Mirakl kataloğunda bu barkodla ürün yok — teklif açılamaz" uyarısı. Çözüm: Teknosa'da teklif yalnızca katalogdaki ürüne açılır. Ürünün barkodunun (EAN/GTIN) doğru ve Teknosa kataloğunda kayıtlı olduğundan emin olun; katalogda olmayan ürünler için yeni ürün oluşturma henüz desteklenmez.
- Belirti: Stok veya fiyat değişikliği mağazada hemen görünmüyor. Çözüm: Mirakl stok ve fiyat güncellemelerini dosya olarak işler; yansıması yaklaşık bir dakika sürer.
- Belirti: "Önce Bağlantı Ayarlarını Kaydedin" uyarısı çıkıyor. Çözüm: Kategori senkronu kayıtlı API anahtarı ister; önce Kaydet'e basın.
İpuçları
- İade talepleri panele düşer; onayladığınızda para iadesi Teknosa üzerinden yapılır, reddettiğinizde gerekçe iletilir.
- E-fatura kesildiğinde fatura bağlantısı Teknosa'ya iletilir; bağlantı kabul edilmezse fatura PDF olarak yüklenir. Teknosa'nın kestiği komisyon faturaları ön muhasebeye gider olarak kaydedilir.
- Diğer → Teknosa Bağlantılarını Sil yalnızca eşleştirmeleri kaldırır; ürünleriniz korunur.
