VibeFox PostNL 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.

PostNL API anahtarı (yalnızca teslim alma noktaları için): teslim alma noktaları PostNL Checkout API'den yüklenir. PostNL işletme müşterileri API anahtarını Mijn PostNL içinde My account > API beheren yolunda bulur. PostNL sandbox'ı ayrı bir sandbox anahtarı gerektirir. Adrese teslimat yöntemlerinin anahtara ihtiyacı 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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_postnl 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 PostNL veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Fiyatları doldurun. Teslim alma noktaları için ayrıca PostNL API key değerini ve Ship from (postcode) alanını girin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde VibeFox PostNL yöntemini bir kargo bölgesine ekleyin, örneğin Hollanda ve Belçika. Bölgede Title ve Delivery to alanlarını ayarlayın. Diğer teslimat türü için yöntemi ikinci kez ekleyin.

Yapılandırma

Başlık ve teslimat türü dışındaki tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox PostNL. Bunlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde iki alan bulunur:

Title (zone): müşterinin bu bölge yöntemi için gördüğü ad. Genel Name değerini kullanmak için boş bırakın.

Delivery to (zone): As in the global settings (varsayılan), PostNL pickup point (customer chooses a point) veya Home address. İkisini de sunmak için yöntemi bir bölgeye iki kez ekleyin.

Ayarların üstünde sayfa uyarılar gösterir: teslim alma noktaları için eksik API anahtarı veya gönderici posta kodu, açık sandbox, ayarlanmamış fiyat ve PostNL'e yapılan son başarısız istek (tarih ve hata ile).

Genel

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

Name: ödeme sayfasında gösterilen kargo yöntemi adı. Bölgede ayarlanmış bir Title bunun yerine geçer. Varsayılan: PostNL.

Delivery to: As in the global settings kullanan bölge yöntemleri ile Ignore zones modu için varsayılan teslimat türü.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez.

PostNL API (teslim alma noktaları) (adrese teslimat için gerekli değil)

API key: Mijn PostNL içindeki (My account > API beheren) PostNL API anahtarınız. "apikey" başlığıyla PostNL'e gönderilir, WordPress veritabanında saklanır ve müşterilere hiçbir zaman gösterilmez ya da günlüğe yazılmaz.

Sandbox: PostNL sandbox'ını (api-sandbox.postnl.nl) sandbox API anahtarıyla kullanır. Müşteriler bu durumda test teslim alma noktalarını görür. Canlı bir mağazada kapalı tutun.

Ship from (country): paketlerinizi PostNL'e teslim ettiğiniz ülke: Hollanda veya Belçika. Varsayılan olarak mağazanızın ülkesidir. PostNL, teslim alma tarihi için gönderici adresini kullanır.

Ship from (postcode): gönderici posta kodu, örneğin Hollanda için 1234AB veya Belçika için 1000. Mağaza aynı ülkedeyse WooCommerce > Settings > General bölümündeki mağaza posta kodunu kullanmak için boş bırakın. Geçersiz posta kodu bir mesajla reddedilir. API anahtarını, sandbox ayarını veya gönderi adresini değiştirdiğinizde önbelleğe alınmış teslim alma noktası listeleri temizlenir.

Fiyatlar (mağaza para biriminde)

PostNL'in herkese açık bir ücret API'si olmadığı için eklenti canlı ücret sorgulamaz ve fiyatları hiçbir zaman dönüştürmez.

Price per country: hedef ülke başına bir satır. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeleri kapsayan bir satır için * All other countries seçin. Her satırın bir Price değeri ve sepet ağırlığına göre isteğe bağlı ağırlık sınıfları vardır: 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 üzeri. Bir ağırlık sınıfı fiyatı Price değerinin yerine geçer; Price kullanmak için boş bırakın. Price değeri 0 ise kargo ücretsizdir. "6.95" ve "6,95" ikisi de kabul edilir. Boş satırlar ve geçersiz ülke kodları kaydetme sırasında kaldırılır. Bir ülke iki kez görünürse ilk satır korunur. Geçersiz fiyatlar bir mesajla yok sayılır.

Calculation: Per order fiyatı bir kez alır. Per item (price x quantity) fiyatı sepetteki gönderilebilir ürün adediyle çarpar.

Price for other countries: tabloda ne ülke ne de * satırı varsa kullanılır. Yöntemi orada gizlemek için boş bırakın.

Koşullar

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı. Yalnızca bir fiyat bulunan yerlerde geçerlidir. Ücretsiz kargoyu hiç sunmamak için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutarın en az olduğunda gösterir. Her zaman göstermek için boş bırakın.

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. Ürün ağırlıkları mağazanızın birimi üzerinden dönüştürülür. Sınır olmaması için boş bırakın.

Maximum weight (kg): daha ağır sepetler için yöntemi gizler. Varsayılan: 30 (PostNL paketleri Benelux'te 30 kg'a kadar gider). Sınır olmaması için boş bırakın.

Hide for shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Tüm tutar ve ağırlıklarda ondalık virgül kabul edilir; binlik ayracıyla da yazılabilir (1.234,50 veya 1,234.50). Geçersiz bir sayı bir mesajla yok sayılır.

Kargo bölgesi olmadan kullanılabilirlik

Ignore zones: hiçbir bölge PostNL'i eklemediğinde PostNL'i aşağıdaki ülkelerde de sunar. Yöntemi içeren bölgeler normal şekilde çalışmaya devam eder. Bu mod genel Name ve Delivery to değerlerini kullanır.

Countries: bu mod için hedef ülkeler. Mağazanın gönderim yaptığı tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore zones açıkken kullanılır.

