VibeFox PostNL for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x, Classic veya Hummingbird teması (ya da bunlara dayalı bir tema).

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

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 kargo firmasının 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. Back office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox PostNL'i bulup Configure düğmesine tıklayın.

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

4. 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). Save düğmesine tıklayın.

Kurulumda modül iki kargo firması oluşturur: PostNL pickup point (teslimat süresi metni Delivery to a PostNL pickup point) ve PostNL (PostNL delivery to the home address). İkisi de Hollanda ve Belçika bölgelerine ve tüm müşteri gruplarına bağlanır. Bölge ekleyebilir; müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Fiyatları orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox PostNL > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. WooCommerce'te bir yöntem, her teslimat türü için bir kez olmak üzere bir bölgeye iki kez eklenir. PrestaShop'ta her teslimat türü kendi adı, durumu ve bölgeleri olan ayrı bir kargo firmasıdır.

Ayarların üstünde sayfa uyarılar gösterir: teslim alma noktaları için eksik API anahtarı veya gönderim posta kodu, açık sandbox, hiç fiyat tanımlanmamış olması, tarih ve hatasıyla son başarısız PostNL isteği, modülün tanımadığı bir mağaza ağırlık birimi ve silinmiş bir kargo firması.

Genel

PostNL pickup point: teslim alma noktası kargo firmasını açar veya kapatır. Müşteri ödeme sırasında bir PostNL noktası seçmek zorundadır. Yalnızca Hollanda ve Belçika adresleri için ve yalnızca API anahtarıyla sunulur. Bu, Shipping > Carriers içindeki kargo firması durumuyla aynı anahtardır.

Pickup point carrier name: müşterilerin ödeme sırasında gördüğü ad. Varsayılan: PostNL pickup point. Zorunlu.

PostNL home address: adrese teslimat kargo firmasını açar veya kapatır. Nokta seçilmez. Fiyatı olan her ülkede çalışır. Kargo firması durumuyla aynı anahtar.

Home delivery carrier name: müşterilerin ödeme sırasında gördüğü ad. Varsayılan: PostNL. Zorunlu.

Tax status: iki kargo firmasının vergi kuralı. Taxable kuralı, bu kuralın kargo vergisini fiyatların üzerine ekler. None ise fiyatların nihai olduğu anlamına gelir.

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

API key: Mijn PostNL'deki (My account > API beheren) PostNL API anahtarınız. "apikey" başlığıyla PostNL'e gönderilir; müşterilere asla gösterilmez ve günlüğe yazılmaz. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. ibaresini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved API key: kutuyu işaretleyin ve kayıtlı anahtarı silmek için Save düğmesine tıklayın. Bundan sonra teslim alma noktası kargo firması sunulmaz.

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

Ship from (country): paketlerinizi PostNL'e teslim ettiğiniz ülke: Netherlands veya Belgium. Varsayılan: Netherlands. PostNL, teslim alma tarihi için gönderen adresini kullanır.

Ship from (postcode): gönderenin posta kodu; örneğin Hollanda'da 1234AB veya Belçika'da 1000. Mağaza aynı ülkedeyse mağaza posta kodunu Shop Parameters > Contact > Stores bölümünden kullanmak için boş bırakın. Geçersiz bir posta kodu uyarıyla boş kaydedilir. API anahtarını, sandbox ayarını veya gönderim adresini değiştirdiğinizde önbelleğe alınmış teslim alma noktası listeleri ve son API hatası temizlenir.

Fiyatlar (mağazanın varsayılan para biriminde, vergi hariç)

Fiyatlar her iki kargo firması için de geçerlidir. PostNL'in herkese açık bir ücret API'si olmadığı için modül canlı ücret sorgulamaz. Başka bir para birimiyle ödeyen müşteri için PrestaShop fiyatı mağazanızın döviz kuruyla çevirir.

Price per country: hedef ülke başına bir satır. Satır eklemek için + Add country, silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkeleri kapsayan bir satır için * All other countries seçin. Her satırda bir Price 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 yerine geçer; Price kullanmak için boş bırakın. Price değeri 0 ise ücretsiz kargo anlamına gelir. "6.95", "6,95" ve "1.234,50" ya da "1,234.50" gibi binlik ayırıcılı tutarlar kabul edilir. Boş satırlar ve geçersiz ülke kodları kaydetme sırasında silinir. Bir ülke iki kez görünürse ilk satır tutulur. Geçersiz fiyatlar uyarıyla yok sayılır.

