VibeFox Correos CityPaq for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

İspanya'ya teslimat: CityPaq dolapları yalnızca İspanya'da bulunduğundan, taşıyıcı yalnızca İspanya'daki teslimat adresleri için sunulur.

Correos API kimlik bilgileri (yalnızca canlı dolap listesi için): Correos CityPaq listesi, aktif dolapları Correos "terminals" API'sinden okur. Correos geliştirici portalında "terminals" API'sini açın ve uygulamanız için Request access seçeneğini kullanın. Correos, iş müşterilerinin taleplerini onaylar ve bir client ID ile bir client secret gönderir. Bunlar ayrıca portalda My applications altında da görüntülenir. Müşteriler dolabı kendileri girerse veya sizin listenizden seçerse API kimlik bilgilerine 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. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module seçeneğine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure seçeneğine tıklayın; ya da daha sonra modül listesinde VibeFox Correos CityPaq modülünü bulup Configure seçeneğine tıklayın.

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

4. Fiyat tablosunu doldurun, müşterinin dolabı nasıl seçeceğini belirleyin (bkz. Yapılandırma) ve Save seçeneğine tıklayın.

Kurulum sırasında modül, Correos CityPaq taşıyıcısını Delivery to a Correos CityPaq parcel locker teslimat süresi metniyle oluşturur. Taşıyıcı tüm müşteri gruplarına ve İspanya bölgesine atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını 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 Correos CityPaq > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Fiyatlar ve tutarlar ondalık virgül veya ondalık nokta kabul eder.

Ayarların üstündeki uyarılar; taşıyıcının bulunamadığını, fiyat tablosunda İspanya için satır veya varsayılan satır olmadığını, seçilen dolap seçiminin çalışamayacağını (listenizde dolap yok, API kimlik bilgisi yok), Correos API'sinin son hatasının ne olduğunu ve mağaza ağırlık biriminin modül tarafından bilinmediğini bildirir (bu durumda ürün ağırlıkları kg olarak okunur; International > Localization bölümünde kg, g, lb veya oz seçin). Ad boş, geçersiz veya 64 karakterden uzunsa; bir ağırlık ya da tutar 0 veya daha büyük geçerli bir sayı değilse; ya da Min weight (kg) değeri Max weight (kg) değerinden büyükse sayfa bir hata gösterir ve hiçbir şey kaydedilmez. Fiyat tablosundaki geçersiz fiyatlar ile My lockers içindeki geçersiz veya yinelenen satırlar uyarı olarak bildirilir ve geri kalanı kaydedilir.

Genel

CityPaq dolapları yalnızca İspanya'da bulunduğundan, taşıyıcı diğer ülkeler için hiçbir zaman sunulmaz.

Enable/Disable: Correos CityPaq kargosunu açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Name: müşterinin ödeme sayfasında gördüğü kargo yönteminin adı. Aynı zamanda taşıyıcının adıdır. Varsayılan: Correos CityPaq. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı. PrestaShop, bu vergiyi tablodaki fiyatların üzerine ekler. No tax fiyatların kesin olduğu anlamına gelir.

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

Correos, CityPaq için bir tarife API'si yayımlamadığından fiyat bu tablodan gelir. Correos sözleşmenizdeki fiyatları mağazanın varsayılan para biriminde, vergisiz olarak girin.

Price table: Spain (ES) için bir satır ve/veya bir varsayılan * Default satırı. Her satırda temel 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'dan fazla) paket boyutları için isteğe bağlı fiyatlar bulunur. Boyut fiyatı 0 veya boşsa temel fiyat kullanılır. Satır eklemek için + Add row seçeneğine, satır silmek için çöp kutusu simgesine tıklayın. Eşleşen satır yoksa taşıyıcı gizlenir. Bir ülke iki kez görünürse yalnızca ilk satır kullanılır.

Calculation type: paket boyutunun nasıl belirlendiği.

Ürün ağırlıkları, mağazanızın ağırlık biriminden kg'a çevrilir (örneğin kg, g, lb veya oz).

Koşullar

Min weight (kg): sepet bundan hafifse taşıyıcıyı gizler. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan ağırsa taşıyıcıyı gizler. Varsayılan: 30, çünkü CityPaq 30 kg'a kadar paket kabul eder. 0 sınır olmadığı anlamına gelir.

Minimum order amount: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce) 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 CityPaq teslimatını açar.

Free shipping from: bu taşıyıcının 0 olacağı sepet ara toplamı (indirimlerden sonra, vergilerden önce). Yalnızca Free shipping açıkken kullanılır.

