VibeFox LP Express for PrestaShop — ヘルプ

要件

PrestaShop：8.0 から 9.x。

PHP：8.0 以降。モジュールは古い PHP バージョンへのインストールを拒否します。

LP Express：API アカウントは不要です。LP Express には公開された料金 API がなく、モジュールは Unisend API を使用しないため、自社の（契約）料金を入力します。荷物は Unisend（「Mano siuntos」）アカウントで作成してください。

パーセルターミナルのリスト：モジュールは LP Express の公開ターミナルリスト（https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals）を使用します。キーは不要です。このオンラインリストを利用できない場合、モジュールは最後にダウンロードしたコピーがあればそれを使用し、なければ独自のリストを使用します。独自のリストを入力する準備をしておいてください（「設定」を参照）。

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

インストール

1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。

2. アップロードが完了したら Configure をクリックします。後で確認する場合は、モジュール一覧で VibeFox LP Express を探し、Configure をクリックします。

3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（ライセンスキーを参照）。

4. 料金表（少なくとも 1 行）または代替料金を入力します。ページ上部のパーセルターミナルに関するステータス行を確認し、オンラインリストを利用できない場合は独自のターミナルリストを追加します。Save をクリックします。

インストール時に、モジュールは LP Express parcel terminal 配送業者を作成し、配送時間のテキストとして Delivery to an LP Express parcel terminal を設定します。配送業者はリトアニアのゾーンとすべての顧客グループに割り当てられます。ゾーンの追加、顧客グループ、配送時間、ロゴ、サイズ制限の変更は Shipping > Carriers で行えます。そこでは料金を設定しないでください。料金は常にモジュールから取得されます。

設定

すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox LP Express > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびにターミナルリストも再読み込みされます。

ページ上部の通知には、問題とターミナルの状態が表示されます。料金が設定されていない場合、またはパーセルターミナルが利用できない場合は警告が表示されます。この場合、チェックアウトで配送業者が表示されないためです。配送業者が削除された場合、およびショップの重量単位がモジュールで認識される単位（kg、g、lb、oz）ではない場合にも警告が表示されます。後者の場合、商品の重量は kg として読み取られます。情報行には、利用可能なパーセルターミナルの数、都市の数、および情報源（オンラインリスト、保存されたオンラインリストのコピー（日付付き）、または独自のリスト）が表示されます。

保存時、空であるか配送業者名として無効な方法タイトルは Enter a valid method title. と表示されて拒否されます。64 文字を超えるタイトルも拒否されます。どちらの場合も何も保存されません。数値ではない（または負の）金額や重量は通知され、以前の値が保持されます。Minimum weight (kg) が Maximum weight (kg)（空の場合は 30 kg）より大きい場合も、配送業者が表示されなくなるため通知され、両方の重量は以前の値を保持します。表内の数値ではない料金は通知され、空欄になります。

一般

Enable/Disable：LP Express をオンまたはオフにします。これは Shipping > Carriers の配送業者のステータスと同じスイッチです。

Method title：カートとチェックアウトで顧客に表示される配送業者名。既定値：LP Express parcel terminal。必須です。

Tax status：None は、以下の料金が最終価格であることを意味します。Taxable と税ルール（ショップの税ルールごとに 1 つの選択肢）は、PrestaShop が以下の料金に配送税を加算することを意味します。これは配送業者の税ルールです。

料金（ショップの既定通貨で。小数は 2.99 または 2,99 の形式で入力できます）

Price table：仕向国ごとに 1 行。+ Add country をクリックすると行が追加され、ゴミ箱アイコンをクリックすると行が削除されます。独自の行がないすべての国には * Any other country を選択します。各行には Base price と重量列があります：XS (≤1 kg)、S (≤2 kg)、M (≤3 kg)、L (≤5 kg)、XL (>5 kg)。重量はカートの重量です。Per item を選択した場合は、1 点の商品の重量になります。空の列では、その行の基本料金が使用されます。0 は無料を意味します。

Fallback cost：料金表に仕向国の行がない場合に使用されます。これらの国で配送業者を非表示にするには空欄のままにします。

Calculation：料金の計算方法。

