VibeFox Servientrega for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, yüklü ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

Servientrega hesabı (yalnızca canlı tarifeler için): canlı tarifeler Servientrega Cotizador Corporativo'yu (kurumsal teklif API'si) kullanır. Buna erişimi olan bir Servientrega kurumsal (kredi) hesabına ihtiyacınız vardır. Üç bilgiye ihtiyacınız vardır: kullanıcı, şifre ve faturalama kodu (código de facturación, genellikle SER ile başlar). Bunlar SISCLINET kimlik bilgileridir ve Servientrega ticari danışmanınız tarafından verilir. Yalnızca sabit fiyat kullanıyorsanız Servientrega hesabına ihtiyacınız yoktur.

Sunucu erişimi (yalnızca canlı tarifeler için): sunucunuz web.servientrega.com adresine 8058 numaralı bağlantı noktasında (teklif API'si) ve 8081 numaralı bağlantı noktasında (şifre şifreleme web servisi) HTTP üzerinden erişebilmelidir.

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. Ayrıca vfd_servientrega klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Servientrega 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 bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Canlı tarifeler için kullanıcı, şifre ve faturalama kodunu girin, Servientrega ürününü seçin, çıkış DANE kodunu girin ve mağaza para biriminiz COP değilse para birimi dönüşüm oranını girin (bkz. Yapılandırma).

6. İsteğe bağlı olarak ülke ve ağırlığa göre sabit fiyatlar ile bir yedek maliyet ekleyin.

7. WooCommerce > Settings > Shipping > Shipping zones bölümünde bir kargo bölgesine VibeFox Servientrega ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Servientrega. Bunlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): müşterilerin bu bölge için gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde, önbelleğe alınmış Servientrega teklifleri ve giriş belirteci temizlenir. Kaydedilen ayarlarla canlı tarifeler çalışamıyorsa, ayarların üstündeki bir uyarı nedenini gösterir: eksik kullanıcı, şifre veya faturalama kodu, eksik dönüşüm oranı ya da eksik çıkış DANE kodu.

Genel

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

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: Servientrega.

Servientrega API'si (Kolombiya için canlı tarifeler) (isteğe bağlı; kimlik bilgileri olmadan yalnızca sabit fiyatlar kullanılır)

User (login): Servientrega / SISCLINET kullanıcınız.

Password: Servientrega / SISCLINET şifreniz, yazdığınız haliyle. Eklenti, resmi Servientrega istemcisinin yaptığı gibi, girişten önce şifreyi Servientrega web servisi tarafından şifreletir.

Billing code: Servientrega hesabınızın faturalama kodu (código de facturación), SISCLINET'te gösterilir. Genellikle SER ile başlar.

Canlı tarifeler için üç alanın tümü gereklidir. Canlı tarifeler yalnızca Kolombiya'daki hedefler için istenir. Diğer ülkeler sabit fiyatları kullanır.

Servientrega product: teklif alınan, Servientrega anlaşmanızdaki hizmet.

Faturalanan ağırlık, gerçek ağırlık ile hacimsel ağırlıktan büyük olanıdır.

Currency conversion rate: Servientrega teklifleri COP cinsinden verir. Mağaza para biriminiz COP değilse, mağaza para biriminizle 1 COP'nin değerini girin, örneğin 0.00023. Beyan edilen paket değeri de aynı şekilde COP'ye dönüştürülür. Mağaza para biriminiz COP ise alanı boş bırakın. Mağazanız başka bir para birimi kullanıyor ve bu alan boşsa canlı tarifeler kullanılmaz ve sabit fiyatlar uygulanır. Eklenti döviz kurlarını almaz. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Çıkış yeri (canlı tarifeler için kullanılır)

Origin city (DANE code): gönderim yaptığınız belediyenin 8 haneli DANE kodu, örneğin 11001000 Bogotá, 05001000 Medellín, 76001000 Cali veya 08001000 Barranquilla. 5 haneli belediye kodu da kabul edilir. Boşsa ve WooCommerce > Settings > General altındaki mağaza adresiniz Kolombiya'daysa, mağaza adresinin belediyesi kullanılır.

Sabit fiyatlar (canlı tarife olmadığında kullanılır: kimlik bilgisi yoksa, hedef Kolombiya dışındaysa, belediye bilinmiyorsa, dönüşüm oranı eksikse, API hatası varsa ya da rota için kapsama yoksa)

Price per country: mağaza para biriminizde ülkeler ve fiyatlar tablosu. Satır eklemek için + Add country düğmesine, satır silmek için çarpıya tıklayın. Price her ağırlık için geçerlidir. XS ≤1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg ve XL >5 kg ağırlık sütunları, 0'dan büyük olduklarında bu ağırlık için Price yerine geçer. * Default satırı, kendi satırı olmayan tüm ülkeler için geçerlidir.

Fallback cost: canlı tarife yokken ve hiçbir tablo satırı eşleşmediğinde kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

Fixed price applies: sabit fiyatların nasıl uygulanacağı.

Servientrega canlı tarifeleri her zaman gönderi başınadır.

Koşullar

