Envanter Yükleme Kılavuzu (Excel / API)
Partner olarak envanterinizi PartAndStock'a iki yolla aktarabilirsiniz: Excel (XLSX) ile toplu yükleme veya kendi API'niz üzerinden otomatik besleme. Bu kılavuz, ürünlerinizin arama sonuçlarında doğru görünmesi için gereken adımları, zorunlu alanları ve sık yapılan hataları açıklar.
1. Excel ile yükleme
Az/orta sayıda ürün ya da elle güncellenen envanterler için en pratik yol. Hazırladığınız tabloyu sürükleyip bırakın.
2. API ile besleme
Stok ve fiyatı sık değişen büyük envanterler için. Kendi API adresinizi tanımlarsınız; ürünleriniz otomatik güncel kalır.
Excel ile yükleme
Desteklenen biçimler: .xlsx ve .xls. En fazla 25 MB. İlk satır başlık satırı olmalıdır; başlıklar Türkçe veya İngilizce yazılabilir, sistem otomatik tanır.
Zorunlu sütunlar
| MPN | Üreticinin parça numarası (örn. NE555P). Zorunlu. |
| Marka (Brand) | Üretici / marka adı (örn. Texas Instruments). Zorunlu. |
İsteğe bağlı sütunlar
| Stok | Eldeki adet (tam sayı). Boşsa 0 kabul edilir. |
| Fiyat | Birim fiyat. Tek değer veya fiyat kademeleri girilebilir. |
| Fiyat Kademeleri | Adet:fiyat çiftleri — 1:0.55; 10:0.48; 100:0.42 |
| Para Birimi | TRY, USD, EUR... Boşsa TRY varsayılır. |
| Ürün Adı | Listelemede görünen başlık. |
| Açıklama | Kısa ürün açıklaması. |
| SKU | Kendi stok kodunuz. |
| MOQ | Minimum sipariş adedi. |
| Paketleme | Reel / Tube / Tray / Cut Tape vb. |
| Görsel URL | Ürün görselinin tam adresi. |
| Yönlendirme URL | Müşterinin satın alma için yönlendirileceği sayfa. |
Fiyat kademeleri nasıl yazılır?
Tek bir hücreye adet:fiyat çiftlerini noktalı virgülle ayırarak yazın:
1:0.55; 10:0.48; 100:0.42; 1000:0.37
Yani 1 adet 0,55; 10+ adet 0,48; 100+ adet 0,42 birim fiyatından satılır. Tek fiyat girecekseniz sadece 0.55 yazmanız yeterli.
Örnek tablo
| MPN | Marka | Stok | Fiyat Kademeleri | Para Birimi |
|---|---|---|---|---|
| NE555P | Texas Instruments | 5400 | 1:0.55; 10:0.48; 100:0.42 | TRY |
| LM358N | ON Semiconductor | 1200 | 1:0.90 | TRY |
Sütun sırası önemli değildir; sistem başlık adlarından eşleştirir.
Partner panelinde Excel yükleAPI ile besleme
Envanteriniz kendi sisteminizde tutuluyorsa, partner panelindeki API ile Ürün Listele sayfasından bağlantı bilgilerinizi girin. Tanımlayacağınız alanlar:
| Temel URL (baseUrl) | API'nizin kök adresi, örn. https://api.firmaniz.com/v1 |
| Kimlik doğrulama türü | API Key, Bearer Token, Basic Auth, OAuth 2.0 veya kimlik doğrulama yok. |
| API anahtarı / secret | Şifrelenerek saklanır; ekranda asla ham olarak gösterilmez. |
| Arama endpoint'i | Örn. /products/search |
| Detay endpoint'i | Örn. /products/{mpn} |
Yükleme sonrası ne olur?
- 1
Dosya alınır ve kuyruğa girer
Excel'iniz yüklendiğinde bir işlem partisi oluşur ve durumu Sırada → İşleniyor → Tamamlandı olarak ilerler.
- 2
Satırlar doğrulanır
Her satır kontrol edilir; hatalı satırlar atlanır ve "Son Yüklemeler" tablosunda hata sayısı olarak gösterilir. Geçerli satırlardan ürün teklifleri üretilir.
- 3
Ürünler yayına alınır
Partner üyeliğiniz onaylı ve ödemeniz tamamlanmışsa ürünleriniz birkaç saniye içinde arama sonuçlarında görünmeye başlar.
Sık yapılan hatalar
- MPN veya Marka sütununun boş bırakılması — bu iki alan zorunludur, eksik satırlar atlanır.
- Fiyatın metin olarak yazılması (örn. para birimi simgesiyle). Sadece sayı veya kademe biçimi kullanın.
- Fiyat kademelerinde yanlış ayırıcı kullanımı — adet ile fiyat arasına iki nokta (:), çiftler arasına noktalı virgül (;) konur.
- 25 MB üzeri dosya — büyük envanteri parçalara bölün veya API beslemesini tercih edin.
Henüz partner değil misiniz?
Envanterinizi yayınlamak için bir partner üyelik paketi seçerek başvurun.