Calculation: Per order fiyatı bir kez alır. Per item (price x quantity) ise fiyatı kargolanması gereken ürün adediyle çarpar.

Price for other countries: tabloda ne ülke ne de * satırı varsa kullanılır. Bu ülkelerde kargo firmalarını gizlemek için boş bırakın.

Koşullar

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı (kargolanması gereken ürünler, vergi hariç, indirimlerden sonra). Yalnızca bir fiyatın bulunduğu yerde geçerlidir. Ücretsiz kargoyu hiç sunmamak için boş bırakın.

Minimum subtotal: kargo firmalarını yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Minimum weight (kg): sepet bundan hafifse kargo firmalarını gizler. Ürün ağırlıkları mağazanızın ağırlık biriminden 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 kargo firmalarını gizler. Varsayılan: 30 (PostNL paketleri Benelux'te 30 kg'a kadar). 0 sınır olmadığı anlamına gelir. Boş bırakırsanız kargo firmalarının bölgelerinde 30 kg geçerli olur; sınırsızlık yalnızca Ignore zones ile ulaşılan ülkeler için geçerlidir. Maksimum ağırlıktan büyük bir minimum ağırlık hatayla reddedilir, çünkü kargo firmaları hiç gösterilmezdi.

Tüm tutarlar ve ağırlıklar, binlik ayırıcılı olsa bile ondalık virgül kabul eder. Geçersiz veya negatif bir sayı uyarıyla yok sayılır ve alan boş kaydedilir.

Kargo bölgesi olmadan kullanılabilirlik

Normalde kargo firmaları, Shipping > Carriers içinde bağlı oldukları kargo bölgelerinde sunulur.

Ignore zones: PostNL'i, bölgelerinde bulunmayan aşağıdaki ülkelerde de sunar. Kargo firmaları bu durumda etkin olan tüm bölgelere bağlanır; sonradan oluşturduğunuz bölgelere de. Tekrar kapattığınızda kargo firmaları önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore zones açıkken kullanılır. Bu ülkelerde iki kargo firması da sunulabilir; ancak teslim alma noktası kargo firması yalnızca Hollanda ve Belçika için sunulur.

Gelişmiş

Debug log: modül klasöründeki logs/vfd_ptnl_debug.log.php dosyasına hata ayıklama mesajları yazar. Dosya web üzerinden açılamaz. API hataları her zaman günlüğe yazılır. API anahtarı veya müşteri verisi yazılmaz. İşiniz bittiğinde günlüğü kapatın.

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

Remove data on uninstall: açıksa modülü kaldırmak PostNL ayarlarını ve kargo firmalarını siler. Kapalıysa kaldırma yalnızca kargo firmalarını kapatır. Siparişlere kaydedilmiş teslim alma noktaları her zaman korunur.

Ödeme sırasında nasıl çalışır

Kargo adımında PrestaShop, her PostNL kargo firması için modülden fiyat ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül koşulları kontrol eder: sepet ağırlığı ve minimum ara toplam. Ardından ülke ve ağırlık sınıfı için tablodaki fiyatı veya diğer ülkeler için fiyatı alır. Fiyat yoksa kargo firması gizlenir. Sepet ara toplamı Free shipping from tutarına ulaşırsa fiyat 0 olur.

Teslim alma noktası kargo firması yalnızca Hollanda ve Belçika adresleri için ve yalnızca API anahtarıyla sunulur. Teslimat adresinde geçerli bir posta kodu varsa modül, PostNL Checkout API'den en yakın üç teslim alma noktasını ister. Müşterinin posta kodunu, caddesini, bina numarasını, şehrini ve ülkesini ve sizin gönderim adresinizi gönderir. Adrese teslimat kargo firması için hiçbir şey gönderilmez. PostNL'e ulaşılamazsa veya adres için nokta yoksa teslim alma noktası kargo firması gizlenir ve adrese teslimat 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 yenilemesini yavaşlatmaz. Son hata modül sayfasında gösterilir.

Bir kargo firmasını, siparişleri olduktan sonra Shipping > Carriers içinde düzenlerseniz PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak takip eder.

Modül canlı PostNL ücreti sorgulamaz; kargo etiketi, barkod, track and trace, iade veya ön bildirim oluşturmaz. Teslimat günü, akşam veya sabah teslimat seçeneği yoktur. Gönderiyi, kaydedilmiş teslim alma noktasını kullanarak Mijn PostNL'de veya başka bir PostNL aracında oluşturun.

