VibeFox ShipStation for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

ShipStation hesabı: kargo firmalarınızı ShipStation'da bağlayın (Settings > Shipping > Carriers), ardından API Key ve API Secret değerlerini ShipStation > Settings > Account > API Settings sayfasından kopyalayın. API erişimi ShipStation planınıza bağlıdır. Sayfa kullanılamıyorsa planınız API erişimini içermiyor demektir. Eklenti ShipStation API V1'i kullanır (API Key ve API Secret). Tek bir API anahtarı olan ShipStation API V2 hesapları desteklenmez. Anahtarlar olmadan yalnızca yedek fiyatlar kullanılır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_shipstation klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox ShipStation ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. API Key ve API Secret değerlerini yapıştırın, gönderici posta kodunu girin ve kaydedin. Sayfa artık hesabınızın kargo firması kodlarını listeler. İstediğiniz kodları Carrier codes alanına girin ve tekrar kaydedin.

6. Mağaza para biriminiz ShipStation hesabınızın para birimi değilse Exchange rate değerini ayarlayın.

7. İsterseniz yedek fiyatları doldurun.

8. VibeFox ShipStation yöntemini WooCommerce > Settings > Shipping > Shipping zones içinde bir kargo bölgesine ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox ShipStation. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): müşterinin bu bölge için gördüğü ad. Genel Name değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde ShipStation'ın önbelleğe alınmış ücretleri temizlenir ve API Key ile API Secret doğrulanır. Sayfa ardından hesabınıza bağlı kargo firmalarını kodlarıyla gösterir; örneğin "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)". Ayarların üstündeki uyarılar, canlı ücretlerin ne zaman çalışamayacağını bildirir: anahtar yoksa, kargo firması kodu yoksa, gönderici posta kodu yoksa, döviz kuru yoksa, bağlantı kontrolü başarısızsa veya kargo firması kodları hesabınıza bağlı değilse.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır.

Name: ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge bunu kendi Title değeriyle değiştirebilir. Varsayılan: ShipStation Shipping.

ShipStation hesabı

API Key: ShipStation > Settings > Account > API Settings sayfasındaki API Key.

API Secret: aynı sayfadaki API Secret.

Carrier codes: virgülle ayrılmış bir veya daha fazla ShipStation kargo firması kodu, örneğin stamps_com, ups_walleted. En fazla 5 kod kullanılır ve her kargo firması için bir API isteği gönderilir. Bu kargo firmalarının en ucuz ücreti gösterilir. Kodları kaydettikten sonra görünen listeden alın.

Allowed services: isteğe bağlı, virgülle ayrılmış ShipStation hizmet kodları, örneğin usps_priority_mail, ups_ground. Yukarıdaki kargo firmalarının en ucuz hizmetini göstermek için boş bırakın.

Package code: "package" (varsayılan) kendi kutunuzun ücretini hesaplar ve kargo firmasının zarflarını ile sabit ücretli kutularını hariç tutar. Kargo firmasının sunduğu tüm paket türlerinin ücretini hesaplamak için boş bırakın.

Gönderici

Ship-from postal code: canlı ücretler için gereklidir. ShipStation ücretleri yalnızca posta koduna göre hesaplar ve bu kod ShipStation hesabınızın ülkesinde olmalıdır. WooCommerce > Settings > General içinde tanımlı mağaza posta kodunu kullanmak için boş bırakın.

Ücretler

Parcels: sepetin ShipStation'a nasıl gönderileceği.

ShipStation account currency: ShipStation'ın ücretleri döndürdüğü para birimi: USD, CAD, GBP, AUD, NZD veya EUR. Varsayılan: USD (ABD hesapları).

Exchange rate: hesap para biriminin 1 biriminin mağaza para biriminizdeki fiyatı, örneğin 0.92. Yalnızca mağaza para birimi hesap para biriminden farklıysa gerekir. Bu alan olmadan canlı ücretler kullanılmaz ve yedek fiyatlar uygulanır. Döviz kurları otomatik olarak güncellenmez.

Tax status: Taxable seçildiğinde WooCommerce kargoya vergi ekleyebilir; None seçildiğinde eklemez. ShipStation ücretleri satış vergisi içermez.

Yedek fiyatlar (canlı ücret olmadığında kullanılır: API anahtarı yoksa, ShipStation erişilemezse veya adres için kargo firmasından ücret gelmezse; fiyatlar mağaza para biriminde; bu durumda yöntemi gizlemek için tabloyu ve Other countries alanını boş bırakın)

Prices by country: ülke başına temel fiyat ve koli ağırlığına göre boyut sütunları içeren bir tablo: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. Boş bir boyut temel fiyatı kullanır. Temel fiyat 0 ise kargo ücretsizdir. * Default (all other countries) satırı kendi satırı olmayan ülkelere uygulanır.

Other countries: tabloda ülke için fiyat yoksa uygulanan fiyat. Bu durumda yöntemi gizlemek için boş bırakın.

Koşullar

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Bu durumda ShipStation'a istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: yöntem yalnızca sepet ara toplamı bu tutarın en az üzerindeyse gösterilir. Her zaman göstermek için boş bırakın.

