Qando

T-Soft Entegrasyonu

T-Soft v3 Admin API ile Qando'yu bağlama — Web Servis Kullanıcısı oluşturma ve kurulum.

T-Soft v3 Admin API

Qando, T-Soft'un v3 Admin REST API'sini kullanır (resmi: developer.tsoft.com.tr). Auth akışı e-posta + parola ile Bearer token alımıdır. Admin paneli giriş bilgileriniz değil — API için ayrı bir Web Servis Kullanıcısı oluşturulur.

Hangi bilgilere ihtiyacınız var?

  • Mağaza Domain — T-Soft mağazanızın domain adı, protokolsüz (örn. my-store.com)
  • Web Servis Kullanıcı E-postası
  • Web Servis Kullanıcı Parolası

Web Servis Kullanıcısı oluşturma

  1. T-Soft yönetim panelinize Admin olarak girin.
  2. Sol menü Ayarlar > Kullanıcı Yönetimi > Web Servis Kullanıcıları.
  3. Yeni Web Servis Kullanıcısı butonuna basın.
  4. Formu doldur:
    • E-posta (örn. webservice@magaza.com — gerçek bir adres olması zorunlu değil, tekil bir identifier)
    • Parola — güçlü, en az 12 karakter
  5. Yetki metodları (CHECK MARK seçimi):
    • ✅ Ürünler — Okuma + Yazma
    • ✅ Stok — Okuma + Yazma
    • ✅ Siparişler — Okuma + Güncelleme
    • ✅ Müşteriler — Okuma
    • ✅ İadeler — Okuma + Güncelleme
    • ✅ Kategori — Okuma
  6. Aktif toggle'ını açın.
  7. Kaydet.

Birden fazla web servis kullanıcısı oluşturabilirsiniz; her entegrasyon için ayrı bir kullanıcı önerilir.

Qando'da bağlantı oluşturma

  1. Entegrasyonlar > Yeni Bağlantı > T-Soft.
  2. Formu doldur:
    • Mağaza Domain — protokolsüz (örn. my-store.com)
    • Web Servis Kullanıcı E-postası
    • Web Servis Kullanıcı Parolası
  3. Test Et → POST /api/v3/admin/auth/login çağrısı yapılır; Bearer token döner.
  4. Başarılı ise ACTIVE olur. Mağaza ID/adı otomatik tespit edilir.
  5. Kaydet.

Auth akışı (teknik)

Qando arka planda otomatik yönetir; sizin bilmenize gerek yok ama bağlam için:

  1. POST https://{magaza-domain}/api/v3/admin/auth/login — body: { email, password }
  2. Yanıttan Bearer token + expiresIn (saniye) alınır
  3. Token cache'lenir (TTL - 60 saniye emniyet)
  4. Sonraki istekler Authorization: Bearer {token} header'ı ile
  5. Süresi dolunca otomatik yeniden token alınır (re-login)

Sync akışları

  • Ürün Sync: 21:00 günlük — GET /api/v3/admin/products
  • Sipariş Sync: 5 dakikada bir — GET /api/v3/admin/orders
  • İade Sync: 10 dakikada bir — GET /api/v3/admin/returns

Yetkilendirme önemli

Web Servis Kullanıcısı oluştururken bir modül için yetki açık değilse Qando o endpoint'e gittiğinde 403 Forbidden alır; ilgili sync kısmen veya tamamen başarısız olur. Yukarıdaki tüm yetkileri açık tutun.

Yaygın sorunlar

  • Test başarısız: 401 Unauthorized → E-posta veya parola yanlış girilmiş; Web Servis Kullanıcısının Aktif olduğundan emin olun
  • Test başarısız: 403 Forbidden → Web Servis Kullanıcısının metod yetkileri yetersiz; T-Soft panelinden açın
  • Test başarısız: 404 Not Found → T-Soft sürümünüz v3'ten eski olabilir (legacy rest1 veya v2). Bu durumda destek talebi açın, eski API için özel kurulum yapacağız
  • Test başarısız: Connection timeout → Mağaza Domain yanlış girilmiş; https:// veya sondaki / koymayın, sadece domain
  • "Web Servis Kullanıcıları" menüsünü göremiyorum → Admin yetkiniz yetersiz olabilir veya T-Soft sürümünüzde menü adı farklı (örn. "Kullanıcılar > Web Servis"); yöneticiye sorun veya destek

Resmi kaynaklar

Sonraki adım