VibeFox Andreani for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x arası.

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

Andreani hesabı (yalnızca anlık tarifeler için): anlık tarifeler Andreani teklif API'sini kullanır. Andreani, işletme müşterilerine API kimlik bilgileri, müşteri kodu ve sözleşme numaraları verir; genellikle ayda yaklaşık 300 gönderiden itibaren. developers.andreani.com adresine bakın veya ventapyme@andreani.com adresine yazın. API kullanıcı adına ve şifresine, müşteri koduna ve sözleşme numarasına ihtiyacınız olacak. Andreani her hizmet için ayrı bir sözleşme verir (ev teslimatı, şubeden teslim alma). API erişimi olmadan sabit fiyatları kullanın. Şube seçici kimlik bilgileri olmadan çalışır.

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

Kurulum

1. Yönetim 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 ya da daha sonra modül listesinde VibeFox Andreani modülünü bulup Configure düğmesine tıklayın.

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

4. Adı, tarife kaynağını, ülke fiyatlarını (örneğin AR=5000) ve anlık tarifeler için API kimlik bilgilerini, müşteri kodunu ve sözleşme numarasını belirleyin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül iki taşıyıcı oluşturur:

Her iki taşıyıcı da Arjantin bölgesine ve tüm müşteri gruplarına atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, 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 Andreani > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Kaydettikten sonra Settings saved. Cached token, branches and rates were cleared. mesajını görürsünüz. Eksik ayarlarla ilgili uyarılar (API kimlik bilgileri, sözleşme numarası, ARS döviz kuru, Arjantin için fiyat yok, silinmiş bir taşıyıcı) sayfanın üstünde gösterilir. Modül mağazanın ağırlık veya boyut birimini tanımıyorsa da bir uyarı çıkar (bu durumda ağırlıklar kg, boyutlar cm olarak okunur). Kaydederken 64 karakterden uzun bir ad ya da Max weight (kg) değerinden büyük bir Min weight (kg) reddedilir ve hiçbir şey kaydedilmez. Sayı olmayan, negatif bir değer ya da 0 veya daha küçük bir ARS exchange rate kaydedilmez ve bir uyarı alanı belirtir.

General

Enable/Disable: Andreani kargoyu açar veya kapatır. Bu, Shipping > Carriers bölümündeki ana taşıyıcının durumuyla aynı anahtardır. İkinci seçeneğin kendi anahtarı vardır.

Name: ödeme sırasında müşteriye gösterilen taşıyıcı adı. Varsayılan: Andreani. Zorunlu.

Tax status: None veya vergi kurallarınızdan biri ile Taxable. Bir vergi kuralıyla mağaza kargo ücretine vergi ekler, bu nedenle API tarifesi IVA hariç alınır. None ile API tarifesi IVA dahil alınır. Ayar iki Andreani taşıyıcısının da kaydedilir.

Andreani API (anlık tarifeler için gereklidir)

Environment: Sandbox / QA (apisqa.andreani.com) (varsayılan) veya Production (apis.andreani.com). Kimlik bilgilerinizin ait olduğu ortamı kullanın.

API username: Andreani API kullanıcı adınız.

API password: Andreani API şifreniz. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. Clearing the API username removes it too. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Client code: Andreani tarafından verilen müşteri kodu (código de cliente), örneğin CL0000000.

Contract number: tarifeler için kullanılan hizmetin sözleşmesi, örneğin ev teslimatı. İkinci seçenek farklı bir sözleşme kullanabilir, örneğin şubeden teslim alma için.

Origin branch code: teklifler için isteğe bağlı çıkış şubesi (sucursalOrigen). Sözleşmenizde tanımlı şubeyi kullanmak için boş bırakın.

Teslimat ve tarifeler

Delivery modality: ana taşıyıcının modu. İlk bölüm Andreani'nin paketi nereden aldığını gösterir (adresiniz ya da paketi bıraktığınız bir şube). İkinci bölüm müşterinin paketi nerede teslim aldığını gösterir.

Rate source: fiyatın nasıl hesaplandığı.

Country prices: mağazanızın varsayılan para biriminde, vergi hariç, hedef ülke başına sabit bir fiyat; her satırda bir ülke, CC=PRICE biçiminde, örneğin AR=5000. Sabit modda ve API başarısız olduğunda yedek olarak kullanılır. Satırı olmayan ülkelerin sabit fiyatı yoktur. Başka biçimdeki satırlar yok sayılır ve kaydederken bir uyarı bunları listeler.

ARS exchange rate: Andreani, Arjantin pesosu cinsinden teklif verir. Yalnızca mağaza varsayılan para biriminiz ARS değilse gerekir: 1 ARS'nin mağaza para birimindeki değeri, örneğin 0.001. Bu olmadan API tarifeleri kullanılmaz.

