VibeFox Andreani 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.

Andreani hesabı (yalnızca anlık tarifeler için): anlık tarifeler Andreani teklif API'sini kullanır. Andreani, işletme müşterilerine genellikle ayda yaklaşık 300 gönderiden itibaren API kimlik bilgileri, müşteri kodu ve sözleşme numaraları verir. developers.andreani.com adresine bakın ya da ventapyme@andreani.com adresine yazın. API kullanıcı adı 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 düzenler (kapıya teslimat, şubeden teslim alma). API erişimi olmadan sabit fiyatları kullanın. Şube seçici kimlik bilgileri olmadan çalışır.

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

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Andreani ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. 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ı ayarlayın (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones yolunu izleyin, Arjantin için bir bölge açın ya da oluşturun ve VibeFox Andreani ekleyin. Bölge penceresinde bu seçenek için başlığı, teslimat modunu ve farklı bir sözleşmeyi belirleyebilirsiniz. Ayrıca Ignore shipping zones seçeneğini açıp bunun yerine ülkeleri seçebilirsiniz.

Yapılandırma

Ana ayarlar WooCommerce > Settings > Shipping > VibeFox Andreani altındadır. Tüm kargo bölgeleri için geçerlidir. Eksik ayarlarla ilgili uyarılar (API kimlik bilgileri, sözleşme numarası, döviz kuru, Arjantin için fiyat yok) sayfanın üstünde görünür. Ayarları her kaydettiğinizde önbellekteki jeton, şube listesi ve tarifeler silinir.

Bölge penceresi (yöntemi bir kargo bölgesine eklediğinizde)

Title: bu seçeneğin ödeme sayfasındaki adı. Genel Name ayarını kullanmak için boş bırakın.

Delivery modality: Use global setting ya da dört moddan biri (aşağıya bakın). Hem ev teslimatını hem de şubeden teslim almayı sunmak için, örneğin kapıdan kapıya ve şubeden teslim alma olarak yöntemi bir bölgeye iki kez ekleyin.

Contract number: bu seçenek için Andreani sözleşmesi. Genel sözleşmeyi kullanmak için boş bırakın.

Genel

Enable/Disable: Andreani kargosunu tüm bölgelerde aynı anda açar veya kapatır.

Name: müşterinin ödeme sayfasında gördüğü kargo yöntemi adı. Varsayılan: Andreani.

Tax status: Taxable, WooCommerce'in kargo ücretine vergi eklediği anlamına gelir; bu nedenle API tarifesi IVA olmadan alınır. None, API tarifesinin IVA dahil alındığı anlamına gelir.

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

Environment: Sandbox / QA (apisqa.andreani.com) (varsayılan) ya da 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.

Client code: Andreani'nin sağladığı müşteri kodu (código de cliente), örneğin CL0000000.

Contract number: tarifeler için kullanılan hizmetin sözleşmesi, örneğin kapıya teslimat. Bir bölge başka bir sözleşme kullanabilir, örneğin şubeden teslim alma için.

Origin branch code: tarife teklifleri 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: ilk bölüm Andreani'nin paketi nereden aldığını belirtir (adresiniz ya da paketi bıraktığınız bir şube). İkinci bölüm müşterinin paketi nerede teslim aldığını belirtir.

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

Country prices: mağaza para biriminde, hedef ülke başına bir sabit fiyat; her satırda bir ülke, CC=PRICE biçiminde, örneğin AR=5000. Sabit modda ve API yedeği olarak kullanılır. Başka biçimdeki satırlar yok sayılır ve kaydederken bu satırları listeleyen bir uyarı görünür.

ARS exchange rate: Andreani teklifleri Arjantin pesosu cinsinden verir. Yalnızca mağaza para biriminiz ARS değilse gerekir: mağaza para biriminizde 1 ARS'nin fiyatı, örneğin 0.001. Bu değer olmadan API tarifeleri kullanılmaz. Sabit fiyatlar her zaman mağaza para biriminizdedir.

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. Varsayılan: 0.5.

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 anlık tarifesi zaten tüm sepet içindir ve çarpılmaz.

Uygunluk

Min weight (kg): yöntemin 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 yöntem gizlenir. Varsayılan: 100. 0 sınır olmadığı anlamına gelir.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutarın en az karşılığında olduğunda gösterir. Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir ürün seçilen bir WooCommerce kargo sınıfına aitse yöntem gizlenir.

Ignore shipping zones: yöntemi bir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için sunar.

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 olmalıdır.

Ödeme sayfası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ı WooCommerce > Status > Logs altına kaydeder (kaynak "vfd-andreani"). Hatalar her zaman kaydedilir. Kimlik bilgileri ve jetonlar asla kaydedilmez.

Remove data on uninstall: açıkken eklentiyi silmek, tüm ayarlarını ve bölge yöntemlerini kaldırır. Devre dışı bırakmak hiçbir şeyi silmez. Siparişlere kaydedilmiş şube verileri her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde eklenti sepet ağırlığını kontrol eder (ürün ağırlıkları kg'a çevrilir; ağırlığı olmayan ürünler Default product weight (kg) kullanır), Minimum subtotal ve Excluded shipping classes değerlerini denetler.

Sabit modda fiyat Country prices alanından alınır. Anlık modlarda eklenti 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 çevrilir.

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 asla gösterilmez: yöntem gizlenir veya yedek modda sabit fiyat kullanılır. Nedeni günlüğe yazılır.

Free shipping açıksa ve sepet ara toplamı Free shipping from değerine ulaşırsa tarife 0 olur. Ücretsiz kargo yalnızca yöntemin bir fiyatı olduğu yerlerde geçerlidir: Andreani API tarife döndürmezse (ve yedek olarak kullanılacak sabit fiyat yoksa) yöntem gösterilmez. Per item seçiliyken sabit fiyat ürün sayısıyla çarpılır.

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

Eklenti 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çildiğinde, ödeme sayfasında Andreani seçeneğinin altında hem klasik ödeme sayfasında hem de Ödeme bloğunda 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. Uygun şube yoksa müşteri bir mesaj görür ve başka bir kargo yöntemi seçebilir.

Şube seçilmeden sipariş verilemez: müşteri Please select an Andreani pickup branch. mesajını görür. Bu kontrol her iki ödeme sayfası için sunucuda yapılır.

Seçilen şube siparişe kaydedilir. Yönetici sipariş ekranında yöntem ve şube, teslimat adresinin altında gösterilir. Başka bir il ve şube seçmek için Edit düğmesine tıklayın. Müşteri şubeyi sipariş sayfasında ve sipariş e-postalarında (HTML ve düz metin) Andreani pickup branch olarak görür. Mevcut siparişler şube verilerini korur.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Shipping > VibeFox Andreani sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölümde durum gösterilir; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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 tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Andreani ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de onu görür; (unlicensed — visible to admins only) olarak işaretlenir. Böylece 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.

Lisans 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

Andreani ö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 adresinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Country prices alanında ülke için bir satır olduğunu (sabit fiyatlar veya yedek olarak) doğrulayın; ardından ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes değerlerini kontrol edin. Ayarlar sayfasının üstündeki uyarıları okuyun.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını açın (kaynak "vfd-andreani"). Nedeni gösterir: eksik kimlik bilgisi 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 bir Andreani HTTP hatası. Andreani API, fixed price if the API fails seçiliyken, siz sorunu çözerken müşteriler yine sabit fiyatı alır.

Mağazam Arjantin pesosu kullanmıyor: ARS exchange rate değerini mağaza para biriminizde 1 ARS'nin değerine ayarlayın.

Kargo vergisi yanlış görünüyor: Tax status Taxable olduğunda IVA'sız Andreani tarifesi kullanılır ve WooCommerce kendi vergisini ekler. None olduğunda IVA dahil tarife kullanılır ve WooCommerce vergi eklemez. Taxable kullanıyorsanız WooCommerce vergilerinin 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 güncel görünmüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki jetonu, şube listesini ve tarifeleri temizler.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir hak 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur ve yalnızca önbellekleri temizler. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekteki jeton, şube listesi ve tarifeler her zaman silinir. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa silinir. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlere kaydedilmiş şube verileri asla silinmez.

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