VibeFox PostNord for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

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 kargo yöntemi yine çalışır, ancak müşteriler bir servis noktası seçemez.

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

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

Kurulum

İndirme dosyası, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_postnord-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_postnord.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_postnord-oc3-(version).ocmod.zip dosyasını seçin. Uzantı OCMOD değişikliği eklemez, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine, paketin upload klasöründeki içeriği mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve uzantı türü olarak Shipping seçin. VibeFox PostNord uzantısını bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

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

5. Enable/Disable (servis noktası teslimatı) ve/veya Home delivery seçeneğini etkinleştirin, PostNord API key değerini yapıştırın, Agreement country seçin, Country prices veya bir Fallback cost alanını doldurun (bkz. Yapılandırma) ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_postnord.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır, adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox PostNord eklentisini bulun, Install düğmesine (yeşil +) ve sonra Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3'teki 4. ve 5. adımlarda olduğu gibi girin. Ayar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, birini etkinleştirip kaydedene kadar iki seçenek de kapalı kalır. Uzantıyı kaldırdıktan sonra yeniden kurarsanız, sakladığınız PostNord ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Shipping > VibeFox PostNord > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbellekteki servis noktası listelerini de temizler. Ayarları yalnızca bu uzantı için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Bir değer yanlışsa hiçbir şey kaydedilmez ve sayfa nedenini gösterir: boş bir ad, 64 karakterden uzun olan veya < > ; = # { } içeren bir ad, tam sayı olmayan bir sıralama, geçersiz bir vergi durumu veya coğrafi bölge ya da Min weight (kg) değerinin Max weight (kg) değerinden büyük olması. 0 veya daha büyük bir sayı olmayan bir sayısal alan boş olarak kaydedilir ve bir mesaj gösterilir. 0 veya daha büyük bir sayı olmayan bir fiyat tablosu hücresi 0 olarak kaydedilir ve bir mesaj gösterilir.

Ayarların üzerinde sayfa; henüz API anahtarı yoksa, henüz fiyat yoksa ve mağazada "kg" ağırlık sınıfı yoksa uyarı verir.

Genel

İki teslimat seçeneği, Availability içinde belirlenen coğrafi bölgede veya Ignore shipping zones ülkeleri için sunulur.

Enable/Disable: PostNord teslimatını bir servis noktasına ya da paket dolabına açar veya kapatır. Müşteri noktayı ödeme sayfasında seçer. Varsayılan: kapalı.

Name: ödeme sayfasındaki servis noktası seçeneğinin adı, örneğin "PostNord MyPack Collect". Varsayılan: PostNord. Zorunlu, en fazla 64 karakter, < > ; = # { } içermeden.

Home delivery: PostNord ev teslimatını da sunar; servis noktası olmayan ikinci bir seçenektir. Varsayılan: kapalı.

Home delivery name: ödeme sayfasındaki ev teslimatı seçeneğinin adı, örneğin "PostNord MyPack Home". Varsayılan: PostNord Home delivery. Name ile aynı kurallar geçerlidir.

Sort order: PostNord'un ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Bir tam sayı.

Tax status: None (the prices are final) (varsayılan) veya bir vergi sınıfı: bu durumda OpenCart, o sınıfın kargo vergisini fiyatların üzerine ekler. Her iki seçenek 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, tarayıcıya asla gönderilmez ve günlüğe asla 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şaretleyin ve kayıtlı anahtarı silmek için Save düğmesine tıklayın.

Test mode: PostNord test ortamını (atapi2.postnord.com) kullanır. 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

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

Calculation type: Per order (varsayılan) 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, silmek için × düğmesine tıklayın. Her satırda bir Price sütunu 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 ve Price değeri 0 ise ücretsiz kargo anlamına gelir. * All other countries ülkesi, kendi satırı olmayan tüm ülkeleri kapsar. Virgüllü veya noktalı ondalık sayılar (9,99 veya 9.99). Yeni bir satır, tüm fiyatları 0 olan * All other countries olarak başlar. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı kaldırın. Boş bir hücre 0 olarak kaydedilir.

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