Default product weight (kg): API tarifeleri istenirken ve ağırlık sınırları kontrol edilirken ağırlığı olmayan ürünler için kullanılır. Boş bırakılırsa 0,5 kg olur.

Calculation type: Per order fiyatı bir kez alır. Per item (price x number of items), Country prices alanındaki sabit fiyatı sepetteki ürün sayısıyla çarpar. Andreani'nin anlık tarifesi zaten tüm sepet için geçerlidir ve çarpılmaz.

Kullanılabilirlik

Min weight (kg): taşıyıcının görünmesi için gereken minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight (kg): maksimum sepet ağırlığı. Aşılırsa taşıyıcı gizlenir. Boş bırakılırsa 100 kg, 0 sınır olmadığı anlamına gelir.

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

Ignore shipping zones: aşağıdaki ülkeler için bölge ayarlamadan Andreani sunar. Açıldığında her iki taşıyıcı da tüm bölgelere bağlanır ve sonradan oluşturulan bir bölge hemen bağlanır. Kapatıldığında taşıyıcılar önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Tüm ülkelere izin vermek için boş bırakın. Yalnızca Ignore shipping zones açıkken kullanılır.

Ücretsiz kargo

Free shipping: ücretsiz kargo eşiğini açar.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Free shipping açık olmasını gerektirir.

İkinci seçenek

Kendi adı, teslimat modu ve sözleşmesi olan ikinci bir Andreani taşıyıcısı; örneğin ana taşıyıcıda "a domicilio" ve burada "retiro en sucursal", ikisini birden sunmak için. Diğer tüm ayarlar ortaktır.

Enable second option: ikinci taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers bölümündeki durumuyla aynı anahtardır. Varsayılan: kapalı.

Second option name: bu seçeneğin ödeme sırasındaki adı. Varsayılan: Andreani - branch pickup. Zorunlu.

Delivery modality: Use global setting veya dört moddan biri. Varsayılan: Door to branch (Puerta a Sucursal).

Contract number: Andreani her hizmet için ayrı bir sözleşme verir (ev teslimatı, şubeden teslim alma). Genel sözleşmeyi kullanmak için boş bırakın.

Ödeme sırasında şube seçici (door to branch ve branch to branch için gösterilir)

Province select width: il listesinin CSS genişliği, örneğin 100% veya 300px. Varsayılan: 100%.

Branch select width: şube listesinin CSS genişliği, örneğin 100% veya 400px. Varsayılan: 100%.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamalarını modül klasöründeki logs/vfd_andr_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Kimlik bilgileri ve jetonlar hiçbir zaman kaydedilmez.

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

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

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

