VibeFox PostNord for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

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 taşıyıcılar yine çalışır, ancak müşteriler servis noktası seçemez.

PostNord sözleşmesi: paket göndermek için, örneğin MyPack Collect veya MyPack Home için normal PostNord müşteri sözleşmeniz gerekir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Yönetici panelinde 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 veya daha sonra modül listesinde VibeFox PostNord öğesini bulup Configure düğmesine tıklayın.

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

4. PostNord API key değerini yapıştırın, Agreement country seçin, Country prices alanlarını doldurun (bkz. Yapılandırma) ve Save düğmesine tıklayın.

Kurulumda modül iki taşıyıcı oluşturur. PostNord servis noktasına teslim eder ve teslimat süresi metni Delivery to a PostNord service point olur. Açıktır. PostNord Home delivery adrese teslim eder ve metni PostNord home delivery olur. Home delivery açılana kadar kapalıdır. İki taşıyıcı da İsveç, Danimarka, Norveç ve Finlandiya bölgelerine ve tüm müşteri gruplarına atanır. Bölgeleri, müşteri gruplarını, teslimat süresi metnini, logoyu ve boyut sınırlarını Shipping > Carriers bölümünden 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 PostNord > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış servis noktası listelerini de temizler.

Ayarların üstünde sayfa; henüz API anahtarı yoksa, henüz fiyat yoksa, bir PostNord taşıyıcısı silinmişse veya mağazanın ağırlık birimi modül tarafından bilinmiyorsa uyarır. Bu durumda ürün ağırlıkları kg olarak alınır. International > Localization bölümünde kg, g, lb veya oz kullanın (Local units).

Genel

Enable/Disable: servis noktası taşıyıcısını açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Name: ödeme sayfasında servis noktası taşıyıcısının adı, örneğin "PostNord MyPack Collect". Varsayılan: PostNord. Zorunlu.

Home delivery: PostNord kapıya teslimatını da sunar. Bu, servis noktası olmayan ikinci taşıyıcıdır. Varsayılan olarak kapalıdır.

Home delivery name: ödeme sayfasında kapıya teslimat taşıyıcısının adı, örneğin "PostNord MyPack Home". Varsayılan: PostNord Home delivery. Zorunlu.

Tax status: None, aşağıdaki fiyatların kesin olduğu anlamına gelir. Taxable: ve ardından bir vergi kuralı, PrestaShop'un bu kuralın kargo vergisini fiyatların üzerine eklediği anlamına gelir. İki taşıyıcı için de geçerlidir.

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 günlüğe yazılmaz. Kaydettikten sonra alan 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.

Remove the saved API key: kutucuğu işaretleyip Save düğmesine tıklayarak kayıtlı anahtarı silin.

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

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

Bölüm başlığı mağazanızın varsayılan para birimini gösterir. Fiyatlar bu para biriminde, vergi hariç ve iki taşıyıcı için aynıdır. PostNord herkese açık bir fiyat API'si sunmadığı için fiyatları siz belirlersiniz; genellikle PostNord sözleşmenizdeki fiyatlar. Sıra şöyledir: ücretsiz kargo eşiği, ardından ülke tablosu ve son olarak yedek ücret.

Calculation type: Per order fiyatı bir kez alır. Per item (price x 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 çöp kutusu simgesine 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 değerli bir ağırlık sütunu Price sütununu kullanır ve Price değeri 0 ise kargo ücretsizdir. * All other countries ülkesi, kendi satırı olmayan tüm ülkeleri kapsar. Ondalık sayılar virgül veya nokta ile yazılır (9,99 veya 9.99). Yeni bir satır, tüm fiyatları 0 olan * All other countries olarak başlar. Kaydetmeden önce ülkeyi seçip fiyatları girin ya da satırı silin. Boş bir hücre 0 olarak kaydedilir. 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 tür ülkelerde taşıyıcıları gizlemek için boş bırakın.

Free shipping from: PostNord'un ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergi hariç). Ülke tablosundan önce kontrol edilir, bu yüzden fiyat satırı olmayan bir ülkede de geçerlidir. Ücretsiz kargo hiç sunulmamasını istiyorsanız boş bırakın.

Uygunluk

Min weight (kg): sepet bundan hafifse taşıyıcıları gizler. Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür. 0, sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan ağırsa taşıyıcıları 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 kabul eder. Max weight (kg) değerinden büyük bir Min weight (kg) hatayla reddedilir ve hiçbir şey kaydedilmez.

Minimum subtotal: taşıyıcıları yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergi hariç) bu tutara eşit veya üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Ignore shipping zones: açıkken, PostNord'un taşıyıcılarının bölgeleri aşağıdaki ülkeleri içermese bile PostNord bu ülkeler için sunulur. Taşıyıcılar tüm etkin bölgelere bağlanır ve daha sonra oluşturduğunuz bir bölge hemen bağlanır. Tekrar kapattığınızda taşıyıcılar önceki bölgelerine geri döner. Kapalıyken taşıyıcılar yalnızca kendi bölgelerinde sunulur.

Countries (Ignore shipping zones): bu mod için hedef ülkeler. Tüm ülkelere izin vermek 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. 0 veya daha büyük bir sayı olmayan değer kaydedilmez ve bir mesaj gösterilir.

