VibeFox Correos CityPaq 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.

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 ayrıca portalda My applications altında da gösterilir. Müşteriler dolabı kendileri girerse veya sizin listenizden seçerlerse 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

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_correos_citypaq 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 Correos CityPaq yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Fiyat tablosunu doldurun ve müşterinin dolabı nasıl seçeceğini belirleyin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones altında İspanya için olan kargo bölgesine VibeFox Correos CityPaq ekleyin veya Ignore shipping zones seçeneğini etkinleştirin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Correos CityPaq. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

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

Ayarların üstündeki uyarılar; fiyat tablosunda kullanılabilir satır olmadığında, seçilen dolap seçiminin çalışamayacağı durumlarda (listenizde dolap yok, API kimlik bilgisi yok) ve Correos API'sinin son hatasının ne olduğunu size bildirir. Fiyatlar ve tutarlar ondalık virgül veya ondalık nokta kabul eder.

Genel

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

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır.

Name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Correos CityPaq.

Tax status: Taxable tablodaki fiyatların üzerine WooCommerce vergisini ekler, None eklemez.

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

Price table: Spain (ES) için bir satır ve/veya varsayılan * satırı. Her satırda temel bir Price ile 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 düğmesine, satır silmek için çarpı işaretine tıklayın. Correos sözleşme fiyatlarınızı mağaza para biriminde girin. Eşleşen bir satır yoksa yöntem gizlenir. Geçersiz fiyatlar ve yinelenen satırlar kaydetme sırasında bildirilir.

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

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

Per item (size by each item weight, multiplied by quantity): her ürün kendi boyutunun fiyatını, adediyle çarpılmış olarak alır ve fiyatlar toplanır.

Ürün ağırlıkları, mağazanızın ağırlık birimine (kg, g, lbs veya oz) göre 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 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: sepet, bu WooCommerce kargo sınıflarından birine ait bir ürün içeriyorsa yöntemi gizler; örneğin bir dolaba sığmayan hacimli ürünler. Eklenti paket ölçülerini kontrol etmez.

Ücretsiz kargo

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

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

CityPaq dolap seçimi

Locker selection: müşterinin siparişten önce dolabı nasıl seçeceğ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 5 haneli başka bir posta kodu arayabilir. Bir posta kodunda dolap yoksa önce aynı bölgenin, sonra aynı ilin dolapları listelenir; en yakın posta kodları önce gelir. Her dolapta adı, adresi, posta kodu, ilçesi ve çalışma saatleri gösterilir. 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; resmi Correos CityPaq bulucusuna bir bağlantıyla birlikte.

Customer chooses from my list of lockers (below): My lockers listesinden dolapların bulunduğu 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 bilgisi olmadan Correos listesini veya My lockers boşken kendi listenizi seçerseniz, müşteriden dolabı elle girmesi istenir.

My lockers: Locker selection sizin listenize ayarlandığında kullanılır. Her satıra bir dolap: CODE | Name | Address | Postal code | City. Kod ve ad zorunludur. Geçersiz ve yinelenen satırlar kaydetme sırasında bildirilir.

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.

Kimlik bilgilerini veya dolap seçimini değiştirdiğinizde, önbelleğe alınmış dolap listeleri temizlenir.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: hiçbir kargo bölgesi bu yöntemi içermese bile her İspanyol adresi için CityPaq sunar. Kapalı (önerilen), yöntemin bir kargo bölgesine eklendiği yerlerde sunulması anlamına gelir.

Gelişmiş

Debug log: WooCommerce > Status > Logs altında, vfd-correos-citypaq kaynağıyla hata ayıklama satırları yazar. Correos API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri ve kişisel veriler hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa, eklentiyi silmek ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kayıtlı dolaplar korunur.

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

Müşteri İspanya'da bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti sepet ağırlığını, minimum sipariş tutarını ve hariç tutulan kargo sınıflarını kontrol eder, İspanya için (veya * satırı için) fiyat satırını ve paket boyutunu bulur ve fiyatı gösterir. Ücretsiz kargo geçerliyse fiyat 0 olur.

Müşteri CityPaq'ı seçtiğinde, dolap alanı yöntemin altında görünür. Geçerli bir dolap olmadan sipariş verilemez. Bu kontrol sunucuda da yapılır; Sepet ve Ödeme bloklarıyla verilen siparişler için de geçerlidir. Correos listesiyle, bir dolap kodu yalnızca Correos bu müşteriye sunmuşsa kabul edilir ve adı ile adresi Correos'tan alınır. Müşteri oturumu başına posta kodu aramalarının sayısı sınırlıdır. Sınıra ulaşıldığında müşteri dolabı elle girer.

Correos listesi, posta kodu başına 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.

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

Eklenti, Correos'tan canlı tarife 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. Sipariş yönetim ekranında teslimat adresinin altında, sipariş alındı sayfasında, My account > Orders bölümünde ve tüm sipariş e-postalarında (HTML ve düz metin) CityPaq locker olarak gösterilir.

Sipariş yönetim ekranında Change CityPaq locker alanından dolabı değiştirebilirsiniz: listenizden başka bir dolap seçin veya yeni bir kod ya da adres girin. Correos listesiyle girilen dolap kodu Correos'ta sorgulanır. Mevcut dolabı korumak için alanı boş bırakın. Her değişiklik siparişe bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Correos CityPaq 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, anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek 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 yoksa Correos CityPaq, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de (unlicensed — visible to admins only) işaretiyle görür; 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ın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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, adresin İspanya'da olduğunu ve yöntemin ilgili kargo bölgesine eklendiğini (veya Ignore shipping zones seçeneğinin açık olduğunu) kontrol edin. Fiyat tablosunda İspanya için bir satır veya bir * satırı olduğunu ve sepetin ağırlık sınırları, Minimum order amount ve Excluded shipping classes içinde kaldığını doğrulayın.

Correos listesi seçili olmasına rağmen müşteriler dolabı yazmak zorunda kalıyor: API client ID ve API client secret alanlarının doldurulduğ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ı kontrol edin ve uygulamanızın "terminals" API'sine erişimi olduğunu doğrulayın. 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 veya 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 buluyor: dolap alanının altında bağlantısı verilen Correos CityPaq bulucusunda.

Geliştirici notları: dolap, _vfd_cpq_locker sipariş meta verisinde (her yerde gösterilen metin) ve _vfd_cpq_locker_id alanında (Correos listesinden veya kendi listenizden seçildiğinde dolap kodu) saklanır. Eklenti Correos'un canlı "terminals" API'sini kullanır. Bu API için belgelenmiş bir sandbox yoktur.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır; önbelleğe alınmış Correos dolap listeleri ve son API hatası da öyle. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde, eklentinin sonradan yeniden kurulması için saklanırlar. Siparişlerde kayıtlı dolaplar hiçbir zaman silinmez ve mevcut siparişler kargo satırlarını korur.

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.