CityPaq dolap seçimi

Bu bölümde resmi Correos CityPaq bulucusuna bağlantı bulunur.

Locker selection: müşterinin siparişi vermeden önce dolabı nasıl seçtiği. Varsayılan: müşteri dolabı girer.

API kimlik bilgisi olmadan Correos listesini veya My lockers boşken kendi listenizi seçerseniz müşterilerden dolabı girmeleri istenir.

My lockers: Locker selection sizin listenize ayarlandığında kullanılır. Her satırda bir dolap: CODE | Name | Address | Postal code | City. Kod ve ad zorunludur. Bir kod iki kez listelenirse yalnızca ilk satır kullanılır.

Correos CityPaq listesi (API) (yalnızca Correos CityPaq listesiyle kullanılır)

Bu bölümde Correos geliştirici portalındaki "terminals" API sayfasına bağlantı bulunur. Yalnızca dolap listesi okunur. Fiyatlar her zaman fiyat tablosundan gelir.

API client ID: Correos geliştirici portalındaki uygulamanızın client_id değeri.

API client secret: Correos geliştirici portalındaki uygulamanızın client_secret değeri.

Kaydettikten sonra iki alan da boş kalır ve Saved - leave empty to keep it yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı client ID ve client secret değerlerini silmek için Remove the saved client ID and client secret kutusunu işaretleyin ve Save seçeneğine tıklayın. Hiçbir şey kayıtlı değilse bölüm No credentials saved yazısını gösterir. Kimlik bilgilerini veya dolap seçimini değiştirdiğinizde önbellekteki dolap listeleri temizlenir.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: adresin bölgesi taşıyıcıyla bağlantılı olmasa bile CityPaq'i her İspanyol adresi için sunar. Açıkken taşıyıcı, daha sonra oluşturulanlar da dahil olmak üzere tüm aktif bölgelere bağlanır. Tekrar kapattığınızda taşıyıcı, önceden sahip olduğu bölgeleri geri alır. Kapalı (önerilir) olduğunda Shipping > Carriers içinde tanımlanan bölgeler kullanılır.

Gelişmiş

Debug log: hata ayıklama satırlarını modül klasöründeki logs/vfd_cpq_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Correos API hataları, bu seçenek kapalı olsa bile her zaman yazılır. Kimlik bilgileri ve kişisel veriler hiçbir zaman günlüğe yazılmaz.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log seçeneğine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak ayarları, taşıyıcıyı, önbellekteki listeleri ve günlükleri siler. Siparişlerde kayıtlı dolaplar korunur. Kapalıyken her şey yeniden kurulum için saklanır.

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

Kargo adımında PrestaShop, modülden CityPaq fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül, teslimat adresinin İspanya'da olduğunu, sepet ağırlığını ve minimum sipariş tutarını kontrol eder, İspanya için fiyat satırını (veya * satırını) ve paket boyutunu bulur ve fiyatı döndürür. Ücretsiz kargo geçerliyse fiyat 0 olur. Fiyat, mağazanızın varsayılan para biriminde hesaplanır ve sonra müşterinin sepet para biriminde gösterilir. Vergi, taşıyıcının vergi kuralıyla eklenir.

Müşteri CityPaq'i seçtiğinde taşıyıcının altında CityPaq locker kutusu belirir. Seçim, müşteri yaptığı anda sepete kaydedilir. Kabul edilemeyen bir dolap bir mesajla reddedilir ve önceki seçim korunur. Correos listesiyle, bir dolap kodu yalnızca Correos bunu aranan posta kodu için sunduysa kabul edilir; adı ve adresi Correos'tan alınır. Bir müşteri sepet başına en fazla 30 farklı posta kodu arayabilir. Bundan sonra Too many searches. Please enter the CityPaq locker you found on the Correos map. mesajını görür.

Kargo adımındaki Continue düğmesi geçerli bir dolap olmadan ilerlemez. Bu kontrol sunucuda da yapılır. Müşteri, örneğin Please choose the CityPaq locker where you want to collect your parcel. mesajını görür. Sipariş verildiğinde sepetteki dolap siparişe kaydedilir.

Correos listesi yalnızca müşteri CityPaq'i seçtiğinde istenir; kargo adımındaki her ziyaretçi için istenmez. Liste, posta koduna göre 12 saat önbellekte tutulur. Başarısız bir istek 10 dakika önbelleğe alınır; böylece ödeme sayfası her yenilemede Correos'u beklemez. API zaman aşımı 12 saniyedir. Müşteri teknik hatayı hiçbir zaman görmez, yalnızca kısa bir mesaj ve elle giriş alanını görür. Dolap kutusu Classic ve Hummingbird temalarıyla çalışır.

