VibeFox Packeta for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。標準テーマの標準チェックアウトで使用します。

PHP: 8.0 以降。

Packeta API キー: Packeta のクライアントセクション（client.packeta.com）の Client support にあります。16 文字の英数字で構成されています。ウィジェットがチェックアウトで開くためにこのキーが必要なため、API キーを入力するまで購入者にはこの配送方法が表示されません。

国: チェコ、スロバキア、ハンガリー、ルーマニアは、ストアで有効になっている国である必要があります。これらは OpenCart の標準データに含まれています。OpenCart ではハンガリーに地域がないため、住所の地域欄は空のままになります。これは問題ありません。

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

インストール

このダウンロードは、両方の OpenCart バージョン用のパッケージが入った zip ファイル 1 つです。コンピュータで解凍してください。README.txt、OpenCart 3 用パッケージ vfd_packeta-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ vfd_packeta.ocmod.zip が含まれています。お使いの OpenCart のバージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer を開き、Upload をクリックして、ファイル vfd_packeta-oc3-(version).ocmod.zip を選択します。本拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。Installer の代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。

2. Extensions > Extensions を開き、拡張機能の種類で Shipping を選択します。VibeFox Packeta を見つけて、Install（緑色の + ボタン）をクリックします。

3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。

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

5. Packeta の API key と料金を入力します。少なくとも 1 行の Country prices（例: * Default）か、Fallback cost を設定してください。Enable/Disable をオンにして Save をクリックします。Packeta がキーを受け付けたかどうかがページに表示されます。

OpenCart 4

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_packeta.ocmod.zip を選択します。ファイル名を変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から読み取るため、名前を変更したパッケージは動作しません。

2. パッケージは同じページのインストール済み拡張機能の一覧に表示されます。その横の Install（緑色の + ボタン）をクリックします。

3. Extensions > Extensions に移動し、拡張機能の種類で Shipping を選択します。VibeFox Packeta を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。

4. ライセンスキー、API キーと料金は、OpenCart 3 の手順 4 と 5 と同じように入力します。設定ページとその項目は両方のバージョンで同じです。

インストール直後は、Enable/Disable をオンにして保存するまで、この配送方法は無効のままです。アンインストール後に拡張機能を再インストールすると、保持されていた Packeta の設定が再び使われます。

設定

すべての設定は拡張機能のページにあります: Extensions > Extensions > Shipping > VibeFox Packeta > Edit。セクションは左側に並んでいます。下部の Save ボタン 1 つで、ページを再読み込みせずにページ全体を保存できます。この拡張機能の変更権限を持つ管理者ユーザーだけが設定を保存できます。

この配送方法は、Packeta 自社の受け取りポイントネットワークに含まれる国（CZ、SK、HU、RO）でのみ提供されます。設定の上部には、API キーの確認結果と、問題に関する警告が表示されます。たとえば、API キーがない、料金がない、選択した国が Packeta のネットワーク外である、またはストアの重量単位を拡張機能が認識できない、といった警告です。警告は保存のたびに更新されます。

すべての料金と上限値は、小数点としてカンマまたはピリオドを受け付けます（4,99 または 4.99）。無効な値や負の値はメッセージとともに拒否され、そのフィールドの以前の値が保持されます。ほかのフィールドは保存されます。

一般

Enable/Disable: チェックアウトでの Packeta のオン・オフを切り替えます。既定値: オフ。

Name: 購入者に表示される配送方法の名称。既定値: 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: 送料に適用する OpenCart の税区分、または None (no tax on shipping)（既定）。

Sort order: チェックアウトの配送方法の中で Packeta を表示する順番。整数で入力します。

料金

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 の行は、独自の行がない国に使われます。新しい行は * Default として、すべての料金が 0（送料無料を意味します）の状態で作成されます。保存する前に国を選び、料金を入力するか、行を削除してください。同じ国（または * Default）が 2 つの行にある場合、保存時には最初の行だけが残ります。表の値が 0 以上の数値でない場合、表は保存されず、ページに誤った値が表示されます。

Fallback cost: 仕向け先の国の行も * Default の行もない場合に使われます。その地域で配送方法を表示したくない場合は空欄にしてください。

Free shipping from: Packeta の配送が無料になる、カートの小計（クーポン適用後、税抜き）です。料金表より先に確認されます。この金額以上の場合、配送方法が提供されているすべての Packeta の国で、国の行や予備料金がない国でも配送は無料になります。送料無料を提供しない場合は空欄にしてください。

利用可能条件

Minimum weight (kg): カートの重量がこれより軽い場合、配送方法を非表示にします。商品の重量は、OpenCart の重量クラスから換算されます。空欄または 0 は制限なしを意味します。

Maximum weight (kg): カートの重量がこれより重い場合、配送方法を非表示にします。既定値: 15。Packeta の受け取りポイントと Z-BOX は通常 15 kg までの荷物を受け付けます。Packeta との契約を確認してください。空欄または 0 は制限なしを意味します。最大値より大きい最小重量は保存時に拒否され、両方の以前の値が保持されます。

Minimum cart subtotal: カートの小計（クーポン適用後、税抜き）がこの金額に達した場合にのみ配送方法を提供します。

Geo zone: このジオゾーン内の住所に対してのみ Packeta を提供します。All zones（既定）は制限なしを意味します。Ignore shipping zones がオンの場合は確認されません。ジオゾーンは System > Localisation > Geo Zones で管理します。

Ignore shipping zones: オンの場合、ジオゾーンは確認されず、下で選択した国に対して配送方法が提供されます。オフ（既定）の場合は、上で指定したジオゾーン内でのみ提供されます。

Countries (ignore zones mode): このモードで対象とする仕向け国。空欄にすると、すべての Packeta の国が使われます。Packeta の受け取りポイントネットワーク外の国はスキップされます。このフィールドは Ignore shipping zones がオンの場合にのみ使われます。

詳細設定

Debug log: 料金計算と受け取りポイントの選択内容を storage/logs/vfd_pckt_debug.log.php に書き込みます。このファイルは Web からは読み取れません。購入者の個人データと API キーは記録されません。エラーと失敗した API キーの確認は、常に記録されます。作業が終わったら、ログをオフにしてください。ファイルが 5 MB に達すると、vfd_pckt_debug.old.log.php に移動され、新しいログが始まります。

Log (last lines): デバッグログのサイズと最新の記録を表示します。Clear log をクリックすると、ログを消去できます。

Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、設定とログが削除されます。オフ（既定）の場合、再インストール用に設定が保持されます。注文に保存された受け取りポイントは、常に保持されます。

インポート / エクスポート

Export: Download JSON をクリックすると、設定を JSON ファイルとして保存できます。API キーも含まれますが、このキーは公開情報です。

Import: 以前にエクスポートした JSON を貼り付けて Import をクリックすると、設定が復元されます。たとえば別のストアに移す場合に使えます。値は通常の保存と同じように確認されます。

チェックアウトでの動作

OpenCart が配送方法を表示するとき、拡張機能に Packeta の料金を問い合わせます。Geo zone が設定されている（かつ Ignore shipping zones がオフの）場合に、住所がそのゾーンの外にあると、Packeta は提供されません。Requires Shipping が Yes の商品だけが計算に含まれます。ほかの商品は重量に加算されず、小計にも含まれません。拡張機能は次の条件を確認します。配送先の国が Packeta のネットワーク内にあること、API キー、ゾーンを無視するモードの国リスト、カートの重量、カートの最低小計。小計は、配送が必要な商品の価格で、クーポン割引適用後、税抜きです。ギフト券、ポイント、ストアクレジットは考慮されません。送料無料が適用される場合、料金は 0 になります。それ以外の場合、料金は国の料金表から取得され、次に予備料金が使われます。料金がない場合、配送方法は非表示になります。料金は、購入者の通貨で、選択された Tax status の税込みで表示されます。

配送方法の手順で 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."

Packeta の料金はリアルタイムでは取得されず、貴店の料金表から取得されます。本拡張機能は Packeta の出荷データの作成、荷物ラベルの印刷、荷物の追跡を行わず、また標準では宅配サービスや提携配送業者の受け取りポイントも提供しません。注文の受け取りポイント ID は、client.packeta.com でのインポートなど、通常の方法で Packeta に渡してください。受け取りポイントボタンは、標準テーマの標準 OpenCart チェックアウトで動作します。

OpenCart 4 では、購入者はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options のウィンドウで Packeta を選択します。Choose pickup point ボタンと選択されたポイントは、Packeta のオプションの下にあるそのウィンドウに表示され、Packeta のウィジェットはその上に開きます。料金は OpenCart 3 と同じです。

受け取りポイント

受け取りポイントは必須です。購入者がポイントを選ばずに配送方法の手順で 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 に照会しません。ポイントが選ばれているかと、その国が一致するかだけを確認します。

受け取りポイントは、注文の作成時に注文に関連付けられます。

注文の配送方法: ポイントの名称と住所が、たとえば Packeta pickup point: <point> のように配送方法名に追加されます（最大 128 文字）。購入者は注文履歴と注文メールでこれを確認でき、請求書にも印刷されます。OpenCart の注文完了ページには配送方法は表示されません。

管理画面の注文ページ: Sales > Orders で注文を開きます。Packeta pickup point のパネルに、名称と住所、Pickup point ID、国が表示されます。Packeta の注文にポイントがない場合、パネルには "No pickup point was selected for this order." と表示されます。

OpenCart 4 では、Shipping method options のウィンドウの Continue ボタンは、ポイントがないと先に進めず、同じメッセージが表示されます。OpenCart 4 は、チェックアウトごとに注文を 1 つ保持し、購入者が再度確定するたびにその注文を更新します。注文のポイントも一緒に更新されます。管理画面の注文ページにある Packeta pickup point のパネルは、History セクションの上に表示されます。

ポイントは、拡張機能独自のテーブル vfd_pckt_point（チェックアウトのセッション、注文、ポイント ID、名称と住所、国）に保存されます。

ライセンスキー

本拡張機能は、vibefox.net で入手した VibeFox ライセンスキーを使用します。ライセンスブロック License — VibeFox Packeta は Extensions > Extensions > Shipping > VibeFox Packeta > Edit の最初のブロックで、設定の上にあります。License key にキーを貼り付けて Activate をクリックしてください。その後、ブロックにはキーが伏せ字で表示され、ステータス（ライセンスの有効期限日やご利用のドメインなど）と、ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key のボタンが表示されます。その下には Product: opencart-shipping-packeta の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーだけです。ブロックのテキストは管理画面の言語に従います（英語とロシア語を含みます）。

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

1 つのキーは 1 つのドメインで使用できます：OpenCart の設定にあるストアのアドレスです。ストアからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、Packeta はチェックアウトで購入者に表示されず、料金も計算されません。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアでこの配送方法が (unlicensed — visible to admins only) と表示された状態で引き続き見えるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合は全員にこの方法が非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると 7 日間非表示になります。既存の注文は影響を受けません。

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

トラブルシューティング

チェックアウトに Packeta が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、API key が入力されていること、配送先の国が CZ、SK、HU、RO のいずれかであることを確認してください。その国の料金（国の行、* Default の行、または Fallback cost）、重量と小計の上限、Geo zone（または Ignore shipping zones とその国）が設定されていることも確認してください。商品の Requires Shipping が Yes になっていることも確認してください。設定ページの上部に設定上の問題が表示されます。理由を Log (last lines) で確認するには、Debug log をオンにしてください。

Packeta が API キーを拒否した: client.packeta.com > Client support から API キーを再度コピーして保存してください。それまでは、ウィジェットをチェックアウトで開くことができません。

ウィジェットが開かない: Packeta のスクリプトが、広告やプライバシーのブロッカー、コンテンツセキュリティポリシー、または Packeta の障害によってブロックされています。コンテンツセキュリティポリシーで widget.packeta.com を許可してください。

誤って送料が無料になっている: Country prices で Price が 0 の行を確認してください。特に、Add country で追加して未入力のままになっている * Default の行に注意してください。また、Free shipping from も確認してください。

重量の上限や重量列が正しくない: ページにストアの重量単位についての警告が表示される場合は、単位が kg、g、lb、oz の重量クラスを使い、System > Settings の Local タブで既定の重量クラスを設定してください。ほかの単位はキログラムとして読み取られます。

ページに "Warning: You do not have permission to modify VibeFox Packeta!" と表示される: 管理者ユーザーグループは設定を表示するだけの権限になっている可能性があります。System > Users > User Groups で、extension/shipping/vfd_packeta（OpenCart 3）または extension/vfd_packeta/shipping/vfd_packeta（OpenCart 4）の変更権限をそのグループに付与してください。

開発者向け: ほかの拡張機能は、国を追加したり、運送業者 ID などのオプションをウィジェットに渡したり、ウィジェットのスクリプトの URL や言語を変更したりできます。これには OpenCart のイベント vfd_packeta/countries、vfd_packeta/widget_options、vfd_packeta/widget_url、vfd_packeta/widget_language を使用します（トリガーには catalog/ の接頭辞を付けます。例: catalog/vfd_packeta/widget_options）。

アンインストール

Extensions > Extensions を開き、種類 Shipping を選択して、VibeFox Packeta の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスのステータスは常に削除されます。OpenCart は常に Enable/Disable、Sort order、Tax status、Geo zone をリセットします。保存された API キーの確認結果は常に削除され、受け取りポイントのボタンと注文のパネルも表示されなくなります。Remove data on uninstall がオンの場合、設定、ログ、そして一度も注文にならなかったチェックアウトの受け取りポイントが削除されます。オフの場合、ほかの設定は保持され、拡張機能を再インストールすると再び使われます。既存の注文は、保存された受け取りポイントと、配送方法に含まれるポイントを常に保持します。

OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox Packeta の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、アップロードしたパッケージを削除するために Delete（赤いゴミ箱ボタン）をクリックしてください。

Packeta は、それぞれの所有者の商標です。本拡張機能は Packeta と提携しておらず、Packeta による承認も受けていません。