VibeFox Aramex for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 5.0 以降がインストールされ、有効になっていること。WooCommerce がない場合、プラグインは有効化できません。

PHP: 8.0 以降。

Aramex アカウント（リアルタイム料金のみ）: リアルタイム料金は Aramex Rate Calculator API を使用します。API アクセスは Aramex のアカウント保有者に提供されます。Aramex のアカウントマネージャーに問い合わせるか、Aramex の Web サイトにある Aramex Developers Solution Center をご覧ください。必要な値は 6 つです: API ユーザー名（通常はメールアドレス）、パスワード、アカウント番号、アカウント PIN、アカウントのエンティティ（拠点。例: DXB）、アカウントの国コード（例: AE）。国ごとの固定料金のみを使用する場合は、Aramex アカウントは不要です。

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

インストール

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

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

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

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

5. 送料の計算方法を選び、対応するセクションに入力します（「設定」の項を参照）。

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

設定

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

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

設定を保存するたびに、キャッシュされた Aramex の料金がクリアされます。

一般

Enable/Disable: 配送方法をすべてのゾーンでまとめてオンまたはオフにします。

Method title: カートとチェックアウトに表示される配送方法の名前。既定値: Aramex。

Shipping cost: 料金の計算方法。

リアルタイム料金が表示されない理由はデバッグログに記録されます。購入者に表示されることはありません。

Aramex API アカウント（リアルタイム料金のみに必要。6 つのフィールドすべてが必須です）

Username: Aramex API のユーザー名。通常はメールアドレスです。

Password: Aramex API のパスワード。

Account number: Aramex のお客様アカウント番号。

Account PIN: Aramex アカウントの PIN。

Account entity: アカウントの Aramex エンティティ（拠点）コード。例: DXB、AMM、RUH。

Account country code: Aramex アカウントの 2 文字の国コード。例: AE。

Aramex サービス（リアルタイム料金で使用）

配送先住所が発送元の国にある場合、Domestic として見積もられます。それ以外の発送はすべて International express として見積もられます。

International service: 海外向け発送の Aramex サービス。PPX Priority Parcel Express（既定）、PDX Priority Document Express、PLX Priority Letter Express、DPX Value Express Parcels、EPX Economy Parcel Express、EDX Economy Document Express、GPX Ground Parcel Express、GDX Ground Document Express から選択します。

Domestic service: 発送元の国内での発送に使う Aramex サービス。ONP Overnight Parcel（既定）、OND Overnight Document、SMP Same Day Parcel、SMD Same Day Document、SDD Same Day Delivery、EMD Early Morning Delivery、PEC Economy Delivery、PEX Road Express、HVY Heavy（20 kg 以上）から選択します。

Payment type: Aramex への発送料金を支払う人。Prepaid（発送者が支払い）、Collect（受取人が支払い）、Third party（第三者が支払い）から選択します。通常は Prepaid です。

API weight unit: Aramex に送信する重量の単位（KG または LB）。商品の重量はストアの重量単位から換算されます。課金重量は実重量と容積重量（縦 × 横 × 高さ（cm）÷ 5000）の大きい方です。最低値は 0.5 kg で、重量が設定されていない商品にもこの値が使われます。

Currency conversion rate: Aramex にはストアの通貨で見積もるよう依頼します。それでも別の通貨で回答された場合、料金にこの数値を掛けます（Aramex の通貨 1 単位 = ストアの通貨 X 単位）。空欄にすると、そのような見積もりは拒否されるため、購入者が誤った通貨で請求されることはありません。小数点はピリオドとカンマのどちらも使用できます。

発送元住所（出発地住所）（リアルタイム料金で使用）

Origin country: 発送元の国。既定ではストアの国です。

Origin city: 発送元の都市。Aramex で必須です。

Origin state / emirate: 任意。

Origin postcode: 任意。

発送元の国がストアの国と同じ場合、空欄の項目は WooCommerce > Settings > General のストア住所から取得されます。

固定料金（固定モードおよびリアルタイム料金のフォールバックとして使用）

Price per country: 2 文字の国コードとストア通貨での料金の表。Add row をクリックすると国を追加でき、×印で削除できます。その他すべての国には * を国コードとして使用します。* の行がない場合、料金が設定されていない国には固定料金が適用されず、その国では配送方法が非表示になります。

Fixed price applies: Per order は料金を 1 回だけ請求します。Per item は料金にカート内の商品数を掛けます。Aramex のリアルタイム料金は常に発送単位で計算されます。

条件

Minimum weight (kg): カートの重量がこの値より軽い場合、配送方法を非表示にします。0 は制限なしを意味します。

Maximum weight (kg): カートの重量がこの値より重い場合、配送方法を非表示にします。既定値: 100。0 は制限なしを意味します。

Minimum order amount: カートの小計（割引後、税抜き）がこの金額以上の場合にのみ配送方法を表示します。空欄にすると常に表示されます。

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

Free shipping: 下記の金額以上で Aramex の送料無料配送をオンにします。

Free shipping from: 送料が無料になるカートの小計（割引後、税抜き）。Free shipping がオンの場合にのみ使用されます。

Tax status: Taxable は送料に WooCommerce の税を加算し、None は加算しません。Aramex のリアルタイム料金にはすでに VAT が含まれている場合があります。その場合は、税が二重に請求されないよう None を選択してください。

配送ゾーンを使用しない場合の提供条件

Ignore shipping zones: 配送方法がどの配送ゾーンにも追加されていなくても、下記の国に対して Aramex を提供します。

Countries: そのモードの配送先の国。空欄にすると、配送先とするすべての国が対象になります。この項目は Ignore shipping zones がオンの場合にのみ使用されます。

詳細設定

Debug log: 料金計算と API エラーを、プラグインフォルダー内の logs/vfd_armx_debug.log.php に書き込みます。このファイルは Web から開くことはできません。パスワード、PIN、アカウント番号、顧客の住所はマスクされます。作業が終わったらログをオフにしてください。

Remove data on uninstall: オンにすると、プラグインを削除したときに、すべての設定、ゾーンの配送方法、キャッシュされた料金、ログが削除されます。プラグインを無効化しても何も削除されません。

チェックアウト時の動作

購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインはまず条件を確認します: 配送先の国、カートの重量、最低注文金額、除外する配送クラス。送料無料が適用される場合、購入者には配送方法が Aramex (free) として表示され、Aramex へのリクエストは送信されません。

固定モードでは、料金は表から取得されます。リアルタイムモードでは、プラグインは発送元と配送先の住所、課金重量、サービス、ストアの通貨を Aramex に送信し、返された合計額を表示します。リアルタイム料金は、購入者が市区町村または郵便番号を入力した後にのみ問い合わせます。各回答は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストは 10 分間キャッシュされるため、チェックアウトを再読み込みするたびに Aramex の応答を待つことはありません。API のタイムアウトは 10 秒です。

Aramex がエラー、ゼロの金額、または換算レートのない別通貨での見積もりを返した場合、購入者にエラーは表示されません。配送方法は非表示になるか、フォールバックモードでは固定料金が使用されます。理由はデバッグログに記録されます。

この方法はクラシックチェックアウトと、カートとチェックアウトのブロックの両方で動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。

プラグインが計算するのは料金のみです。Aramex の発送データの作成、ラベルの印刷、集荷の予約、荷物の追跡、購入者による Aramex 営業所の選択は行いません。荷物は常に 1 個として Aramex に送信されます。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Aramex が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、配送方法が購入者の国のゾーンに追加されていること（または Ignore shipping zones がオンで国が許可されていること）を確認してください。重量の制限、Minimum order amount、Excluded shipping classes も確認します。固定モードでは、その国または * に料金が設定されているか確認してください。

リアルタイム料金が表示されない: Debug log をオンにし、チェックアウトを再読み込みして、プラグインフォルダー内の logs/vfd_armx_debug.log.php を開きます。ログには理由が表示されます: API 認証情報の不足、Aramex のエラーコード、発送元の都市の未入力、配送先の都市または郵便番号が未入力、重量または金額の制限、別通貨での見積もり。Aramex live rates, fixed prices if the API fails を設定している場合、問題を解決するまでの間も購入者には固定料金が表示されます。

ログに ERR75 のエラー: Aramex がログインを拒否しました。ユーザー名、パスワード、アカウント番号、PIN、エンティティ、国コードを Aramex のアカウントマネージャーに確認してください。

別通貨での見積もりが拒否される: Aramex がストアの通貨以外の通貨で回答しました。Currency conversion rate を入力するか、Aramex にストアの通貨で見積もるよう依頼してください。

送料に税が二重に課される: Aramex の合計額にはすでに VAT が含まれている場合があります。Tax status を None に設定してください。

変更後も料金が古いように見える: 設定ページを保存してください。これによりキャッシュされた Aramex の料金がクリアされます。

Aramex サンドボックス: プラグインは本番環境の Aramex Rate Calculator を使用します。開発者は vfd_armx_api_url フィルターでエンドポイントを変更できます。フィルター vfd_armx_rate_request、vfd_armx_number_of_pieces、vfd_armx_volumetric_divisor は、リクエスト、荷物の個数、容積重量の除数を調整します。

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

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた料金、ログは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、再インストールのために残ります。既存の注文は配送明細を保持します。

Aramex は、それぞれの所有者の商標です。このプラグインは Aramex と提携しておらず、Aramex による推奨も受けていません。