VibeFox ShipStation for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmaz.

ShipStation hesabı: kargo firmalarınızı ShipStation'da bağlayın (Settings > Shipping > Carriers), ardından API Key ve API Secret değerlerini ShipStation > Settings > Account > API Settings sayfasından kopyalayın. API erişimi ShipStation planınıza bağlıdır. Sayfa kullanılamıyorsa planınız API erişimini içermiyordur. Modül ShipStation API V1'i kullanır (API Key ve API Secret). Tek API anahtarı olan ShipStation API V2 hesapları desteklenmez. Anahtarlar olmadan yalnızca yedek fiyatlar kullanılır.

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

Kurulum

1. Back office'te 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 ya da daha sonra modül listesinde VibeFox ShipStation 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. API Key ve API Secret değerlerini yapıştırın, gönderici posta kodunu girin ve Save düğmesine tıklayın. Sayfa artık hesabınızın kargo firması kodlarını listeler. İstediğiniz kodu veya kodları Carrier codes alanına girin ve tekrar kaydedin.

5. Mağazanızın varsayılan para birimi ShipStation hesabınızın para birimi değilse Exchange rate değerini ayarlayın.

6. İsteğe bağlı olarak yedek fiyatları doldurun.

Kurulumda modül, ShipStation carriers (USPS, UPS, FedEx, ...) teslimat süresi metniyle ShipStation Shipping 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 ShipStation > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış ShipStation ücretlerini temizler ve API Key ile API Secret değerlerini kontrol eder. Ardından sayfa, hesabınıza bağlı kargo firmalarını kodlarıyla birlikte gösterir; örneğin "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)".

Sayfanın üstündeki uyarılar, canlı ücretlerin ne zaman çalışamayacağını bildirir: anahtar yoksa, kargo firması kodu yoksa, gönderici posta kodu yoksa, döviz kuru eksikse, bağlantı kontrolü başarısız olduysa veya kargo firması kodları hesabınıza bağlı değilse. Mağazanın ağırlık veya boyut birimi modül tarafından dönüştürülemiyorsa da bir uyarı görünür. International > Localization bölümünde (Local units) kg, g, lb veya oz ile cm, mm, m veya in değerlerini ayarlayın. Negatif değer içeren ya da sayı olmayan metin girilen bir sayısal alan veya Maximum weight değerinden büyük bir Minimum weight hata olarak bildirilir ve hiçbir şey kaydedilmez.

Genel

Enable ShipStation shipping: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Name: ödeme sırasında müşteriye gösterilen kargo firması adı. Varsayılan: ShipStation Shipping. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax. ShipStation ücretleri satış vergisi içermez. No tax bunları teklif edildiği gibi gösterir; bir vergi kuralı ise vergi kurallarınıza göre kargoya vergi ekler.

ShipStation hesabı

API Key: ShipStation > Settings > Account > API Settings sayfasındaki API Key. Yalnızca ShipStation'a gönderilir ve asla günlüğe yazılmaz. Kaydedildikten 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.

API Secret: aynı sayfadaki API Secret. Anahtarla aynı şekilde saklanır.

Remove the saved API key and secret: anahtarlar kaydedildiğinde görünür. Her ikisini kaldırmak için işaretleyin ve kaydedin.

Carrier codes: virgülle ayrılmış bir veya daha fazla ShipStation kargo firması kodu; örneğin stamps_com, ups_walleted. En fazla 5 kod kullanılır ve her kargo firması için bir API isteği yapılır. Daha fazla kod girerseniz yalnızca ilk 5'i tutulur ve sayfa bunu bildirir. Bu kargo firmalarının en ucuz ücreti gösterilir. Kodları kaydettikten sonra görünen listeden alın.

Allowed services: isteğe bağlı, virgülle ayrılmış ShipStation hizmet kodları; örneğin usps_priority_mail, ups_ground. Yukarıdaki kargo firmalarının en ucuz hizmetini göstermek için boş bırakın.

Package code: "package" (varsayılan) kendi kutunuzu hesaplar ve kargo firmasının zarflarını ile sabit ücretli kutularını dışarıda bırakır. Kargo firmasının sunduğu tüm paket türlerini hesaplamak için boş bırakın.

Gönderici

Ship-from postal code: canlı ücretler için gereklidir. ShipStation ücreti yalnızca posta kodundan hesaplar ve bu kodun ShipStation hesabınızın ülkesinde olması gerekir. Mağaza posta kodunu Shop Parameters > Contact > Stores bölümünden kullanmak için boş bırakın.

Ücretler

Parcels: sepetin ShipStation'a nasıl gönderileceği.

ShipStation account currency: ShipStation'ın ücretleri döndürdüğü para birimi: USD, CAD, GBP, AUD, NZD veya EUR. Varsayılan: USD (ABD hesapları).

Exchange rate: hesap para biriminin 1 birimi için mağazanızın varsayılan para birimindeki fiyat; örneğin 0.92. Yalnızca varsayılan para birimi hesap para biriminden farklıysa gerekir. Bu alan olmadan canlı ücretler kullanılmaz ve yedek fiyatlar uygulanır. Döviz kurları otomatik olarak güncellenmez.

Yedek fiyatlar (canlı ücret olmadığında kullanılır: API anahtarı yok, ShipStation'a ulaşılamıyor veya adres için kargo firması ücreti yok; fiyatlar mağazanızın varsayılan para biriminde; bu durumda kargo firmasını gizlemek için tabloyu ve Other countries alanını boş bırakın)

Prices by country: ülke başına bir temel fiyat ve koli ağırlığına göre boyut sütunlarını içeren bir tablo: XS ≤ 1 kg, S ≤ 2 kg, M ≤ 3 kg, L ≤ 5 kg ve XL > 5 kg. Satır eklemek için Add country düğmesine, satırı silmek için çöp kutusu simgesine tıklayın. Boş bir boyut temel fiyatı kullanır. 0 temel fiyat ücretsiz kargo anlamına gelir. * Default (all other countries) satırı, kendi satırı olmayan ülkeler için geçerlidir. Hiçbir fiyatı olmayan satır kaydedilmez.

Other countries: tabloda ülke için fiyat olmadığında uygulanan ücret. Bu durumda kargo firmasını gizlemek için boş bırakın.

Koşullar

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergiden önce). Bu durumda ShipStation'a istek yapılmaz. Kapatmak için boş bırakın.

Minimum subtotal: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Minimum weight: kargo firmasını göstermek için gereken, mağazanızın ağırlık biriminde minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet ağırlığı mağazanızın ağırlık biriminde bu değerin üzerindeyse kargo firması gizlenir. 0 sınır olmadığı anlamına gelir.

Kargo bölgesi olmadan kullanılabilirlik

Normalde kargo firması, Shipping > Carriers bölümündeki bölgelerinde sunulur. Alternatif olarak ülkeye göre de sunulabilir.

Ignore shipping zones: kargo firmasını, bölgeleri atanmış olsun veya olmasın, aşağıdaki ülkeler için sunar. Açık olduğu sürece kargo firması sonradan oluşturulanlar dahil tüm bölgelere eklenir. Kapatıldığında eklenen bölgeler kaldırılır.

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: ShipStation isteklerini modül klasöründeki logs/vfd_shst_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API Key, API Secret ve müşteri adresleri asla kaydedilmez. Posta kodu maskelenir.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak ayarları, kargo firmasını, günlüğü ve siparişlerle kaydedilen ShipStation hizmetini siler. Kapalıyken yeniden kurulum için her şey korunur.

Ödeme sırasında nasıl çalışır

Kargo adımında PrestaShop modülden fiyat ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo uygulanıyorsa kargo firması 0 fiyatla gösterilir ve ShipStation'a istek gönderilmez.

Modül daha sonra ShipStation'a gönderici posta kodunu, hedef ülkeyi, eyaleti, şehri ve posta kodunu, koli ağırlığını ve kutu boyutunu gönderir. Müşteri bir posta kodu girmeden istek yapılmaz. Posta kodu olmayan ülkeler yedek fiyatları alır. Ürünler tek bir kutuya yerleştirilir. Bir ürünün boyutu yoksa, koli yalnızca ağırlığa göre hesaplanır.

ShipStation her kargo firması kodu için bir kez sorgulanır. Modül, izin verilen en ucuz ücreti kullanır ve bunu mağazanızın varsayılan para birimine çevirir. Fiyat daha sonra müşterinin sepet para biriminde gösterilir.

