VibeFox Packeta for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Packeta API anahtarı: Packeta müşteri bölümünde (client.packeta.com), Client support altında bulabilirsiniz. 16 harf ve rakamdan oluşur. Widget'ın ödeme sayfasında açılabilmesi için bu anahtara ihtiyacı vardır; bu nedenle kargo firması, müşterilere ancak API anahtarı girildikten sonra gösterilir.

Ülkeler: Çek Cumhuriyeti, Slovakya, Macaristan veya Romanya, mağazanızın etkin ülkeleri olmalı ve kargo firmasının bağlı olduğu bir bölgede yer almalıdır.

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 Packeta modülünü bulup Configure düğmesine tıklayın.

3. Yapılandırma sayfasının üst kısmındaki lisans bloğunda License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Packeta API key değerinizi ve fiyatlarınızı girin: en az bir Country prices satırı (örneğin * Default) veya bir Fallback cost. Save düğmesine tıklayın. Sayfa, Packeta'nın anahtarı kabul edip etmediğini gösterir.

Kurulumda modül, Packeta pickup point kargo firmasını Packeta pickup point or Z-BOX teslimat süresi metniyle oluşturur. Bu firma Çek Cumhuriyeti, Slovakya, Macaristan ve Romanya bölgelerine ve tüm müşteri gruplarına bağlanır. Bölgeleri, müşteri gruplarını, teslimat süresini ve logoyu Shipping > Carriers üzerinden değiştirebilirsiniz. Fiyatları orada belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Packeta > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder.

Kargo firması yalnızca Packeta'nın kendi teslim noktası ağının ülkeleri için sunulur: CZ, SK, HU ve RO. Ayarların üstünde sayfa, API anahtarı kontrolünün sonucunu ve sorunlara dair uyarıları gösterir: API anahtarı yok, fiyat yok, seçilen ülkeler Packeta ağının dışında, kargo firması eksik veya modülün tanımadığı bir mağaza ağırlık birimi.

Tüm fiyatlar ve sınırlar, ondalık ayırıcı olarak virgül veya nokta kabul eder (4,99 veya 4.99). Geçersiz veya negatif bir sayı bir mesajla reddedilir ve önceki değer korunur.

Genel

Enable/Disable: ödeme sürecinde Packeta'yı açar veya kapatır.

Name: müşterinin gördüğü kargo firması adı. Aynı zamanda Shipping > Carriers içindeki kargo firması adıdır. Varsayılan: Packeta pickup point. Zorunlu, en fazla 64 karakter.

API key: client.packeta.com > Client support bölümündeki Packeta API anahtarınız. 32 karakterlik API şifresini de yapıştırabilirsiniz: yalnızca API anahtarı olan ilk 16 karakter kaydedilir. API anahtarı herkese açıktır: widget'ı açmak için müşterinin tarayıcısına gönderilir. Yeni bir anahtar kaydettiğinizde Packeta kargo firması beslemesine karşı kontrol edilir ve sayfa Packeta API key verified mesajını veya Packeta'nın anahtarı reddettiğini gösterir. Kontrol yapılamazsa anahtar kaydedilir ve bir sonraki kaydetmede yeniden kontrol edilir.

Widget language: teslim noktası widget'ının dili. Store / visitor language (varsayılan) sayfanın dilini izler. Ayrıca Çekçe, Slovakça, Macarca, Rumence, İngilizce, Almanca, Lehçe veya Ukraynaca olarak sabitleyebilirsiniz.

Pickup point types: widget'ın sunduğu Packeta noktaları.

Tax status: kargo fiyatına uygulanan vergi kuralları. None (no tax on shipping) veya vergi kuralı gruplarınızdan biriyle Taxable. Seçim kargo firmasına kaydedilir.

Fiyatlar

Packeta'nın herkese açık bir ücret API'si yoktur. Fiyatlar bu tablodan gelir ve mağazanızın varsayılan para biriminde, vergi hariç girilir. Başka bir para birimiyle ödeme yapan müşteriler dönüştürülmüş fiyatı görür.

Calculation type: Per order fiyatı bir kez uygular. Per item (price x quantity) fiyatı sepetteki fiziksel ürün adediyle çarpar.

Country prices: hedef ülke ve paket ağırlığı başına bir fiyat. Satır eklemek için Add country düğmesine, satır silmek için çarpı işaretine tıklayın. Her satırda bir Price ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg ve XL 5 kg'ın üzeri. 0 bırakılan bir ağırlık sütunu Price sütununu kullanır. * Default satırı, kendi satırı olmayan ülkeler için kullanılır. Yeni bir satır, tüm fiyatları 0 olan bir * Default satırı olarak başlar; bu da ücretsiz kargo anlamına gelir. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı silin. Aynı ülke (veya * Default) iki satırda yer alırsa, kaydederken yalnızca ilki korunur. Tablodaki bir değer geçerli bir sayı değilse tablo kaydedilmez ve sayfa hatalı değerleri listeler.

