VibeFox Omniva for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降、インストールおよび有効化されていること。WooCommerce がなければプラグインは有効化できません。

PHP: 8.0 以降。

Omniva: API アカウントは不要です。Omniva には公開された料金 API がありません。Omniva OMX API は契約顧客のみが利用でき、本プラグインでは使用しません。そのため、ご自身の（契約）料金を入力します。Omniva の法人アカウントで荷物を登録してください。

Parcel machine list: プラグインは omniva.ee から Omniva の公開ロケーションファイルをダウンロードします（キーや契約は不要）。サーバーから www.omniva.ee へ HTTPS リクエストを送信できる必要があります。

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

インストール

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

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

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

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

5. 国とパーセルサイズ別の料金、パーセルサイズ、Parcel machine list のステータス行を確認します。

6. WooCommerce > Settings > Shipping > Shipping zones で、エストニア、ラトビア、リトアニアのゾーンに VibeFox Omniva を追加するか、Ignore shipping zones を有効にして国を選択します。

設定

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

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

ページ上部には問題を知らせる通知が表示されます。料金が未設定の場合、または宅配ロッカーのリストをダウンロードできず保存済みのコピーもない場合は、赤い通知が表示されます。この場合、チェックアウトでこの配送方法は表示されません。リストを今は更新できず保存済みのコピーを使っている場合は、黄色い通知が表示されます。読み取れない数値は保存後に通知され、保存されません。

一般

Enable/Disable: すべてのゾーンで Omniva を一度にオン・オフします。

Method title: 購入者に表示される配送方法の名称。ゾーンの配送方法の Title がこれを上書きします。初期値：Omniva parcel machine。

Tax status: Taxable は配送料に WooCommerce の税金を加算し、None は加算しません。

料金（ストアの通貨で入力します。小数は 3.50 または 3,50 と書けます）

Price by parcel size: エストニア、ラトビア、リトアニアごとに 1 行あり、S、M、L、XL、Free from の列があります。配送先の国ごとに、Omniva の各パーセルサイズの料金を入力します。空欄は、その国ではそのサイズを提供しないことを意味します。パッケージがそのサイズを必要とする場合、この配送方法は非表示になります。0 は無料を意味します。Free from は、この金額以上のカート合計（割引後、カートに表示される金額）でその国への配送が無料になるしきい値です。無料配送を設けない場合は空欄にします。独自の料金を保存するまでは、表はエストニアが 3.50、ラトビアとリトアニアが 4.00 で始まります。WooCommerce の税金が有効な場合、各料金の横にある小さな -% ボタンで、入力した料金からストアの国の付加価値税（VAT）を差し引けます（税込みの料金がわかっている場合に使用します）。

Calculation: パーセルサイズと料金の求め方。

Parcel sizes (cm): 各サイズの最大寸法で、Smallest side、Middle side、Largest side として指定します。商品の寸法も同じ順に並べ替えられ、並べて比較されます。値は保存時に並べ替えられます。商品の寸法はストアの単位から cm に変換されます。寸法がない商品はサイズ S に収まるものとみなされます。どのサイズにも収まらない場合は、この配送方法は非表示になります。初期値：S 9 x 38 x 64、M 19 x 38 x 64、L 38 x 39 x 64、XL 39 x 64 x 64。現在の Omniva のパーセルサイズと照らし合わせて確認してください。

利用条件

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

Maximum weight (kg): カート（Per item の場合は 1 つの商品）がこれより重い場合、この配送方法を非表示にします。Omniva の宅配ロッカーは 30 kg までの荷物を受け付けます。初期値：30。0 は制限なしを意味します。ストアの重量単位は kg に変換されます。

Minimum cart total: この金額以上のカート合計の場合にのみ、この配送方法を表示します。常に表示する場合は空欄にします。

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

Ignore shipping zones: ゾーンに追加せずに、下記の国で Omniva を提供します。オフの場合は、この配送方法が追加された配送ゾーンによって国が決まります。オフにしておくことを推奨します。

Countries (without zones): このモードでの配送先の国。このフィールドは Ignore shipping zones が有効な場合にのみ使われます。すべての配送先国を対象にする場合は空欄にします。どのモードでも、Omniva は宅配ロッカーがある国（エストニア、ラトビア、リトアニア）でのみ提供されます。

宅配ロッカー

Post offices: 同じリストに Omniva の郵便局も表示します。Omniva はエストニアの郵便局を掲載しています。初期値はオフです。

City order: 最大の都市（タリン、リガ、ヴィリニュスなど）を先頭に、残りはアルファベット順に表示します。初期値はオンです。オフの場合、都市はすべてアルファベット順に並びます。

Parcel machine list: 国ごとの宅配ロッカーの数（郵便局も有効な場合はその数）と、omniva.ee から最後にダウンロードした時刻を示すステータス行です。Update the list now をクリックすると、すぐにリストをダウンロードします。omniva.ee が応答しない場合は、保存済みのコピーが残ります。

詳細設定

Debug log: 料金計算と宅配ロッカーリストの詳細を WooCommerce > Status > Logs（ソース vfd-omniva）に記録します。利用できない宅配ロッカーリストなどのエラーは、常に記録されます。購入者のデータは記録されません。