Gelişmiş

Debug log: hata ayıklama mesajlarını WooCommerce > Status > Logs bölümüne yazar (kaynak "vfd-postnl"). API hataları her zaman kaydedilir. API anahtarı veya müşteri verisi yazılmaz. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa eklentiyi silmek PostNL ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları hiçbir zaman silmez. Siparişlere kaydedilen teslim alma noktaları her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir ücret ister. Eklenti koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve kargo sınıfları. Ardından ülke ve ağırlık sınıfı için tablodaki fiyatı, ya da diğer ülkeler için fiyatı alır. Fiyat yoksa yöntem gizlenir. Sepet ara toplamı Free shipping from değerine ulaşırsa fiyat 0 olur.

Teslim alma noktası yöntemi yalnızca Hollanda ve Belçika adresleri için ve yalnızca API anahtarıyla sunulur. Müşteri geçerli bir posta kodu girer girmez eklenti PostNL Checkout API'den en yakın teslim alma noktalarını ister. Müşterinin posta kodunu, sokağını, bina numarasını, şehrini ve ülkesini ile mağazanızın gönderici adresini gönderir. Adrese teslimat yöntemleri için hiçbir şey gönderilmez. PostNL'e ulaşılamazsa veya adres için nokta döndürmezse teslim alma noktası yöntemi gizlenir, diğer yöntemleriniz kullanılabilir kalır. API zaman aşımı 12 saniyedir.

Nokta listeleri posta kodu başına 6 saat, "nokta yok" yanıtları 1 saat önbelleğe alınır. Başarısız istekler 10 dakika önbelleğe alınır; böylece bir kesinti her ödeme sayfası güncellemesini yavaşlatmaz. Son hata ayarlar ekranında gösterilir.

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

Eklenti PostNL'den canlı ücret sorgulamaz ve kargo etiketi, barkod, track and trace, iade veya ön bildirim oluşturmaz. Teslimat günü, akşam veya sabah teslimatı seçenekleri yoktur. Gönderiyi Mijn PostNL'de veya başka bir PostNL aracında, kaydedilen teslim alma noktasını kullanarak oluşturun.

Teslim alma noktaları

Müşteri bir teslim alma noktası yöntemi seçtiğinde, altında üç en yakın noktayla birlikte bir PostNL pickup point listesi görünür: firma adı, adres ve mesafe. Müşteri posta kodunu girmeden önce "PostNL teslim alma noktalarını görmek için posta kodunuzu girin (örneğin 1234 AB)." mesajını görür (Belçika için 4 rakam). Seçim, ödeme sayfası yenilendiğinde hatırlanır.

Nokta zorunludur. Nokta olmadan ödeme sayfası "Lütfen bir PostNL teslim alma noktası seçin." mesajıyla durur. Sunucu, noktayı teslimat adresi için PostNL listesiyle karşılaştırır. Listede yoksa ödeme sayfası "Seçilen PostNL teslim alma noktası bu adres için kullanılamıyor. Lütfen tekrar seçin." mesajıyla durur. Siparişle kaydedilen ad ve adres tarayıcıdan değil, PostNL'den gelir.

Yönetici sipariş ekranı: teslimat adresinin altında, ad ve adresle birlikte PostNL pickup point ve Location code.

Teşekkür sayfası ve Hesabım sipariş görünümü: ad ve adresle birlikte PostNL pickup point.

Sipariş e-postaları: HTML ve düz metin e-postalarda noktanın adı ve adresi.

Veritabanında nokta, sipariş meta verilerinde _vfd_ptnl_servicepoint_id (PostNL konum kodu), _vfd_ptnl_servicepoint_name (ad ve adres) ve _vfd_ptnl_servicepoint (ortak ID, firma, sokak, bina numarası, posta kodu, şehir, ülke) olarak saklanır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox PostNL 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 etkin olduğu tarih ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini 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, o alan adının yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan PostNL, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de (unlicensed — visible to admins only) ibaresiyle görür; böylece 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

PostNL ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore zones açık ve ülke izinliyse). Ülke için fiyat, ağırlık sınırları, Minimum subtotal ve Hide for shipping classes ayarlarını kontrol edin.

Teslim alma noktası yöntemi görünmüyor: yalnızca Hollanda ve Belçika adresleri için, yalnızca API anahtarı, gönderici posta kodu ve fiyat varsa ve PostNL müşterinin posta kodu için nokta döndürdüğünde gösterilir. Ayarlar ekranının üstündeki uyarıları ve WooCommerce > Status > Logs bölümünü, kaynak "vfd-postnl" olarak kontrol edin. Hatalar her zaman kaydedilir; ayrıntılar için Debug log seçeneğini açın.

"PostNL teslim alma noktaları şu anda yüklenemiyor": PostNL'e ulaşılamadı, API anahtarını reddetti veya gönderici posta kodu eksik. Ayarlar ekranı son hatayı gösterir. Sandbox anahtarı yalnızca Sandbox açıkken, canlı anahtar yalnızca kapalıyken çalışır.

Müşteriler test teslim alma noktalarını görüyor: Sandbox seçeneğini kapatın.

Geliştiriciler için filtreler: vfd_ptnl_number_of_locations (varsayılan 3), vfd_ptnl_checkout_request (istek gövdesi) ve vfd_ptnl_api_url.

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 açı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 ayarları korur ve yalnızca önbelleğe alınmış teslim alma noktası listelerini temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış nokta listeleri ve son API hatasıyla birlikte her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını ve kaydedilen teslim alma noktasını korur.

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