VibeFox SF Express for WooCommerce — ヘルプ
要件
WordPress:5.8 以降。
WooCommerce:5.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないとプラグインを有効化できません。
PHP:8.0 以降。
SF Express アカウント（リアルタイム料金のみ）:リアルタイム料金は、SF Express の FengQiao オープンプラットフォーム（open.sf-express.com）を使用します。SF Express の月額契約アカウントと、FengQiao の開発者アカウントが必要です。そこで登録してアプリケーションを作成し、API "Delivery time standard and price query"（EXP_RECE_QUERY_DELIVERTM）を追加して、顧客コードと checkword をコピーしてください。サンドボックスと本番環境の checkword は異なります。料金表のみを使用する場合、SF Express アカウントは不要です。
VibeFox ライセンスキー:vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_sf_express フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox SF Express。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 料金表や代替料金を入力します。
6. 中国本土でリアルタイム料金を使用する場合は、顧客コードと checkword、発送元の都道府県と市区町村（または中国国内のストア住所）を入力します。ストアの通貨が CNY 以外の場合は、換算レートも入力してください。まず Sandbox とサンドボックスの認証情報でテストしてください。
7. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox SF Express を追加するか、Ignore shipping zones をオンにして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox SF Express。これらはすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます：
Title (zone):このゾーンでお客様に表示される名称。空欄の場合は、全体の Method title が使われます。
設定を保存するたびに、キャッシュされた SF Express の料金が消去されます。リアルタイム料金の設定が一部だけの場合、設定の上部の警告に、不足している設定または換算レートが表示されます。
一般
Enable/Disable:すべてのゾーンでこの配送方法を一度にオンまたはオフにします。
Method title:カートとチェックアウトに表示される配送方法の名称。ゾーンごとに上書きできます。初期値：SF Express。
Tax status:Taxable を選ぶと、料金にストアの配送税が加算されます。None を選ぶと加算されません。SF Express の料金に、請求したいものがすべて含まれている場合は None を選んでください。
SF Express FengQiao API（リアルタイム料金）（任意。中国本土の配送先住所向け）
Customer code (partnerID):FengQiao アプリケーションの顧客コード（顾客编码）。
Checkword:同じ環境の checkword（校验码）。リクエストへの署名にのみ使用され、送信やログ記録は一切行われません。
Sandbox:サンドボックスの認証情報を使ってテストするには、FengQiao のサンドボックスを使用します。サンドボックスの料金は実際の料金ではありません。本番のストアではオフにしてください。初期値：off。
SF Express product:どの SF Express 商品の料金を表示するか。
Sender province:荷物を発送する都道府県。ストアが中国にある場合は、空欄にすると WooCommerce > Settings > General のストア住所の都道府県が使われます。
Sender city:標準的な中国語の市名（例：深圳市）。ストアが中国にある場合は、空欄にするとストアの市が使われます。
Currency conversion rate:SF Express の料金は CNY（元）建てです。ストアの通貨が CNY でない場合は、1 CNY がストア通貨の何単位に相当するかを入力してください。入力しないと、リアルタイム料金は使用されません。ストアの通貨が CNY の場合、料金はそのまま使われます。小数点とカンマのどちらも小数区切りとして受け付けます。
料金表と代替料金（香港、マカオ、台湾、その他の国に使用されます。リアルタイム料金が設定されていない場合、または SF Express が料金を返さない場合に使われます。料金はストアの通貨建てです）
Country prices:国ごとの基本料金を設定する表です。* Any other country の行は、自分の行がないすべての国に適用されます。重量区分の料金が 0 より大きい場合、その区分の荷物については基本料金の代わりになります：≤ 1 kg、≤ 2 kg、≤ 3 kg、≤ 5 kg、> 5 kg。基本料金が 0 の場合は送料無料になります。基本料金が空欄の場合、その国には料金がないことを意味し、代替料金が使われます。
Fallback cost:SF Express も表も料金を返さない場合に使われます。空欄にすると、その場合は配送方法が非表示になります。
Table / fallback price is:料金表と代替料金の課金方法。
SF Express のリアルタイム料金は、常に注文全体に対するものです。
条件
Free shipping from:送料が無料になるカートの小計。送料無料は、その配送方法に配送先の料金（リアルタイム料金、料金表の行、または Fallback cost）がある場合にのみ提供されます。空欄にすると送料無料は提供されません。
Minimum subtotal:カートの小計がこの金額に達した場合にのみ配送方法を表示します。空欄にすると常に表示されます。
Min weight (kg):カートの最小重量（kg）。商品の重量は、ストアの重量単位から変換されます。0 は制限なしを意味します。
Max weight (kg):カートの最大重量（kg）。初期値：50。0 は制限なしを意味します。
Excluded shipping classes:カートにこれらの WooCommerce 配送クラスの商品が含まれている場合、配送方法を非表示にします。
配送ゾーンを使わない場合の提供
Ignore shipping zones:配送方法がどのゾーンにも追加されていなくても、下記の国に対して提供します。オフの場合、配送方法は追加された配送ゾーンにのみ表示されます。
Countries:このモードの配送先の国。空欄にすると、発送先として設定しているすべての国が使われます。この項目は Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log:料金の計算内容を WooCommerce のログに記録します：WooCommerce > Status > Logs、ソースは vfd-sf-express。この設定がオフでも、API エラーは常に記録されます。checkword や顧客の住所は記録されません。
Remove data on uninstall:オンの場合、プラグインを削除すると、その設定、配送ゾーンの配送方法、キャッシュが削除されます。プラグインを無効化しても、何も削除されません。
チェックアウト時の動作
お客様が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します：配送先の国、カートの重量、最低小計、除外する配送クラス。送料無料が適用され、かつ料金表または Fallback cost に配送先の料金がある場合、配送方法は 0 円で表示され、SF Express へのリクエストは送信されません。それ以外の場合、プラグインはまず SF Express にリアルタイム料金を問い合わせ、料金が返ってきた場合にのみ配送方法を無料として表示します。
中国本土の配送先で、顧客コードと checkword が設定されている場合、プラグインは SF Express に、発送元の都道府県と市区町村、お客様の都道府県と市区町村、カートの重量、そしてカートの容積（縦・横・高さの 3 つすべてが入力されている商品から算出）を送信します。リクエストは checkword で署名されます。SF Express は料金を CNY で返し、プラグインは選ばれた料金をストアの通貨に換算します。
SF Express は、標準的な中国語の名称で住所を認識します。お客様の都道府県は、チェックアウトの都道府県（State）欄から取得されます。市名は中国語で入力する必要があります。例：广州市。北京、上海、天津、重庆の場合、市名は自動で入力されます。"Guangzhou" のようにラテン文字で入力された市名は、料金表の料金になります。
各料金は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトが更新のたびに SF Express の応答を待つことはありません。HTTP のタイムアウトは 10 秒です。
リアルタイム料金がない場合、料金は料金表から、次に Fallback cost から取得されます。どちらも該当しない場合、配送方法は非表示になります。お客様にエラーが表示されることはありません。エラーはログに記録されます。
この配送方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。英語と簡体字中国語の翻訳が含まれています。
このプラグインは料金の計算のみを行います。送り状やラベルの作成、SF Express での注文作成、集荷の予約、配送のキャンセルや追跡は行いません。いつも通り SF Express アカウントで発送の作成と追跡を行ってください。お客様は SF のサービスポイントやロッカーを選ぶことはできません。SF Express はドア・ツー・ドアの宅配として使用されます。リアルタイム料金は中国本土の配送先住所にのみ適用されます。このプラグインは FengQiao のドキュメントとモックの応答をもとに開発されているため、本番稼働の前に、SF Express アカウント（まずサンドボックス）で料金を確認してください。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox SF Express ページの上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ステータス（例：ライセンスの有効期限日）とドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、SF Express はチェックアウトでお客様に表示されません。ただし、ログインしているストアの管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されます。これにより、キーを購入する前にプラグインの設定とテストができます。Plugins ページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもプラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに SF Express が表示されない:ライセンスが有効であること、Enable/Disable がオンであること、お客様の国のゾーンに配送方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。重量の制限、Minimum subtotal、Excluded shipping classes も確認してください。料金表または Fallback cost に、その国の料金が設定されているかを確認してください。
料金が SF Express ではなく料金表から来ている:リアルタイム料金には、顧客コードと checkword、発送元の都道府県と市区町村、都道府県と中国語の市名を含む中国本土の配送先住所、そして（CNY 以外のストアの場合）換算レートが必要です。原因を確認するには、WooCommerce > Status > Logs を開き、ソースに vfd-sf-express を選択してください。失敗したリクエストは 10 分後に再試行されます。
ログのエラー A1006:署名が無効です。checkword が間違っているか、別の環境のものです。Sandbox の設定を確認してください。
ログのエラー A1004:料金照会 API が FengQiao アプリケーションに追加されていません。
香港：料金表と代替料金で動作します。FengQiao の料金照会は中国本土の住所のみが対象です。
変更後に料金が古く見える：設定ページを保存してください。キャッシュされた SF Express の料金が消去されます。
開発者向け：vfd_sfex_quote_request フィルターで料金リクエストを変更できます（例：別の商品コードに変更）。vfd_sfex_api_url でゲートウェイの URL を変更できます。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。例えば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントでドメインの枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた料金は、Remove data on uninstall がオンになっていた場合にのみ削除されます。それ以外の場合は、後で再インストールする際に使えるよう保持されます。既存の注文は、配送の明細をそのまま保持します。
SF Express は、その所有者の商標です。このプラグインは SF Express と提携しておらず、SF Express の承認も受けていません。