E-Ticaret Entegrasyonu Kurulumu: API Anahtarı ve Bağlantı Rehberi

E-ticaret entegrasyonu kurmak, çoğu satıcının düşündüğünden daha basittir. Temelde tek bir şey yaparsınız: her satış kanalının size verdiği API kimlik bilgilerini entegrasyon programına tanımlarsınız. Bu rehberde, API anahtarınızı pazaryeri satıcı panelinizden nasıl alacağınızı, bunları nasıl gireceğinizi ve ilk senkronizasyonu nasıl başlatacağınızı adım adım anlatıyoruz.

Anlatım genel ve öğreticidir; pazaryerleri arayüzlerini zaman zaman değiştirdiği için ekran düzeni farklılık gösterebilir. Ancak mantık her platformda aynıdır: bir kimlik (mağaza/satıcı no), bir anahtar ve çoğunlukla bir gizli anahtar (secret).

Kurulum öncesi hazırlık

Bağlantıya başlamadan önce şunların elinizde olduğundan emin olun:

• Aktif satıcı hesabı: Bağlamak istediğiniz pazaryerinde onaylı ve aktif bir mağazanız olmalı.
• Panel yetkisi: API/entegrasyon ayarlarına erişebilen bir kullanıcı hesabı (genelde yönetici/sahip yetkisi gerekir).
• Entegrasyon programı hesabı: Stokzone gibi bir e-ticaret operasyon merkezinde açılmış bir hesap.
• Mağaza/satıcı kimlik numarası: Çoğu platform API anahtarının yanında ayrıca bir mağaza/satıcı ID ister.

Adım 1: Satıcı panelinden API bilgilerinizi alın

API kimlik bilgileri, satıcı panelinizdeki "Entegrasyonlar", "API Erişim Bilgileri" veya "Geliştirici/Hesap Ayarları" gibi bir bölümde bulunur. Platforma göre adlandırma değişir ama akış benzerdir.

Trendyol'da

Trendyol Satıcı Paneli'nde Hesap/Entegrasyon ayarlarından API anahtarınıza (API Key) ve gizli anahtarınıza (API Secret) ulaşırsınız. Ayrıca Satıcı ID (Seller ID) bilginiz de gereklidir. Bu üç bilgi birlikte bağlantıyı oluşturur.

Hepsiburada'da

Hepsiburada satıcı tarafında entegrasyon bilgileri kullanıcı adı, gizli anahtar ve satıcı (merchant) ID üzerinden tanımlanır. Bu bilgiler hesap/entegrasyon ayarlarından alınır.

Diğer pazaryerlerinde

N11, Çiçeksepeti, Pazarama, İdefix, PTT AVM gibi pazaryerleri de kendi panellerinde API anahtarı/secret veya tek bir API key sunar. Her platformun bu bilgileri verme şekli biraz farklıdır; bazıları tek anahtar, bazıları anahtar + secret kullanır. Entegrasyon programının bağlantı formu hangi alanları istediğini size gösterir.

Adım 2: Bilgileri entegrasyon programına girin

Kimlik bilgilerini aldıktan sonra entegrasyon programında ilgili kanalı seçip bağlantı formunu doldurursunuz. Stokzone'da bağlantı şu mantıkla çalışır:

1. Kanalı seçin: Bağlamak istediğiniz pazaryerini veya e-ticaret altyapısını (Shopify, WooCommerce, İkas, Ticimax vb.) listeden seçin.
2. Alanları doldurun: Program, o kanal için hangi alanları istediğini dinamik olarak gösterir; örneğin API Key, API Secret ve Satıcı ID.
3. Bağlantıyı test edin: Kaydetmeden önce "Bağlantıyı Test Et" ile kimlik bilgilerinin geçerli olduğunu doğrulayın.
4. Kaydedin: Test başarılıysa bağlantıyı kaydedin; kanal artık operasyon merkezinize bağlıdır.

Adım 3: İlk senkronizasyonu başlatın

Bağlantı kurulduktan sonra program, kanaldan veri çekmeye başlar. İlk senkronizasyon genellikle şunları kapsar:

• Siparişler: Mevcut ve yeni siparişler operasyon merkezine aktarılır.
• Ürünler: Kanaldaki ürünleriniz listelenir ve eşleştirilir.
• Stok bilgisi: Güncel stok seviyeleri okunur ve tek kaynakta toplanır.

Stokzone'da geçmiş siparişlerin ne kadar geriden çekileceğini bir başlangıç tarihiyle sınırlayabilirsiniz. "Belirli bir tarihten sonra" seçeneğiyle yalnızca o tarihten itibaren olan siparişleri içe aktararak ilk senkronizasyonu hızlandırabilirsiniz.

İlk senkronizasyonun tamamlanması, kanaldaki veri hacmine göre birkaç dakika sürebilir. İşlem tamamlandığında siparişlerinizi ve ürünlerinizi tek ekranda görmeye başlarsınız.

Adım 4: Otomatik senkronizasyonu açın

İlk içe aktarımdan sonra senkronizasyonu otomatik moda almak, entegrasyonun asıl değerini ortaya çıkarır. Otomatik senkronizasyon açıkken yeni siparişler düzenli aralıklarla kendiliğinden çekilir ve stok hareketleri kanallar arasında güncel tutulur.

Stokzone'da her kanal için senkronizasyonu açıp kapatabilir, kontrol sıklığını yönetebilirsiniz. Stok senkronizasyonu açık olduğunda bir kanalda satış gerçekleştiğinde stok tek kaynaktan düşülür ve bağlı tüm kanallara güncel miktar yayılır.

Sık karşılaşılan kurulum hataları

• Eksik/yanlış kimlik bilgisi: Anahtar veya secret kopyalanırken araya boşluk girmesi en sık hatadır. Bağlantı testi başarısızsa önce bunu kontrol edin.
• Yetkisiz kullanıcı: API anahtarını panelden alan kullanıcının yeterli yetkisi yoksa anahtar çalışmaz.
• API erişimi kapalı: Bazı platformlarda API erişimini önce etkinleştirmeniz gerekir.
• Ürün eşleştirme eksiği: Aynı ürünün farklı kanallardaki kayıtları doğru eşleşmezse stok yayılımı beklediğiniz gibi olmaz; ilk kurulumda eşleştirmeyi gözden geçirin.

Özet

E-ticaret entegrasyonu kurulumu dört adıma indirgenir: satıcı panelinden API bilgilerini alın, entegrasyon programına girip test edin, ilk senkronizasyonu başlatın ve otomatik senkronizasyonu açın. Bu adımlardan sonra tüm kanallarınızı tek ekrandan yönetir, stok ve siparişlerinizi güncel tutarsınız. Stokzone, bağlantı formundan oversell korumasına kadar bu süreci tek panelde toplar ve 30 gün ücretsiz denenebilir.