VibeFox Servientrega for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

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 var: kullanıcı, şifre ve fatura kodu (código de facturación, genellikle SER ile başlar). Bunlar SISCLINET kimlik bilgilerinizdir 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 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 tek bir alan adında çalışır.

Kurulum

İndirme, 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_servientrega-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_servientrega.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze ait paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

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

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

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

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

5. Canlı tarifeler için kullanıcı, şifre ve fatura kodunu girin, Servientrega ürününü seçin, çıkış noktasının DANE kodunu girin ve mağaza para biriminiz COP değilse para birimi dönüşüm kurunu girin.

6. İsteğe bağlı olarak ülke ve ağırlığa göre sabit fiyatlar ile bir yedek maliyet ekleyin, Enable Servientrega seçeneğini açın 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_servientrega.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

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

3. Extensions > Extensions bölümüne gidin, eklenti türü olarak Shipping seçin, VibeFox Servientrega öğesini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4 ila 6. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra Enable Servientrega seçeneğini açıp kaydedene kadar yöntem kapalıdır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Servientrega ayarları tekrar kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Servientrega > Edit. Bölümler solda listelenir. Tüm coğrafi bölgeler için geçerlidirler. Alttaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış Servientrega tekliflerini ve giriş belirtecini temizler. Ayarları yalnızca bu eklenti için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Canlı tarifeler kayıtlı ayarlarla çalışamıyorsa, ayarların üstündeki bir uyarı nedenini söyler: kullanıcı, şifre veya fatura kodu eksikliği, eksik dönüşüm kuru veya eksik çıkış DANE kodu. Mağazada kg ağırlık sınıfı veya cm uzunluk sınıfı yoksa ve varsayılan birimi eklenti 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 kuru, maksimum ağırlığın üzerindeki bir minimum ağırlık, tabloda hatalı bir fiyat, boş bir yöntem başlığı, 64 karakterden uzun veya < > ; = # { } içeren bir başlık ya da tam sayı olmayan bir sıralama değeri bir hatayla reddedilir ve hiçbir şey kaydedilmez.

Genel

Enable Servientrega: Servientrega'yı ödeme sayfasında gösterir veya gizler. Varsayılan: kapalı.

Method title: müşterinin sepette ve ödeme sayfasında gördüğü kargo yöntemi adı. Varsayılan: Servientrega. Zorunlu, en fazla 64 karakter.

Sort order: Servientrega'nın ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Tam sayı.

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

User (login): Servientrega / SISCLINET kullanıcınız. Bunu silmek kayıtlı şifreyi de kaldırır.

Password: Servientrega / SISCLINET şifreniz, yazdığınız haliyle. Eklenti, girişten önce Servientrega web servisi tarafından şifrelenmesini sağlar. 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.

Billing code: Servientrega hesabınızın fatura kodu (código de facturación), SISCLINET'te göründüğü gibi. 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 ve hacimsel ağırlığın büyüğüdür.

Currency conversion rate: Servientrega COP cinsinden teklif verir. Mağazanızın varsayılan para birimi COP değilse, mağaza para biriminizdeki 1 COP değerini girin, örneğin 0.00023. Paketin beyan edilen değeri de aynı şekilde COP'ye dönüştürülür. Mağaza para biriminiz COP ise alan dönüşüm gerekmediğini belirtir: 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ı çekmez. Ondalık ayracı olarak hem nokta hem virgül kabul edilir.