Minimum weight: bu yöntemin gösterilmesi için gereken, mağaza ağırlık biriminde minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet ağırlığı bu değerin üzerindeyse yöntem gizlenir; değer mağaza ağırlık biriminde girilir. 0 sınır olmadığı anlamına gelir.

Disabled shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntemin bir bölgeye eklenip eklenmediğine bakılmaksızın aşağıdaki ülkeler için sunulmasını sağlar.

Countries: bu mod için hedef ülkeler. Mağazanın gönderim yaptığı tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Bir kargo bölgesine eklenen yöntem her zaman o bölgenin ülkeleri için çalışır.

Gelişmiş

Debug log: ShipStation isteklerini WooCommerce > Status > Logs altına, vfd-shipstation kaynağıyla kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API Key, API Secret ve müşteri adresleri hiçbir zaman kaydedilmez. Posta kodu maskelenir.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını ve kargo bölgelerindeki yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları hiçbir zaman silmez.

Ödeme sayfasında nasıl çalışır

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir ücret ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve devre dışı kargo sınıfları. Ücretsiz kargo geçerliyse yöntem 0 fiyatla gösterilir ve ShipStation'a istek gönderilmez.

Ardından eklenti ShipStation'a gönderici posta kodunu, hedef ülkeyi, eyaleti, şehri ve hedef posta kodunu, koli ağırlığını ve kutu boyutunu gönderir. Müşteri bir posta kodu girene kadar istek yapılmaz. Posta kodu olmayan ülkeler yedek fiyatları alır. Ağırlıklar ve boyutlar mağaza birimlerinizden dönüştürülür. Ürünler tek bir kutuya yerleştirilir. Bir ürünün boyutu yoksa koli yalnızca ağırlığa göre hesaplanır.

ShipStation her kargo firması kodu için bir kez sorgulanır. Eklenti, izin verilen en ucuz ücreti mağaza para birimine çevirerek yöntem adının altında gösterir.

Her yanıt 1 saat önbelleğe alınır. ShipStation kullanılabilir bir ücret vermeden yanıt verirse yanıt 10 dakika hatırlanır. ShipStation anahtarları reddederse veya erişilemezse istekler 5 dakika duraklatılır. İstek limitine ulaşıldığında duraklatma süresi ShipStation'ın sıfırlama zamanına göre belirlenir. İstek zaman aşımı 12 saniyedir. Eklentiyi devre dışı bırakmak önbelleğe alınmış ücretleri temizler.

Canlı ücret yoksa fiyat yedek fiyat tablosundan, ardından Other countries alanından alınır. İkisi de geçerli değilse yöntem gizlenir. Müşteri hiçbir zaman ShipStation hata metinlerini görmez. Ayrıntılar WooCommerce günlüğüne yazılır.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca ücret hesaplar. ShipStation'da etiket satın almaz, sipariş veya gönderi oluşturmaz, paketleri takip etmez ve iadeleri yönetmez. Teslim noktası yoktur; ödeme sayfasında birden fazla hizmet arasından seçim yoktur; adres doğrulama, sigorta, imza onayı, birden fazla pakete bölme ve ücret artışı yoktur.

Siparişler

Siparişin kargo satırı seçilen Service değerini saklar, örneğin "USPS Ground Advantage - Package". Bunu yönetici sipariş ekranında görürsünüz ve ShipStation'da ilgili etiketi oluşturabilirsiniz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox ShipStation sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa ShipStation ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise (unlicensed — visible to admins only) etiketiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

ShipStation ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum subtotal ve Disabled shipping classes değerlerini kontrol edin. Canlı ücret yoksa ülkenin, * Default satırının veya Other countries alanının bir fiyatı olup olmadığına bakın.

Ödeme sayfası ShipStation ücreti yerine yedek fiyatı gösteriyor: ayarlar sayfasının üstündeki uyarıları kontrol edin (anahtarlar, kargo firması kodu, gönderici posta kodu, döviz kuru). Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasını, vfd-shipstation kaynağıyla açın. Müşterinin posta kodu gereklidir. Girilene kadar istek yapılmaz.

Hangi kargo firması kodunu girmelisiniz: ayarları anahtar ve secret ile kaydedin. Sayfa hesabınızın kargo firması kodlarını listeler. Bunlardan bir veya birkaçını kullanın.

Ücret ShipStation'dan farklı: koli, ürünlerin ağırlıklarından ve boyutlarından oluşturulur; ürünler tek bir kutuya yerleştirilir. Boyutu olmayan ürünler yalnızca ağırlığa göre hesaplanır. Ücretler 1 saat önbelleğe alınır. Önbelleği temizlemek için ayarları kaydedin.

Geliştiriciler için: vfd_shst_rate_request, vfd_shst_selected_rate ve vfd_shst_api_url filtreleri, kargo firması başına ücret isteğini, seçilen ücreti ve API temel URL'sini değiştirir.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak ayarları korur ve yalnızca önbelleğe alınmış ücretleri temizler. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış ücretler ve kayıtlı kargo firması listesi her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler kargo satırlarını korur.

ShipStation, ilgili sahibinin ticari markasıdır. Bu eklenti ShipStation ile bağlantılı değildir ve ShipStation tarafından onaylanmamıştır.