VibeFox CTT for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

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ı gerekir (CTT Expresso sözleşmeli müşteriler için veya CTT'den bir 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 yetkilinizden isteyin. 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. Ayarlar sayfası, anahtarlar kaydedildikten sonra hesabınızdaki kargo firmalarını listeler. Yalnızca fiyat tablosunu ve adrese teslimatı kullanıyorsanız API anahtarlarına ihtiyacınız yoktur.

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

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox CTT'yi bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda, License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Fiyat tablosunu doldurun (en az bir Portugal veya * Default satırı) ve Save düğmesine tıklayın. İsteğe bağlı olarak CTT API anahtarlarını ve Carrier ID'yi girin, Live rates ve Enable CTT point carrier seçeneklerini açın (bkz. Yapılandırma).

Kurulumda modül iki kargo firması oluşturur. CTT (müşterinin adresine teslimat, teslimat süresi metni CTT delivery to your address) açık durumdadır. CTT point / parcel locker (teslimat süresi metni Pickup at a CTT point or parcel locker) siz açana kadar kapalıdır. İkisi de Portekiz bölgesine ve tüm müşteri gruplarına bağlıdır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox CTT > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Fiyatlar ve koşullar iki CTT kargo firmasına da uygulanır. Her kayıt, API belirteci ve CTT noktası listeleri dahil olmak üzere önbelleğe alınmış CTT yanıtlarını temizler.

Ayarların üstündeki uyarılar; boş fiyat tablosu, Portekiz için eksik fiyat, eksik API anahtarları, eksik Carrier ID, EUR dışında bir mağaza para birimi ve döviz kuru olmadan, CTT API bağlantı hatası ve silinmiş bir CTT kargo firması hakkında bilgi verir. Geçersiz değerler kaydedilirken bildirilir: geçersiz bir sayı kaydedilmez, bilinmeyen bir hedef veya fiyat tablosundaki yinelenen bir satır kaldırılır. Mağazanızın ağırlık veya boyut birimi modül tarafından bilinmiyorsa, bir uyarı birimleri International > Localization (Local units) bölümünde ayarlamanızı ister.

Genel

Enable/Disable: müşterinin adresine CTT teslimatını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Name: ödeme sayfasında müşteriye gösterilen kargo firması adı, örneğin "CTT Expresso". Varsayılan: CTT. Zorunlu, en fazla 64 karakter.

Tax status: None, fiyatların kesin olduğu anlamına gelir. Bir vergi kuralıyla birlikte Taxable, PrestaShop'un fiyatların üzerine bu kargo vergisini (örneğin IVA) eklediği anlamına gelir. Seçim her iki CTT kargo firmasına da kaydedilir.

CTT noktasına veya paket dolabına teslimat

İkinci CTT kargo firması. Müşteri posta kodu veya şehre göre CTT noktalarını arar ve devam etmeden önce bir nokta seçmelidir. CTT API anahtarlarına ve Carrier ID'ye ihtiyaç duyar. Bunlar olmadan nokta seçimi olmayan bir kargo firmasıdır.

Enable CTT point carrier: CTT nokta kargo firmasını açar veya kapatır. Bu, Shipping > Carriers bölümündeki durumuyla aynı anahtardır. Varsayılan: kapalı.

CTT point carrier name: bu seçeneğin ödeme sayfasındaki adı. Varsayılan: CTT point / parcel locker. Zorunlu, en fazla 64 karakter.

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 asla gönderilmez ve günlüğe yazılmaz.

Her iki anahtar da kaydedildikten sonra bir daha gösterilmez. Alan açıklaması bu durumda Saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Remove the saved public and private key seçeneğini işaretleyip kaydederek ikisini de silin.

App ID (X-APPID): CTT tarafından verilen ve X-APPID başlığında gönderilen uygulama anahtarı.

Carrier ID: hesabınızdaki CTT kargo firmasının kimliği; canlı fiyatlar ve CTT noktası araması için kullanılır. Anahtarlar ve App ID kaydedildikten sonra hesabınızdaki kargo firmaları alanın altında listelenir; CTT noktalarını destekleyenler (CTT points) ile işaretlenir. Yalnızca sayılar.

Live rates: müşteri sokak, posta kodu ve şehri girdikten sonra modül 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ğazanızın varsayılan para birimi farklıysa, CTT para biriminin 1 birimine kaç birim mağaza para biriminin denk geldiğini girin. Bu olmadan başka bir para birimindeki canlı fiyatlar kullanılmaz ve fiyat tablosu uygulanır.

Default product size (cm): boyutları 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 mağazanızın birimlerinden gram'a dönüştürülür.

Fiyatlar (bölüm başlığı mağazanızın varsayılan para birimini gösterir)

CTT sözleşmenizin veya ctt.pt adresindeki CTT genel fiyat listesinin fiyatlarını, mağazanın varsayılan para biriminde ve vergi hariç olarak girin. Canlı fiyatlar kapalıyken bu tablo fiyatı belirler. Canlı fiyatlar açıkken ise yedek fiyattır.

Price table: hedef başına bir satır. Bir ülke seçin: Portugal - Azores (PT-AC), Portugal - Madeira (PT-MA) veya * Default (other destinations). Her satırda temel bir 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 üstü) boyutları için isteğe bağlı fiyatlar bulunur. Boş (veya 0) bir boyut fiyatı temel fiyatı kullanır. İki alanı da boş olan bir satır kargo firmasını gizler. Azores satırı 9500-9999 arasındaki Portekiz posta kodları için, Madeira satırı (Porto Santo dahil) 9000-9499 için kullanılır. Bunlar olmadan Portugal satırı geçerlidir. Satır eklemek için Add destination düğmesine, silmek için çöp kutusu simgesine tıklayın. Fiyatlarda ondalık nokta veya virgül kabul edilir. Tablo kurulumdan sonra boştur.

