VibeFox Shippo for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. Eklenti, WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Shippo hesabı: bir Shippo hesabı oluşturun, kargo firmalarını bağlayın veya etkinleştirin (USPS, UPS, FedEx, DHL ve diğerleri) ve API token'ını Shippo > Settings > Advanced > API bölümünden kopyalayın. Shippo, satın alınan etiketler için ücret alır, ücret isteklerine değil. Yeni Shippo hesaplarının canlı ücretlerin döndürülmesinden önce Shippo tarafından doğrulanması gerekebilir. Token olmadan yalnızca yedek fiyatlar kullanılır.

Ürünler: ürünlerin ağırlığı ve ölçüleri olmalıdır. Ölçüsü olmayan ürünler varsayılan kutu boyutunu kullanır.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_shippo klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

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

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

5. Shippo API token'ınızı yapıştırın ve Ship from adresini doldurun. Posta kodu zorunludur.

6. Shippo rate currency seçin (ABD'den gönderim yapıyorsanız USD) ve mağazanız başka bir para birimi kullanıyorsa döviz kurunu girin.

7. İsteğe bağlı olarak ülke ve ağırlık tablosuna yedek fiyatları girin.

8. VibeFox Shippo eklentisini WooCommerce > Settings > Shipping > Shipping zones içindeki bir kargo bölgesine ekleyin veya 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 Shippo. 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üşterilerin bu bölge için gördüğü ad. Genel Name değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbelleğe alınmış Shippo ücretleri temizlenir. Ayarların üstündeki uyarılar, yöntemin hiçbir zaman gösterilemeyeceğini veya canlı ücretlerin kullanılamayacağını bildirir: API token'ı yoksa, gönderen posta kodu veya ülkesi yoksa ya da döviz kuru eksikse. Test token'ı ayarlandığında bir bildirim hatırlatır.

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, kendi Title değeriyle bunu geçersiz kılabilir. Varsayılan: Shippo Shipping.

Shippo hesabı

API token: Shippo API token'ınız. Canlı mağazada gerçek ücretler için canlı token'ı (shippo_live_...) veya Shippo test ücretleri için test token'ını (shippo_test_...) kullanın.

Allowed carriers / services: isteğe bağlı, virgülle ayrılmış. Bir kargo firmasını Shippo'nun adlandırdığı şekilde (USPS, UPS, FedEx, DHL Express) veya bir Shippo hizmet seviyesi token'ını (usps_priority, ups_ground) girin. İzin verilen en ucuz ücret gösterilir. Herhangi bir kargo firmasının en ucuz ücretini göstermek için boş bırakın.

Ship from (paketlerinizin gönderildiği adres; boş alanlar, aynı ülkedeyse WooCommerce > Settings > General altındaki mağaza adresinden doldurulur)

Sender name / company: gönderici adı. Gümrük beyannamesini imzalamak için de kullanılır.

Street address: göndericinin sokak adresi.

City: göndericinin şehri.

State / province: iki harfli eyalet kodu, örneğin CA veya NY. Bazı kargo firmaları bunu gerektirir.

Postal / ZIP code: canlı ücretler için zorunludur.

Country: gönderim yaptığınız ülke. Varsayılan: United States.

Ücretler

Parcels: sepetin Shippo'ya nasıl gönderileceği.

Default box size: mağaza ölçü biriminizde uzunluk x genişlik x yükseklik, örneğin 30 x 20 x 10. Shippo kutu boyutunu gerektirir. Sepetteki bir ürünün ölçüsü yoksa kullanılır. 30 x 20 x 10 cm kullanmak için boş bırakın.

Shippo rate currency: Shippo'nun kargo firmalarınızı fiyatlandırdığı para birimi; gönderim ülkesinin para birimidir: USD (ABD), CAD (Kanada), GBP (Birleşik Krallık), EUR (Euro bölgesi) veya AUD (Avustralya). Varsayılan: USD. Shippo'nun mağaza para biriminde döndürdüğü ücretler her zaman olduğu gibi kullanılır.

Exchange rate: Shippo rate currency biriminin 1 birimi için mağaza para biriminizdeki fiyat, örneğin 0.92. İki para birimi aynıysa gerekmez. Bu olmadan diğer para birimindeki ücretler kullanılmaz ve yedek fiyatlar uygulanır. Eklenti para birimlerini otomatik olarak çevirmez.

Tax status: Taxable, WooCommerce'in vergi kurallarınıza göre kargoya vergi eklemesine izin verir; None eklemez. Shippo ücretleri satış vergisi içermez.

Yedek fiyatlar (canlı ücret olmadığında kullanılır: API token'ı yok, Shippo'ya ulaşılamıyor, token reddedildi veya adres için kargo firması ücreti yok; fiyatlar mağaza para biriminde; bu durumda yöntemi gizlemek için iki alanı da boş bırakın)

Country prices: ülkeye ve sepet ağırlığına göre bir fiyat tablosu. Satır eklemek için + Add country'ye, satır silmek için çarpıya tıklayın. Sütunlar Price ile XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg üzeri) ağırlık kademeleridir. Boş veya 0 olan kademe Price sütununu kullanır. * Default satırı, kendi satırı olmayan ülkeler için geçerlidir. Yeni bir satır * Default olarak başlar. Tüm hücreleri boş kaydedilen bir satır 0 ücret alır; bu yüzden doldurmadığınız satırları silin.

Other countries: yukarıdaki tabloda olmayan ülkeler için fiyat (* Default satırı yoksa). Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Koşullar

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı. Bu durumda Shippo'ya istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı en az bu tutardaysa gösterir. Her zaman göstermek için boş bırakın.

Minimum weight (kg): bu yöntemin gösterilmesi için gereken en düşük sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): bu sepet ağırlığının üzerinde yöntem gizlenir. Varsayılan: 30. 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öntem bir bölgeye eklenmiş olsun ya da olmasın, aşağıdaki ülkeler için sunar.

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: Shippo isteklerini WooCommerce > Status > Logs altında, vfd-shippo kaynağıyla günlüğe kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API token'ı ve müşteri adresleri hiçbir zaman kaydedilmez.

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ı asla 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 Shippo'ya istek gönderilmez.