Teslimat adımında PrestaShop, her Andreani 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 ülkeleri kontrol eder (Ignore shipping zones açıkken), sepet ağırlığını (ürün ağırlıkları kg'a çevrilir, ağırlığı olmayan ürünler Default product weight (kg) kullanır) ve Minimum subtotal değerini.

Sabit modda fiyat Country prices alanından alınır. Anlık modlarda modül Andreani API'sine giriş yapar ve hedef posta kodu, sözleşme, müşteri kodu, kg cinsinden ağırlık, ürün boyutlarından hesaplanan hacim ve beyan edilen değer (ARS cinsinden sepet ara toplamı) ile bir teklif ister. Anlık tarife yalnızca geçerli bir Arjantin posta kodu için istenir. Mağaza para biriminiz ARS değilse ARS tutarı ARS exchange rate ile dönüştürülür. Fiyat mağazanın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Giriş jetonu 23 saat önbelleğe alınır ve Andreani reddettiğinde otomatik olarak yenilenir. Teklifler 1 saat önbelleğe alınır. Başarısız bir API çağrısı 5 dakika boyunca tekrarlanmaz. API hataları müşteriye hiçbir zaman gösterilmez: taşıyıcı gizlenir veya yedek modda sabit fiyat kullanılır. Neden günlüğe yazılır.

Free shipping açıksa ve sepet ara toplamı Free shipping from değerine ulaşırsa fiyat 0 olur. Ücretsiz kargo yalnızca taşıyıcının bir fiyatı olduğu yerlerde uygulanır: Andreani API tarife döndürmezse ve yedek olarak kullanılacak bir sabit fiyat yoksa taşıyıcı gösterilmez.

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

Modül Andreani gönderileri oluşturmaz, etiket basmaz ve paketleri takip etmez. Bunlar için Andreani web portalını kullanın.

Teslim noktaları

Door to branch veya Branch to branch seçili bir taşıyıcı seçildiğinde, teslimat adımında altında bir il listesi ve bir şube listesi görünür. İl, teslimat adresinden önceden seçilir. Şube listesi Andreani'nin herkese açık şube API'sinden gelir ve 12 saat önbelleğe alınır. Paket teslim etmeyen şubeler listelenmez. Hiç şube yoksa müşteri No Andreani branches available right now. Please try again later or choose another shipping method. mesajını görür.

Seçim, müşteri seçer seçmez sepete kaydedilir. Yalnızca Andreani'nin güncel listesindeki bir şube kabul edilir. Şube olmadan teslimat adımındaki Continue ve ödeme adımındaki sipariş düğmesi ilerlemez ve müşteri Please select an Andreani pickup branch. mesajını görür. Müşteri devam ettiğinde sunucu şubeyi yeniden kontrol eder. Şube listede artık yoksa müşteri The selected Andreani branch is not available. Please choose another one. mesajını görür.

Müşteri başka bir taşıyıcıya geçmeden önce Andreani altında seçtiği şube siparişe ait değildir.

Siparişler

Sipariş teslimat modunu ve şube modları için seçilen şubeyi saklar.

Admin order page: bir Andreani bloğu modu ve şubeyi (ad, ID ve il) gösterir. Değiştirmek için Edit düğmesine tıklayın, başka bir il ve şube seçin ve Save düğmesine tıklayın. Branch updated. mesajını görürsünüz. Yalnızca Andreani listesindeki şubeler kaydedilebilir. Liste kullanılamıyorsa şube değiştirilemez.

Müşteri: şube, sipariş onay sayfasında ve sipariş ayrıntıları sayfasında Andreani pickup branch: olarak gösterilir.

E-postalar: sipariş onay e-postasında ve mağazaya giden yeni sipariş e-postasında (Mail alerts modülü) şube, taşıyıcı adına eklenir. Mağaza e-postası ayrıca şube ID'sini gösterir.

Mevcut siparişler kendi şube verilerini korur.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Andreani lisans bloğu, Modules > Module Manager > VibeFox Andreani > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın hangi tarihe kadar geçerli olduğunu ve alan adınızı) gösterir. Ayrıca durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key düğmeleri bulunur. Bunların altında Product: presta-shipping-andreani satırı ve Manage licenses and domains in your account bağlantısı yer alır; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office 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 veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Andreani taşıyıcıları ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop mağazası back office'e giriş yaptığınızı bilmez; bu nedenle taşıyıcılar sizin için de gizlenir: modülü bir anahtar satın almadan önce yapılandırabilirsiniz, 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 yenileme gerektirir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Andreani ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin (ikinci taşıyıcı için ayrıca Enable second option). Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesini ve müşteri grubunu kapsadığını kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Country prices alanında ülke için bir satır olduğunu kontrol edin (sabit fiyatlar veya yedek için) ve ağırlık sınırlarını ile Minimum subtotal değerini kontrol edin. Configure sayfasının üstündeki uyarıları okuyun. Ayrıca ürünler, ürün sayfasında belirli taşıyıcılarla sınırlandırılmış olabilir.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Nedeni gösterir: eksik kimlik bilgileri veya sözleşme numarası, başarısız giriş (yanlış kullanıcı adı, şifre veya ortam), henüz geçerli bir Arjantin posta kodu olmaması, döviz kuru olmaması ya da Andreani HTTP hatası. Andreani API, fixed price if the API fails seçeneğiyle, siz sorunu çözerken müşteriler yine sabit fiyatı görür.

Mağazam Arjantin pesosu cinsinden değil: ARS exchange rate değerini, mağazanızın varsayılan para biriminde 1 ARS'nin değerine ayarlayın.

Kargo vergisi yanlış görünüyor: Tax status alanında bir vergi kuralıyla IVA'sız Andreani tarifesi kullanılır ve PrestaShop kendi vergisini ekler. None ile IVA'lı tarife kullanılır ve vergi eklenmez. Vergilerin açık olduğunu ve vergi kuralının Arjantin için ayarlandığını kontrol edin.

Listede şube yok: Andreani şube API'si yanıt vermedi. Başarısız istek 5 dakika sonra yeniden denenir. Günlüğü kontrol edin.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış jetonu, şube listesini ve tarifeleri temizler.

Sayfa bir Andreani 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ünde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Andreani 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ış jeton, şube listesi ve tarifeler de her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcılar silinir (siparişler geçmişini korur) ve ayarlar, günlük ve siparişi olmayan sepetlerdeki şube seçimleri kaldırılır. Kapalıysa taşıyıcılar yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak ya da modülün Reset işlemi, iki taşıyıcıya da önceki durumlarını geri verir. Siparişlerde kaydedilen şube verileri hiçbir zaman silinmez.

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