Calculation: tablo fiyatının nasıl bulunacağı.

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

Koşullar

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

Max weight (kg): bu sepet ağırlığının üzerinde kargo firmaları gizlenir. Varsayılan: 30 (CTT paketleri 30 kg'a kadar gider). 0 sınır olmadığı anlamına gelir. Min weight (kg), Max weight (kg) değerinden büyük olamaz: ayarlar kaydedilmez.

Minimum order amount: kargo firmalarını yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergi öncesi) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Ücretsiz kargo

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

Free shipping from: kargo firmalarının 0 maliyetli olduğu sepet ara toplamı (indirimlerden sonra, vergi öncesi). Yalnızca fiyatı olan hedefler için geçerlidir. Yalnızca Free shipping açıkken kullanılır.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde kargo firmaları, Shipping > Carriers bölümünde bağlı oldukları kargo bölgelerinde sunulur.

Ignore shipping zones: kargo firmalarını aşağıdaki ülkelerde, bölgelerine bağlamadan sunar. Açtığınızda, iki kargo firması da (daha sonra oluşturacağınız bölgeler dahil) tüm etkin bölgelere bağlanır. Kapattığınızda önceki bölgelerine geri döner.

Countries: bu mod için hedef ülkeler. Varsayılan: Portugal. Tüm ülkelere izin vermek için boş bırakın. Yalnızca Ignore shipping zones açıkken kullanılır. Kargo firmalarının önceden bağlı olduğu bölgelerdeki müşteriler her zaman hizmet alır.

Gelişmiş

Debug log: fiyat hesaplamasını ve CTT API çağrılarını modül klasöründeki logs/vfd_ctt_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. CTT API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar, belirteçler ve müşteri adresleri asla günlüğe yazılmaz.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açık olduğunda modülün kaldırılması, modül ayarlarını ve kargo firmalarını siler. Kapalı olduğunda kaldırma yalnızca kargo firmalarını kapatır. Seçilen CTT noktası dahil siparişler asla değiştirilmez.

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

Kargo adımında PrestaShop, her CTT kargo firması için modülden fiyat ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce Ignore shipping zones ve ülkelerini, sepet ağırlığını ve minimum sipariş tutarını kontrol eder. Live rates açıkken ve adres eksiksizken, teslimat adresini ve sepetteki her satır için adet, gram cinsinden ağırlık ve cm cinsinden boyutları CTT'ye gönderir ve dönen fiyatı kullanır. 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'dır. Fiyat mağazanın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

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. API hataları müşteriye asla ulaşmaz: fiyat tablosu kullanılır veya hedefin fiyatı yoksa kargo firması gizlenir.

Shipping > Carriers bölümünde bir kargo firmasını siparişleri olduktan sonra düzenlerseniz, PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

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

Modül gönderi oluşturmaz, etiket yazdırmaz, kargo alımı talep etmez, takip numarası sağlamaz ve CTT noktalarının haritasını göstermez. Her iki kargo firması için tek bir fiyat tablosu ve tek bir API ayarları kümesi vardır.

