VibeFox Correios for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Correios sözleşmesi (yalnızca canlı fiyatlar için): canlı fiyatlar Correios Web Services (CWS) fiyat API'sini kullanır ve posting card'lı bir Correios sözleşmesinin kimlik bilgilerini gerektirir. Üç değere ihtiyacınız vardır: Meu Correios kullanıcınız (genellikle sözleşmenin CNPJ'si veya CPF'si), API erişim kodu ve posting card numarası. Erişim kodunu Correios Web Services portalında oluşturun (cws.correios.com.br; homologasyon için cwshom.correios.com.br). Ayrıca gönderim yaptığınız CEP'e de ihtiyacınız olacak. Kimlik bilgileri olmadan modül yalnızca sabit fiyatlarla çalışır.

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

Kurulum

1. Arka ofiste 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 Correios öğesini bulup Configure düğmesine tıklayın.

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

4. Correios API kullanıcısını, erişim kodunu, posting card numarasını, çıkış CEP'ini ve hizmeti girin. Mağaza varsayılan para biriminiz BRL değilse BRL kurunu girin. Diğer ülkeler ve yedek olarak kullanılacak sabit fiyatları doldurun (Yapılandırma bölümüne bakın) ve Save düğmesine tıklayın.

Kurulumda modül, Correios (Brazilian Post) teslimat süresi metniyle Correios taşıyıcısını oluşturur. Taşıyıcı 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 içinden değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Correios > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbelleğe alınmış Correios fiyatlarını ve API jetonlarını temizler. Sayılar nokta veya virgülle girilebilir.

Canlı fiyatlar veya taşıyıcı çalışamadığında sayfa uyarılar gösterir: üç kimlik bilgisinden yalnızca bazıları doldurulmuştur, çıkış CEP'i eksiktir, farklı para birimi kullanan bir mağaza için BRL kuru eksiktir veya ne kimlik bilgisi ne de sabit fiyat vardır. Her uyarı, bu arada sabit fiyatların kullanılıp kullanılmadığını ya da taşıyıcının gizlenip gizlenmediğini belirtir. Mağazanın ağırlık veya boyut birimi modül tarafından bilinmiyorsa da bir uyarı görünür (bu durumda kg veya cm olarak okunur); International > Localization bölümünde (Local units) kg, g, lb veya oz ile cm, mm, m veya in ayarlayın.

Yöntem başlığı boşsa veya geçersizse (en fazla 64 karakter), Country prices içindeki bir sayı alanı veya fiyat 0 veya daha büyük bir sayı değilse, BRL kuru 0 ise, Min cart weight, Max cart weight değerinden büyükse, çıkış CEP'i 8 haneli değilse ya da diğer hizmet kodu 5 haneden fazlaysa kaydetme bir mesajla reddedilir. Değeri düzeltene kadar hiçbir şey kaydedilmez.

Genel

Enable Correios: taşıyıcıyı tüm bölgelerde aynı anda açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: Correios. Zorunlu.

Tax: kargo maliyetinin üzerine eklenen vergi kuralı veya No tax (varsayılan).

