BigCommerce entegrasyonu: API hesabından sipariş durumuna kadar
BigCommerce entegrasyonu, BigCommerce altyapısındaki sitenizin ürün, stok ve sipariş bilgisini pazaryeri mağazalarınızla aynı stok kartı üzerinden yönetmenizi sağlar. Bu bölümde bağlantının teknik tarafını satıcı gözüyle anlatıyoruz: BigCommerce'te API hesabının nasıl açıldığı, stoğun hangi alanlarda tutulduğu, eşleştirmeden önce SKU ve varyantların nasıl hazırlanacağı ve sipariş durumlarının ne anlama geldiği. Amaç, ilk günden aşırı satış ve yanlış eşleşme riskini düşürmeniz.
BigCommerce entegrasyonu hangi satıcının işine yarar?
BigCommerce, yurt dışına satış yapan markaların yanı sıra toptan (B2B) satış kurgusu olan işletmelerin de kullandığı bir altyapıdır. Bu satıcıların ortak noktası, aynı ürünü hem kendi sitesinde hem de bir ya da birkaç pazaryerinde satmasıdır. Stok tek kaynaktan yönetilmediğinde sitede satılan ürünün pazaryerindeki adedi elle düşürülür; yoğun günlerde bu adım atlanır ve elde olmayan ürün satılır.
- Yurt dışı vitrini BigCommerce olan marka: Aynı ürünleri Amazon, eBay ya da Etsy'de de satıyor, tek depodan gönderiyorsunuz.
- Yurt içi pazaryerinde de satan üretici: BigCommerce sitenizi yurt dışı için, Trendyol veya Hepsiburada'yı yurt içi için kullanıyorsunuz ve stoğu iki ayrı yerde sayıyorsunuz.
- Toptan ve perakendeyi birlikte yürüten işletme: Bayi siparişi ile perakende sipariş aynı depodan çıkıyor; hangisinin stoğu tükettiğini ayrı ayrı görmek istiyorsunuz.
- Varyantı çok ürün satanlar: Beden, renk ve ölçü kombinasyonları yüzlerce SKU'ya ulaşıyor; tek adetlik hata bile iptal demek.
Merkezi bir BigCommerce entegrasyon programında siteniz, panelde tanımlı 80 satış kanalından biri olarak aynı stok kartına bağlanır. Böylece pazaryeri, kargo ve fatura tarafı da ayrı ekranlara dağılmadan tek panelde yürür.
BigCommerce'te API hesabı nasıl açılır?
BigCommerce bağlantıları mağaza şifresiyle değil, kontrol panelinde oluşturulan mağaza düzeyindeki API hesabıyla kurulur. BigCommerce geliştirici dokümanına göre bu hesap tek bir mağazanın verisini okumak ve değiştirmek içindir ve sabit bir erişim anahtarı (access token) üretir.
- BigCommerce kontrol panelinde Settings > Store-level API accounts menüsüne girin ve yeni bir API hesabı oluşturun.
- Hesaba tanınacak bir ad verin (ör. "eticaretcim stok"); bu ad yalnız sizin içindir.
- Kapsamları (OAuth scopes) belirleyin: ürünler (Products), siparişler (Orders), stok (Store Inventory) ve lokasyonlar (Store Locations) için her kapsamda salt okuma ya da değiştirme (modify) seçeneği vardır; stok ve sipariş güncellemesi için değiştirme gerekir.
- Kaydettiğinizde oluşan Client ID, Client Secret, Access Token ve API Path bilgilerini güvenli bir yere not edin.
- Bu bilgileri panelde BigCommerce bağlantı ekranına girin; mevcut ürünleriniz panele okunur ve barkod ya da stok koduyla eşleşir.
BigCommerce stok entegrasyonu: hangi sayı esas alınmalı?
BigCommerce stoğu tek bir sayı olarak tutmaz. Dokümana göre stok, her varyant için lokasyon bazında izlenir ve elde bulunan adet ile satılabilir adet ayrı alanlardır. Pazaryerine hangi sayının gittiği, aşırı satışın önlenmesinde belirleyicidir.
| BigCommerce alanı | Anlamı | Entegrasyon açısından |
|---|---|---|
| Elde bulunan (on hand) | Depodaki fiziksel adet | Ortak stok kartının temel sayısıdır |
| Güvenlik stoğu (safety stock) | Vitrinde satışa açılmayan, ayrılmış adet | Satılabilir adede dahil değildir; pazaryerine de gönderilmemesi gerekir |
| Ön sipariş limiti (backorder) | Stok bitince alınabilecek ek sipariş adedi | Satılabilir adedi büyütür; pazaryerinde gerçek stok gibi görünmemeli |
| Satılabilir (available to sell) | Elde bulunan − güvenlik stoğu + ön sipariş limiti | Sitede satışa açık sayı; pazaryeriyle karşılaştırırken bu formülü hesaba katın |
BigCommerce ayrıca stok güncellemelerinin eşzamansız işlendiğini, yani yazılan değerin stok seviyesine kısa bir gecikmeyle yansıdığını belirtiyor. Bu nedenle kampanya günlerinde son birkaç adet risklidir; BigCommerce'teki güvenlik stoğu tam olarak bu tür bir tampon için düşünülmüş alandır. Panel tarafında kritik stok uyarısı ve stok çakışmaları listesi, son adetlerde sorun büyümeden müdahale etmenizi sağlar; ayrıntılar stok ve fiyat senkronu sayfasında.
BigCommerce ürün eşleştirme: SKU ve varyant hazırlığı
BigCommerce stok entegrasyonunda en sık sorun bağlantıdan değil, ürün verisinden çıkar. Mevcut ilanlar panele okunur ve barkod ya da stok koduyla eşleşir; kodlar düzensizse eşleşme de düzensiz olur. Bağlamadan önce kısa bir temizlik yapmanız ilk haftadaki düzeltme işini ciddi biçimde azaltır.
SKU, barkod ve varyant kontrol listesi
- Her varyantın kendine ait, tekrar etmeyen bir SKU'su olsun; ürün düzeyindeki SKU'yu varyantlarda kopyalamayın.
- Pazaryerinde kullandığınız barkodu (GTIN/EAN) BigCommerce'teki ilgili varyanta da girin.
- Renk ve beden gibi seçenekleri varyant olarak tanımlayın; fiyatı ya da stoğu etkilemeyen kişiselleştirme alanlarını ayrı tutun.
- Aynı ürünün eski, pasif kopyalarını arşivleyin; iki kayıt aynı koda sahipse hangisinin eşleşeceği belirsizleşir.
- 5'li ya da 10'lu paket satıyorsanız paketi ayrı stok gibi saymayın; panelde paket stoğu tek stok biriminden düşecek şekilde tanımlanır.
Eşleşmeyen ürünler ne olur?
Barkodu ya da stok kodu tutmayan ürünler kendiliğinden eşleşmez; bunları doğru stok kartına sizin bağlamanız gerekir. Bu sırada siz onaylamadan hiçbir ilan değişmez. Eşleşmeyen ürünleri tek tek gözden geçirip bağladıktan sonra senkronu başlatmak en güvenli yoldur.
BigCommerce sipariş durumları ve kargo takibi
BigCommerce'te bir sipariş, ödeme ve gönderim aşamasına göre farklı durumlar alır. Sipariş entegrasyonu kurulurken bu durumların anlamını bilmek, hangi siparişin hazırlanacağına karar verirken işinizi kolaylaştırır.
| BigCommerce durumu | BigCommerce'e göre anlamı | Satıcı için not |
|---|---|---|
| Awaiting Payment | Müşteri ödeme adımını tamamladı, ödeme henüz teyit edilmedi | Havale gibi yöntemlerde hazırlığa başlamadan önce bekleyin |
| Awaiting Fulfillment | Ödeme teyit edildi, sipariş hazırlanmayı bekliyor | Paketleme listesine alınacak siparişler |
| Awaiting Shipment | Paketlendi, kargo firmasının teslim almasını bekliyor | Etiket ve takip numarası bu aşamada hazır olmalı |
| Partially Shipped | Siparişin yalnız bir kısmı gönderildi | Kalan kalemlerin stoğunu ayrıca kontrol edin |
| Shipped | Kargoya verildi, teslim henüz teyit edilmedi | Takip numarası müşteriye iletilmiş olmalı |
| Cancelled / Refunded | Satıcı siparişi iptal etti ya da iade işlemi yaptı | Ürün depoya döndüyse stoğun geri eklendiğini doğrulayın |
BigCommerce'te gönderi (shipment) kaydı oluşturulduğunda müşteriye e-posta bildirimi gider; kayda girilen takip numarası ve kargo firması da takip bağlantısını oluşturmak için kullanılır. Panelde kendi kargo sözleşmenizle bağlanırsınız; barkod ve etiket panelden alınır, takip numarası pazaryerine iletilir. Ayrıntılar kargo entegrasyonu sayfasında. Site ve pazaryeri siparişlerinin tek listede nasıl ilerlediğini sipariş yönetimi bölümünde görebilirsiniz.
BigCommerce fiyatı ile pazaryeri fiyatı nasıl ayrılır?
BigCommerce siteniz ile pazaryerleri arasında fiyat çoğu zaman aynı olmaz; pazaryeri komisyonu ve kargo kesintisi fiyata yansıtılır. Panelde kanal başına yüzde ya da tutar olarak fiyat farkı tanımlanır; böylece aynı stok kartından her kanala kendi fiyatı gider. Farkı belirlerken komisyon ve kargo kesintisi hesabı rehberindeki örnekleri kullanabilirsiniz.
BigCommerce entegrasyonunda sık yapılan hatalar
- Ön sipariş limiti açık ürünlerin satılabilir adedini pazaryerine gerçek stok gibi göndermek.
- Güvenlik stoğunu BigCommerce'te tanımlayıp pazaryeri tarafında hesaba katmamak.
- Aynı stoğu hem BigCommerce'teki başka bir uygulama hem de merkezi panel üzerinden güncellemek; iki kaynak birbirinin değerini ezebilir.
- API hesabını salt okuma kapsamıyla açıp stok güncellemesinin neden gitmediğini aramak.
Daha geniş bir kontrol listesi için çok kanallı stokta aşırı satışı önlemek rehberine bakabilirsiniz. Paket seçerken dikkat edin: Başlangıç paketi yalnız yedi yurt içi pazaryerinden birini kapsadığı için BigCommerce bağlantısı Büyüme paketiyle başlar. Paketlerin kanal ve ürün limitlerini fiyatlar ve paketler sayfasında karşılaştırabilirsiniz.
- BigCommerce Docs: API Accounts (store-level API accounts ve OAuth kapsamları)
- BigCommerce Docs: Inventory adjustments (lokasyon, güvenlik stoğu, eşzamansız güncelleme)
- BigCommerce Docs: Backorders (available_to_sell formülü)
- BigCommerce API Reference: List Order Statuses
- BigCommerce Docs: Orders overview (gönderi ve takip numarası)
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi
