VibeFox CTT for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

CTT e-ticaret hesabı (yalnızca canlı fiyatlar ve CTT noktaları için): canlı fiyatlar ve CTT noktasına teslimat, CTT e-ticaret API'sini kullanır. enviosecommerce.ctt.pt adresinde bir CTT e-ticaret hesabına ihtiyacınız vardır (CTT Expresso sözleşmesi olan müşteriler için; ya da CTT'den teklif isteyin). Bu hesabın anahtar yönetimi sayfasında bir genel ve özel anahtar çifti oluşturun. App ID (X-APPID), entegrasyonunuz için CTT tarafından verilir: CTT e-ticaret yetkilinize sorun. CTT ayrıca App ID'nizin hangi API işlevlerini (maliyet tahmini, CTT noktaları) kullanabileceğine karar verir. Son olarak, hesabınızdaki CTT Carrier ID'sine ihtiyacınız vardır. Anahtarlar kaydedildikten sonra ayarlar sayfası hesabınızın taşıyıcılarını listeler. Yalnızca fiyat tablosunu ve eve teslimatı kullanıyorsanız API anahtarlarına ihtiyacınız yoktur.

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_ctt 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 CTT 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. Fiyat tablosunu doldurun (en az bir Portugal veya * Default satırı). İsterseniz CTT API anahtarlarını ve Carrier ID'yi girin ve Live rates seçeneğini açın (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde Portekiz için bir bölge açın veya oluşturun ve VibeFox CTT ekleyin. Yöntem ayarlarında başlığı ve teslimat türünü seçin. Ya da Ignore shipping zones seçeneğini açın ve ülkeleri seçin.

Yapılandırma

Fiyatlar, API anahtarları ve koşullar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox CTT. Bunlar her kargo bölgesi için geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde iki alan bulunur:

Title (zone): bu bölgede ödeme sayfasında bu seçeneğin adı. Genel Name değerini kullanmak için boş bırakın.

Delivery: To the customer's address (varsayılan) veya To a CTT point or parcel locker chosen at checkout. Bir CTT noktası, genel ayarlarda CTT API anahtarlarını ve Carrier ID'yi gerektirir. Eve teslimat ile CTT noktası teslimatını yan yana sunmak için yöntemi bir bölgeye iki kez ekleyin.

Ayarların üstündeki uyarılar; Portekiz için eksik fiyatı, eksik API anahtarlarını, eksik Carrier ID'yi, döviz kurunu olmayan mağaza para birimini ve CTT API'sine başarısız bağlantıyı bildirir. Ayarları her kaydettiğinizde, önbelleğe alınmış CTT yanıtları temizlenir.

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ı, örneğin "CTT Expresso". Varsayılan: CTT. Bir bölgenin Title değeri bunu geçersiz kılar.

Tax status: Taxable fiyatın üzerine WooCommerce kargo vergisini (örneğin IVA) ekler; None fiyatın kesin olduğu anlamına gelir.

CTT e-ticaret API'si (canlı fiyatlar, CTT noktaları) (isteğe bağlı; anahtarlar olmadan fiyat tablosu kullanılır)

Public key: CTT e-ticaret hesabınızın anahtar yönetimi sayfasındaki genel anahtar.

Private key: her isteği imzalamak için kullanılan gizli anahtar (HMAC-SHA256). CTT'ye hiçbir zaman gönderilmez ve günlüğe yazılmaz.

App ID (X-APPID): entegrasyonunuz için CTT tarafından verilen uygulama anahtarı.

Carrier ID: hesabınızdaki CTT taşıyıcısının ID'si; canlı fiyatlar ve CTT noktası araması için kullanılır. Anahtarlar kaydedildikten sonra hesabınızdaki taşıyıcılar alanın altında listelenir; CTT noktalarını destekleyenler işaretlenir.

Live rates: müşteri sokağı, posta kodunu ve şehri girdikten sonra CTT'den fiyat (maliyet tahmini) ister. Adres eksik olduğu sürece ve CTT fiyat vermediğinde fiyat tablosu kullanılır. CTT bu fiyata tahmin der. Varsayılan: kapalı.