Correios API (Brezilya'da canlı fiyatlar)

Brezilya'daki adresler için fiyat Correios fiyat API'sinden gelir. API fiyat vermezse (API kullanılamıyor, CEP hizmet vermiyor, paket çok büyük), Country prices içindeki sabit fiyat kullanılır; sabit fiyat yoksa taşıyıcı gizlenir. Hata ayrıntıları müşteriye değil, günlüğe gider.

API user: Meu Correios portalındaki giriş bilgileriniz; genellikle sözleşmenin CNPJ'si veya CPF'si.

Access code: Correios Web Services portalında oluşturulan API erişim kodu (código de acesso). Portal şifresi değildir. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it (empty the API user as well to remove it) metnini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı kodu kaldırmak için hem API user hem de Access code alanlarını boşaltıp kaydedin.

Posting card: sözleşmenizin posting card (cartão de postagem) numarası: 10 haneli, genellikle iki sıfırla başlar, örneğin 0012345678. Daha kısa numaralar başına sıfır eklenerek tamamlanır. Numarayı Correios web sitesinin Correios Fácil sayfasından kontrol edebilirsiniz.

Homologation: Correios homologasyon (test) ortamını kullanır: istekler bir homologasyon erişim koduyla apihom.correios.com.br adresine gider. Canlı bir mağazada kapalı tutun.

Origin CEP: paketlerin gönderildiği CEP (8 hane), örneğin 01001-000.

Service: ödeme sayfasında fiyatlandırılan Correios hizmeti. Perakende kodları: PAC (04510, varsayılan), SEDEX (04014), SEDEX 12 (04782), SEDEX 10 (04790), SEDEX Hoje (04804). Sözleşme kodları: PAC (03298), SEDEX (03220), SEDEX 12 (03140), SEDEX 10 (03158), SEDEX Hoje (03204), Correios Mini Envios (04227). Sözleşme kodları, hizmeti içeren bir sözleşmenin posting card'ını gerektirir.

Other service code: isteğe bağlı; listede olmayan, sözleşmenizdeki 5 haneli bir hizmet kodu, örneğin 03085. Daha kısa bir kod başına sıfır eklenerek tamamlanır. Doldurulduğunda Service yerine kullanılır.

Package format: Correios'a gönderilen nesne türü.

Default product weight: kg cinsinden; ağırlığı olmayan her ürün için Correios'a gönderilir. Varsayılan: 0.3. Ürün ağırlıkları ve boyutları mağazanızın birimlerinden dönüştürülür (alan açıklaması bunları gösterir) ve sepet tek bir paket olarak fiyatlandırılır.

BRL → store currency rate: alan adı mağazanızın varsayılan para birimini gösterir, örneğin BRL → EUR rate. Correios fiyatları BRL cinsindendir. Varsayılan para biriminiz BRL değilse, bir BRL'nin kaç birim sizin para biriminize eşdeğer olduğunu girin, örneğin 0.17. Bu olmadan canlı fiyatlar kullanılmaz. Kur 0'dan büyük olmalıdır. Varsayılan para biriminiz BRL ise alanı boş bırakın.

Sabit fiyatlar (Brezilya dışındaki ülkeler için, API kimlik bilgisi olmadan ve API fiyat vermediğinde yedek olarak kullanılır)

Country prices: mağazanızın varsayılan para biriminde, vergi hariç, bir Base fiyatı ve sepet ağırlığına göre fiyatlar içeren ülke tablosu: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg üzeri. Boş veya sıfır bir boyut fiyatı Base fiyatını kullanır. Satır eklemek için Add country düğmesine, bir satırı kaldırmak için çarpı işaretine tıklayın. * Default (all other countries) satırı, kendi satırı olmayan tüm ülkeler için fiyatları belirler. Satırı olmayan (ve * de olmayan) bir ülke sabit fiyat almaz. Hiçbir fiyatı olmayan bir satır kaydedilmez. Sayı olmayan veya negatif bir fiyat, kaydetmeyi bir hatayla durdurur. 0 temel fiyat, o ülke için ücretsiz kargo anlamına gelir.

Fixed price per: Order fiyatı bir kez alır. Item (price × quantity) ise fiyatı sepetteki ürün adediyle çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Canlı fiyatlar her zaman tüm paket için hesaplanır.

Koşullar

Min cart weight: kg cinsinden; taşıyıcıyı bu sepet ağırlığının altında gizler. 0 sınır olmadığı anlamına gelir. Max cart weight değerinden büyük olamaz.

Max cart weight: kg cinsinden; taşıyıcıyı bu sepet ağırlığının üzerinde gizler. Varsayılan: 30. 0 sınır olmadığı, boş alan ise 30 kg anlamına gelir. Correios PAC ve SEDEX paketleri 30 kg'a kadar olabilir.

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

Free shipping: aşağıdaki tutardan itibaren ücretsiz teslimatı açar.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergilerden önce). Bu durumda API isteği yapılmaz.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers içinde atandığı bölgelerde gösterilir.

Ignore shipping zones: hangi bölgenin eşleştiğinden bağımsız olarak taşıyıcıyı aşağıdaki ülkeler için sunar. Kaydedildiğinde taşıyıcı tüm bölgelere eklenir. Seçeneği kapatmak, eklediği bölgeleri kaldırır. Seçenek açıkken sonradan oluşturulan bir bölge otomatik olarak eklenir.

Countries: bu mod için hedef ülkeler. Mağazanı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: fiyat hesaplamalarını modül klasöründeki logs/vfd_crr_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman günlüğe yazılır. API kullanıcısı, erişim kodu, posting card, jeton ve müşteri CEP'leri günlüğe yazılmaz.

Log: hata ayıklama günlüğünü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 ayarları, taşıyıcıyı, sipariş hizmetlerini, önbelleğe alınmış fiyatları ve günlüğü siler. Kapalıyken yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop modülden Correios 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: izin verilen ülkeler (Ignore shipping zones ile birlikte), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Correios'a istek gönderilmez.

