Sistem Dokümantasyonu

E-ticaret Ürün Toplayıcı sistemimizin detaylı dokümantasyonu, kurulum kılavuzları ve API referans belgeleri. Bu dökümanlar, sistemi en verimli şekilde kullanmanıza yardımcı olacaktır.

İçindekiler

Başlangıç

E-ticaret Ürün Toplayıcı, farklı e-ticaret platformlarındaki ürünlerinizi tek bir merkezde toplamanızı, yönetmenizi ve analiz etmenizi sağlayan bir çözümdür. Bu dokümantasyon, sistemin kurulumundan gelişmiş özelliklerine kadar tüm konuları kapsamaktadır.

Ön Koşullar

Başlamadan önce, entegre etmek istediğiniz e-ticaret platformlarında API erişiminizin olduğundan emin olun. API anahtarları ve bağlantı bilgileri gerekecektir.

Panel Genel Görünümü

Şekil 1: E-ticaret Ürün Toplayıcı Panel Genel Görünümü

Kurulum

Sistemimiz tamamen bulut tabanlı olduğu için herhangi bir kurulum gerektirmez. Sadece hesap oluşturmanız ve API bilgilerinizi girmeniz yeterlidir.

Sistem Gereksinimleri

Sistemimizi kullanmak için aşağıdaki gereksinimlere ihtiyacınız vardır:

Gereksinim Detay
Web Tarayıcısı Chrome, Firefox, Safari veya Edge (güncel sürüm)
İnternet Bağlantısı Stabil bir internet bağlantısı
API Erişimi E-ticaret platformunuzun API anahtarları ve erişim bilgileri

Hesap Kurulumu

Hesap kurulumu için aşağıdaki adımları izleyin:

1

Kayıt Olun

Ana sayfadaki "Üye Ol" butonuna tıklayarak kayıt formunu doldurun.

2

E-posta Doğrulama

E-posta adresinize gönderilen doğrulama bağlantısına tıklayarak hesabınızı doğrulayın.

3

Giriş Yapın

Kullanıcı adınız ve şifrenizle sisteme giriş yapın.

4

Paket Seçin

İhtiyaçlarınıza uygun paket seçimi yapın ve ödeme işlemini tamamlayın.

Platform Entegrasyonu

E-ticaret platformlarınızı sisteme entegre etmek için aşağıdaki adımları izleyin.

Ticimax Entegrasyonu

Ticimax platformunuzdan API bilgilerini almak ve sisteme entegre etmek için şu adımları izleyin:

  1. Ticimax yönetici panelinize giriş yapın.
  2. Sol menüden "Ayarlar" > "API" bölümüne gidin.
  3. Yeni bir API anahtarı oluşturun ve yetkilendirin.
  4. Oluşturulan API anahtarını ve mağaza URL'nizi kopyalayın.
  5. E-ticaret Ürün Toplayıcı panelinde "Entegrasyonlar" sayfasından "Yeni Entegrasyon Ekle" butonuna tıklayın.
  6. Platform olarak "Ticimax"i seçin ve kopyaladığınız bilgileri ilgili alanlara yapıştırın.
  7. "Bağlantıyı Test Et" butonuna tıklayarak bağlantıyı kontrol edin.
  8. Bağlantı başarılıysa "Kaydet" butonuna tıklayarak entegrasyonu tamamlayın.
Ticimax API Örnek İstek 
const apiKey = 'YOUR_API_KEY';
const storeUrl = 'https://yourstore.ticimax.com';