Fallback cost: hedef için ülke tablosunda satır yoksa ve bir * Default satırı da yoksa kullanılır. Bu durumda kargo firmasını sunmamak için boş bırakın.

Free shipping from: Packeta teslimatının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi hariç). Fiyat tablosundan önce kontrol edilir: bu tutardan itibaren, kargo firmasının sunulduğu her Packeta ülkesinde teslimat ücretsizdir; satırı veya yedek ücreti olmayan bir ülke de dahildir. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Kullanılabilirlik

Minimum weight (kg): sepet bundan hafifse kargo firmasını gizler. Sepet ağırlığı mağazanızın ağırlık biriminden dönüştürülür. Boş veya 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan ağırsa kargo firmasını gizler. Varsayılan: 15. Packeta teslim noktaları ve Z-BOX'lar genellikle 15 kg'a kadar paketleri kabul eder; Packeta sözleşmenizi kontrol edin. Boş veya 0, sınır olmadığı anlamına gelir. Maksimumdan büyük bir minimum ağırlık kaydetmede reddedilir ve iki önceki değer korunur.

Minimum cart subtotal: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergi hariç) bu tutara ulaştığında sunar.

Ignore shipping zones: açıkken kargo firması tüm bölgelere bağlanır ve aşağıda seçilen ülkeler için sunulur. Sonradan oluşturulan bölgeler hemen bağlanır. Kapatıldığında kargo firması daha önce sahip olduğu bölgeleri geri alır. Kapalıyken kargo firması yalnızca Shipping > Carriers içinde kargo firması için belirlenen bölgelerde sunulur.

Countries (ignore zones mode): bu mod için hedef ülkeler. Tüm Packeta ülkelerini kullanmak için boş bırakın. Packeta teslim noktası ağının dışındaki ülkeler atlanır. Birden fazla seçmek için Ctrl tuşunu basılı tutarak tıklayın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını ve teslim noktası seçimlerini modules/vfd_packeta/logs/ klasörüne yazar. Dosya web üzerinden açılamaz. Müşterilerin kişisel verileri ve API anahtarı kaydedilmez. Hatalar ve başarısız API anahtarı kontrolleri her zaman kaydedilir. İşiniz bittiğinde günlüğü kapatın.

Log (last lines): hata ayıklama günlüğünün son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak ayarları ve günlüğü siler. Siparişlerde kayıtlı teslim noktası her zaman korunur.

Ödeme sürecinde nasıl çalışır

Kargo adımında PrestaShop, modülden Packeta fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül koşulları kontrol eder: teslimat ülkesi Packeta ağında mı, API anahtarı, bölgeleri yok sayma modunda ülke listesi, sepet ağırlığı ve minimum sepet ara toplamı. Ücretsiz kargo uygulanıyorsa fiyat 0'dır. Aksi halde fiyat ülke tablosundan, ardından yedek ücretten gelir. Fiyat yoksa kargo firması gizlenir.

Müşteri Packeta kargo firmasını seçtiğinde, firmanın altında Choose pickup point düğmesi belirir. Bu düğme, müşterinin tarayıcısında resmi Packeta widget'ını hedef ülke, sepet ağırlığı, seçilen nokta türleri ve widget dili ile açar. Müşteri bir nokta seçtikten sonra, adı ve adresi kargo firmasının altında gösterilir ve düğme Change pickup point olur. Nokta sepetle birlikte kaydedilir ve sayfa yeniden yüklendiğinde korunur. Başka bir ülke için seçilmiş bir nokta, teslimat adresi değiştiğinde kaldırılır.

Sunucunuz ödeme sırasında Packeta'dan hiçbir şey istemez. Widget betiği widget.packeta.com'dan yüklenir. Bu betik engellenirse (bir reklam veya gizlilik engelleyicisi, içerik güvenlik politikası ya da Packeta kesintisi nedeniyle), müşteri şu mesajı görür: "The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method."

Kargo firmasında siparişler olduktan sonra Shipping > Carriers içinde düzenlerseniz, PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül, yeni sürümü otomatik olarak izler.

Packeta fiyatları canlı olarak istenmez; tablonuzdan gelir. Modül Packeta gönderileri oluşturmaz, etiket yazdırmaz veya koli takibi yapmaz; ayrıca varsayılan olarak adrese teslimat veya ortak kargo firmalarının teslim noktalarını sunmaz. Siparişteki teslim noktası kimliğini, alışageldiğiniz yolla Packeta'ya aktarın; örneğin client.packeta.com üzerinden içe aktarma ile.

