VibeFox Correios for WooCommerce — Yardım
Gereksinimler
WordPress: 5.8 veya üzeri.
WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleşmez.
PHP: 8.0 veya üzeri.
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. Üç bilgiye ihtiyacınız var: 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önderdiğiniz CEP'e de ihtiyacınız var. Kimlik bilgileri olmadan eklenti yalnızca sabit fiyatlarla ç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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_correios 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 Correios, veya 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. Correios API kullanıcısını, erişim kodunu, posting card numarasını, çıkış CEP'ini ve hizmeti girin. Mağaza para biriminiz BRL değilse BRL kurunu girin. Diğer ülkeler ve yedek olarak sabit fiyatları doldurun (bkz. Yapılandırma).
6. VibeFox Correios yöntemini WooCommerce > Settings > Shipping > Shipping zones içindeki bir kargo bölgesine ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.
Yapılandırma
Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Shipping > VibeFox Correios. 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): bu bölge için müşteriye gösterilen ad. Genel Method title değerini kullanmak için boş bırakın.
Ayarlar sayfası, canlı fiyatlar veya yöntem çalışamayacağında uyarı gösterir: üç kimlik bilgisinin yalnızca bazıları doldurulmuşsa, çıkış CEP'i eksikse, başka para birimli bir mağaza için BRL kuru eksikse veya ne kimlik bilgileri ne de sabit fiyatlar varsa. Ayarları her kaydettiğinizde önbellekteki fiyatlar ve API jetonu temizlenir. Sayılar nokta veya virgülle yazılabilir.
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ı. Varsayılan: Correios. Bir bölge bunu kendi başlığıyla değiştirebilir.
Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez.
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 veya hiç yoksa yöntem gizlenir.
API user: Meu Correios portalı giriş bilginiz, genellikle sözleşmenin CNPJ veya CPF'si.
Access code: Correios Web Services portalında oluşturulan API erişim kodu (código de acesso). Portal şifresi değildir.
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 sitesindeki Correios Fácil sayfasından kontrol edebilirsiniz.
Homologation: homologasyon erişim kodu ile Correios homologasyon (test) ortamını kullanır. Canlı bir mağazada kapatın.
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. Doldurulduğunda Service yerine kullanılır.
Package format: Correios'a gönderilen nesne türü.
Default product weight (kg): ağırlığı olmayan her ürün için Correios'a gönderilir. Default: 0.3. Ürün ağırlıkları ve boyutları mağazanızın birimlerinden dönüştürülür ve sepet tek paket olarak fiyatlandırılır.
BRL → store currency rate: alan adı mağaza para biriminizi gösterir. Correios fiyatları BRL cinsindendir. Mağaza para biriminiz BRL değilse, 1 BRL'nin kaç birim sizin para biriminize eşit olduğunu girin, örneğin 0.17. Bu olmadan canlı fiyatlar kullanılmaz. Mağaza para biriminiz BRL ise boş bırakın.
Sabit fiyatlar (Brezilya dışındaki ülkeler için, API kimlik bilgileri olmadan ve API fiyat vermediğinde yedek olarak)
Country prices: Base temel fiyatı ve mağaza para biriminizle 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 olan boyut fiyatı Base fiyatını kullanır. Satır eklemek için Add country'ye, satır silmek için çarpıya tıklayın. * Default (all other countries) satırı, kendi satırı olmayan tüm ülkeler için fiyatları belirler. Satırı olmayan (ve * satırında da bulunmayan) bir ülkenin sabit fiyatı yoktur. Temel fiyat 0 ise o ülke için kargo ücretsizdir.
Fixed price per: Order fiyatı bir kez alır. Item (price × quantity) fiyatı sepetteki ürün sayısıyla ç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): bu sepet ağırlığının altında yöntemi gizler. 0 sınır olmadığı anlamına gelir.
Max cart weight (kg): bu sepet ağırlığının üstünde yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Correios PAC ve SEDEX paketleri 30 kg'a kadar olabilir.
Minimum order amount: yöntemi yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.
Excluded shipping classes: sepetteki herhangi bir üründe bu WooCommerce kargo sınıflarından biri varsa yöntemi gizler.
Free shipping: aşağıdaki tutardan itibaren ücretsiz kargoyu açar.
Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Bu durumda API'ye istek gönderilmez.
Kargo bölgeleri olmadan kullanılabilirlik
Ignore shipping zones: eşleşen bölge ne olursa olsun, yöntemi aşağıdaki ülkeler için sunar.
Countries: bu mod için hedef ülkeler. Mağazanın gönderim yaptığı 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: fiyat hesaplamalarını WooCommerce > Status > Logs içinde, kaynak vfd-correios olarak kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API kullanıcısı, erişim kodu, posting card, jeton ve müşteri CEP'leri kaydedilmez.
Remove data on uninstall: açıksa eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbellekteki fiyatları 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 fiyat ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse müşteri ücretsiz bir fiyat alır ve Correios'a hiçbir istek gönderilmez.
Kimlik bilgileri girilmiş bir Brezilya adresi için eklenti ö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, dolayısıyla fiyat sözleşmenizin fiyatıdır. Ardından seçilen hizmetin fiyatını çıkış ve varış CEP'ine, gram cinsinden paket ağırlığına ve cm cinsinden paket boyutuna göre ister. Fiyat yalnızca varış CEP'i 8 haneli olduğunda 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. Hizmet, siparişin kargo satırına Correios service olarak kaydedilir ve sipariş yönetim ekranında görünür.
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, süresi dolmadan kısa bir süre önce kadar önbellekte tutulur 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 veya sabit fiyat yoksa yöntem gizlenir. Müşteri API hata ayrıntılarını hiçbir zaman görmez; bunlar WooCommerce günlüğüne gider.
Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.
Eklenti yalnızca fiyat 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 bildirimi) eklenmez. Mağaza başına yalnızca bir Correios hizmeti gösterilir ve döviz kurları otomatik olarak güncellenmez.
Lisans anahtarı
Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Shipping > VibeFox Correios sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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ı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.
Etkin bir anahtar olmadan Correios ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma çıkar. Mevcut siparişler etkilenmez.
Lisansın 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
Correios ö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 (veya Ignore shipping zones açık olup ülke izinliyse). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını inceleyin. Canlı fiyat yoksa, ülke için veya * için bir sabit fiyat bulunmalıdır.
Yöntem Correios fiyatı yerine sabit fiyat gösteriyor: WooCommerce > Status > Logs sayfasını, kaynak vfd-correios olacak şekilde açın. Correios hatası orada kayıtlıdır: yanlış erişim kodu, sözleşmenizde olmayan hizmet, hizmet verilmeyen CEP, 30 kg'ı aşan paket veya boyut sınırlarını aşan paket. Ayrıca çıkış CEP'inin girildiğini ve mağaza para biriminiz 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, canlı kod ise yalnızca kapalıyken çalışır.
Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki fiyatları ve API jetonunu temizler.
Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuva serbest bırakın ve Check now'a tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now'a tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumuyla çalışmaya devam eder.
Kaldırma
Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbellekteki fiyatlar yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Siparişler hiçbir zaman değiştirilmez.
Correios, ilgili sahibinin ticari markasıdır. Bu eklenti Correios ile bağlantılı değildir ve Correios tarafından onaylanmamıştır.