Free shipping from: bu tutardan itibaren PostNord'un ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, kupon sonrası, vergi hariç). Ülke tablosundan önce kontrol edilir, bu nedenle fiyat satırı olmayan bir ülke için de geçerlidir. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Kullanılabilirlik

Min weight (kg): sepet bundan hafifse PostNord'u gizler. Ürün ağırlıkları, ağırlık sınıflarından dönüştürülür. Varsayılan: 0, yani sınır yok.

Max weight (kg): sepet bundan ağırsa PostNord'u 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: PostNord'u yalnızca sepet ara toplamı (kargo gerektiren ürünler, kupon sonrası, vergi hariç) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Geo zone: PostNord'u yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones altında yönetilir. Ignore shipping zones açıkken kullanılmaz.

Ignore shipping zones: açıkken coğrafi bölge kontrol edilmez ve PostNord aşağıdaki ülkeler için sunulur. Kapalıyken yalnızca coğrafi bölgede 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.

Gelişmiş

Debug log: fiyat hesaplamalarını ve API çağrılarını storage/logs/vfd_ptnd_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. API hataları her zaman kaydedilir. API anahtarı asla kaydedilmez. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında yeni bir günlük başlatılır.

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

Remove data on uninstall: açıkken uzantı kaldırıldığında PostNord ayarları ve günlük silinir. Önbellekteki servis noktası listeleri her zaman silinir. Siparişlerde kaydedilen servis noktaları her zaman korunur.

İçe / Dışa Aktarma

Export: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API anahtarı dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Değerler normal bir kayıtta olduğu gibi kontrol edilir. Kayıtlı API anahtarı korunur.

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

OpenCart kargo yöntemlerini gösterdiğinde, her PostNord seçeneğinin fiyatını uzantıdan ister. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Uzantı, coğrafi bölgeyi veya ülke listesini, sepet ağırlığını ve minimum ara toplamı kontrol eder. Ücretsiz kargo geçerliyse fiyat 0'dır. Aksi halde fiyat önce ülke tablosundan, ardından yedek ücretten alınır. Fiyat yoksa seçenek gizlenir. Fiyat varsayılan para biriminizde hesaplanır ve müşteriye kendi para biriminde, Tax status olarak seçilen verginin eklenmesiyle gösterilir. Fiyat hesaplaması hiçbir zaman PostNord'a bağlanmaz.

Servis noktası seçeneği 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 önbellekte tutulur, "nokta yok" yanıtları ise 1 saat. API hataları 5 dakika önbelleğe alınır; böylece bir PostNord kesintisi her ödeme güncellemesini yavaşlatmaz. Önbellek, uzantının kendi veritabanı tablosunda tutulur. Teslimat adımı hiçbir zaman PostNord'u beklemez: liste henüz önbellekte değilse, müşteri seçeneği seçtikten sonra yüklenir.

Diğer hedefler için seçenekler, seçici olmadan kendi fiyatlarınızla yine de sunulabilir. Ev teslimatı seçeneği hiçbir zaman seçici göstermez.

Uzantı, 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ı kullanın; bu araçlara kaydedilen servis noktası kimliği gerekir.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde bir PostNord seçeneği seçer. Fiyatlar OpenCart 3'tekiyle aynıdır.

Teslim alma noktaları

Teslimat adresi İsveç, Danimarka, Norveç veya Finlandiya'da olduğunda, servis noktası seçeneğinin altında, en yakın noktaların şehre göre gruplandığı, her birinin adres ve mesafe bilgisiyle gösterildiği bir PostNord service point listesi görünür. Posta kodu girilmeden önce müşteri "PostNord servis noktası seçmek için posta kodunuzu girin." ifadesini görür. Seçim ödeme için hemen kaydedilir.

Liste yüklendiğinde bir nokta seçilmesi zorunludur. Nokta seçilmezse, teslimat yöntemi adımındaki Continue "Lütfen bir PostNord servis noktası seçin." uyarısıyla durur. Seçilen nokta, sunucuda teslimat adresi için PostNord listesine göre kontrol edilir. Başka bir posta kodu için seçilen bir nokta kullanılmaz.

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

