VibeFox PostNord for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

PostNord API anahtarı (servis noktası seçici için): developer.postnord.com adresinde ücretsiz bir hesap oluşturun, bir uygulama ekleyin ve API anahtarını kopyalayın. Anahtar olmadan yöntem yine çalışır, ancak müşteriler servis noktası seçemez.

PostNord sözleşmesi: paket göndermek için MyPack Collect veya MyPack Home gibi alışılmış PostNord müşteri sözleşmenize ihtiyacınız vardır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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. Ayrıca vfd_postnord klasörünü FTP ile /wp-content/plugins/ klasörüne yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox PostNord veya Eklentiler 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. PostNord API key değerini yapıştırın, Agreement country seçeneğinizi seçin ve Country prices alanlarını doldurun (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde, İsveç, Danimarka, Norveç veya Finlandiya'nın kargo bölgelerine VibeFox PostNord ekleyin. Yöntemin ayarlarında Title ve Delivery type değerlerini belirleyin. Ya da Ignore shipping zones seçeneğini açın.

Yapılandırma

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

Title (zone): ödeme sayfasında bu seçeneğin adı, örneğin "PostNord MyPack Collect". Genel Name değerini kullanmak için boş bırakın.

Delivery type (zone): Same as global setting (varsayılan), Service point / parcel locker veya Home delivery. Her ikisini sunmak için bir bölgeye iki PostNord yöntemi ekleyin.

Ayarların üstünde sayfa, henüz API anahtarı veya fiyat yoksa uyarır. Ayarları her kaydettiğinizde önbelleğe alınmış servis noktası listeleri temizlenir.

Genel

Enable/Disable: işaret kaldırıldığında yöntem, kargo bölgeleri dahil her yerde gizlenir.

Name: ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge yöntemi bunu kendi Title değeriyle değiştirebilir. Varsayılan: PostNord.

Delivery type: tüm PostNord yöntemleri için varsayılan; her bölge yöntemi kendisininkini seçebilir.

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

PostNord API (servis noktası seçici)

API key: developer.postnord.com üzerindeki uygulamanızın API anahtarı. Yalnızca sunucunuzdan PostNord'a gönderilir, asla tarayıcıya gönderilmez ve asla günlüğe kaydedilmez.

Test mode: PostNord test ortamını kullanır (atapi2.postnord.com). Yalnızca test ortamı için verilmiş anahtarlarla kullanın.

Agreement country: PostNord müşteri sözleşmenizin ülkesi: İsveç, Danimarka, Norveç veya Finlandiya. Hangi servis noktalarının sunulacağını belirler. Same as the delivery country (varsayılan) müşterinin ülkesini kullanır.

Fiyatlar

Fiyatlar mağaza para biriminde girilir. PostNord herkese açık bir fiyat API'si sunmadığı için kendi fiyatlarınızı belirlersiniz; genellikle PostNord sözleşmenizdeki fiyatlar. Sıra şöyledir: önce ülke tablosu, ardından yedek ücret; ücretsiz kargo yalnızca bunlardan birinin fiyat verdiği yerlerde geçerlidir.

Calculation type: Per order fiyatı bir kez tahsil eder. Per item (price × number of items) fiyatı sepetteki ürün sayısıyla çarpar.

Country prices: hedef ülke ve sepet ağırlığına göre 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 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar ve XL 5 kg'ın üzeri. 0 olan bir ağırlık sütunu Price sütununu kullanır. * All other countries ülkesi, kendi satırı olmayan tüm ülkeleri kapsar. Virgül veya noktayla ondalık sayılar (9,99 veya 9.99). Yeni bir satır, tüm fiyatları 0 olan * All other countries olarak başlar; bu da ücretsiz kargo anlamına gelir. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı silin. Sayı olmayan bir hücre 0 olarak kaydedilir ve bir mesaj gösterilir.

Fallback cost: ülke tablosunda hedef için satır ve * satırı yoksa kullanılır. Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Free shipping from: PostNord'un ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi hariç). Yalnızca bir fiyatın belirlendiği yerlerde geçerlidir: bir ülke satırı, * satırı veya yedek ücret. Ücretsiz kargoyu hiç sunmamak için boş bırakın.

Uygunluk

Min weight (kg): sepet bundan hafif olduğunda yöntemi gizler. Ürün ağırlıkları mağazanızın ağırlık biriminden çevrilir. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan ağır olduğunda yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. PostNord hizmetinizin ağırlık sınırını kontrol edin: paket dolapları servis noktalarından daha az ağırlık kabul eder.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutara eşit veya daha yüksekse gösterir. Her zaman göstermek için boş bırakın.

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

Ignore shipping zones: açıkken PostNord, bir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için genel ayarlarla sunulur. Kapalıyken yalnızca eklediğiniz kargo bölgelerinde sunulur.

Countries (Ignore shipping zones): bu mod için hedef ülkeler. Tüm kargo ülkelerini kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Tutarlar ve ağırlıklar virgül veya nokta kabul eder. Geçersiz bir sayı kaydedilmez ve bir mesaj gösterilir.

Gelişmiş

Debug log: fiyat hesaplamalarını ve API çağrılarını WooCommerce > Status > Logs bölümüne ("vfd-postnord" kaynağı) yazar. API hataları her zaman kaydedilir. API anahtarı asla kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıkken eklentiyi silmek PostNord ayarlarını ve bölge yöntemlerini kaldırır. Devre dışı bırakmak ayarları asla silmez. Siparişlere kaydedilmiş servis noktaları her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve devre dışı kargo sınıfları. Fiyat önce ülke tablosundan, ardından yedek ücretten alınır. Fiyat yoksa yöntem gizlenir. Ücretsiz kargo geçerliyse müşteri yöntemi ücretsiz olarak görür.

Bir servis noktası yöntemi ve İsveç, Danimarka, Norveç veya Finlandiya'da bir teslimat adresi için sunucunuz, teslimat posta koduna en yakın servis noktalarını PostNord Business Location API'den ister. Teslimat ülkesini ve posta kodunu ile sözleşme ülkesini gönderir. API zaman aşımı 10 saniyedir. Listeler posta kodu başına 6 saat, "nokta yok" yanıtları 1 saat önbelleğe alınır. API hataları 5 dakika önbelleğe alınır; böylece bir PostNord kesintisi her ödeme sayfası güncellemesini yavaşlatmaz.

Diğer hedefler için yöntem, seçici olmadan yine de sizin fiyatlarınızla sunulabilir.

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

Eklenti canlı PostNord fiyatı talep etmez ve kargo etiketi oluşturmaz, gönderi ayırtmaz (EDI), takip numarası sağlamaz ya da takip e-postası göndermez. Harita görünümü yoktur. Gönderiler için PostNord Portal, Skicka Direkt Business veya bir etiket eklentisi kullanın; bu araçların ihtiyacı olan şey, kaydedilmiş servis noktası kimliğidir.

Teslim alma noktaları

Müşteri bir servis noktası yöntemi seçtiğinde, altında en yakın noktaları içeren bir PostNord service point listesi görünür; şehre göre gruplanmış ve mesafe bilgisiyle. Posta kodu girilmeden önce müşteri "Enter your postcode to choose a PostNord service point." mesajını görür. Seçim, ödeme sayfası güncellemelerinde korunur.

Liste yüklendiğinde bir nokta seçmek zorunludur. Seçim yapılmazsa ödeme sayfası "Please select a PostNord service point." mesajıyla durur. Seçilen nokta, hem klasik hem blok ödeme sayfasında sunucuda listeyle karşılaştırılır.

Seçici hiçbir zaman satışı engellemez. Liste yüklenemezse (henüz API anahtarı yok, PostNord API'si kapalı, posta koduna yakın nokta yok), müşteri bir not görür ve yine de siparişi tamamlayabilir. Bu durumda PostNord, adrese en yakın servis noktasına teslim eder.

Yönetici sipariş ekranı: PostNord service point, ad, adres ve Service point ID ile birlikte, teslimat adresinin altında. Bir nokta seçilmediyse "not selected — PostNord delivers to the service point nearest to the shipping address" yazar.

Teşekkür sayfası ve Hesabım sipariş görünümü: PostNord service point: ad ve adresiyle.

Sipariş e-postaları: HTML ve düz metin e-postalarında noktanın adı, adresi ve kimliği.

Veritabanında nokta, _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name ve _vfd_ptnd_servicepoint_address sipariş meta verilerinde saklanır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox PostNord 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 aktif olduğunu 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 kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarın bir siteden kaldırılması, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

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

PostNord ö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 shipping zones açık ve ülke izinliyse). Ülke için bir fiyatın belirlendiğini kontrol edin (ülke satırı, * satırı veya Fallback cost), ağırlık sınırlarını, Minimum subtotal ve Disabled shipping classes ayarlarını da kontrol edin.

Seçici, servis noktalarının yüklenemediğini söylüyor: API key değerini ve Test mode ayarını kontrol edin. Üretim anahtarı test ortamında çalışmaz, tersi de geçerlidir. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümüne, "vfd-postnord" kaynağına bakın. Sipariş yine de verilebilir; bu durumda PostNord en yakın servis noktasına teslim eder.

Beklenmeyen servis noktaları: Agreement country değerini kontrol edin. Hangi servis noktalarının sunulacağını o belirler.

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

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, yeni alan adı için anahtarı 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ış servis noktası listelerini temizler. Kaldırmak için devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış servis noktası listeleriyle 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 kalırlar. Mevcut siparişler kargo satırlarını ve kaydedilmiş servis noktasını korur.

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