Teslim noktaları

Teslim noktası zorunludur. Müşteri kargo adımında bir nokta seçmeden Continue düğmesine tıklarsa, adım tamamlanmaz ve müşteri şu mesajı görür: "Please choose a Packeta pickup point." Seçilen nokta teslimat adresinden farklı bir ülkedeyse, müşteri şu mesajı görür: "The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again." Modül nokta kimliğini Packeta ile doğrulamaz; yalnızca bir noktanın seçildiğini ve ülkesinin eşleştiğini kontrol eder.

Nokta, sipariş oluşturulduğunda siparişe eklenir:

Yönetim panelindeki sipariş sayfası: ad, adres, Pickup point ID ve ülkeyi içeren bir Packeta pickup point bloğu. Bir Packeta siparişinde nokta yoksa blok şu mesajı gösterir: "No pickup point was selected for this order."

Sipariş onay ve sipariş ayrıntıları sayfaları: Packeta pickup point: ad ve adresle birlikte.

Sipariş e-postaları: sipariş onay e-postasında kargo firmasına nokta adı ve adresi eklenir. Satıcıya giden yeni sipariş e-postası ayrıca Pickup point ID bilgisini içerir.

Nokta, modülün vfd_pckt_point tablosunda saklanır (sepet, sipariş, nokta kimliği, ad ve adres, ülke).

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Packeta lisans bloğu, Modules > Module Manager > VibeFox Packeta > 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 Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-shipping-packeta satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan ç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 veya hesabınızdaki 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Packeta kargo firması ödeme sırasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez; bu nedenle kargo firması sizin için de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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 için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtarın girilmesinden sonraki ilk 14 gün 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

Packeta ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, API key alanının girildiğini ve teslimat ülkesinin CZ, SK, HU veya RO olduğunu kontrol edin. Ülke için bir fiyatın tanımlı olduğunu (ülke satırı, * Default satırı veya Fallback cost), ağırlık ve ara toplam sınırlarını ve kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu Shipping > Carriers içinde kapsadığını kontrol edin (veya Ignore shipping zones açık olmalıdır). Ürün sayfasında ürünler belirli kargo firmalarıyla da sınırlandırılmış olabilir. Ayarlar sayfasının üst kısmında yapılandırma sorunları listelenir. Nedeni Log (last lines) içinde görmek için Debug log seçeneğini açın.

Packeta API anahtarını reddetti: API anahtarını client.packeta.com > Client support bölümünden yeniden kopyalayın ve kaydedin. O zamana kadar widget ödeme sayfasında açılamaz.

Widget açılmıyor: Packeta betiği bir reklam veya gizlilik engelleyicisi, içerik güvenlik politikası ya da Packeta kesintisi tarafından engellenmiştir. İçerik güvenlik politikanızda widget.packeta.com alan adına izin verin. Geliştiriciler betik URL'sini actionVfdPcktWidgetUrl kancasıyla değiştirebilir.

Kargo yanlışlıkla ücretsiz: Country prices içinde Price değeri 0 olan satırları kontrol edin; özellikle Add country ile eklenip doldurulmamış bir * Default satırını ve Free shipping from alanını kontrol edin.

Ağırlık sınırları veya ağırlık sütunları yanlış görünüyor: sayfa mağazanın ağırlık biriminde uyarı veriyorsa, International > Localization (Local units) bölümünde kg, g, lb veya oz seçin. Diğer birimler kilogram olarak okunur.

Diğer ülkeler veya kargo firmaları: kutudan çıktığı haliyle kargo firması CZ, SK, HU ve RO için çalışır. Geliştiriciler actionVfdPcktCountries kancasıyla ülke ekleyebilir ve actionVfdPcktWidgetOptions kancasıyla kargo firması kimliklerini widget'a iletebilir.

Sayfa Packeta kargo firmasının eksik olduğunu söylüyor: kargo firması Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Packeta yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Packeta kargo firması her zaman kaldırılır (siparişler kendi kargo firmalarını korur), kayıtlı API anahtarı kontrolü sonucuyla birlikte. Remove data on uninstall açıksa ayarlar, günlük ve hiçbir zaman siparişe dönüşmemiş sepetlerin teslim noktaları silinir. Kapalıysa ayarlar yeniden kurulum için saklanır; yeniden kurulumda kargo firması tekrar oluşturulur. Mevcut siparişler her zaman kayıtlı teslim noktasını korur.

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