Her yanıt 1 saat önbelleğe alınır. ShipStation kullanılabilir ücret olmadan yanıt verirse bu yanıt 10 dakika hatırlanır. ShipStation anahtarları reddederse veya ulaşılamazsa istekler 5 dakika duraklatılır. İstek limitinden sonra duraklatma süresi, ShipStation'ın bildirdiği sıfırlama zamanına göre belirlenir. İstek zaman aşımı 12 saniyedir. Modülü devre dışı bırakmak önbelleğe alınmış ücretleri temizler.

Canlı ücret yoksa fiyat yedek fiyat tablosundan, ardından Other countries alanından alınır. İkisi de geçerli değilse kargo firması gizlenir. Müşteri ShipStation hata metinlerini asla görmez. Ayrıntılar hata ayıklama günlüğüne gider.

Kargo firmasını siparişleri olduktan sonra 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 ücret hesaplar. ShipStation'da etiket satın almaz, sipariş veya gönderi oluşturmaz, paketleri takip etmez ve iadeleri yönetmez. Teslim noktası yoktur; ödeme sırasında birden fazla hizmet arasında seçim yoktur; adres doğrulama, sigorta, imza onayı, birden fazla kolide paketleme veya ücret üzerine kâr marjı da yoktur.

Siparişler

Canlı bir ShipStation ücretiyle sipariş verildiğinde seçilen hizmet siparişle birlikte kaydedilir. Back office sipariş sayfası bunu ShipStation bloğunda Service olarak gösterir; örneğin "USPS Ground Advantage - Package". Böylece ShipStation'da karşılık gelen etiketi oluşturabilirsiniz. Sepetin sonraki yeniden hesaplamaları bunu değiştirmez. Yedek fiyatla veya ücretsiz kargoyla verilen siparişlerde hizmet bloğu bulunmaz.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox ShipStation lisans bloğu, Modules > Module Manager > VibeFox ShipStation > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskeli olarak, durum (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeler görünür: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-shipstation satırı ve 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 personel değiştirebilir. Bloğun metinleri back office 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 tarihli License expired on. 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 modül son bilinen durumla çalışmaya devam eder.

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

Etkin bir anahtar olmadan ShipStation kargo firması ödeme sırasında müşterilere gösterilmez ve ücret hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu yüzden kargo firması sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırasında test edemezsiniz. Modules > Module Manager sayfasında 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. Durum, back office'te çalıştığınız sürece otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

ShipStation ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable ShipStation shipping 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ı kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Canlı ücret yoksa ülkenin, * Default satırının veya Other countries alanının bir fiyatı olduğunu kontrol edin. Ayrıca ürün sayfasında ürünler belirli kargo firmalarıyla sınırlandırılmış olabilir.

Ödeme sayfasında ShipStation ücreti yerine yedek fiyat görünüyor: modül sayfasının üstündeki uyarıları (anahtarlar, kargo firması kodu, gönderici posta kodu, döviz kuru) kontrol edin. Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve Log alanına bakın. Müşterinin posta kodu zorunludur. Girilmeden istek yapılmaz.

Hangi kargo firması kodunun girileceği: ayarları anahtar ve secret ile kaydedin. Sayfa, hesabınızın kargo firması kodlarını listeler. Bunlardan bir veya birkaçını kullanın.

ShipStation bağlantı kontrolü başarısız oldu: mesaj nedeni gösterir. API Key ve API Secret değerlerini kontrol edin, ardından kontrolü tekrarlamak için yeniden kaydedin.

Ücret ShipStation'dan farklı: koli, ürün ağırlıklarından ve boyutlarından oluşturulur; ürünler tek bir kutuya yerleştirilir. Boyutu olmayan ürünler yalnızca ağırlığa göre hesaplanır. Ücretler 1 saat önbelleğe alınır. Önbelleği temizlemek için modül sayfasında Save düğmesine tıklayın.

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

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox ShipStation yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbelleğe alınmış ücretler ve bağlantı kontrolünün sonucu her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişlerini korur); ayarlar, günlük ve siparişlerle kaydedilen hizmet kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve ayarlar ile verilmiş siparişlerin hizmeti korunur. Modülü yeniden kurmak veya Reset yapmak, kargo firmasına daha önceki durumunu geri verir.

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