VibeFox Servientrega for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

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. Üç değere 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 fiyatları kullanıyorsanız Servientrega hesabına ihtiyacınız yoktur.

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

VibeFox lisans anahtarı: 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 bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Servientrega 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. Canlı tarifeler için kullanıcı, şifre ve faturalama kodunu girin, Servientrega ürününü seçin, köken DANE kodunu girin ve mağaza para biriminiz COP değilse para birimi dönüşüm oranını girin. Mağazanızda henüz yoksa Add Colombian departments düğmesine tıklayın (bkz. Yapılandırma).

5. İsteğe bağlı olarak ülke ve ağırlığa göre sabit fiyatlar ile yedek bir maliyet ekleyin, ardından Save düğmesine tıklayın.

Kurulumda modül, Servientrega courier delivery teslimat süresi metniyle Servientrega kargo firmasını oluşturur. Kargo firması tüm bölgelere 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 Servientrega > Configure. Tüm bölgelerde geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki Servientrega tekliflerini ve giriş belirtecini temizler.

Kayıtlı ayarlarla canlı tarifeler çalışamıyorsa, formun üstündeki bir uyarı nedenini gösterir: eksik kullanıcı, şifre veya faturalama kodu, eksik dönüşüm oranı ya da eksik köken DANE kodu. Mağazanızın ağırlık veya boyut birimi (International > Localization, Local units) modül tarafından bilinmiyorsa da bir uyarı görünür; bu durumda ağırlıklar kg, boyutlar cm olarak okunur. Kaydederken sayı olmayan bir değer, negatif bir sayı, 0 dönüşüm oranı, maksimum ağırlıktan büyük minimum ağırlık, tablodaki hatalı bir fiyat veya 64 karakterden uzun bir yöntem başlığı bir hatayla reddedilir ve hiçbir şey kaydedilmez.

Genel

Enable Servientrega: kargo firmasını tüm bölgelerde aynı anda açar veya kapatır. Shipping > Carriers içindeki kargo firması durumuyla aynı anahtardır.

Method title: müşteriye sepette ve ödeme sayfasında gösterilen kargo firması adı. Varsayılan: Servientrega. Zorunlu, en fazla 64 karakter.

Servientrega API (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. Bunu temizlemek kayıtlı şifreyi de kaldırır.

Password: Servientrega / SISCLINET şifreniz, yazdığınız gibi. Modül, girişten önce şifreyi Servientrega web servisi aracılığıyla şifreler. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Billing code: SISCLINET'te görünen Servientrega hesabınızın código de facturación değeri. Genellikle SER ile başlar.

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

Servientrega product: Servientrega anlaşmanızdaki, teklifi alınan 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ğazanızın varsayılan para birimi COP değilse, mağaza para biriminizde 1 COP'un değerini girin, örneğin 0.00023. Beyan edilen paket değeri de aynı şekilde COP'a çevrilir. Mağaza para biriminiz COP ise 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. Modül döviz kurlarını almaz. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Colombian departments: departman, aynı ada sahip belediyeleri ayırt etmeye yardımcı olur. PrestaShop'ta varsayılan olarak Kolombiya departmanı bulunmaz; bunlar olmadan yalnızca Kolombiya'da benzersiz olan şehir adları tanınır. Kolombiya'nın 33 departmanını Kolombiya'nın eyaletleri (ISO kodları ANT, DC…) olarak eklemek için Add Colombian departments düğmesine tıklayın, Kolombiya için Contains states seçeneğini açın ve Kolombiya adres formuna departman alanını ekleyin. Zaten var olan departmanlar iki kez eklenmez. Her şey hazır olduğunda alan, Kolombiya adreslerinin kaç departmana sahip olduğunu gösterir.

Gönderim 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 Shop Parameters > Contact > Stores 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, bir API hatası varsa veya rota için kapsama yoksa)

Price per country: mağazanızın varsayılan para biriminde, vergi hariç ülke ve fiyat tablosu. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine 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 o ağırlık için bu fiyatın yerine geçer. * Default satırı, kendi satırı olmayan tüm ülkeler için geçerlidir. Hiçbir fiyatı olmayan bir satır kaydedilmez.

Fallback cost: canlı tarife yoksa ve tablodaki hiçbir satır eşleşmiyorsa kullanılır. Bu durumda kargo firmasını gizlemek için boş bırakın.

Fixed price applies: sabit fiyatların nasıl tahsil edileceği.

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

Koşullar

Minimum weight: sepet daha az tartıyorsa kargo firmasını gizler, kg cinsinden. 0 sınır yok anlamına gelir.

Maximum weight: sepet daha fazla tartıyorsa kargo firmasını gizler, kg cinsinden. Varsayılan: 50. 0 sınır yok anlamına gelir.

Minimum order amount: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergiden ö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, vergiden önce) bu tutara ulaştığında teslimat ücretsizdir ve Servientrega'ya istek gönderilmez. Kargo firmasının sunulduğu tüm hedeflerde geçerlidir; fiyat tablosunda satırı olmayan ülkeler dahil. Ücretsiz kargoyu hiçbir zaman sunmamak için boş bırakın.