Per order (tier by total cart weight)：カート全体に対して 1 つの料金を適用し、カートの合計重量に応じて重量列を選択します。これが既定値です。

Per item (each item priced by its own weight x quantity)：各商品はそれぞれの重量で計算され、数量を掛けたうえで、料金が合計されます。

Free shipping from：LP Express が無料になるカート合計額（配送が必要な商品、割引適用後、税抜き）。送料無料を設定しない場合は空欄にします。

提供条件

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

Maximum weight (kg)：カートがこの重量より重い場合、配送業者を非表示にします。LP Express のターミナルは最大 30 kg の荷物を受け付けます。既定値：30。0 は制限なしを意味します。空欄は、配送業者のゾーンでは 30 kg を意味し、Ignore shipping zones の国のうちそれらのゾーン外の国に対してのみ制限なしになります。

Minimum cart total：このカート合計額（配送が必要な商品、割引適用後、税抜き）に達した場合にのみ配送業者を表示します。空欄にすると常に表示されます。

Ignore shipping zones：ゾーンを自分で設定せずに、以下の国に対して LP Express を提供します。この場合、配送業者は有効なすべてのゾーン（後から作成されたゾーンを含む）に関連付けられます。配送業者にもともと設定されていたゾーンは、その国すべてに対して引き続き許可されます。このオプションを再びオフにすると、配送業者は以前のゾーンに戻ります。オフの場合、国は Shipping > Carriers における配送業者のゾーンによって定義されます。この設定を推奨します。

Countries (without zones)：このモードの仕向国。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。すべての国で配送業者を提供する場合は空欄のままにします。

パーセルターミナル

Terminal list：ターミナルの取得元。

LP Express online list：オンラインリストは 1 日 1 回ダウンロードされます。読み込めない場合は、最後にダウンロードしたコピーが使用され、その後に下の独自のリストが使用されます。これが既定値です。

Only my own list：下に入力したターミナルのみが提供されます。

詳細設定

Debug log：料金計算とターミナルリストの詳細を、モジュールフォルダー内の logs/vfd_lpex_debug.log.php に書き込みます。このファイルは Web から開くことはできません。ターミナルリストが利用できないなどのエラーは、常に記録されます。顧客データは記録されません。

Log：ログのサイズと最新のエントリを表示します。Clear log をクリックすると内容が消去されます。

Remove data on uninstall：オンの場合、モジュールをアンインストールすると、設定、配送業者、保存されたターミナルリストが削除されます。オフの場合、アンインストールでは配送業者をオフにするだけです。注文に保存されたターミナルは常に保持されます。

チェックアウトでの動作

配送ステップで PrestaShop はモジュールに LP Express の料金を問い合わせます。物理的な商品のみが対象になります。仮想商品は重量を加算せず、カート合計額にも含まれません。モジュールは Ignore shipping zones の国、カートの重量、最低カート合計額を確認します。送料無料が適用される場合、料金は 0 です。それ以外の場合、料金は国の行（または * の行）から取得されます：重量列、なければ基本料金、それもなければ代替料金です。料金がない場合、またはパーセルターミナルが利用できない場合は配送業者が非表示になるため、顧客が完了できないチェックアウトを目にすることはありません。

料金と金額はショップの既定通貨で表示されます。その後、PrestaShop の為替レートを使用して、顧客のカート通貨で料金が表示されます。

オンラインターミナルリストは 24 時間キャッシュされます。ダウンロードに失敗した場合は 15 分間記憶されるため、チェックアウトが再読み込みのたびにリストを待つことはありません。ダウンロードのタイムアウトは 10 秒です。リスト内の有効なターミナルのみが提供されます。

注文がある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを配送業者の新しいバージョンとして保存します。モジュールは新しいバージョンに自動的に追従します。

モジュールは LP Express や Unisend の料金を取得せず、配送の作成、ラベルの印刷、宅配便の手配、荷物の追跡も行いません。荷物は Unisend（「Mano siuntos」）アカウントで作成してください。宅配（玄関先への配送）はこの配送業者の対象外です。

受け取りポイント