Teslim alma noktaları

Müşteri teslim alma noktası kargo firmasını seçtiğinde, altında en yakın üç noktayla birlikte bir PostNL pickup point listesi belirir: firma adı, adres ve mesafe. Sayfa hiçbir zaman PostNL'i beklemez: liste henüz önbellekte değilse kargo firması seçilir seçilmez yüklenir. Tam posta kodu girilmeden önce müşteri "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çilen nokta sepete kaydedilir ve ödeme yenilendiğinde korunur.

Nokta zorunludur. Nokta olmadan müşteri devam edemez ve "Lütfen bir PostNL teslim alma noktası seçin." mesajını görür. Müşteri Continue düğmesine tıkladığında sunucu, noktayı teslimat adresi için PostNL listesiyle karşılaştırır. Listede yoksa müşteri "Seçilen PostNL teslim alma noktası bu adres için kullanılamıyor. Lütfen yeniden seçin." mesajını görür. PostNL'e ulaşılamazsa müşteri "PostNL teslim alma noktaları şu anda yüklenemiyor. Lütfen birkaç dakika sonra tekrar deneyin veya başka bir kargo yöntemi seçin." mesajını görür. Başka bir adres için seçilmiş bir nokta asla sipariş için kullanılmaz. Siparişle kaydedilen ad ve adres tarayıcıdan değil, PostNL'den gelir.

Yönetici sipariş sayfası: ad ve adresi, Location code ve Partner ID ile birlikte bir PostNL pickup point bloğu.

Sipariş onay ve sipariş ayrıntı sayfaları: ad ve adresiyle PostNL pickup point.

Sipariş e-postaları: noktanın adı ve adresi, sipariş onay e-postasında kargo firmasının adına eklenir. Mağazanın yeni sipariş e-postası (Mail alerts modülü) konum kodunu da gösterir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PostNL lisans bloğu, Modules > Module Manager > VibeFox PostNL > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin 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ı) 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-postnl satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızdaki bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül, son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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 PostNL kargo firmaları ödeme sırasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez; bu nedenle kargo firmaları sizin için de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtarın girilmesinden sonraki ilk 14 gün günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak her zaman lisans anahtarını ve lisans durumunu siler. Bu modülün Reset işlemi veri silmez, bu nedenle anahtar ve durum korunur.

Sorun giderme

PostNL ödeme sırasında görünmüyor: lisansın etkin olduğunu ve kargo firması anahtarının açık olduğunu kontrol edin. Shipping > Carriers içinde kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore zones açık ve ülke izinliyse). Ülke için bir fiyat, ağırlık sınırları ve Minimum subtotal değerlerinin ayarlı olduğunu kontrol edin. Ürünler ürün sayfasında belirli kargo firmalarıyla da sınırlandırılmış olabilir.

Teslim alma noktası kargo firması görünmüyor: yalnızca Hollanda ve Belçika adresleri için, yalnızca API anahtarı, gönderim posta kodu ve fiyat varsa ve yalnızca PostNL müşterinin posta kodu için nokta döndürdüğünde gösterilir. Modül sayfasının üstündeki uyarılara ve Log alanına bakın. Hatalar her zaman günlüğe yazılır; ayrıntılar için Debug log seçeneğini açın.

"PostNL pickup points cannot be loaded right now": PostNL'e ulaşılamadı, API anahtarını reddetti veya gönderim posta kodu eksik. Modül sayfası son hatayı gösterir. Sandbox anahtarı yalnızca Sandbox açıkken, canlı anahtar ise yalnızca kapalıyken çalışır.

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

Ürün ağırlıkları yanlış görünüyor: modül sayfası mağaza ağırlık biriminin bilinmediğini belirtiyorsa International > Localization içinde Local units altından standart bir birim (kg, g, lb veya oz) seçin. O zamana kadar ürün ağırlıkları kg olarak okunur.

Sayfa bir PostNL kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers içinde silinmiştir. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın. Sıfırlama ayarlarınızı ve kargo firmalarının durumunu korur.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox PostNL'in yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbelleğe alınmış teslim alma noktası listeleri ve son API hatası her zaman silinir. Remove data on uninstall açıksa kargo firmaları silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firmaları yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak kargo firmalarına eski durumlarını geri verir. Mevcut siparişler kargo satırlarını ve kayıtlı teslim alma noktasını korur.

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