VibeFox Packeta for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 から 9.x。
PHP: 8.0 以降。モジュールは、それより古い PHP バージョンではインストールを拒否します。
Packeta API キー: Packeta のクライアントセクション（client.packeta.com）の Client support で確認できます。16 文字の英数字で構成されています。ウィジェットがチェックアウトで開くために必要なため、API キーを入力した後にのみ、配送業者が購入者に表示されます。
国: チェコ、スロバキア、ハンガリー、ルーマニアのいずれかが、ショップで有効な国であり、配送業者が紐付いているゾーンに含まれている必要があります。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後からモジュール一覧で VibeFox Packeta を探し、Configure をクリックすることもできます。
3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（「ライセンスキー」を参照）。
4. Packeta の API key と料金を入力します。Country prices の行（例：* Default）を少なくとも 1 つ、または Fallback cost を入力します。Save をクリックします。Packeta がキーを受け付けたかどうかが、ページに表示されます。
インストール時に、モジュールは配送業者 Packeta pickup point を作成します。配送日数の文言は Packeta pickup point or Z-BOX です。この配送業者は、チェコ、スロバキア、ハンガリー、ルーマニアのゾーンと、すべての顧客グループに紐付けられます。ゾーン、顧客グループ、配送日数、ロゴは Shipping > Carriers で変更できます。料金はそこで設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Packeta > Configure。各セクションには個別の Save ボタンがあり、ページ全体が保存されます。
配送業者は、Packeta 独自の受け取りポイントネットワークの国、つまり CZ、SK、HU、RO についてのみ提供されます。設定の上部には、API キーの確認結果と、問題に関する警告が表示されます。API キーがない、料金がない、選択した国が Packeta のネットワーク外である、配送業者がない、またはモジュールが認識しないショップの重量単位が設定されている、といった問題です。
すべての料金と上限値は、小数点の区切りとしてカンマまたはピリオドを受け付けます（4,99 または 4.99）。無効な数値や負の数値は、メッセージとともに拒否され、以前の値が保持されます。
一般
Enable/Disable: チェックアウトでの Packeta を有効または無効にします。
Name: 購入者に表示される配送業者の名前です。Shipping > Carriers での配送業者名にもなります。既定値：Packeta pickup point。必須で、最大 64 文字です。
API key: client.packeta.com > Client support で確認できる Packeta の API キーです。32 文字の API パスワードを貼り付けることもできます。保存されるのは先頭 16 文字、つまり API キーだけです。API キーは公開情報です。ウィジェットを開くために購入者のブラウザに送信されます。新しいキーを保存すると、Packeta の配送業者フィードと照合され、ページには Packeta API key verified または Packeta がキーを拒否したことが表示されます。照合を実行できない場合、キーは保存され、次回の保存時に再度照合されます。
Widget language: 受け取りポイントのウィジェットの言語です。Store / visitor language（既定）はページの言語に従います。チェコ語、スロバキア語、ハンガリー語、ルーマニア語、英語、ドイツ語、ポーランド語、ウクライナ語に固定することもできます。
Pickup point types: ウィジェットに表示する Packeta のポイントです。
Tax status: 配送料に適用される税ルールです。None (no tax on shipping)、または税ルールグループのいずれかを選んだ Taxable を選択します。選択内容は配送業者に保存されます。
料金
Packeta には公開された料金 API がありません。料金はこの表から取得され、ショップの既定通貨で税抜きの金額を入力します。別の通貨で支払う購入者には、換算後の金額が表示されます。
Calculation type: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、カート内の実物商品の数量を掛けて請求します。
Country prices: 配送先の国と荷物の重量ごとの料金です。Add country をクリックすると行が追加され、×印をクリックすると行が削除されます。各行には Price と重量列があります：XS は 1 kg まで、S は 1～2 kg、M は 2～3 kg、L は 3～5 kg、XL は 5 kg を超える場合です。重量列を 0 のままにすると、Price 列が使われます。* Default の行は、独自の行がない国に使われます。新しい行は、すべての料金が 0 の * Default として追加されます。これは送料無料を意味します。保存する前に国を選び、料金を入力するか、行を削除してください。同じ国（または * Default）が 2 行にある場合、保存時には最初の行だけが残ります。表の値が有効な数値でない場合、表は保存されず、ページに誤った値が一覧表示されます。
Fallback cost: 国の表に配送先の行がなく、* Default の行もない場合に使われます。その場所で配送業者を提供しない場合は空のままにします。
Free shipping from: この金額以上のカート小計（割引後、税抜き）で、Packeta の配送が無料になります。この判定は料金表より先に行われます。この金額以上であれば、配送業者が提供されているすべての Packeta の国で送料が無料になります。国の行やフォールバック料金がない国でも同様です。空のままにすると、送料無料は提供されません。
利用条件
Minimum weight (kg): カートの重量がこの値より軽い場合、配送業者を非表示にします。カートの重量は、ショップの重量単位から変換されます。空欄または 0 は、制限がないことを意味します。
Maximum weight (kg): カートの重量がこの値より重い場合、配送業者を非表示にします。既定値：15。Packeta の受け取りポイントと Z-BOX は、通常 15 kg までの荷物を受け付けます。Packeta との契約を確認してください。空欄または 0 は、制限がないことを意味します。最小重量が最大重量より大きい場合は、保存時に拒否され、前の 2 つの値が保持されます。
Minimum cart subtotal: カート小計（割引後、税抜き）がこの金額に達した場合にのみ、配送業者を提供します。
Ignore shipping zones: オンにすると、配送業者はすべてのゾーンに紐付けられ、下で選択した国に対して提供されます。後から作成されたゾーンも、すぐに紐付けられます。オフにすると、配送業者は以前紐付けられていたゾーンに戻ります。オフの場合、配送業者は Shipping > Carriers でその配送業者に設定されたゾーンにのみ提供されます。
Countries (ignore zones mode): このモードでの配送先の国です。空欄にすると、すべての Packeta の国が使われます。Packeta の受け取りポイントネットワークの外にある国はスキップされます。Ctrl キーを押しながらクリックすると、複数の国を選択できます。このフィールドは Ignore shipping zones がオンの場合にのみ使われます。
詳細
Debug log: 料金の計算と受け取りポイントの選択内容を modules/vfd_packeta/logs/ に記録します。このファイルは Web からは開けません。購入者の個人情報と API キーは記録されません。エラーと API キーの確認失敗は、常に記録されます。作業が終わったら、ログをオフにしてください。
Log (last lines): デバッグログの最新の項目を表示します。Clear log をクリックすると、ログが空になります。
Remove data on uninstall: オンにすると、モジュールをアンインストールしたときに、設定とログが削除されます。注文に保存された受け取りポイントは、常に保持されます。
チェックアウトでの動作
配送ステップで、PrestaShop はモジュールに Packeta の料金を問い合わせます。対象となるのは実物商品のみです。仮想商品は重量に加算されず、小計にも含まれません。モジュールは、配送先の国が Packeta のネットワーク内か、API キーがあるか、ゾーン無視モードでの国のリスト、カートの重量、カート小計の最低額、という条件を確認します。送料無料が適用される場合、料金は 0 です。それ以外の場合、料金は国の表から取得され、なければフォールバック料金が使われます。料金がない場合、配送業者は非表示になります。
購入者が Packeta の配送業者を選ぶと、その下に Choose pickup point ボタンが表示されます。ボタンをクリックすると、購入者のブラウザで Packeta の公式ウィジェットが開きます。配送先の国、カートの重量、選択されたポイントの種類、ウィジェットの言語が渡されます。購入者がポイントを選ぶと、その名前と住所が配送業者の下に表示され、ボタンは Change pickup point に変わります。ポイントはカートと一緒に保存され、ページを再読み込みしても保持されます。配送先住所が変わると、別の国向けに選ばれたポイントは破棄されます。
チェックアウト時に、お使いのサーバーが Packeta に問い合わせることはありません。ウィジェットのスクリプトは widget.packeta.com から読み込まれます。広告ブロッカーやプライバシー保護ツール、コンテンツセキュリティポリシー、Packeta の障害などによってブロックされた場合、購入者には「The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.」と表示されます。
注文がある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを新しい配送業者のバージョンとして保存します。モジュールは新しいバージョンに自動的に従います。
Packeta の料金はリアルタイムでは取得されず、貴店の料金表から取得されます。モジュールは Packeta への発送データの作成、送り状の印刷、荷物の追跡は行わず、標準では宅配サービスやパートナー配送業者の受け取りポイントも提供しません。注文の受け取りポイント ID は、通常の方法で Packeta に渡してください。たとえば client.packeta.com でのインポートなどです。
受け取りポイント
受け取りポイントは必須です。購入者がポイントを選ばずに配送ステップで Continue をクリックした場合、そのステップは完了せず、「Please choose a Packeta pickup point.」と表示されます。選択したポイントが配送先住所と異なる国にある場合、購入者には「The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.」と表示されます。モジュールはポイント ID を Packeta に照会しません。ポイントが選択されていること、そして国が一致することだけを確認します。
ポイントは注文の作成時に注文へ紐付けられます：
管理画面の注文ページ: 名前、住所、Pickup point ID、国を表示する Packeta pickup point ブロックです。Packeta の注文にポイントがない場合、ブロックには「No pickup point was selected for this order.」と表示されます。
注文完了ページと注文詳細ページ: Packeta pickup point: と、名前および住所です。
注文メール: 注文確認メールでは、配送業者の情報にポイント名と住所が追加されます。販売者向けの新規注文メールには Pickup point ID も含まれます。
ポイントは、モジュールのテーブル vfd_pckt_point（カート、注文、ポイント ID、名前と住所、国）に保存されます。
ライセンスキー
モジュールは vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Packeta は、Modules > Module Manager > VibeFox Packeta > Configure ページで設定より上にある最初のブロックです。キーを License key に入力し、Activate をクリックします。その後、ブロックにはキーがマスクされた状態で表示され、ステータス（ライセンスの有効期限日とドメインなど）と、ボタン Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）が表示されます。その下に Product: presta-shipping-packeta の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントが開きます。キーを変更できるのは、このモジュールの Configure 権限を持つスタッフだけです。ブロックのテキストは管理画面の言語に従います（英語とロシア語を含みます）。
キーが受け付けられない場合、ブロックにその理由が表示されます。例：Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ショップのアドレスを変更した後、またはアカウントでドメインの枠を解放した後に、Check now をクリックします。ライセンスサーバーに接続できない場合、モジュールは最後に確認できたステータスで動作を続けます。
1 つのキーは 1 つのドメインで使用できます。メインショップのドメインで、マルチストア構成でも同様です。ショップからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。
有効なキーがない場合、Packeta の配送業者はチェックアウトで購入者に表示されず、料金も計算されません。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでのテストはできません。Modules > Module Manager の Alerts タブに通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Packeta が表示されない: ライセンスが有効か、Enable/Disable がオンか、API key が入力されているか、配送先の国が CZ、SK、HU、RO のいずれかかを確認してください。その国に料金が設定されているか（国の行、* Default の行、または Fallback cost）、重量と小計の上限、そして配送業者が Shipping > Carriers で、購入者の国のゾーンと購入者のグループを対象としているか（または Ignore shipping zones がオンか）を確認してください。商品ページで、商品を特定の配送業者に限定している場合もあります。設定ページの上部には、設定上の問題が表示されます。理由は、Debug log をオンにして Log (last lines) で確認できます。
Packeta が API キーを拒否した: client.packeta.com > Client support から API キーをコピーし直して、保存してください。それまで、チェックアウトでウィジェットは開けません。
ウィジェットが開かない: Packeta のスクリプトが、広告ブロッカーやプライバシー保護ツール、コンテンツセキュリティポリシー、または Packeta の障害によってブロックされています。コンテンツセキュリティポリシーで widget.packeta.com を許可してください。開発者は actionVfdPcktWidgetUrl フックでスクリプトの URL を変更できます。
誤って送料が無料になっている: Country prices で Price が 0 の行を確認してください。特に、Add country で追加して未入力のままの * Default の行に注意してください。また Free shipping from も確認してください。
重量制限または重量列が正しくないようです: ページにショップの重量単位についての警告が表示されている場合は、International > Localization（Local units）で kg、g、lb、oz のいずれかを設定してください。その他の単位は、キログラムとして扱われます。
他の国や配送業者: 標準では、配送業者は CZ、SK、HU、RO に対して機能します。開発者は actionVfdPcktCountries フックで国を追加し、actionVfdPcktWidgetOptions フックで配送業者 ID をウィジェットに渡すことができます。
ページに Packeta の配送業者がないと表示される: 配送業者が Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager を開き、VibeFox Packeta の横にあるメニューを開いて、Uninstall を選択します。ライセンスキーとライセンスステータスは常に削除されます。Packeta の配送業者は常に削除されます（注文は配送業者の情報を保持します）。保存された API キーの確認結果も削除されます。Remove data on uninstall がオンの場合、設定、ログ、そして注文にならなかったカートの受け取りポイントが削除されます。オフの場合、設定は再インストールのために残され、再インストール時に配送業者が再作成されます。既存の注文は、保存された受け取りポイントを常に保持します。
Packeta はその所有者の商標です。本モジュールは Packeta と提携しておらず、Packeta による推奨もされていません。