VibeFox SmartPost for WooCommerce — ヘルプ

要件

WordPress：5.8 以降。

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

PHP：8.0 以降。SimpleXML 拡張機能が必要です（ほとんどの PHP 環境に含まれています）。

SmartPost：API アカウントやキーは不要です。受け取りポイントのリストは、公開されている SmartPost の場所リストから取得されます。SmartPost には公開された料金 API がないため、ご自身の（契約）料金を入力してください。荷物は SmartPost（SmartPosti）のビジネスアカウントで作成してください。

国：SmartPost の受け取りポイントは、エストニア、ラトビア、リトアニア、フィンランドにあります。それ以外の配送先国では、この配送方法は表示されません。

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

インストール

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

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

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

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

5. ページ上部で、料金表（既定の料金は入力済みです）、ボックスサイズ、受け取りポイントの状態を確認します。

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

設定

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

Title (zone)：このゾーンでお客様に表示される名前です。空欄のままにすると、全体の Method title が使われます。

ページ上部の通知には、問題と受け取りポイントの状態が表示されます。料金が 1 つも設定されていない場合は赤い通知が表示されます。その場合、チェックアウトに配送方法が表示されないためです。Pickup points available at checkout のブロックには、国ごとに、利用可能な受け取りポイントの数と都市の数が表示されます。また、SmartPost のリストが現在利用できないため保存済みのコピーを使用している場合、国のリストをまったく読み込めなかった場合、料金が設定されていない国がある場合も表示されます。Refresh pickup point lists now ボタンを押すと、リストを再ダウンロードし、新しい件数が表示されます。

一般

Enable/Disable：すべてのゾーンで SmartPost を一括して有効または無効にします。

Method title：お客様に表示される配送方法の名前です。ゾーン別の方法の Title がこれを上書きします。既定値：SmartPost parcel locker。

Tax status：Taxable にすると、配送料に WooCommerce の税金が加算されます。None にすると加算されません。

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

Price table：国（エストニア、ラトビア、リトアニア、フィンランド）ごとに 1 行あり、ボックスサイズ S、M、L、XL ごとに料金を入力し、Free from 列があります。0 は無料を意味します。空欄は、そのボックスサイズを提供しないことを意味します。荷物がそのボックスを必要とする場合、この配送方法は非表示になります。すべてのセルが空欄の国にはサービスを提供しません。Free from は、その国で SmartPost が無料になるカート合計です。送料無料がない場合は空欄にします。数値ではない料金は保存後に通知され、空欄のままになります。既定の料金：エストニア 3.50、ラトビア 4.00、リトアニア 4.00、フィンランド 5.00（すべてのボックス共通）。

Box sizes (cm)：各ボックスの内寸です。最も短い辺を先頭にします（Side 1 (smallest)、Side 2、Side 3 (largest)）。商品の辺も同じ順に並べて比較し、収まる最小のボックスが使われます。寸法のない商品は S ボックスに収まるものとして扱われます。どのボックスにも収まらない荷物がある場合、配送方法は非表示になります。商品の寸法は、ストアの寸法単位から変換されます。既定値：S 12 x 36 x 60、M 20 x 36 x 60、L 36 x 38 x 60、XL 36 x 60 x 60。正の数値ではないサイズは、保存後に通知され、変更されません。

Calculation：料金の計算方法です。

表示条件

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

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

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

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

Ignore shipping zones：ゾーンに追加せず、以下の国に SmartPost を提供します。オフの場合、国は配送方法を追加した配送ゾーンによって決まります。これを使うことをお勧めします。

Countries (without zones)：このモードの配送先国です。エストニア、ラトビア、リトアニア、フィンランドから選択します。このフィールドは Ignore shipping zones が有効な場合にのみ使われます。空欄にすると、4 か国すべてで配送方法を提供します。

受け取りポイント

Pickup point types：お客様が選択できる SmartPost のポイントです：Parcel lockers (APT)、Parcel boxes (IPB)、Parcel shops (PUDO)、Posti post offices (Finland)。空欄にすると、宅配ロッカー、宅配ボックス、宅配ショップが提供されます（既定）。どの種別が存在するかは国によって異なります。たとえば、ラトビアには宅配ボックスしかなく、郵便局はフィンランドにしかありません。

City order：オンにすると、大都市（タリン、リガ、ヴィリニュス、ヘルシンキなど）が先頭に並び、残りはアルファベット順になります。オフにすると、すべての市区町村がアルファベット順になります。

詳細設定

Debug log：料金計算と受け取りポイントリストの詳細を WooCommerce > Status > Logs（ソース vfd-smartpost）に記録します。受け取りポイントのリストが利用できないなどのエラーは、常に記録されます。お客様のデータは記録されません。

Remove data on uninstall：オンにすると、プラグインを削除したときに、設定、ゾーンの配送方法、キャッシュされた受け取りポイントが削除されます。プラグインを無効化しても設定は削除されません。注文に保存された受け取りポイントは残ります。