Remove data on uninstall: オンの場合、プラグインを削除すると、設定、ゾーンの配送方法、保存済みの宅配ロッカーリストが削除されます。プラグインを無効化しても、設定は削除されません。注文に保存された宅配ロッカーは残ります。

チェックアウトでの動作

購入者がエストニア、ラトビア、リトアニアの配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはカートの重量、最小カート合計、除外する配送クラスを確認し、商品の寸法からパーセルサイズを求めます。パッケージがどのサイズにも収まらない場合、またはそのサイズにその国の料金がない場合、または利用できる宅配ロッカーがない場合は、この配送方法が非表示になります。そのため、購入者が完了できないチェックアウトを目にすることはありません。カート合計がその国の Free from に達すると、料金は 0 になります。パーセルサイズは、注文の配送行に Omniva parcel size として保存されます。

宅配ロッカーのリストは 1 日 1 回 omniva.ee からダウンロードされ、プラグインのフォルダではなく WordPress のデータベースに保存されます。ダウンロードに失敗した場合は、保存済みのコピーが引き続き使われ、次の試行は 15 分後に行われます。そのため、チェックアウトは更新のたびに omniva.ee の応答を待つことがありません。ダウンロードのタイムアウトは 15 秒です。

この配送方法は、クラシックチェックアウトと、カートおよびチェックアウトブロックで動作します。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。料金はストアの通貨で表示されます。プラグインは通貨を換算しません。

プラグインは Omniva の料金を取得せず、発送の登録、ラベルの印刷、集荷の手配、荷物の追跡も行いません。荷物は Omniva の法人アカウントに登録してください。宅配業者による戸口までの配送は、この配送方法には含まれません。

受け取りポイント

購入者が Omniva を選択すると、配送方法の下に 2 つのリストが表示されます：-- Select city -- と -- Select parcel machine --。表示されるのは配送先国の都市と宅配ロッカーだけです。購入者が国を変更すると、リストも変わります。エストニアでは都市は郡になっており、タリン、タルトゥ、ペルヌは個別に表示されます。ラトビアとリトアニアでは都市と自治体です。配送先住所の都市がリストの都市と一致すると、その都市が自動的に選択されます。各宅配ロッカーは、名称と住所とともに表示されます。選択内容はチェックアウトの間保持されるため、チェックアウトが更新されても失われません。

宅配ロッカーは必須です。クラシックチェックアウトでは、購入者に Please select an Omniva parcel machine. と表示されます。ブロックチェックアウトでは、宅配ロッカーを選ぶまで Place order がブロックされます。どちらのチェックアウトでも、サーバーは宅配ロッカーをリストと照合し直すため、偽造された ID や別の国の宅配ロッカーは拒否されます。

宅配ロッカーの ID、名称、都市、国は注文に保存されます。注文画面の配送先住所の下（宅配ロッカーの ID 付き）、注文完了ページ、My account > Orders、注文メール（HTML とプレーンテキスト）に、Omniva parcel machine として表示されます。

注文の宅配ロッカーを変更するには、WooCommerce > Orders で注文を開き、宅配ロッカーの横の Change をクリックして、注文の配送先国の都市と宅配ロッカーを選び、Save parcel machine をクリックします。注文メモには、変更前と変更後の宅配ロッカーが記録されます。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Omniva が表示されない: ライセンスが有効か、Enable/Disable がオンか、配送先国がエストニア、ラトビア、リトアニアのいずれかか、この配送方法が購入者の国のゾーンに追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。設定ページを開くと、料金が未設定の場合や宅配ロッカーのリストがない場合は、赤い通知で理由が説明されます。商品の寸法（XL サイズより大きい荷物、または料金欄が空のサイズは、この配送方法を非表示にします）、重量の制限、Minimum cart total、Excluded shipping classes も確認してください。Debug log がオンの場合、WooCommerce > Status > Logs（ソース vfd-omniva）で、この配送方法が非表示になった理由を確認できます。

宅配ロッカーがない: omniva.ee からリストをダウンロードできず、保存済みのコピーもありません。プラグインは 15 分ごとに再試行します。Update the list now をクリックしてください。失敗する場合は、サーバーが www.omniva.ee に接続できるか確認し、WooCommerce > Status > Logs でエラーを確認してください。

新しい宅配ロッカーが表示されない: リストは 1 日 1 回更新されます。すぐにダウンロードするには、Update the list now をクリックしてください。

誤った料金が請求される: 料金は、商品の寸法から判定されるパーセルサイズによって決まります。商品の寸法、Calculation、Parcel sizes (cm) を確認してください。Debug log がオンの場合、ログに選択されたサイズと料金が表示されます。

購入者が注文を完了できない: 宅配ロッカーを選ぶ必要があります。購入者に「The Omniva parcel machine list is temporarily unavailable」と表示される場合は、現在利用できる宅配ロッカーがありません。「宅配ロッカーがない」を参照してください。

料金の通貨: ストアの通貨です。プラグインは通貨を換算しません。

開発者向け: vfd_omniva_locations_url フィルターは、ロケーションファイルのアドレス（Omniva 形式の CSV）を変更します。vfd_omniva_countries フィルターは、配送先国のリスト（初期値は EE、LV、LT）を変更します。

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

アンインストール

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

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