Gelişmiş

Debug log: fiyat hesaplamalarını ve API çağrılarını modül klasöründeki logs/vfd_ptnd_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. API anahtarı asla günlüğe yazılmaz. İşiniz bittiğinde günlüğü kapatın.

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

Remove data on uninstall: açıkken modülü kaldırmak PostNord ayarlarını ve taşıyıcılarını siler. Kapalıyken kaldırma yalnızca taşıyıcıları kapatır. Siparişlerde kaydedilmiş servis noktaları her zaman korunur.

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

Kargo adımında PrestaShop, her PostNord taşıyıcısının fiyatını modülden ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül sepet ağırlığını ve minimum ara toplamı kontrol eder. Ücretsiz kargo geçerliyse fiyat 0 olur. Aksi halde fiyat ülke tablosundan, ardından yedek ücretten gelir. Fiyat yoksa taşıyıcı gizlenir. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Servis noktası taşıyıcısı ve İsveç, Danimarka, Norveç veya Finlandiya'daki bir teslimat adresi için sunucunuz, PostNord Business Location API'den teslimat posta koduna en yakın 10 servis noktasını 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 önbelleğe alınır, "nokta yok" yanıtları 1 saat. API hataları 5 dakika önbelleğe alınır; böylece bir PostNord kesintisi her kargo adımı güncellemesini yavaşlatmaz. Teslimat adımı hiçbir zaman PostNord'u beklemez: liste henüz önbellekte değilse, müşteri taşıyıcıyı seçtikten sonra yüklenir.

Diğer hedefler için taşıyıcılar seçici olmadan, kendi fiyatlarınızla yine sunulabilir. Kapıya teslimat taşıyıcısı hiçbir zaman seçici göstermez.

Shipping > Carriers bölümünde, siparişleri olan bir taşıyıcıyı düzenlerseniz PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

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

Teslim noktaları

Müşteri servis noktası taşıyıcısını seçtiğinde, altında en yakın noktaları şehre göre gruplanmış ve mesafe bilgisiyle gösteren bir PostNord service point listesi belirir. Posta kodu girilmeden önce müşteri "Bir PostNord servis noktası seçmek için posta kodunuzu girin." mesajını görür. Seçim sepetle birlikte kaydedilir ve teslimat adımı güncellemelerinde korunur.

Liste yüklendiğinde bir nokta seçmek zorunludur. Seçim yapılmazsa Continue "Lütfen bir PostNord servis noktası seçin." mesajıyla durur. Seçilen nokta, sunucuda teslimat adresi için PostNord listesine karşı kontrol edilir. Başka bir posta kodu için seçilmiş bir nokta kullanılmaz.

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

Yönetici sipariş sayfası: ad, adres ve Service point ID içeren bir PostNord service point bloğu. Hiçbir nokta seçilmediyse "seçilmedi - PostNord, kargo adresine en yakın servis noktasına teslim eder" yazar.

Müşterinin sipariş onayı ve sipariş ayrıntıları: PostNord service point: ad ve adresle birlikte.

Sipariş e-postaları: müşteriye giden sipariş onayı ve mağazaya giden yeni sipariş bildirimi, taşıyıcı adının yanında nokta adını, adresini ve kimliğini gösterir. Mağaza bildirimi, nokta olmadığında "not selected" da gösterir.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PostNord lisans bloğu, Modules > Module Manager > VibeFox PostNord > 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ı maskelenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu 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-postnord satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetici panelinin 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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar 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ızda serbest bırakın.

Etkin bir anahtar olmadan PostNord taşıyıcıları ödeme sayfasında müşterilere gösterilmez ve hiçbir kargo fiyatı hesaplanmaz. PrestaShop vitrini yönetici paneline giriş yaptığınızı bilmez, bu yüzden taşıyıcılar sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak her zaman lisans anahtarını ve lisans durumunu siler. Bu modülün Reset işlemi verileri silmez, bu yüzden anahtar ve durum korunur.

Sorun giderme

PostNord ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable (veya Home delivery) seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını doğrulayın ya da Ignore shipping zones seçeneğini açın. Ülke için bir fiyat olduğunu (ülke satırı, * satırı veya Fallback cost), ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

Seçici servis noktalarının yüklenemediğini söylüyor: API key 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, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Sipariş yine de verilebilir; PostNord bu durumda en yakın servis noktasına teslim eder.

Beklenmeyen servis noktaları: Agreement country ayarını kontrol edin. Hangi servis noktalarının sunulacağını bu belirler.

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

Bir değişiklikten sonra servis noktaları eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış listeleri temizler.

Sayfa bir PostNord taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers bölümünde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünden modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox PostNord yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Modülü devre dışı bırakmak yalnızca önbelleğe alınmış servis noktası listelerini temizler. Kaldırmada önbelleğe alınmış listeler her zaman silinir. Remove data on uninstall açıksa taşıyıcılar silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcılar yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kayıtlı taşıyıcılara önceki durumlarını geri verir. Siparişlerde kaydedilmiş servis noktaları her zaman korunur.

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