チェックアウトでの動作

お客様が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはエストニア、ラトビア、リトアニア、フィンランドの場合にのみ動作します。カートの重量、カート合計の最低金額、除外する配送クラスを確認し、荷物に合うボックスを探して、配送先国の行からその料金を取得します。ボックスに料金がない場合、または荷物がどのボックスにも収まらない場合は、配送方法が非表示になります。国に受け取りポイントがない場合（リストを読み込めず、保存済みのコピーもない場合）も同様に非表示になります。これにより、お客様が完了できないチェックアウトを目にすることはありません。カート合計がその国の Free from に達した場合、料金は 0 になります。

各国の受け取りポイントリストは 24 時間キャッシュされ、最後に正常に取得したリストのコピーも保持されます。ダウンロードに失敗した場合は 15 分間記憶されるため、チェックアウトは更新のたびにリストを待つことがありません。ダウンロードのタイムアウトは 15 秒です。同じ都市の異なる表記（たとえば Riga と Rīga）は、1 つの都市として表示されます。

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

プラグインは、SmartPost の料金を取得せず、配送伝票の作成、ラベルの印刷、宅配業者の手配、荷物の追跡も行いません。荷物は SmartPost（SmartPosti）のビジネスアカウントで作成してください。宅配業者による玄関先までの配送はこの配送方法に含まれず、地図表示もありません。

受け取りポイント

お客様が SmartPost を選択すると、配送方法の下に 2 つのリストが表示されます：-- Select city -- と -- Select pickup point --。リストは常に配送先国のものです。従来のチェックアウトでは、配送先住所の国が使われます。ただし、注文を別の住所に送らない場合は、請求先住所の国が使われます。国が変わるとリストは作り直されます。ブロックのチェックアウトでは、リストは配送先住所の国に従います。配送先住所の市区町村が、リスト内の市区町村と一致する場合は、自動的に選択されます。各ポイントは、名前と住所とともに表示されます。選択内容はチェックアウトの間保持されるため、チェックアウトが更新されても失われません。

受け取りポイントは必須です。従来のチェックアウトでは、お客様に Please select a SmartPost pickup point in the shipping country. と表示されます。ブロックのチェックアウトでは、ポイントを選択するまで Place order がブロックされます。どちらのチェックアウトでも、サーバーは配送先国のリストに照らして再度ポイントを検証します。そのため、偽造されたもの、古いポイント ID、別の国のポイントは拒否されます。国のリストが一時的に利用できない場合、お客様にはメッセージが表示され、別の配送方法を選択できます。

ポイントの ID、名前、市区町村、国は注文に保存されます。注文画面では配送先住所の下に（場所 ID とともに）表示され、注文受付ページ、My account > Orders、注文メール（HTML とプレーンテキスト）では SmartPost pickup point として表示されます。

注文の受け取りポイントを変更するには、注文を開き、SmartPost pickup point の横にある Change をクリックします。注文の配送先国から市区町村とポイントを選択します。新しいポイントはすぐに保存され、注文メモに旧ポイントと新ポイントが記録されます。

ライセンスキー

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

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

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

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

トラブルシューティング

SmartPost がチェックアウトに表示されない：ライセンスが有効か、Enable/Disable がオンか、配送先国がエストニア、ラトビア、リトアニア、フィンランドのいずれかか、そして配送方法がお客様の国のゾーンに追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。設定ページを開くと、料金が設定されていないこと、料金のない国があること、受け取りポイントのない国があることを、通知で確認できます。重量制限、Minimum cart total、Excluded shipping classes、ボックスサイズも確認してください。どのボックスにも収まらない荷物や、料金のセルが空欄のボックスがあると、配送方法は非表示になります。Debug log がオンの場合、WooCommerce > Status > Logs（ソース vfd-smartpost）で、配送方法が非表示になった理由を確認できます。

お客様に別の国のポイントが表示される：リストは配送先住所に従います。配送先住所に入力されている国を確認してください（注文を別の住所に送らない場合は、請求先住所を確認してください）。別の国のポイントは、注文時に拒否されます。

ある国に受け取りポイントがない：SmartPost のリストを読み込めず、保存済みのコピーもありません。プラグインは 15 分ごとに再試行します。後で Refresh pickup point lists now をクリックしてください。また、Pickup point types に、その国に存在する種別が含まれているかも確認してください。

受け取りポイントのリストが古い：設定ページで Refresh pickup point lists now をクリックしてください。リストは 24 時間ごとにも再ダウンロードされます。

お客様が注文できない：配送先国の受け取りポイントを選択する必要があります。お客様に "The SmartPost pickup point list is temporarily unavailable" と表示される場合、その国のポイントは現在利用できません。

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

開発者向け：vfd_smpt_places_url フィルターは、国ごとの場所リストの URL を変更します（引数：URL、国コード）。たとえば、同じ XML を返すミラーに切り替えるときに使います。

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

アンインストール

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

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