Ship from (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. OpenCart'taki mağaza adresi serbest metindir, bu yüzden çıkış noktası asla ondan alınmaz: bu alan olmadan canlı tarife olmaz.

Fixed prices (canlı tarife olmadığında kullanılır: kimlik bilgisi yok, Kolombiya dışında bir hedef, bilinmeyen bir belediye, eksik dönüşüm kuru, API hatası veya rota için kapsam yoksa)

Price per country: mağazanızın varsayılan para birimindeki, vergi hariç ülke ve fiyat tablosu. Satır eklemek için Add country düğmesine, bir satırı silmek için silme düğmesine tıklayın. Price her ağırlık için geçerlidir. XS (1 kg'a kadar), S (1–2 kg), M (2–3 kg), L (3–5 kg) ve XL (5 kg'dan fazla) ağırlık sütunları 0'dan büyükse o ağırlık için bunun yerine geçer. * Default satırı kendi satırı olmayan tüm ülkeler için geçerlidir. Yeni bir satır * Default olarak başlar. Hiçbir fiyatı olmayan bir satır kaydedilmez.

Fallback cost: canlı tarife olmadığında ve tablodaki hiçbir 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 tahsil edileceği.

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

Conditions

Minimum weight (kg): bu sepet ağırlığının altında yöntemi gizler. 0 sınır olmadığı anlamına gelir (varsayılan).

Maximum weight (kg): bu sepet ağırlığının üzerinde yöntemi gizler. Varsayılan: 50. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupondan sonra, vergiden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: bu ara toplam bu tutara ulaştığında kargo ücretsizdir ve Servientrega'ya hiçbir istek gönderilmez. Yöntemin sunulduğu her hedef için geçerlidir; fiyat tablosunda satırı olmayan ülkeler için de. Hiç ücretsiz kargo sunmamak için boş bırakın.

Tax class: kargo maliyetinin vergi sınıfı veya No tax (varsayılan). Servientrega teklifleri (ValorTotal) taşıyıcının ücretlerini zaten içerir. Üzerine vergi eklemek istemiyorsanız No tax seçin.

Geo zone: Servientrega'yı yalnızca bu bölgedeki adresler için sunun. All zones (varsayılan) sınır olmadığı anlamına gelir. Bölgeler System > Localisation > Geo Zones bölümünde yönetilir. Ignore shipping zones açıkken kontrol edilmez.

Availability without geo zone

Normalde yöntem Conditions bölümünde seçilen bölgede veya her yerde sunulur.

Ignore shipping zones: bölge ne olursa olsun, Servientrega'yı aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Mağazanızdaki etkin tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Advanced

Debug log: tarife hesaplamalarını ve API hatalarını storage/logs/vfd_svtg_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. Kimlik bilgileri, belirteçler ve müşteri adresleri kaydedilmez. Günlük kapalıyken hiçbir şey yazılmaz; API hataları dahil. Dosya 5 MB'a ulaştığında vfd_svtg_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır. İşiniz bittiğinde günlüğü kapatın.

Log: hata ayıklama günlüğünün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa eklentiyi kaldırmak tüm Servientrega ayarlarını ve günlüğü siler. Kapalıysa (varsayılan), yeniden kurulum için korunurlar. Önbelleğe alınmış teklifler her zaman silinir.

Import / Export

Export: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. Şifre 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ıttaki gibi kontrol edilir. Kullanıcı tanımlı olduğu sürece kayıtlı şifre korunur.

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

OpenCart kargo yöntemlerini gösterirken, eklentiden Servientrega fiyatını ister. Bir Geo zone tanımlıysa ve adres bunun dışındaysa, Servientrega sunulmaz (Ignore shipping zones açık değilse). Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Sipariş tutarı, kupon indiriminden sonra ve vergiden önce bu ürünlerin fiyatıdır. Hediye sertifikaları ve puanlar hesaba katılmaz. Eklenti önce koşulları kontrol eder: teslimat ülkesi (Ignore shipping zones ile), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo uygulanıyorsa fiyat 0'dır ve Servientrega'ya hiçbir istek gönderilmez. Ardından bir fiyat arar: canlı Servientrega tarifesi, sonra fiyat tablosu ve son olarak yedek maliyet. Fiyat yoksa yöntem o sepet için gizlenir.

Kimlik bilgileri ayarlanmış Kolombiya'daki bir hedef için eklenti, müşterinin belediyesinin DANE kodunu bulur. Posta kodu veya şehir alanına yazılan bir DANE kodunu kullanır ya da departman ve şehri yaklaşık 1.130 belediyenin yerleşik tablosuyla eşleştirir. Departman, adresin Region / State alanıdır: OpenCart'ta Kolombiya'nın 33 departmanı zaten bulunur. Aksanlar ve "D.C." yok sayılır. Yalnızca bir departmanda bulunan bir şehir, departman olmadan bile bulunur.

Eklenti daha sonra Servientrega'ya sipariş başına bir parça gönderir: ürünün ağırlık sınıfından kg'a çevrilmiş toplam ağırlık ve en büyük ürünün uzunluk ile genişliğine ve tüm ürünlerin toplam hacmine sahip bir kutu, cm'ye çevrilmiş olarak. Boyutları olmayan ürünler 10 × 10 × 10 cm sayılır. Beyan edilen değer, sipariş tutarının COP'ye çevrilmiş hali ve en az 6.000 COP'dir. Servientrega toplamı COP olarak döndürür. Eklenti bunu mağazanızın varsayılan para birimine çevirir ve ondalık basamaklarına yuvarlar. Müşteri bunu, seçilen Tax class vergisiyle kendi para biriminde görür.

Giriş belirteci süresi dolana kadar saklanır, en fazla 4 gün. Reddedilen bir belirteç bir kez otomatik olarak yenilenir. Her teklif, rota ve paket başına 1 saat önbelleğe alınır; böylece 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. İstek başına zaman aşımı 10 saniyedir.

Müşteri asla bir API hatası görmez. Neden, etkinse hata ayıklama günlüğüne yazılır.

Eklenti yalnızca tarife hesaplar. Kılavuz (guías), etiket veya çıkartma oluşturmaz, kurye talebi açmaz, gönderileri takip etmez veya iptal etmez ve müşterinin 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) teklifi verilmez. Canlı teklifler yalnızca Kolombiya içindeki yurt içi gönderiler içindir. Siparişlere hiçbir şey eklemez: sipariş, diğer tüm OpenCart kargo yöntemleri gibi yöntem başlığını ve kargo maliyetini gösterir.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Servientrega'yı seçer; bu pencerede yöntem başlığı fiyatla birlikte gösterilir. Yöntem OpenCart 3'tekiyle aynı şekilde çalışır.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Servientrega lisans bloğu, Extensions > Extensions > Shipping > VibeFox Servientrega > Edit sayfasında ayarların üstünde yer alan 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 tarih ve alan adınız) ve 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üğmelerini gösterir. Bunların altında Product: opencart-shipping-servientrega satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca bu eklenti 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 söyler, ö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 veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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ızda serbest bırakın.