顧客が LP Express を選択すると、配送業者の下に LP Express parcel terminal ブロックが表示され、2 つのリストが含まれます：-- Select city -- と -- Select parcel terminal --。配送先住所の都市がリスト内の都市と一致する場合、その都市が事前に選択されます。各ターミナルは名前、住所、郵便番号とともに表示されます。選択はすぐにカートに保存されるため、チェックアウトが再読み込みされても失われません。Classic と Hummingbird のテーマで動作します。

ターミナルの選択は必須です。選択しない場合、配送ステップの Continue と Place order は Please select an LP Express parcel terminal. を表示します。顧客が Continue をクリックすると、サーバーはターミナルをリストに照らして再度確認します。そのため、偽造された、または古いターミナル ID は The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. と表示されて拒否されます。

ターミナル ID、名前、都市は注文とともに保存されます。これらは管理画面の注文ページの LP Express parcel terminal ブロック（Terminal ID を含む）、注文確認ページ、顧客の注文詳細に表示されます。注文確認メールと、販売者への新規注文メールでは、配送業者名に LP Express parcel terminal: として続けてターミナルが追加されます。注文にターミナルがない場合、管理画面の注文ページには No parcel terminal was chosen for this order. と表示されます。

ライセンスキー

このモジュールは vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox LP Express は、Modules > Module Manager > VibeFox LP Express > Configure の最初のブロックで、設定の上にあります。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（たとえばライセンスの有効期限日とドメイン）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）のボタンが表示されます。その下には Product: presta-shipping-lp-express の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。モジュールの Configure 権限を持つ従業員のみがキーを変更できます。ブロックのテキストは管理画面の言語に従います（英語とロシア語が含まれています）。

キーが受け入れられない場合、ブロックは理由を表示します。例：Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ショップのアドレスを変更した後、またはアカウントでドメイン枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認できたステータスで動作を続けます。

1 つのキーは 1 つのドメインで使用できます。マルチストア構成でも、メインショップのドメインを指します。ショップからキーを削除しても、ドメイン枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで顧客に LP Express 配送業者は表示されず、料金も計算されません。PrestaShop のストアフロントは、管理画面にログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。

ライセンスが期限切れになっても、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。管理画面で作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに LP Express が表示されない：ライセンスが有効であること、および Enable/Disable がオンであることを確認してください。Shipping > Carriers で、配送業者が顧客の国のゾーンと顧客のグループをカバーしていることを確認してください（または Ignore shipping zones がオンで、その国が許可されていること）。モジュールのページを開くと、料金が設定されていない場合、またはパーセルターミナルが利用できない場合に、警告が理由を説明します。重量制限と Minimum cart total も確認してください。商品ページで、商品が特定の配送業者に限定されている場合もあります。Debug log がオンの場合、モジュールのページの Log 欄に配送業者が非表示になった理由が表示されます。

パーセルターミナルがない：オンラインリストを読み込めず、保存されたコピーや独自のリストもありません。モジュールは 15 分ごとに再試行します。Own terminal list に独自のリストを入力するか、Only my own list を選択してください。

ターミナルリストが古い：モジュールのページで Save をクリックしてください。これによりターミナルリストが再読み込みされます。独自のリストを使用している場合は、行を自分で更新してください。

顧客が先に進めない：パーセルターミナルを選択する必要があります。顧客に The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method. と表示される場合、現在利用可能なターミナルはありません。独自のリストを追加してください。

料金の通貨：ショップの既定通貨です。別の通貨で支払う顧客には、PrestaShop の為替レートで換算された料金が表示されます。

ページに LP Express 配送業者が見つからないと表示される：配送業者は Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。

アンインストール

Modules > Module Manager に進み、VibeFox LP Express の横にあるメニューを開き、Uninstall を選択します。ライセンスキーとライセンスステータスは常に削除されます。キャッシュされたターミナルリストは常に消去されます。Remove data on uninstall がオンの場合、配送業者は削除され（注文は履歴を保持します）、設定、ログ、保存されたターミナルリストのコピーも削除されます。オフの場合、配送業者はオフになるだけで、すべての設定と保存されたコピーは保持されます。モジュールを再インストールすると、保存されていた配送業者は以前のステータスに戻ります。注文に保存されたターミナルは決して削除されません。

LP Express は各所有者の商標です。本モジュールは LP Express と提携しておらず、LP Express による承認も受けていません。