VibeFox Correos CityPaq for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

İspanya'ya teslimat: CityPaq dolapları yalnızca İspanya'da bulunur, bu nedenle yöntem 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 düğmesini kullanın. Correos, kurumsal müşterilerinin taleplerini onaylar ve bir client ID ile bir client secret gönderir. Bunlar portalda My applications altında da gösterilir. Müşterileriniz dolabı kendileri girecekse veya sizin listenizden seçecekse API kimlik bilgilerine 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

İndirme dosyası, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_correos_citypaq-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_correos_citypaq.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_correos_citypaq-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu nedenle Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin, eklenti türü olarak Shipping seçin. VibeFox Correos CityPaq eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

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

5. Fiyat tablosunu doldurun, müşterinin dolabı nasıl seçeceğini belirleyin (bkz. Yapılandırma), Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_correos_citypaq.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Correos CityPaq eklentisini bulun, Install düğmesine (yeşil + düğmesi), ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4. ve 5. adımlardaki gibi girin. Ayar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, Enable/Disable seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız ayarlar yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Correos CityPaq > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Fiyat ve tutarlar ondalık virgül veya ondalık nokta ile girilebilir. Yalnızca bu eklenti için değiştirme izni olan yönetici kullanıcılar ayarları kaydedebilir.

Sayfanın üstünde şu durumlarda uyarılar görünür: fiyat tablosunda İspanya için satır ya da varsayılan satır yoksa, seçilen dolap yöntemi çalışamıyorsa (listenizde dolap yoksa, API kimlik bilgileri yoksa), son Correos API hatası nedir, ve mağazada kg birimli bir ağırlık sınıfı yoksa (ürün ağırlıkları o zaman birim adına göre dönüştürülür: kg, g, lb veya oz; bilinmeyen birimler kg olarak okunur). System > Localisation > Weight Classes sayfasını kontrol edin. Ad boş, geçersiz veya 64 karakterden uzunsa, bir ağırlık veya tutar 0 veya daha büyük geçerli bir sayı değilse, Min weight (kg) değeri Max weight (kg) değerinden büyükse ya da Sort order tam sayı değilse, sayfa bir hata gösterir ve hiçbir şey kaydedilmez. Fiyat tablosundaki geçersiz fiyatlar, yinelenen satırlar ve My lockers içindeki geçersiz veya yinelenen satırlar uyarı olarak bildirilir, kalanı kaydedilir.

Genel

CityPaq dolapları yalnızca İspanya'da bulunur, bu nedenle yöntem diğer ülkeler için hiçbir zaman sunulmaz.

Enable/Disable: Correos CityPaq kargosunu açar veya kapatır. Varsayılan: kapalı.

Name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Correos CityPaq. Zorunlu, en fazla 64 karakter, < > ; = # { } karakterleri olmadan.

Tax class: OpenCart, bu sınıfın vergisini tablodaki fiyatların üzerine ekler. No tax fiyatların nihai olduğu anlamına gelir.

Sort order: yönteminin kargo yöntemleri listesindeki konumu. Tam sayı.

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

Correos, CityPaq için bir ücret API'si yayınlamadığından fiyat bu tablodan gelir. Correos sözleşme fiyatlarınızı mağazanın varsayılan para biriminde, vergi hariç girin.

Price table: Spain (ES) için bir satır ve/veya varsayılan * Default satırı. Her satırda bir 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 üzeri) 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 düğmesine, bir satırı silmek için × düğmesine tıklayın. Eşleşen bir satır yoksa yöntem 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.

Per order (size by the total cart weight): tüm sepet için tek bir fiyat, toplam ağırlığa göre seçilir. Varsayılan budur.

Per item (size by each item weight, multiplied by quantity): her ürün kendi boyutunun fiyatını alır, miktarıyla çarpılır ve fiyatlar toplanır.

Ürün ağırlıkları, her ürünün ağırlık sınıfından kg'a çevrilir.

Koşullar

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

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

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, 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 CityPaq ile ücretsiz teslimatı açar.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi); bu tutardan itibaren bu yöntem 0 kuruş olur. Yalnızca Free shipping açıkken kullanılır.

CityPaq dolap seçimi

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

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