fetch(`${storeUrl}/api/products`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Ideasoft Entegrasyonu

Ideasoft platformunuzu entegre etmek için gerekli adımlar:

  1. Ideasoft yönetici panelinize giriş yapın.
  2. "Sistem Ayarları" > "Entegrasyonlar" bölümüne gidin.
  3. "API" sekmesinden yeni bir API kullanıcısı oluşturun.
  4. API anahtarını, müşteri kodunu ve mağaza URL'sini kaydedin.
  5. E-ticaret Ürün Toplayıcı panelinde "Entegrasyonlar" sayfasını açın.
  6. "Yeni Entegrasyon Ekle" butonuna tıklayın ve platform olarak "Ideasoft"u seçin.
  7. İstenilen bilgileri girin ve "Bağlantıyı Test Et" butonuna tıklayın.
  8. Test başarılıysa "Kaydet" butonuyla entegrasyonu tamamlayın.

Tsoft Entegrasyonu

Tsoft platformunuzu entegre etmek için şu adımları takip edin:

  1. Tsoft admin panelinize giriş yapın.
  2. "Sistem" > "Web Servis Ayarları" menüsünü açın.
  3. Yeni bir API kullanıcısı oluşturun ve tam yetki verin.
  4. Oluşturulan kullanıcı adı, şifre ve mağaza URL'sini not alın.
  5. E-ticaret Ürün Toplayıcı sisteminde "Entegrasyonlar" sayfasına gidin.
  6. "Yeni Entegrasyon Ekle" butonuyla Tsoft entegrasyonu ekleyin.
  7. Gerekli bilgileri doldurun ve bağlantıyı test edin.
  8. Başarılı test sonrasında entegrasyonu kaydedin.

Quqasoft Entegrasyonu

Quqasoft platformunuzu entegre etmek için aşağıdaki adımları uygulayın:

  1. Quqasoft yönetim paneline giriş yapın.
  2. "Ayarlar" > "Entegrasyonlar" > "API Ayarları" bölümüne gidin.
  3. Yeni bir API anahtarı oluşturun ve yetkilendirmeleri yapın.
  4. API anahtarı ve mağaza URL'nizi kopyalayın.
  5. E-ticaret Ürün Toplayıcı panelinde "Entegrasyonlar" sayfasını açın.
  6. "Yeni Entegrasyon Ekle" butonuyla Quqasoft seçeneğini seçin.
  7. Gerekli bilgileri girin ve bağlantıyı test edin.
  8. Test başarılıysa "Kaydet" butonuyla işlemi tamamlayın.

Veri Yönetimi

Sistemdeki verilerinizi filtreleme, düzenleme ve yönetme konusunda detaylı bilgiler.

Veri Yönetimi Ekranı

Şekil 2: Veri Yönetimi Arayüzü

Filtreleme İşlemleri

Panel üzerinde ürünlerinizi çeşitli kriterlere göre filtreleyebilirsiniz:

Kategori Filtreleme

Belirli kategorilerdeki ürünleri listelemek için filtreleme yapabilirsiniz.

Fiyat Aralığı

Minimum ve maksimum fiyat aralığı belirleyerek filtreleme yapabilirsiniz.

Stok Durumu

Stokta olan, tükenen veya belirli stok adedine göre filtreleme yapabilirsiniz.

Platform Bazlı

Belirli bir e-ticaret platformundaki ürünleri filtreleyebilirsiniz.

Dışa Aktarım

Sistemdeki verilerinizi çeşitli formatlarda dışa aktarabilirsiniz.

Desteklenen Formatlar

Excel (.xlsx)

Microsoft Excel formatında dışa aktarım yapabilirsiniz.

Örnek Dosya İndir

CSV

Virgülle ayrılmış değerler formatında dışa aktarım yapabilirsiniz.

Örnek Dosya İndir

JSON

JSON formatında dışa aktarım yapabilirsiniz (API entegrasyonu için idealdir).

Örnek Dosya İndir

XML

XML formatında dışa aktarım yapabilirsiniz.

Örnek Dosya İndir

Özel Alan Seçimi

Dışa aktarım yaparken hangi alanların dahil edileceğini özelleştirebilirsiniz. Bunun için "Dışa Aktar" butonuna tıkladıktan sonra açılan penceredeki "Özel Alan Seçimi" seçeneğini kullanabilirsiniz.

API Referansı

E-ticaret Ürün Toplayıcı API'si, ürün verilerinize programatik olarak erişmenizi sağlar.

Not

API erişimi yalnızca Kurumsal paket aboneleri için mevcuttur. API kullanımında, isteğinizin başlık kısmında API anahtarınızı göndermelisiniz.

Kimlik Doğrulama

API isteklerinizde kimlik doğrulama için Bearer token kullanılır. Token'ı header bilgisinde aşağıdaki gibi göndermelisiniz:

API Kimlik Doğrulama Örneği 
Authorization: Bearer YOUR_API_KEY

Endpoints

GET

/api/v1/products

Tüm ürünleri listeler. Sayfalama parametreleri: ?page=1&limit=20

GET

/api/v1/products/{id}

Belirli bir ürünün detaylarını getirir.

POST

/api/v1/products

Yeni bir ürün oluşturur.

PUT

/api/v1/products/{id}

Mevcut bir ürünü günceller.

DELETE

/api/v1/products/{id}

Bir ürünü siler.

Örnek İstek ve Yanıtlar

Ürün Listesi İstek Örneği 
curl -X GET 'https://api.eticaret-toplayici.com/api/v1/products?page=1&limit=20' \
-H 'Authorization: Bearer YOUR_API_KEY'
Ürün Listesi Yanıt Örneği 
{
    "status": "success",
    "data": {
        "products": [
            {
                "id": 1,
                "name": "Akıllı Telefon X Pro",
                "sku": "SP-XP-1234",
                "price": 4299.99,
                "stock": 15,
                "platform": "ticimax",
                "category": "Elektronik",
                "updated_at": "2025-04-15T14:22:31Z"
            },
            ...
        ],
        "pagination": {
            "total": 156,
            "page": 1,
            "limit": 20,
            "pages": 8
        }
    }
}

Sorun Giderme

Sık karşılaşılan sorunlar ve çözümleri.

API bağlantı hatası alıyorsanız, şu adımları kontrol edin:

  • API anahtarınızın doğru olduğundan emin olun.
  • E-ticaret platformunuzun API servislerinin aktif olduğunu kontrol edin.
  • Firewall veya güvenlik duvarı ayarlarınızın API bağlantısına izin verdiğinden emin olun.
  • Mağaza URL'nizin doğru formatta olduğunu kontrol edin (https:// ile başlamalıdır).

Veri çekme işlemi yavaş ise:

  • İnternet bağlantınızın hızını kontrol edin.
  • E-ticaret platformunuzun sunucu yanıt sürelerini kontrol edin.
  • Tek seferde daha az veri çekmeyi deneyin (filtre kullanarak).
  • Yoğun olmayan saatlerde veri çekmeyi deneyin.

Ürün bilgileri eksik veya hatalıysa:

  • E-ticaret platformunuzdaki ürün bilgilerini kontrol edin.
  • API izinlerinin tüm ürün verilerine erişim yetkisine sahip olduğundan emin olun.
  • Veri senkronizasyonunu manuel olarak tetikleyin.
  • Ürün varyasyonları olan ürünlerde, varyasyon verilerinin doğru aktarıldığından emin olun.

Dışa aktarım sırasında hata alıyorsanız:

  • Farklı bir dosya formatı kullanmayı deneyin.
  • Daha az veri dışa aktarmayı deneyin (filtreleme kullanarak).
  • Tarayıcı önbelleğini temizleyin ve tekrar deneyin.
  • Destek ekibimizle iletişime geçin.

Destek İletişim Bilgileri

Sorunlarınızı çözemediyseniz, destek ekibimizle iletişime geçebilirsiniz: