VibeFox ShipStation for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないと、プラグインは有効化できません。

PHP: 8.0 以降。

ShipStation アカウント: ShipStation で配送業者を接続し（Settings > Shipping > Carriers）、その後 ShipStation > Settings > Account > API Settings から API Key と API Secret をコピーしてください。API へのアクセスは ShipStation のプランによって異なります。ページが表示されない場合、お使いのプランには API アクセスが含まれていません。本プラグインは ShipStation API V1（API Key と API Secret）を使用します。API キーが 1 つだけの ShipStation API V2 アカウントには対応していません。キーがない場合は、代替送料のみが使用されます。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_shipstation フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox ShipStation。または、プラグインのページでプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. API Key と API Secret を貼り付け、出荷元の郵便番号を入力して保存します。ページにアカウントの配送業者コードが表示されます。使用したいコードを Carrier codes に入力し、もう一度保存します。

6. ストアの通貨が ShipStation アカウントの通貨と異なる場合は、Exchange rate を設定します。

7. 必要に応じて、代替送料を入力します。

8. WooCommerce > Settings > Shipping > Shipping zones で、VibeFox ShipStation を配送ゾーンに追加するか、Ignore shipping zones を有効にして国を選択します。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox ShipStation。設定はすべての配送ゾーンに適用されます。配送ゾーンにこの方法を追加すると、ゾーンのウィンドウには 1 つのフィールドだけが表示されます:

Title (zone): このゾーンで購入者に表示される名前。空欄にすると、全体の Name が使用されます。

設定を保存するたびに、キャッシュされた ShipStation の送料が消去され、API Key と API Secret が確認されます。その後、ページにはアカウントに接続された配送業者とそのコードが表示されます。例: "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)"。設定の上部に表示される警告は、リアルタイム送料が機能しない場合を知らせます。キーがない、配送業者コードがない、出荷元の郵便番号がない、為替レートがない、接続チェックが失敗した、または配送業者コードがアカウントに接続されていない、といった場合です。

全般

Enable/Disable: すべてのゾーンで、この方法を一度に有効または無効にします。

Name: チェックアウトに表示される配送方法の名前。ゾーンは、独自の Title で上書きできます。デフォルト: ShipStation Shipping。

ShipStation アカウント

API Key: ShipStation > Settings > Account > API Settings にある API Key。

API Secret: 同じページにある API Secret。

Carrier codes: 1 つ以上の ShipStation 配送業者コードを、カンマ区切りで入力します（例: stamps_com, ups_walleted）。最大 5 つのコードが使用され、配送業者ごとに 1 回 API リクエストが送られます。これらの配送業者の中で最も安い送料が表示されます。コードは保存後に表示される一覧から取得してください。

Allowed services: 任意。カンマ区切りの ShipStation サービスコード（例: usps_priority_mail, ups_ground）。空欄にすると、上記の配送業者の中で最も安いサービスが表示されます。

Package code: "package"（デフォルト）は、お使いの箱の送料を計算し、配送業者の封筒や定額料金の箱は除外します。空欄にすると、配送業者が提供するすべてのパッケージタイプの送料を計算します。

出荷元

Ship-from postal code: リアルタイム送料に必須です。ShipStation は郵便番号のみで送料を計算し、その郵便番号は ShipStation アカウントの国にある必要があります。空欄にすると、WooCommerce > Settings > General のストアの郵便番号が使用されます。

送料

Parcels: カートを ShipStation に送信する方法。

ShipStation account currency: ShipStation が送料を返す通貨: USD、CAD、GBP、AUD、NZD、EUR のいずれか。デフォルト: USD（米国のアカウント）。

Exchange rate: アカウント通貨 1 単位のストア通貨での価格（例: 0.92）。ストアの通貨がアカウント通貨と異なる場合にのみ必要です。設定しないと、リアルタイム送料は使用されず、代替送料が適用されます。為替レートは自動では更新されません。

Tax status: Taxable を選択すると、WooCommerce は税ルールに従って送料に税金を加算できます。None を選択すると加算しません。ShipStation の送料には、売上税は含まれません。

代替送料（リアルタイム送料がない場合に使用されます: API キーがない、ShipStation に接続できない、またはその住所の配送業者の送料がない場合。料金はストアの通貨です。その場合にこの方法を非表示にするには、表と Other countries を空欄にしてください）

Prices by country: 国ごとの基本料金と、荷物の重量に応じたサイズ列を持つ表: XS ≤1 kg、S ≤2 kg、M ≤3 kg、L ≤5 kg、XL >5 kg。+ Add country をクリックすると行が追加され、×をクリックすると行が削除されます。サイズが空欄の場合は基本料金が使用されます。基本料金が 0 の場合は送料無料です。* Default (all other countries) の行は、独自の行がない国に適用されます。

Other countries: 表に国の料金がない場合の料金。空欄にすると、その場合この方法は非表示になります。

条件

Free shipping from: この金額以上のカート小計で送料が無料になります。その場合、ShipStation へのリクエストは行われません。空欄にすると無効になります。

Minimum subtotal: カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると常に表示されます。

Minimum weight: この方法を表示するための最小カート重量（ストアの重量単位）。0 は制限なしを意味します。

Maximum weight: カート重量がこの値を超えると、この方法は非表示になります（ストアの重量単位）。0 は制限なしを意味します。

Disabled shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかの商品が含まれている場合、この方法を非表示にします。

配送ゾーンを使わない場合の提供

Ignore shipping zones: この方法を配送ゾーンに追加しているかどうかにかかわらず、下記の国に対してこの方法を提供します。

Countries: このモードの配送先の国。空欄にすると、ストアが配送するすべての国が使用されます。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。配送ゾーンに追加された方法は、常にそのゾーンの国に対して機能します。

詳細設定

Debug log: ShipStation へのリクエストを WooCommerce > Status > Logs に、ソース vfd-shipstation で記録します。このオプションがオフでも、API エラーは常に記録されます。API Key、API Secret、顧客の住所は記録されません。郵便番号はマスクされます。

Remove data on uninstall: 有効にすると、プラグインを削除したときに、その設定と配送ゾーンの配送方法が削除されます。プラグインを無効にしても、設定が削除されることはありません。

チェックアウトでの動作

購入者が配送先の住所を入力すると、WooCommerce はプラグインに送料を問い合わせます。プラグインはまず条件を確認します: カートの重量、最小小計、無効な配送クラス。送料無料が適用される場合は、価格 0 でこの方法が表示され、ShipStation へのリクエストは送られません。

次にプラグインは、ShipStation に出荷元の郵便番号、配送先の国、都道府県、市区町村、郵便番号、荷物の重量、箱のサイズを送信します。購入者が郵便番号を入力するまで、リクエストは行われません。郵便番号のない国には代替送料が適用されます。重量と寸法は、ストアの単位から換算されます。商品は 1 つの箱にまとめられます。寸法のない商品がある場合、荷物は重量のみで計算されます。

ShipStation へのリクエストは、配送業者コードごとに 1 回行われます。プラグインは、許可された中で最も安い送料を、ストアの通貨に換算して、この方法の名前の下に表示します。

各応答は 1 時間キャッシュされます。ShipStation が使用可能な送料を返さなかった場合、その結果は 10 分間記憶されます。ShipStation がキーを拒否した場合、または接続できない場合、リクエストは 5 分間一時停止されます。レート制限の後は、一時停止の時間は ShipStation のリセット時刻に従います。リクエストのタイムアウトは 12 秒です。プラグインを無効にすると、キャッシュされた送料は消去されます。

リアルタイム送料がない場合、料金は代替送料の表から、次に Other countries から取得されます。どちらも該当しない場合、この方法は非表示になります。購入者に ShipStation のエラーメッセージが表示されることはありません。詳細は WooCommerce のログに記録されます。

この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高パフォーマンス注文保存機能（HPOS）に対応しています。

プラグインが行うのは送料の計算だけです。送り状ラベルの購入、ShipStation での注文や出荷の作成、荷物の追跡、返品の処理は行いません。受け取り場所はなく、チェックアウトで複数のサービスから選ぶこともできません。住所の検証、保険、署名確認、複数の荷物への分割、送料の上乗せもありません。

注文

注文の配送行には、選択された Service（例: "USPS Ground Advantage - Package"）が保存されます。管理画面の注文画面で確認でき、ShipStation で対応する送り状ラベルを作成できます。

ライセンスキー

本プラグインは、vibefox.net の VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox ShipStation の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなどのステータスが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。リンク Manage licenses and domains in your account を開くと、vibefox.net のアカウントが表示されます。

1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。

有効なキーがない場合、ShipStation はチェックアウトで購入者に表示されません。ログインしている店舗管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定し、テストできます。プラグインのページと WooCommerce のページにリマインダーが表示されます。既存の注文には影響しません。

ライセンスの期限が切れても、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。

トラブルシューティング

ShipStation がチェックアウトに表示されない: ライセンスが有効か、Enable/Disable がオンか、この方法が購入者の国のゾーンに追加されているか（または Ignore shipping zones がオンで、国が許可されているか）を確認してください。重量制限、Minimum subtotal、Disabled shipping classes を確認してください。リアルタイム送料がない場合は、その国、* Default、または Other countries に料金があるかを確認してください。

チェックアウトに ShipStation の送料ではなく代替送料が表示される: 設定ページの上部にある警告（キー、配送業者コード、出荷元の郵便番号、為替レート）を確認してください。Debug log をオンにし、WooCommerce > Status > Logs を、ソース vfd-shipstation で開いてください。購入者の郵便番号が必要です。入力されるまでリクエストは行われません。

入力する配送業者コード: キーとシークレットを使って設定を保存してください。ページにアカウントの配送業者コードが表示されます。そのうち 1 つ以上を使用してください。

送料が ShipStation と異なる: 荷物は商品の重量と寸法から作られ、商品は 1 つの箱にまとめられます。寸法のない商品は重量のみで計算されます。送料は 1 時間キャッシュされます。設定を保存すると、キャッシュが消去されます。

開発者向け: フィルター vfd_shst_rate_request、vfd_shst_selected_rate、vfd_shst_api_url は、配送業者ごとの送料リクエスト、選択された送料、API のベース URL を変更します。

ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。

アンインストール

プラグインを無効にしても設定は保持され、キャッシュされた送料だけが消去されます。削除するには、Plugins ページで無効にしてから削除してください。このプラグインのライセンスキーとライセンスステータス、キャッシュされた送料、保存された配送業者の一覧は、常に削除されます。設定と配送ゾーンの方法は、Remove data on uninstall が有効だった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、配送行を保持します。

ShipStation は、その所有者の商標です。本プラグインは ShipStation と提携しておらず、ShipStation による承認も受けていません。