Tax: kargo firmasının vergi kuralı veya No tax. Servientrega teklifleri (ValorTotal) kargo firmasının ücretlerini zaten içerir. Üzerine vergi eklemek istemiyorsanız No tax seçin.

Kargo bölgesi olmadan kullanılabilirlik

Normalde kargo firması, Shipping > Carriers içinde kendisine atanan bölgelerde sunulur.

Ignore shipping zones: kargo firması bölgelerine atanmamış olsa bile Servientrega'yı aşağıdaki ülkeler için sunar. Kargo firması bu durumda tüm bölgelere atanır; sonradan oluşturacağınız bölgeler dahil. Seçeneği kapatmak, kargo firmasına önceki bölgelerini geri verir.

Countries: bu mod için hedef ülkeler. Mağazanızın tüm aktif ülkelerini 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ı modül klasöründeki logs/vfd_svtg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Kimlik bilgileri, belirteçler ve müşteri adresleri kaydedilmez. Günlük kapalıyken hiçbir şey yazılmaz; API hataları dahil. İşiniz bittiğinde günlüğü kapatın.

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çıksa, modülü kaldırmak tüm Servientrega ayarlarını, kargo firmasını, önbellekteki teklifleri ve günlükleri siler. Geçmiş siparişler kargo firmalarını korur. Kapalıysa, yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, modülden Servientrega fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: teslimat ülkesi (Ignore shipping zones ile birlikte), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Servientrega'ya istek gönderilmez. Ardından bir fiyat arar: önce Servientrega canlı tarifesini, sonra fiyat tablosunu, son olarak yedek maliyeti. Fiyat yoksa kargo firması o sepet için gizlenir.

Kimlik bilgileri ayarlanmış Kolombiya hedefi için modül, 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 belediyenin yerleşik tablosuyla eşleştirir. Aksanlar ve "D.C." yok sayılır. Yalnızca bir departmanda bulunan bir şehir adı, departman olmadan da bulunur.

Ardından modül, Servientrega'ya sipariş başına bir parça gönderir: toplam ağırlık mağazanızın biriminden kg'a çevrilmiş ve en büyük ürünün uzunluğu ve genişliği ile tüm ürünlerin toplam hacmi cm'ye çevrilmiş bir kutu. Boyutları olmayan ürünler 10 × 10 × 10 cm sayılır. Beyan edilen değer, sepet ara toplamının COP'a çevrilmiş hali olup en az 6.000 COP'tur. Servientrega toplamı COP olarak döndürür. Modül bunu mağazanızın varsayılan para birimine çevirir ve müşteri sepet para biriminde görür.

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 önbellekte tutulur; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek (şifreleme, giriş veya teklif) 10 dakika önbellekte tutulur; böylece ödeme sayfası her yenilemede Servientrega'yı beklemez. İstek başına zaman aşımı 10 saniyedir.

Müşteri hiçbir zaman API hatası görmez. Hata ayıklama günlüğü açıksa neden oraya yazılır.

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

Modül 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 veya Servientrega portalınızda oluşturun. Kapıda ödeme (logística de recaudo) teklif edilmez. Canlı teklifler yalnızca Kolombiya içindeki yurt içi gönderiler içindir. Diğer ülkeler sabit fiyatları kullanır.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Servientrega lisans bloğu, Modules > Module Manager > VibeFox Servientrega > 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) ve şu düğmeleri gösterir: 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. Bunların altında Product: presta-shipping-servientrega satırı ile 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 yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 License expired on ve bir tarih. Mağaza adresi değiştikten sonra ya da 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Servientrega kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife istenmez ya da hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez; bu yüzden kargo firması sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde 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. Durum, yönetim panelinde çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülün kaldırılması veya sıfırlanması lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Servientrega ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Servientrega seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde kargo firması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çıp Countries alanını kontrol edin. Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Canlı tarife yoksa, ülkenin veya * Default satırının bir fiyatı olduğunu ya da Fallback cost değerinin ayarlandığını kontrol edin. Ürünler, ürün sayfasında belirli kargo firmalarıyla da sınırlandırılmış olabilir.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Yaygın nedenler: eksik dönüşüm oranı (mağaza para birimi COP değil), köken DANE kodu yok, müşterinin departmanı veya şehri henüz girilmemiş ya da bilinen bir belediye değil, hatalı kimlik bilgileri veya rota için kapsama yok. 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 modül bir sonraki denemeden önce 10 dakika bekler. Hemen yeniden denemek için ayarları kaydedin.

Müşterinin şehri tanınmıyor: müşterilerin departmanlarını seçebilmesi için Add Colombian departments düğmesine tıklayın. Nadir yazımlar için müşteri, 8 haneli DANE kodunu posta kodu olarak girebilir.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki Servientrega tekliflerini ve belirteci temizler.

Sayfa Servientrega kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers bölümünde silinmiş. Yeniden oluşturulması için Modules > Module Manager bölümünde modülü sıfırlayın.

Geliştiriciler için: actionVfdSvtgDaneCode ve actionVfdSvtgQuoteRequest kancaları, hedef DANE kodunu ve teklif isteğini değiştirmenize olanak tanır.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Servientrega yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki teklifler, belirteçler ve şifrelenmiş şifre her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişlerini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak veya Reset kullanmak, kargo firmasına daha önceki durumunu geri verir.

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