Başlamadan önce
Bağlantının kurulabilmesi için ToptanTR tarafından mağazanıza tanımlanan iki bilgiye ihtiyaç duyulur:
- API kullanıcı adı
- API parolası
Bu bilgilere ToptanTR satıcı panelinizden ulaşabilirsiniz.
Bağlantının kurulması
Bağlantı adını ve mağaza bilgilerini girin
Bağlantı adı alanına bu mağazayı tanımlayan bir ad yazın (örneğin “ToptanTR – Ana mağaza”). Birden fazla ToptanTR mağazanız bulunuyorsa bu ad, mağazaları birbirinden ayırt etmenizi sağlar. Ardından ToptanTR tarafından verilen API kullanıcı adı ve API parolası bilgilerini ilgili alanlara giriniz.
- Bilgileri kopyalarken başında veya sonunda boşluk bulunmadığından emin olunuz.

Stok deposunu ve fatura bağlantısını belirleyin
Hesabınızda birden fazla şube veya bağlı bir muhasebe programı bulunuyorsa formda “Bu mağaza hangi depodan satar, faturası nereden kesilir” bölümü görüntülenir.
- Stok deposu: Bu mağazanın satışa sunacağı stoğun hangi şubelerden alınacağını belirler. Tek şube kullanıyorsanız herhangi bir değişiklik yapmanız gerekmez.
- Fatura bağlantısı: Bu mağazaya ait siparişlerin hangi Paraşüt hesabı üzerinden faturalandırılacağını belirler.

Ürün gönderim varsayılanlarını belirleyin
Bu bölümde yapılan seçimler, ToptanTR’ye gönderilen ürünlerde ayrıca belirtilmediği sürece varsayılan olarak uygulanır.
- Varsayılan termin süresi: Siparişin kaç gün içinde kargoya teslim edileceğini belirtir. 0 değeri aynı gün kargoya teslim anlamına gelir.
- Kargo modeli: Pazaryerinin anlaşmalı kargosunu kullanıyorsanız “Platform anlaşmalı kargo” seçeneğini, kendi kargo anlaşmanızla gönderim yapıyorsanız “Kendi kargom (Mağaza Hesabı)” seçeneğini seçiniz. Kendi kargonuzla yapılan gönderimlerde takip numarası ve teslim bilgisi ToptanTR’ye SUPSEM tarafından iletilir.

Bağlantıyı kaydedin
Formun alt bölümündeki Bağlantıyı ekle düğmesine tıklayın. Bağlantınız sayfada bir kart olarak listelenir. Oluşturulan ilk bağlantı otomatik olarak Varsayılan bağlantı olarak işaretlenir.
Otomatik işlemler
Senkron ayarlarındaki her anahtar, SUPSEM tarafından düzenli aralıklarla yürütülen bir işlemi etkinleştirir veya devre dışı bırakır. Bu ayarlar, bağlantı kartındaki menüden Düzenle seçeneği kullanılarak dilediğiniz zaman değiştirilebilir.
- Siparişleri çek (varsayılan: açık): Yeni ve güncellenen siparişler 5 dakikada bir panele aktarılır. Alıcı adına müşteri kartı otomatik olarak oluşturulur.
- Sipariş durumunu platforma bildir (varsayılan: açık): Siparişi onayladığınızda veya iptal ettiğinizde bu bilgi ToptanTR’ye iletilir. Bu işlemler için ToptanTR paneline ayrıca giriş yapmanız gerekmez.
- Fatura bağlantısını gönder (varsayılan: açık): Fatura resmileştiğinde fatura bağlantısı ToptanTR’deki siparişe eklenir.
- Platformdaki ilan değişikliklerini izle (varsayılan: kapalı): Etkinleştirildiğinde ToptanTR panelinde yapılan fiyat değişiklikleri ile ilanın satışa kapatılması gibi durumlar SUPSEM’e de yansıtılır.
- Fiyat ve stoğu otomatik gönder (varsayılan: kapalı): Etkinleştirildiğinde fiyatı veya stoğu değişen ürünler 10 dakikada bir ToptanTR’ye gönderilir.
Geçmiş siparişlerin aktarılması
SUPSEM, bağlantının kurulduğu andan itibaren oluşan siparişleri otomatik olarak aktarır. Bağlantı öncesine ait siparişlerin de panelde ve raporlarda yer alması için aşağıdaki adımları izleyiniz:
Geçmiş sipariş aktarımını başlatın
Bağlantı kartındaki Geçmiş siparişleri çek düğmesine tıklayın.
Sonraki adım
Mağaza bağlantısı tamamlandıktan sonra, ürünlerinizi ToptanTR’ye gönderebilmeniz için kategori ve marka tanımlarınızın ToptanTR’deki karşılıklarıyla eşleştirilmesi gerekir. Bağlantı kartındaki Eşleştirmeler bağlantısı sizi doğrudan ilgili ekrana yönlendirir. Eşleştirme işlemi bir kez yapılır; ikinci bir ToptanTR mağazası bağlandığında tekrarlanması gerekmez.
Sık karşılaşılan durumlar
Bağlantı testi başarısız oldu.
Bu durum genellikle bilgilerden birinin eksik veya hatalı kopyalanmasından kaynaklanır. Bağlantı kartındaki menüden Düzenle seçeneğini kullanarak bilgileri ToptanTR panelinden yeniden kopyalayınız ve ilgili mağazaya ait olduklarını kontrol ediniz.
ToptanTR’de API bilgilerimi yeniledim.
Yenilenen bilgilerle birlikte önceki bilgiler geçerliliğini yitirir. Bağlantı kartındaki menüden Düzenle seçeneğini kullanarak yeni bilgileri giriniz. Değiştirmediğiniz gizli alanları boş bırakabilirsiniz; bu alanlardaki mevcut değerler korunur.
Birden fazla ToptanTR mağazam var.
Her mağaza için ayrı bir bağlantı oluşturunuz. Varsayılan olarak kullanılacak bağlantıyı, ilgili kartın menüsündeki Varsayılan yap seçeneğiyle belirleyebilirsiniz.
“Yeni ToptanTR bağlantısı” düğmesi görüntülenmiyor.
Kullanıcı hesabınızda bağlantı ekleme yetkisi tanımlı değildir. Firmanızın panel yöneticisinden entegrasyon yönetimi yetkisi talep ediniz.
Bağlantıyı geçici olarak durdurmak istiyorum.
Bağlantı kartındaki menüden Düzenle seçeneğini kullanarak Aktif ayarını kapatınız. Bağlantı silinmez; yeniden etkinleştirildiğinde kaldığı yerden devam eder.
Bu rehberde yanıtını bulamadığınız sorular için panel üzerinden destek talebi oluşturabilir veya iletişim sayfamız aracılığıyla bize ulaşabilirsiniz.