Customer chooses from the Correos CityPaq list (Correos API, credentials below): müşteri, teslimat adresinin posta kodundaki aktif CityPaq dolaplarını görür ve başka bir 5 haneli posta kodu arayabilir. Bir posta kodunda dolap yoksa aynı bölgedeki, ardından aynı ildeki dolaplar listelenir; önce en yakın posta kodları gelir (en fazla 50). Liste yüklenemezse veya hiçbir şey bulamazsa müşteri dolabı elle girer.

Customer enters the locker (code or address from the Correos finder): dolap kodu (örneğin S0000213D) veya adres için zorunlu bir alan, 3 ila 120 karakter; Correos CityPaq haritasına bir bağlantıyla birlikte.

Customer chooses from my list of lockers (below): My lockers içindeki dolaplardan oluşan zorunlu bir açılır liste. Müşterinin posta koduna yakın dolaplar önce listelenir.

Do not ask for a locker: ödeme sayfasında dolapla ilgili soru sorulmaz.

API kimlik bilgileri olmadan Correos listesini ya da My lockers boşken kendi listenizi seçerseniz, müşteriden dolabı elle girmesi istenir.

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 bir 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 her iki alan da boş kalır ve Saved - leave empty to keep it. ifadesini 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 düğmesine tıklayın. Hiçbir şey kayıtlı değilse bölüm No credentials saved. gösterir. Kimlik bilgilerini veya dolap seçimini değiştirdiğinizde önbelleğe alınmış dolap listeleri ve son API hatası temizlenir.

Kullanılabilirlik

Geo zone: yöntemi yalnızca bu coğrafi bölgedeki adreslere sunar. All zones (varsayılan) tüm İspanya adresleri anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünden yönetilir.

Ignore geo zone: yukarıda belirtilen coğrafi bölgede olmasalar bile, tüm İspanya adreslerine CityPaq'ı sunar.

Gelişmiş

Debug log: hata ayıklama satırlarını storage/logs/vfd_cpq_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_cpq_debug.log.php). Dosya web üzerinden okunamaz. Bu seçenek kapalı olsa bile Correos API hataları her zaman yazılır. Kimlik bilgileri ve kişisel veriler asla günlüğe yazılmaz.

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

Remove data on uninstall: açıkken eklentiyi kaldırmak ayarları, önbelleğe alınmış listeleri ve günlükleri siler. Siparişlerde kaydedilmiş dolaplar korunur. Kapalıyken (varsayılan) yeniden kurulum için her şey saklanır.

İçe / dışa aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API client ID ve secret dahil edilmez.

Import: bu eklentiden dışa aktarılmış ayar JSON'unu yapıştırın ve Import düğmesine tıklayın. Değerler normal bir kayıtta olduğu gibi kontrol edilir. Kayıtlı kimlik bilgileri korunur.

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

OpenCart kargo yöntemlerini gösterirken eklentiden CityPaq fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore geo zone kapalıysa) ve adres bu bölgenin dışındaysa CityPaq sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler dikkate alınır: diğer ürünler ağırlığa eklenmez ve sipariş tutarına dahil edilmez. Eklenti ardından 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 uygulanırsa fiyat 0 olur. Fiyat mağazanızın varsayılan para biriminde hesaplanır, o para biriminin ondalık basamaklarına yuvarlanır ve seçilen Tax class vergisiyle birlikte müşteriye kendi para biriminde gösterilir. Fiyat için Correos'a bir istek gönderilmez.

CityPaq locker kutusu, kargo yöntemi adımında CityPaq yönteminin altında görünür. Seçim, müşteri seçer seçmez 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, her ödeme oturumunda en fazla 30 farklı posta kodu arayabilir. Bundan sonra müşteri Too many searches. Please enter the CityPaq locker you found on the Correos map. mesajını görür.

Kargo yöntemi adımındaki Continue düğmesi, geçerli bir dolap olmadan CityPaq ile devam etmez. Bu, sunucu tarafında kontrol edilir. Müşteri örneğin Please choose the CityPaq locker where you want to collect your parcel. mesajını görür. Sipariş verildiğinde dolap siparişe kaydedilir.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde CityPaq'ı seçer. CityPaq locker kutusu bu pencerede CityPaq seçeneğinin altında görünür ve yukarıda açıklandığı gibi çalışır. Pencerenin Continue düğmesi, geçerli bir dolap olmadan CityPaq ile devam etmez. OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri yeniden onayladığında bu siparişi günceller; siparişin dolabı da onunla birlikte güncellenir.