Service ID: isteğe bağlı. CTT birden fazla hizmet döndürdüğünde, bu ServiceId'ye sahip olan kullanılır. En ucuzunu kullanmak için boş bırakın.

Exchange rate: CTT fiyatları euro cinsindendir. Mağaza para biriminiz farklıysa, 1 CTT para birimi biriminin kaç mağaza para birimi birimine eşit olduğunu girin. Bu olmadan, başka bir para birimindeki canlı fiyatlar kullanılmaz ve fiyat tablosu geçerli olur.

Default product size (cm): boyutu olmayan ürünler için CTT'ye gönderilen uzunluk x genişlik x yükseklik. Varsayılan: 30x20x15. Boyutları olan ürünler kendi boyutlarını kullanır. Boyutlar cm'ye, ağırlıklar ise mağazanızın birimlerinden gram'a çevrilir.

Fiyatlar (bölüm başlığı mağaza para biriminizi gösterir)

CTT sözleşmenizin veya CTT'nin genel fiyat listesinin fiyatlarını mağaza para biriminde girin. Canlı fiyatlar kapalıyken bu tablo fiyatı belirler. Canlı fiyatlar açıkken ise yedek fiyat olarak kullanılır.

Price table: hedef başına bir satır. Bir ülke, Portugal - Azores (PT-AC), Portugal - Madeira (PT-MA) veya * Default (other destinations) seçin. Her satırın bir temel fiyatı (Price) ve XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg'ın üzeri) boyutları için isteğe bağlı fiyatları vardır. Boş (veya 0) bir boyut fiyatı temel fiyatı kullanır. İkisi de boş olan bir satır yöntemi gizler. Azor Adaları satırı 9500-9999 arası Portekiz posta kodları için, Madeira satırı (Porto Santo dahil) 9000-9499 için kullanılır. Bunlar yoksa Portugal satırı geçerli olur. Satır eklemek için + Add destination düğmesine, silmek için çarpı işaretine tıklayın. Fiyatlar nokta veya virgül ondalık ayırıcısını kabul eder. Geçersiz satırlar kaydederken bildirilir.

Calculation: tablo fiyatının nasıl bulunduğu.

Canlı bir CTT fiyatı her zaman tüm gönderi içindir.

Koşullar

Min weight (kg): yöntemin görünmesi için gereken minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet ağırlığı bunun üzerindeyse yöntem gizlenir. Varsayılan: 30 (CTT paketleri 30 kg'a kadar). 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergilerden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir ürün bu WooCommerce kargo sınıflarından birine aitse yöntemi gizler.

Ücretsiz kargo

Free shipping: aşağıdaki tutardan itibaren CTT ücretsiz teslimatını açar.

Free shipping from: bu yöntemin 0 maliyetli olduğu sepet ara toplamı (indirimlerden sonra, vergilerden önce). Yalnızca yöntemin bir fiyatı olduğu yerlerde geçerlidir. Yalnızca Free shipping açıkken kullanılır.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: müşterinin bölgesi yöntemi içermediğinde, yöntemi aşağıdaki ülkelerde sunar.

Countries: bu mod için hedef ülkeler. Varsayılan: Portugal. Teslimat yaptığınız tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamasını ve CTT API çağrılarını WooCommerce > Status > Logs altında, kaynak vfd-ctt ile kaydeder. CTT API hataları, bu kapalı olsa bile her zaman kaydedilir. Anahtarlar, jetonlar ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıkken eklentiyi silmek, ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir zaman veri silmez. Siparişler hiçbir zaman değiştirilmez.

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

Müşteri bir teslimat adresi girdiğinde, WooCommerce eklentiden bir fiyat ister. Eklenti önce sepet ağırlığını, minimum sipariş tutarını ve hariç tutulan kargo sınıflarını kontrol eder. Live rates açıkken ve adres tamamsa, CTT'ye teslimat adresini ve sepet satırı başına miktarı, gram cinsinden ağırlığı ve cm cinsinden boyutları gönderir, ardından dönen fiyatı gösterir. Aksi halde veya CTT fiyat vermediğinde (API hatası, zaman aşımı, kapsama yok, App ID'niz için etkinleştirilmemiş bir işlev), fiyat tablodan gelir. Ücretsiz kargo geçerliyse fiyat 0 olur.

