VibeFox SMSA Express for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：5.0 以降、インストールおよび有効化済みであること。WooCommerce がないとプラグインは有効化できません。
PHP：8.0 以降。
SMSA Express 料金カード：料金表の料金は、SMSA アカウントまたは SMSA の営業チームから入手してください。ストアの通貨で入力してください。料金カードが SAR、AED などの別の通貨の場合は、先に換算してください。
SMSA passKey（リアルタイム送料のみ）：リアルタイム送料は SMSA ウェブサービス（SECOM、操作 getShipCharges）を使用します。passKey は依頼に応じて SMSA が発行します。SMSA のアカウントマネージャーに問い合わせるか、info@smsaexpress.com に、アカウント番号を添えて SMSA ウェブサービスへのアクセスを依頼してください。passKey は SMSA の e コマースポータルの API キーとは異なる場合があります。このサービスには SMSA のテストサーバー（サンドボックス）はありません。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_smsa_express フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox SMSA Express。または、プラグイン画面でプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 料金表に SMSA Express の料金を入力します。
6. 任意：Live rates (API) で Live charges を有効にし、SMSA passKey、発送元の都市と国を入力します。ストアの通貨が SAR でない場合は、為替レートも入力します。
7. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーン（例：「サウジアラビア」）に VibeFox SMSA Express を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox SMSA Express。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます：
Title (zone)：このゾーンで購入者に表示される名前。空欄にすると、グローバルの Method title が使用されます。
設定を保存するたびに、キャッシュされた SMSA 送料はクリアされます。リアルタイム送料が有効な場合、設定の上部の警告で、passKey、発送元の都市、為替レートの未入力や、料金表が空であることが分かります。
一般
Enable/Disable：すべてのゾーンでこの方法を一括で有効または無効にします。
Method title：カートとチェックアウトに表示される配送方法の名前。ゾーンごとに上書きできます。初期値：SMSA Express。
リアルタイム料金（API）（任意。SMSA が送料を返さない場合は料金表が使用されます）
Live charges：SMSA Express から配送料を取得します。初期値：オフ。
SMSA passKey：SMSA ウェブサービス（SECOM）のキーです。ログに「Invalid Passkey」と表示される場合、このサービスではキーが受け付けられていません。SMSA にウェブサービス用の passKey を依頼してください。
Ship-from city：荷物を発送する都市。SMSA の表記に合わせて入力します（例：Riyadh、Jeddah、Dammam）。空欄にすると、WooCommerce > Settings > General のストアの都市が使用されます。
Ship-from country：荷物を発送する国。初期値はストアの所在国です。
Shipment type：SMSA に配送タイプとして送信されます。DLV（初期値）は標準配送です。SMSA から別のコードを指定された場合のみ変更してください。
Currency of SMSA charges：SMSA はすべての送料に通貨コード（通常は SAR、初期値）を付けて返します。この通貨およびストアの通貨以外の通貨による送料は使用されません。
Exchange rate：SMSA 通貨 1 単位のストア通貨での価格。例：0.24。2 つの通貨が同じ場合は不要です。設定しない場合、他の通貨の送料は使用されず、料金表が適用されます。小数点とカンマのどちらも小数点区切りとして受け付けられます。
料金（ストアの通貨での SMSA Express 料金カード。リアルタイム料金がオフの場合に使用され、SMSA が送料を返さない場合のフォールバックとしても使用されます）
Price table：仕向け国ごとに 1 行。+ Add country をクリックすると行を追加でき、×をクリックすると削除できます。* All other countries の行は、独自の行がない国に適用されます。各行には基本料金と重量列があります：XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg 超。重量列が空または 0 の場合は基本料金が使用されます。基本料金が 0 の場合は送料無料になります。料金が 1 つもない行は、保存時に削除されます。「9.99」と「9,99」のどちらも受け付けられます。
Price for countries not in the table：料金表に仕向け国の行がない場合（* の行もない場合）、またはその行にこの重量の料金がない場合に使用されます。空欄にすると、その場合は方法を非表示にします。
Price applies：料金の計算方法。
商品の重量は、ストアの重量単位からキログラムに変換されます。
条件
Minimum weight (kg)：カートがこれより軽い場合、方法を非表示にします。0 は無制限を意味します。
Maximum weight (kg)：カートがこれより重い場合、方法を非表示にします。初期値：30。0 は無制限を意味します。
Minimum order amount：カートの小計（割引後、税抜き）がこの金額に達した場合のみ、方法を表示します。空欄にすると常に表示されます。
Free shipping from：SMSA Express の送料が無料になる、カートの小計（割引後、税抜き）の金額。送料無料は、その方法に仕向け先の料金がある場合のみ提供されます：SMSA の送料、料金表の行、または料金表にない国の料金。料金表に料金がある場合、SMSA へのリクエストは送信されません。空欄にすると、送料無料は提供されません。
Excluded shipping classes：カートに、これらの WooCommerce 配送クラスのいずれかの商品が含まれる場合、方法を非表示にします。
Tax status：Taxable は WooCommerce の税金を送料に加算し、None は加算しません。料金（料金表と SMSA の送料）にすでに税が含まれている場合（例：サウジアラビアの付加価値税）は、None を選択してください。
配送ゾーンなしでの利用
Ignore shipping zones：この方法がどの配送ゾーンにも追加されていなくても、下に指定した国に SMSA Express を提供します。
Countries：このモードの仕向け国。空欄にすると、配送先のすべての国が使用されます。この項目は Ignore shipping zones が有効な場合のみ使用されます。配送ゾーンに追加された方法は、常にそのゾーンの国に対して機能します。
詳細
Debug log：すべての送料計算を WooCommerce > Status > Logs に、ソース vfd_smsa_express で記録します。購入者の住所やキーは記録されません。リアルタイム送料のエラーは、このオプションがオフでも常に記録されます。作業が終わったらログをオフにしてください。
Remove data on uninstall：有効な場合、プラグインを削除すると、すべての SMSA Express 設定とゾーンの方法が削除されます。プラグインを無効化しても、何も削除されません。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します：配送先の国、カートの重量、最低注文金額、除外する配送クラス。送料無料が適用され、仕向け先に料金がある場合、その方法は料金 0 で表示されます。
リアルタイム送料が有効な場合、プラグインは発送元の都市と国、購入者の都市と国、配送タイプ、kg 単位の荷物の重量、代金引換額 0 を SMSA に送信します。SMSA は送料とその通貨を返します。プラグインはそれをストアの通貨に換算して表示します。リアルタイム送料は、購入者が都市を入力した後にのみ要求されます。
各送料は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 5 分間キャッシュされます。タイムアウトまたはサーバーエラーの後は、2 分間 SMSA に問い合わせません。キーが拒否された後は、5 分間問い合わせません。これにより、チェックアウトが更新のたびに不調なサービスを待つことはありません。リクエストのタイムアウトは 12 秒です。
SMSA が有効な送料を返さない場合（passKey なし、都市が未入力、商品の重量がない、キーが無効、タイムアウト、エラー、その都市へのサービスがない、または不明な通貨）には、料金表が使用されます。料金表と Price for countries not in the table のどちらからも料金が得られない場合、方法は非表示になります。購入者にエラーが表示されることはありません。理由はログに記録されます。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。アラビア語翻訳が含まれています。
プラグインは配送料の計算のみを行います。SMSA の出荷データの作成、AWB ラベルの印刷、返品の処理、荷物の追跡は行いません。代金引換とその手数料はリアルタイム送料に含まれません。SMSA の店舗受け取りの選択肢はなく、この方法は戸口までの配送です。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox SMSA Express のページ上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックにはステータスが表示されます。例えば、ライセンスの有効期限日や、お使いのドメインです。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。リンク Manage licenses and domains in your account から、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、SMSA Express はチェックアウトで購入者に表示されません。ログインしているストアの管理者には、(unlicensed — visible to admins only) と表示された状態で表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグイン画面と WooCommerce の画面には通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
SMSA Express がチェックアウトに表示されない：ライセンスが有効であること、Enable/Disable が有効であること、この方法が購入者の国のゾーンに追加されていること（または Ignore shipping zones が有効で、その国が許可されていること）を確認してください。重量制限、Minimum order amount、Excluded shipping classes を確認してください。国または * に料金があるか、または Price for countries not in the table が設定されているかを確認してください。
購入者に SMSA の送料ではなく料金表の価格が表示される：SMSA には購入者の都市が必要なため、都市が入力されるまでは料金表の価格が表示されます。料金表は、SMSA が応答しない、キーまたは都市を拒否する、または為替レートのない通貨で送料を返す場合にも使用されます。理由を確認するには、WooCommerce > Status > Logs を開き、ソース vfd_smsa_express を見てください。
ログに「Invalid Passkey」と表示される：キーが SMSA ウェブサービスに受け付けられていません。SMSA にウェブサービス用の passKey を依頼してください。
購入者の都市が受け付けられない：SMSA は独自の都市表記を求めます。開発者は、vfd_smsa_express_live_request_fields フィルターを使用して、都市名などのリクエストを調整できます。
送料に税金が二重にかかる：料金カードまたは SMSA の送料に、すでに付加価値税が含まれている可能性があります。Tax status を None に設定してください。
変更後も料金が古く見える：設定ページを保存してください。キャッシュされた SMSA の送料がクリアされます。
ライセンスブロックにエラーが表示される：ブロックのメッセージに従ってください。例えば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化します。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins 画面で無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの方法、キャッシュされた送料は、Remove data on uninstall が有効だった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、配送の行を保持します。
SMSA Express は、それぞれの所有者の商標です。このプラグインは SMSA Express と提携しておらず、SMSA Express による推奨もされていません。