Ardından eklenti Shippo'ya gönderen adresi, müşterinin adresini ve paketi gönderir. WooCommerce'in posta kodu istediği ülkelerde istek, müşteri posta kodunu girene kadar bekler. Uluslararası gönderilerde, ürün adları, adetleri, ağırlıkları ve değerleriyle birlikte bir gümrük beyannamesi eklenir. Shippo, kargo firmalarınızın ücretlerini döndürür ve eklenti, izin verilen en ucuz ücreti yöntem adının altında mağaza para biriminde gösterir.

Sipariş başına modda ürünler tek bir kutuya yerleştirilir: en büyük ürünlerin en uzun ve orta kenarları ile tüm birimlerin en kısa kenarları toplanır. Herhangi bir ürünün ölçüsü yoksa tüm paket için varsayılan kutu boyutu kullanılır. Ürün başına modda her ürün ayrı bir paket olarak ücretlendirilir ve ücret, adetle çarpılır.

Her yanıt, adres ve paket başına 1 saat önbelleğe alınır. Shippo kullanılabilir bir ücret olmadan yanıt verirse adres 10 dakika boyunca hatırlanır. Zaman aşımı, reddedilen token, sunucu hatası veya istek sınırından sonra eklenti 5 dakika boyunca istekleri duraklatır ve yedek fiyatları kullanır. İstek zaman aşımı 10 saniyedir.

Canlı ücret yoksa fiyat önce yedek tablodan, sonra Other countries'dan alınır. İkisi de geçerli değilse yöntem gizlenir. Müşteri hiçbir zaman hata görmez.

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 ücretleri hesaplar. Etiket satın almaz, paketleri takip etmez, adresleri doğrulamaz; teslim alma veya bırakma noktaları, sigorta, imza seçenekleri veya iade etiketleri sunmaz. Yalnızca izin verilen en ucuz ücret gösterilir, tüm hizmetlerin listesi değil. Yukarıda açıklanan birleştirme dışında kutu paketleme yoktur; ücret artırımı veya işlem ücreti de yoktur.

Siparişler

Siparişin kargo satırı seçilen Carrier / service bilgisini ve sipariş başına bir paket için Estimated delivery days bilgisini saklar. Bunları yönetici sipariş ekranında görürsünüz ve Shippo'da ilgili etiketi satın alabilirsiniz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Shippo sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu) ve alan adınızı gösterir. 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Alan adı hakkını vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Shippo, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) ibaresiyle görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler 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

Shippo ö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 (veya Ignore shipping zones açık olmalı ve ülke izinli olmalıdır). Ağırlık sınırlarını, Minimum subtotal ve Disabled shipping classes ayarlarını kontrol edin. Canlı ücret yoksa ülke, * Default veya Other countries için bir fiyat olup olmadığını kontrol edin.

Canlı ücretler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, vfd-shippo kaynağını açın. Yaygın nedenler: API token'ı veya gönderen posta kodu yok, mağaza para birimi, döviz kuru olmadan Shippo rate currency'den farklı, müşterinin posta kodu henüz girilmemiş, Shippo hesabınızdaki hiçbir kargo firması adrese hizmet vermiyor veya Shippo hesabı henüz doğrulanmamış.

Canlı mağazada test ücretleri: test token'ı (shippo_test_...) Shippo test ücretlerini döndürür. Canlı token'ı (shippo_live_...) kullanın.

Beklenmeyen ülkeler için ücretsiz kargo: fiyat tablosunda boş bir satır olup olmadığını kontrol edin, özellikle boş bir * Default satırını. Tüm hücreleri boş olan bir satır 0 ücret alır.

Bir değişiklikten sonra ücretler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış Shippo ücretlerini temizler.

Geliştiriciler için: vfd_shpo_shipment_request, vfd_shpo_customs_declaration, vfd_shpo_selected_rate ve vfd_shpo_api_url filtreleri istek gövdesini, gümrük beyannamesini, seçilen ücreti ve API 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 alan adı hakkını 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 tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbelleğe alınmış ücretler 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ır. Mevcut siparişler kargo satırlarını korur.

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