Bir CTT fiyatı 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 5 dakika hatırlanır; böylece ödeme sayfası her yenilemede CTT'yi beklemez. API zaman aşımı 12 saniyedir.

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

API anahtarları doldurulduğunda, eklenti fiyat veya en yakın CTT noktalarını almak için CTT'ye teslimat adresini, ürün ağırlıklarını ve boyutlarını ve mağaza URL'nizi gönderir.

Eklenti gönderi oluşturmaz, etiket yazdırmaz, kargo alımı talep etmez, takip numarası sağlamaz veya CTT noktalarının haritasını göstermez. Tüm mağaza için tek bir fiyat tablosu ve tek bir API ayarları grubu vardır. Bölgeler başlık ve teslimat türüne göre farklılaşır.

Teslim noktaları

Delivery ayarı bir CTT noktası olarak belirlenmiş bir bölge yöntemi için, ödeme sayfasında yöntemin altında bir arama alanı ve bir liste görünür. Teslimat adresi otomatik olarak aranır. Müşteri posta kodu veya şehre göre diğer CTT noktalarını arayabilir ve siparişi vermeden önce birini seçmelidir. Bu, sunucu tarafında da kontrol edilir. CTT nokta listeleri 6 saat önbelleğe alınır. CTT'ye ulaşılamazsa müşteri bir mesaj görür ve daha sonra tekrar deneyebilir ya da başka bir kargo yöntemi seçebilir.

Seçilen nokta siparişe kaydedilir. Sipariş yönetim ekranında teslimat adresinin altında, sipariş alındı sayfasında, My account > Orders bölümünde ve sipariş e-postalarında (HTML ve düz metin) CTT point olarak gösterilir.

Sipariş yönetim ekranında, CTT noktasının yanındaki Change düğmesine tıklayın, posta kodu veya şehre göre arama yapın ve başka bir nokta seçin. Değişiklik hemen kaydedilir ve siparişe bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarı ile çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox CTT 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan CTT, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri hâlâ görür; bunlar (unlicensed — visible to admins only) ile işaretlenir. 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 sona erdiğinde eklenti çalışmaya devam eder; ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

CTT ö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 olmalı ve ülke izinli olmalıdır). Hedefin fiyat tablosunda bir satırı (ya da bir * Default satırı) olduğunu, sepet ağırlığının Min weight ile Max weight arasında olduğunu, Minimum order amount tutarına ulaşıldığını ve hiçbir ürünün hariç tutulan bir kargo sınıfına ait olmadığını kontrol edin.

Müşteri bir CTT noktası seçemiyor: seçici yalnızca Delivery ayarı bir CTT noktası olan bir bölge yöntemi için görünür ve yalnızca genel anahtar, özel anahtar, App ID ve Carrier ID doldurulduğunda görünür. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünü kontrol edin.

Canlı fiyatlar görünmüyor: müşteri sokağı, posta kodunu ve şehri girene kadar fiyat tablosu kullanılır. Ayarların üstündeki uyarıları ve günlüğü kontrol edin. "405" yanıtı, işlevin App ID'niz için etkinleştirilmediği anlamına gelir: CTT'ye sorun. Euro kullanmayan bir mağazada Exchange rate alanını doldurun.

CTT API bağlantısı başarısız oldu: ayarların üstündeki uyarı hatayı gösterir. Anahtarları ve App ID'yi kontrol edin. Eklenti birkaç dakika sonra otomatik olarak yeniden dener.

KDV dahil veya hariç fiyatlar: Tax status Taxable olduğunda WooCommerce kargo vergisini fiyatın üstüne ekler. None olduğunda fiyat kesindir.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin, anahtar zaten başka bir alan adında kullanılıyorsa, vibefox.net hesabınızda bir yuva 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır; önbelleğe alınmış CTT yanıtları ve API jetonu da öyle. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde, daha sonra yeniden kurulum için saklanır. Seçilen CTT noktası dahil siparişler hiçbir zaman değiştirilmez ve mevcut siparişler kendi kargo satırlarını korur.

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