Etkin bir anahtar olmadan Servientrega kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife istenmez veya hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi mağazada hâlâ görür; yöntem (unlicensed — visible to admins only) olarak işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici Dashboard sayfasında bir hatırlatma belirir. 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. Yönetici Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak 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. Geo zone değerini kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries değerini 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ünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti sayfasındaki Log alanına bakın. Yaygın nedenler: eksik dönüşüm kuru (mağaza para birimi COP değil), çıkış DANE kodu eksikliği, müşterinin departmanı veya şehri henüz girilmemiş ya da bilinen bir belediye değil, hatalı kimlik bilgileri, rota için kapsam yokluğu veya sunucunun 8058 ve 8081 numaralı bağlantı noktalarından web.servientrega.com'a erişememesi. Ayarladıysanız sabit fiyatlar bu durumları kapsar.

Giriş başarısız: kullanıcı, şifre ve fatura 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: müşteri Region / State alanında departmanı seçmelidir. Nadir yazımlar için müşteri 8 haneli DANE kodunu posta kodu olarak yazabilir.

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

Sayfa "Warning: You do not have permission to modify VibeFox Servientrega!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_servientrega (OpenCart 3) veya extension/vfd_servientrega/shipping/vfd_servientrega (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: OpenCart olayları vfd_servientrega/dane_code ve vfd_servientrega/quote_request, başka bir eklentinin hedef DANE kodunu ve teklif isteğini değiştirmesine izin verir.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Servientrega yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart Enable Servientrega, Sort order, Tax class ve Geo zone değerlerini her zaman sıfırlar. Önbelleğe alınmış teklifler, belirteçler ve şifrelenmiş şifre her zaman kaldırılır. Remove data on uninstall açıksa diğer ayarlar ve günlük de silinir. Kapalıysa, korunur ve eklentiyi tekrar kurduğunuzda yeniden kullanılır. Mevcut siparişler kargo yöntemlerini ve maliyetlerini korur.

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

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