Modül, Correos'tan canlı tarifeler almaz, harita göstermez, gönderileri önceden kaydetmez, etiket basmaz, kurye talebi oluşturmaz ve paketleri takip etmez. Gönderiyi siparişte kayıtlı dolabı kullanarak Correos hesabınızda oluşturun.

Teslim noktaları

Seçilen dolap siparişe kaydedilir. Müşteri bunu sipariş onay sayfasında ve müşteri hesabındaki sipariş ayrıntıları sayfasında CityPaq locker: olarak görür. Sipariş onay e-postasında ve Mail alerts modülünün yeni sipariş e-postasında dolap, taşıyıcı satırına eklenir; örneğin Correos CityPaq - CityPaq locker: ....

Yönetim panelindeki sipariş sayfasında CityPaq locker bloğu, dolabı ve bir listeden seçilmişse Locker code: değerini gösterir. Değiştirmek için Change CityPaq locker alanını kullanın ve Save seçeneğine tıklayın: kendi listenizle açılır listeden başka bir dolap seçin; Correos listesiyle bir dolap kodu (Correos'ta aranır) veya bir adres girin; diğer durumlarda yeni bir kod veya adres girin. Mevcut dolabı korumak için alanı boş bırakın. Her değişiklik siparişe özel bir not ekler: CityPaq dolabı şuna değiştirildi: .... Dolabı değiştirmek için siparişleri düzenleme izni gerekir. Modules sayfalarına erişim gerekmez.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Correos CityPaq lisans bloğu, Modules > Module Manager > VibeFox Correos CityPaq > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, maskelenmiş anahtarı, durumu (örneğin lisansın geçerli olduğu son 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-correos-citypaq satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri arka ofis 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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çok mağazalı kurulumda da. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızda boşaltın.

Etkin bir anahtar olmadan Correos CityPaq taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini arka ofise giriş yaptığınızı bilmediği için taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde 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. Arka ofiste çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında 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

Correos CityPaq ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve teslimat adresinin İspanya'da olduğunu kontrol edin. Shipping > Carriers içinde taşıyıcının İspanya bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones seçeneğini açın). Fiyat tablosunda İspanya için bir satır ya da bir * satırı olduğunu ve sepetin ağırlık sınırları ile Minimum order amount içinde kaldığını kontrol edin. Ayrıca ürün sayfasında ürünler belirli taşıyıcılarla sınırlandırılmış olabilir.

Correos listesi seçili olmasına rağmen müşteriler dolabı elle yazmak zorunda kalıyor: API client ID ve API client secret alanlarının kayıtlı olduğunu kontrol edin ve ayarların üstündeki uyarıya bakın. Uyarı, Correos API'sinin son hatasını gösterir. HTTP 401/403, Correos'un kimlik bilgilerini reddettiği anlamına gelir: bunları ve uygulamanızın "terminals" API'sine erişimi olup olmadığını kontrol edin. Bir hatadan sonra bir sonraki deneme 10 dakika sonra yapılır.

Bir posta kodu için dolap yok: Correos, bu posta kodunda, bölgesinde veya ilinde aktif bir dolap bulamadı. Müşteri başka bir posta kodu arayabilir ya da Correos CityPaq bulucusunda bulduğu dolabı girebilir.

Dolaplarım açılır listesi görünmüyor: My lockers boş veya satırları geçersiz. Her satırda en az CODE | Name bulunmalıdır.

Müşteriler dolap kodunu nerede bulur: dolap alanının altındaki bağlantıdan erişilen Correos CityPaq bulucusunda.

Sayfa, taşıyıcının bulunamadığını veya güncellenemediğini söylüyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın. Sıfırlama ayarları ve taşıyıcı durumunu korur.

Geliştirici notları: bir sepetin ve siparişin dolabı vfd_cpq_locker tablosunda saklanır (veritabanı önekinizle birlikte). Modül, Correos'un canlı "terminals" API'sini kullanır.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Correos CityPaq yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu, önbellekteki Correos dolap listeleri ile son API hatası her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişlerini korur); ayarlar, günlük ve siparişi olmayan sepetlerin dolapları da silinir. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, taşıyıcının önceki durumunu geri yükler. Siparişlerde kayıtlı dolaplar hiçbir zaman silinmez.

Correos ve CityPaq, ilgili sahiplerinin ticari markalarıdır. Bu modül Correos ile bağlantılı değildir ve Correos tarafından onaylanmamıştır.