Hızlı başlangıç

Bu kılavuz, yepyeni bir işletmeyi boş halden satışa geçirir: bir ürün, çalışan vergi ve kargo ayarları, mağazanız için bir API anahtarı ve panelinize düşen ilk sipariş. İşletmeniz için Commerce modülünün etkin olduğunu varsayar; kenar çubuğunda Web mağazası girdisi yoksa platform yöneticinize başvurun.

1. İlk ürününüzü oluşturun#

1. Kenar çubuğunda Katalog → Ürünler yolunu izleyin. Yeni bir işletmede liste "Henüz ürün yok" mesajını gösterir.

2. Yeni ürün düğmesine tıklayın. Ekran Ne satıyorsunuz? diye sorar: Ürün seçin (olduğu gibi satılır, isteğe bağlı olarak beden veya renk gibi seçeneklerle). Ölçüye göre yalnızca Yapılandırıcı modülü etkinken sunulur.

3. Bir Ad yazın ve Kaydet düğmesine tıklayın. Ürün taslak olarak oluşturulur ve ürün sayfası açılır.

4. Ürün sayfasında temel bilgileri doldurun ve hepsi için bir kez Kaydet düğmesine tıklayın:

   Alan	Nerede	Açıklama
   Fiyat	Fiyatlandırma	Ana birim cinsinden girilir (örn. 19.99 veya 19,99); varyantlar bunu geçersiz kılabilir.
   Birim	Fiyatlandırma	Ağırlık, uzunluk, alan, hacim veya zamana göre satmıyorsanız Adet.
   SKU	Stok ve kargo	Kendi iç ürün numaranız.
   Stoğu takip et / Stok miktarı	Stok ve kargo	Stok modülüyle, elinizde kaç tane olduğu. Sınırsız satmak için miktarı boş bırakın.
   Durum	Kenar çubuğu	Draft, Active veya Archived. Ürünü yalnızca satılabilir olması gerektiğinde Aktif yapın.

   S, M, L değerleriyle Beden gibi seçenekler Seçenekler ve varyantlar kartına eklenir; varyantlar da orada üretilir. Tam tur Ürün yönetimi sayfasındadır.

Paneldeki Başlarken kontrol listesi de İlk ürününüzü oluşturun bağlantısıyla buraya yönlendirir.

2. Vergileri ve kargoyu ayarlayın#

Bir mağazanın ödeme alabilmesi için işletmenizde en az bir KDV sınıfı ve bir kargo yöntemi bulunmalıdır.

1. Ayarlar → Vergiler sayfasını açın. Yeni bir işletmede Standaard 21%, Verlaagd 9% ve Nultarief 0% zaten bulunur; gerekirse Yeni KDV sınıfı ile kendi sınıfınızı ekleyin. Bir sınıf varsayılandır; başka bir sınıf seçmediğiniz sürece ürünler bunu kullanır.
2. Web mağazası → Ayarlar → Kargo sayfasını açın ve Yeni kargo yöntemi ile bir yöntem ekleyin. Fiyatlar mağaza para biriminizdedir; ücretsiz kargo sunmuyorsanız ücretsiz kargo eşiğini boş bırakın.

İpucu: Paneldeki Başlarken kontrol listesindeki Vergileri ve kargoyu yapılandırın öğesi doğrudan 2. adımdaki kargo sayfasını açar.

Vergilerin tüm ayrıntıları Vergiler sayfasındadır; kargo ve diğer mağaza ayarları Mağaza ayarları sayfasındadır.

3. Mağazanız için bir API anahtarı oluşturun#

Mağazanız (web sitesi, uygulama veya entegrasyon) Borkol ile bu işletmeye özel kapsamlı bir API anahtarı üzerinden iletişim kurar.

1. Kenar çubuğunun Çalışma alanı bölümünden Ayarlar sayfasını açın ve bölüm listesinden API Anahtarları seçeneğini seçin (veya doğrudan /settings/api-keys adresine gidin).
2. Anahtar oluştur kartına bir anahtar adı girin (örneğin storefront) ve en az bir kapsam seçin. Kapsamlar etkin modüllerinizden gelir: tenant:read artı her modül için bir :read ve :write kapsamı (örn. commerce:read, commerce:write).
3. Oluştur düğmesine tıklayın. Düz metin token, "Bu token'ı şimdi kopyalayın. Yalnızca bir kez gösterilir." başlıklı bir kartta yalnızca bir defa görünür.
4. Token'ı kopyalayıp güvenli bir yerde saklayın. Bir daha asla görüntülenemez; kaybederseniz anahtarı iptal edip yenisini oluşturun.

Kapsamlar ve anahtar iptali hakkında daha fazlası API anahtarları sayfasında. Mağazayı geliştiren kişi bu token'ı, API referansındaki Kimlik doğrulama bölümünde açıklandığı gibi kullanır.

4. İlk siparişin gelişini izleyin#

Mağazanız yayına girip bir müşteri ödeme yaptığında:

• Panel ana sayfası siparişi Son siparişler bölümünde gösterir; Siparişler (14 gün), Bu ayki siparişler ve sipariş ödendiğinde Gelir (14 gün) ile Gelir kartları güncellenir.
• Tam liste Web mağazası → Siparişler altındadır; sipariş detayını açmak için herhangi bir satıra tıklayın.
• Yeni siparişler pending_payment olarak başlar ve paid, shipped ve completed (veya cancelled / refunded) durumlarından geçer.

Entegrasyonunuzun, siz paneli yenilemeden siparişlere otomatik tepki vermesi gerekiyorsa, Ayarlar → Webhook'lar bölümünden bir webhook uç noktası ekleyin; bu uç nokta order.created ve order.status_changed olaylarını gerçekleştikleri anda alabilir.