Minimum weight (kg): sepet bundan daha hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan daha ağırsa yöntemi gizler. Varsayılan: 50. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergilerden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: sepet ara toplamı (indirimlerden sonra, vergilerden önce) bu tutara ulaştığında teslimat ücretsizdir. Yalnızca yöntemin bir fiyatı olduğu durumlarda geçerlidir: bir tablo fiyatı ya da yedek maliyet (bu durumda Servientrega'ya istek gönderilmez) veya canlı tarife. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Excluded shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Tax status: Taxable WooCommerce vergisini kargo ücretine ekler, None eklemez. Servientrega teklifleri (ValorTotal) taşıyıcının ücretlerini zaten içerir. Üzerine vergi eklemek istemiyorsanız None seçin.

Kargo bölgeleri olmadan kullanılabilirlik

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

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını ve API hatalarını WooCommerce günlüğüne yazar: WooCommerce > Status > Logs, kaynak vfd_servientrega. Kimlik bilgileri, belirteçler ve müşteri adresleri kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa, eklentiyi silmek tüm Servientrega ayarlarını, bölge yöntemlerini ve önbelleğe alınmış teklifleri kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ardından bir fiyat arar: önce Servientrega canlı tarifesini, sonra fiyat tablosunu, en son yedek maliyeti. Fiyat yoksa yöntem gizlenir. Ücretsiz kargo uygulanıyorsa yöntem 0 fiyatla gösterilir.

Yapılandırılmış kimlik bilgileriyle Kolombiya'daki bir hedef için eklenti, müşterinin belediyesinin DANE kodunu bulur. Posta kodu veya şehir alanına yazılmış bir DANE kodunu kullanır ya da departman ve şehri yaklaşık 1.130 belediyelik yerleşik tabloyla eşleştirir. Aksanlar ve "D.C." yoksayılır. Yalnızca bir departmanda bulunan bir şehir adı, departman belirtilmese bile bulunur.

Ardından eklenti Servientrega'ya sipariş başına tek bir paket gönderir: mağaza biriminizden kg'a çevrilmiş toplam ağırlık ve en büyük ürünün uzunluk ve genişliği ile tüm ürünlerin toplam hacminden oluşan, cm'ye çevrilmiş bir kutu. Boyutu olmayan ürünler 10 × 10 × 10 cm sayılır. Beyan edilen değer, COP'ye çevrilmiş sepet ara toplamıdır ve en az 6.000 COP'dir. Servientrega toplamı COP olarak döndürür ve eklenti bunu mağaza para biriminize çevirir.

Giriş belirteci süresi dolana kadar, en fazla 4 gün saklanır. Reddedilen bir belirteç bir kez otomatik olarak yenilenir. Her teklif rota ve paket başına 1 saat önbelleğe alınır, bu yüzden aynı sepet yeni bir istek tetiklemez. Başarısız bir istek (şifreleme, giriş veya teklif) 10 dakika önbelleğe alınır, böylece ödeme sayfası her yenilemede Servientrega'yı beklemez. Zaman aşımı istek başına 10 saniyedir.

Canlı tarife yoksa fiyat sabit fiyat tablosundan, ardından Fallback cost değerinden alınır. İkisi de geçerli değilse yöntem gizlenir. Müşteri asla bir API hatası görmez. Neden hata ayıklama günlüğüne yazılır.

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

Eklenti yalnızca tarifeleri hesaplar. Kılavuz (guías), etiket veya çıkartma oluşturmaz, kargo alımı talep etmez, gönderileri izlemez veya iptal etmez ve müşterilerin bir Servientrega ofisi (Centro de Soluciones) seçmesine izin vermez. Kılavuzu SISCLINET'te ya da Servientrega portalınızda oluşturun. Kapıda ödeme (logística de recaudo) için teklif verilmez. Canlı teklifler yalnızca Kolombiya içindeki yurt içi gönderimler içindir. Ekvador, Peru, Panama ve uluslararası gönderiler sabit fiyatları kullanır.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Servientrega sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta, lisansın etkin olduğu tarih ve alan adınız gibi durum bilgileri gösterilir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve 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 alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Servientrega ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de bunu (unlicensed — visible to admins only) etiketiyle görür. 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 sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Servientrega ö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 ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık olmalı ve ülke izinli olmalı). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Canlı tarife yoksa ülkenin ya da * Default satırının bir fiyatı olduğunu veya Fallback cost değerinin ayarlandığını kontrol edin.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd_servientrega olacak şekilde açın. Yaygın nedenler: eksik dönüşüm oranı (mağaza para birimi COP değil), çıkış DANE kodunun olmaması, müşterinin departmanı veya şehrinin henüz girilmemiş ya da bilinen bir belediye olarak tanınmamış olması, hatalı kimlik bilgileri veya rota için kapsamanın olmaması. Ayarladıysanız sabit fiyatlar bu durumları kapsar.

Giriş başarısız oluyor: kullanıcıyı, şifreyi ve faturalama kodunu Servientrega ticari danışmanınızla kontrol edin. Başarısız bir girişten sonra eklenti bir sonraki denemeden önce 10 dakika bekler. Hemen tekrar denemek için ayarları kaydedin.

Müşterinin şehri tanınmıyor: departman ve şehir, yerleşik DANE tablosuyla eşleştirilir. Nadir yazımlar için müşteri 8 haneli DANE kodunu posta kodu olarak girebilir. Geliştiriciler bunu vfd_svtg_dane_code filtresiyle eşleştirebilir.

Bir değişiklikten sonra tarifeler güncel görünmüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış Servientrega tekliflerini ve belirteci temizler.

Geliştiriciler için: vfd_svtg_quote_request ve vfd_svtg_default_dimensions filtreleri, teklif isteğini ve boyutu olmayan ürünlerin boyutlarını ayarlar. vfd_svtg_api_base ve vfd_svtg_soap_url uç noktaları değiştirir, örneğin Servientrega size başka bir sunucu verirse.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar zaten başka bir alan adında kullanılıyorsa, vibefox.net hesabınızda bir yuva 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 verileri korur. Kaldırmak için devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri, önbelleğe alınmış teklifler ve belirteçler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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