Teslim noktaları

Müşteri CTT nokta kargo firmasını seçtiğinde, altında bir arama alanı ve bir liste görünür. Teslimat adresinin posta kodu doldurulur ve otomatik olarak aranır. Müşteri, posta kodu veya şehre göre diğer CTT noktalarını arayabilir (Search düğmesi veya Enter) ve listeden birini seçebilir. Seçim hemen sepete kaydedilir. Yalnızca o arama için CTT listesindeki bir nokta kabul edilir.

Müşteri devam etmeden önce bir nokta seçilmelidir. Müşteri kargo adımında Continue düğmesine tıkladığında modül noktayı sunucuda yeniden kontrol eder. Nokta yoksa müşteri Please select a CTT point. mesajını görür; CTT listesinde olmayan bir nokta seçilmişse The selected CTT point is not in the CTT list for this search. Please choose the CTT point again. mesajını görür. CTT nokta listeleri 6 saat önbelleğe alınır. CTT'ye ulaşılamazsa müşteri CTT points cannot be loaded right now. Please try again in a few minutes or choose another shipping method. mesajını görür.

Nokta seçimi Classic ve Hummingbird temalarıyla çalışır. Yalnızca genel anahtar, özel anahtar, App ID ve Carrier ID doldurulduğunda etkindir.

Seçilen nokta siparişe kaydedilir. Yönetim sipariş sayfasında CTT point bloğunda (ad ve ID), sipariş onay sayfasında, müşteri hesabındaki sipariş ayrıntılarında ve sipariş onay e-postasında kargo firması adının yanında CTT point: olarak gösterilir. Mail alerts modülünün yeni sipariş e-postası da nokta ID'sini gösterir.

Yönetim sipariş sayfasında, Change CTT point altına bir posta kodu veya şehir girin, Search düğmesine tıklayın, bir nokta seçin ve Save düğmesine tıklayın. Sayfa CTT point updated. mesajını gösterir ve yeni noktayla birlikte CTT point changed to: özel sipariş mesajı eklenir. Noktayı değiştirmek için siparişleri düzenleme izni gerekir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox CTT lisans bloğu, Modules > Module Manager > VibeFox CTT > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-ctt satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar yoksa CTT kargo firmalarının hiçbiri (adrese veya CTT noktasına teslimat) ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden kargo firmaları sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

CTT ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable (veya Enable CTT point carrier) seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde, kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını ya da Ignore shipping zones açık ve ülkenin izinli olduğunu kontrol edin. Hedefin fiyat tablosunda bir satırı (veya bir * Default satırı) olduğunu, sepet ağırlığının Min weight ve Max weight arasında olduğunu ve Minimum order amount değerine ulaşıldığını kontrol edin. Ürünler ayrıca ürün sayfasında belirli kargo firmalarıyla sınırlandırılmış olabilir.

Müşteri bir CTT noktası seçemiyor: seçici yalnızca CTT nokta kargo firmasının altında görünür ve yalnızca genel anahtar, özel anahtar, App ID ve Carrier ID doldurulduğunda görünür. Ayarların üstündeki uyarıları kontrol edin, Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Canlı fiyatlar görünmüyor: müşteri sokak, posta kodu 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. EUR 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. Modül birkaç dakika sonra otomatik olarak yeniden dener.

KDV dahil veya hariç fiyatlar: Tax status bir Taxable kuralına ayarlandığında PrestaShop, kargo vergisini fiyatın üzerine ekler. None ile fiyat kesindir.

Bir değişiklikten sonra fiyatlar eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış CTT yanıtlarını temizler.

Sayfa bir CTT kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers bölümünde silinmiştir. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın. Sıfırlama, ayarları ve her iki kargo firmasının açık/kapalı durumunu korur.

Geliştiriciler için: CTT API adresi vfd_ctt_API_URL yapılandırma anahtarıyla değiştirilebilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox CTT yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu, önbelleğe alınmış CTT yanıtları ve API belirteci her zaman kaldırılır. Remove data on uninstall açıksa, her iki kargo firması silinir (siparişler geçmişini korur), ayrıca sipariş olmamış sepetlerin ayarları, günlüğü ve CTT noktaları kaldırılır. Kapalıysa, kargo firmaları yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak, her kargo firmasına daha önce sahip olduğu açık/kapalı durumunu geri verir. Siparişlerde kaydedilmiş CTT noktaları her zaman korunur.

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