Correos listesi yalnızca CityPaq seçili yöntem olduğunda istenir, adım gösterilirken değil. Bir liste, posta kodu başına 12 saat önbelleğe alınır. Başarısız bir istek 10 dakika önbelleğe alınır; böylece ödeme sayfası her güncellemede Correos'u beklemez. Müşteri teknik hatayı asla görmez; yalnızca The Correos CityPaq list cannot be loaded right now. mesajını ve elle giriş alanını görür.

Eklenti Correos'tan canlı tarifeler almaz, harita göstermez, gönderi kaydı oluşturmaz, etiket yazdırmaz, kurye talebi açmaz veya paketleri takip etmez. Gönderiyi, siparişte kaydedilmiş dolabı kullanarak Correos hesabınızda oluşturun.

Teslim noktaları

Seçilen dolap, siparişin kargo yöntemine eklenir; örneğin Correos CityPaq - CityPaq locker: .... Böylece müşteri, hesabındaki sipariş geçmişinde ve sipariş e-postalarında bunu görür; fatura üzerinde yazdırılır ve Sales > Orders bölümünde gösterilir. OpenCart sipariş tamamlandı sayfası kargo yöntemini göstermez.

Yönetici sipariş sayfasında, geçmişin üstündeki CityPaq locker paneli, dolabı ve bir listeden seçildiyse Locker code: değerini gösterir. Değiştirmek için Change CityPaq locker alanını kullanın ve Save düğmesine 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 veya -- Keep the current locker -- seçeneğini bırakın. Her değişiklik, siparişin kargo yöntemi metnini de günceller ve müşteriye bildirim göndermeden geçmişe CityPaq locker changed to: ... kaydı ekler. Dolabı değiştirmek için sipariş değiştirme izni (sale/order) gerekir. Eklenti ayarlarına erişim gerekmez. Panel, eklenti kapalı olsa bile CityPaq siparişleri için gösterilir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Correos CityPaq lisans bloğu, Extensions > Extensions > Shipping > VibeFox Correos CityPaq > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın 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) gösterir; ayrıca 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 düğmeleri bulunur. Bunların altında Product: opencart-shipping-correos-citypaq satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca bu eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini takip eder (İ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 License expired on ve bir tarih. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 Correos CityPaq kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve ücret hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, mağazada yöntemi yine görür; yöntem (unlicensed — visible to admins only) olarak işaretlenir. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfasını açtığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak 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. Geo zone ayarını kontrol edin (veya Ignore geo zone seçeneğini açın). Fiyat tablosunda İspanya için bir satır ya da * satırı olduğunu, sepetin ağırlık sınırları ve Minimum order amount içinde olduğunu ve ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

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

Bir posta kodu için dolap yok: Correos, bu posta kodu, bölgesi veya ili için aktif bir dolap bulamadı. Müşteri başka bir posta kodu arayabilir veya Correos CityPaq haritasında bulduğu dolabı girebilir.

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

Müşteriler dolap kodunu nerede buluyor: dolap alanının altına bağlanan Correos CityPaq haritasında.

Sayfa "Warning: You do not have permission to modify VibeFox Correos CityPaq!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. Gruba System > Users > User Groups altında extension/shipping/vfd_correos_citypaq (OpenCart 3) veya extension/vfd_correos_citypaq/shipping/vfd_correos_citypaq (OpenCart 4) için değiştirme izni verin.

Geliştiriciler için: bir ödeme oturumunun ve bir siparişin dolabı vfd_cpq_locker tablosunda saklanır (veritabanı önekinizle birlikte). Correos API adresi vfd_cpq_api_url ayarıyla değiştirilebilir (testler için); ayarlar sayfasında bunun için bir alan yoktur.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Correos CityPaq yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable/Disable, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış Correos dolap listeleri ve son API hatası her zaman silinir. Remove data on uninstall açıksa ayarlar, günlük ve siparişi olmayan ödeme oturumlarının dolapları da silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerde kaydedilen dolaplar asla silinmez ve mevcut siparişler kargo yöntemini ve maliyetini korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Correos CityPaq yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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