Kimlik bilgileri ayarlanmış bir Brezilya adresi için modül önce posting card'ınız için bir API jetonu alır. Jeton ayrıca sözleşme ve bölge ofisi numaralarını da verir, bu nedenle fiyat sözleşmenizin fiyatıdır. Ardından seçilen hizmetin fiyatını çıkış ve varış CEP'ine, paket ağırlığına (gram) ve paket boyutuna (cm) göre ister. Fiyat yalnızca varış CEP'i 8 haneliyse istenir. Tüm ürünlerin boyutları varsa paket boyutu bunlardan tahmin edilir; aksi halde Correios minimum boyutu gönderilir. 30 kg'ı aşan paketler API'ye gönderilmez. BRL fiyatı kurunuzla dönüştürülür. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Her fiyat paket başına 1 saat önbelleğe alınır. Başarısız bir istek 10 dakika önbelleğe alınır, böylece bir API kesintisi her ödeme sayfası güncellemesini yavaşlatmaz. Jeton, sona ermesine kısa bir süre kala kadar önbelleğe alınır ve otomatik olarak yenilenir; Correios reddederse yeni bir jeton istenir ve fiyat isteği bir kez tekrarlanır. API zaman aşımı 12 saniyedir.

API fiyat vermezse sabit fiyat kullanılır; sabit fiyat yoksa taşıyıcı gizlenir. Müşteri API hata ayrıntılarını hiçbir zaman görmez; bunlar hata ayıklama günlüğüne gider.

Taşıyıcının siparişleri olduktan sonra Shipping > Carriers içinde düzenlerseniz, PrestaShop onu yeni bir taşıyıcı sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca oranları hesaplar. Uluslararası Correios fiyatlarını (Exporta Fácil, Packet), teslimat süresi tahminlerini, etiketleri, ön kayıtları, beyanları veya takibi almaz. Müşteriler bir Correios şubesi veya dolabı seçemez. Ek hizmetler (beyan edilen değer, eline teslim, teslim alındı bildirimi) eklenmez. Mağaza başına tek bir Correios hizmeti gösterir ve para birimi kurları otomatik olarak güncellenmez.

Siparişler

Correios taşıyıcısıyla bir sipariş verildiğinde modül, kargo fiyatının nasıl hesaplandığını kaydeder. Arka ofisteki sipariş sayfası bunun ardından Correios service (canlı fiyat için, örneğin PAC — contract (03298)) ve Price source alanlarını içeren bir Correios bloğu gösterir: Live price (Correios API), Fixed price veya Free shipping.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Correios lisans bloğu, Modules > Module Manager > VibeFox Correios > Configure 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, maskelenmiş anahtarı, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-shipping-correios 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 yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri arka ofis 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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını boşalttı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, çok mağazalı kurulumda da. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızda boşaltın.

Etkin bir anahtar olmadan Correios taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini arka ofise giriş yaptığınızı bilmediği için taşıyıcı sizin için de gizlenir: modülü bir 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ın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Arka ofiste çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında 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

Correios ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Correios seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (veya Ignore shipping zones açık olmalı ve ülke izin verilmiş olmalı). Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Canlı fiyat yoksa, ülke veya * için bir sabit fiyat bulunmalıdır. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlandırılmış olabilir.

Taşıyıcı Correios fiyatı yerine sabit fiyat gösteriyor: modül sayfasındaki Log alanına bakın. Correios hataları orada günlüğe yazılır: yanlış erişim kodu, sözleşmenizde olmayan hizmet, hizmet verilmeyen CEP, 30 kg'ı aşan veya boyut sınırlarını aşan paket. Ayrıca çıkış CEP'inin ayarlandığını, müşterinin CEP'inin 8 haneli olduğunu ve varsayılan para birimi BRL değilse BRL kurunun girildiğini kontrol edin. Her hesaplamayı görmek için Debug log seçeneğini açın.

Jeton isteği başarısız oluyor: API kullanıcısını, erişim kodunu, posting card'ı ve ortamı kontrol edin. Homologasyon erişim kodu yalnızca Homologation açıkken, üretim kodu ise yalnızca kapalıyken çalışır.

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

Sayfa Correios taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Kaydetme sırasında izniniz olmadığı yazıyor: çalışan profiliniz modülü görüntüleyebilir ancak yapılandıramaz. Ayarları kaydetmek ve günlüğü temizlemek için modülün yapılandırma iznine ihtiyaç vardır.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Correios yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu, önbelleğe alınmış fiyatlar ve jetonlar her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişlerini korur) ve ayarlar, kaydedilmiş sipariş hizmetleri ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, taşıyıcıyı daha önceki durumuyla geri getirir.

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