Sipariş sayfaları, e-postalar ve fatura: nokta, siparişin kargo yöntemine eklenir; örneğin "PostNord: ad, adres (ID 12345)" (önce seçeneğin adı, sonra nokta). Metin 128 karakterden uzunsa adres atlanır (OpenCart 4'te bu sınır yoktur ve adres her zaman korunur). OpenCart'ın kargo yöntemini gösterdiği her yerde görünür: müşterinin sipariş geçmişinde, sipariş e-postalarında, faturada ve Sales > Orders bölümünde. Noktası olmayan bir sipariş, yöntemin sade adını korur.

Yönetici sipariş sayfası: Sales > Orders bölümünde sipariş sayfası, geçmişin üstünde ad, adres ve Service point ID bilgilerinin yer aldığı bir PostNord service point paneli gösterir. Hiçbir nokta seçilmediyse "seçilmedi - PostNord, teslimat adresine en yakın servis noktasına teslim eder" ifadesi görünür.

OpenCart 4'te liste, Shipping method options penceresinde PostNord service point seçeneğinin altında görünür ve pencere her açıldığında yeniden yüklenir; çünkü tek sayfalık ödemede adres değişebilir. Pencerenin Continue düğmesi, listedeki bir nokta olmadan ilerlemez; mesaj aynıdır. Müşteri liste hâlâ yüklenirken tıklarsa, pencere listeyi mesaj göstermeden bekler ve ardından Continue düğmesini kendiliğinden yeniden tıklar. Kullanılamayan bir liste de siparişi engellemez. OpenCart 4 ödeme için tek bir sipariş tutar ve müşteri her onaylamada onu günceller; siparişin servis noktası onunla birlikte güncellenir.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox PostNord, Extensions > Extensions > Shipping > VibeFox PostNord > Edit sayfasının ilk bloğudur ve ayarların üstündedir. 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: opencart-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 uzantı için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan PostNord seçenekleri ödeme sayfasında müşterilere gösterilmez ve fiyat hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, seçenekleri yine de mağazada görür; seçenekler (unlicensed — visible to admins only) ile işaretlenir. Böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar yoksa seçenekler herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. 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, yönetici Dashboard ekranını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

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. Ignore shipping zones açıksa Geo zone veya Countries listesini kontrol edin. Ülke için bir fiyat tanımlı 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ünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

Seçici servis noktalarının yüklenemediğini bildiriyor: API key değerini ve Test mode ayarını kontrol edin. Canlı anahtar test ortamında çalışmaz, tersi de geçerlidir. Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve uzantı sayfasındaki Log alanı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ı 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: uzantı sayfasında Save düğmesine tıklayın. Bu, önbellekteki listeleri temizler.

Ürün ağırlıkları yanlış görünüyor: uzantı sayfası mağazada "kg" ağırlık sınıfı olmadığını bildiriyorsa, System > Localisation > Weight Classes bölümünü kontrol edin. Ürün ağırlıkları, sınıflarının birim adına göre dönüştürülür; bilinmeyen birimler kg olarak okunur.

Sayfa "Warning: You do not have permission to modify VibeFox PostNord!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. Gruba, System > Users > User Groups altında extension/shipping/vfd_postnord (OpenCart 3) veya extension/vfd_postnord/shipping/vfd_postnord (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: PostNord API adresi vfd_ptnd_api_url ayarıyla değiştirilebilir (testler için); ayar sayfasında bunun için bir alan yoktur.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox PostNord yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman silinir. OpenCart her zaman uzantının durumunu, Sort order, Tax status ve Geo zone değerlerini sıfırlar. Önbellekteki servis noktası listeleri her zaman silinir. Remove data on uninstall açıksa PostNord ayarları, hata ayıklama günlüğü ve hiçbir zaman siparişe dönüşmemiş ödemelerin servis noktaları da silinir. Kapalıysa diğer ayarlar korunur ve uzantıyı yeniden kurduğunuzda yeniden kullanılır. Mevcut siparişler kargo yöntemlerini, ücretlerini ve kaydedilen servis noktasını korur.

OpenCart 4'te eklenti dosyalarını da silmek için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox PostNord yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

PostNord, ilgili sahibinin ticari markasıdır. Bu uzantının PostNord ile bir bağlantısı yoktur ve PostNord tarafından onaylanmamıştır.