VibeFox Coordinadora for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 ～ 9.x。
PHP: 8.0 以降。古い PHP バージョンではモジュールをインストールできません。
Coordinadora API キー（リアルタイム見積もりの場合のみ）: リアルタイム見積もりは、Coordinadora WooCommerce サービスを経由して Coordinadora Cotizador から取得されます。これは公式の Coordinadora プラグインが使用しているものと同じサービスです。Coordinadora は、有効な商業契約を結んだ顧客に API キーを発行します。Coordinadora のアカウントマネージャーに問い合わせるか、wc.coordinadora.com をご覧ください。出荷元都市の 8 桁の DANE コードも必要です。キーがない場合、配送業者は固定料金のみで動作します。
商品: リアルタイム見積もりでは、カート内のすべての商品に重量と寸法（幅、高さ、奥行き）が必要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 ドメインでのみ使用できます。
インストール
1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後でモジュール一覧から VibeFox Coordinadora を探し、Configure をクリックすることもできます。
3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（ライセンスキーを参照）。
4. API キー、出荷元都市の DANE コード、そしてデフォルト通貨が COP でない場合は COP 為替レートを入力します。コロンビアの固定料金を最低 1 つ、予備として追加してください（「設定」を参照）。Save をクリックします。
5. ショップでコロンビアが有効になっていること、商品に重量と寸法があることを確認します。
インストール時、モジュールは配送時間のテキスト Courier delivery in Colombia を付けた Coordinadora 配送業者を作成します。この配送業者はすべてのゾーンとすべての顧客グループに割り当てられます。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。ここで料金は設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールページにあります: Modules > Module Manager > VibeFox Coordinadora > Configure。設定は配送業者のすべてのゾーンに適用されます。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた Coordinadora の見積もりも消去されます。数値は小数点またはカンマで入力できます（9,99 = 9.99）。
数値または料金表の価格が無効または負の値の場合、COP per 1 unit of store currency が 0 の場合、Min weight が Max weight より大きい場合、または Name が 64 文字を超える場合、ページは保存を拒否し、エラーを表示します。修正するまで何も保存されません。
リアルタイム見積もりが機能しない場合、または配送業者が非表示になる場合、ページ上部に警告が表示されます: Origin city (DANE code) が空または無効、デフォルト通貨が COP でないのに COP per 1 unit of store currency が未入力、またはコロンビア（または *）の固定料金がない場合。API キーがなく、そのような固定料金もない場合、コロンビアの住所に配送業者が表示されることはありません。ショップの重量単位または寸法単位（International > Localization の Local units）がモジュールで認識されない場合にも警告が表示されます。その場合、商品の重量は kg、寸法は cm として読み取られます。
一般
Enable Coordinadora: 配送業者を有効または無効にします。これは Shipping > Carriers の配送業者のステータスと同じスイッチです。
Name: チェックアウトで購入者に表示される配送業者の名前。デフォルト: Coordinadora。必須。
Tax: 配送業者の税ルール、または No tax。ルールを選ぶと、PrestaShop は料金に配送税を加算します。料金または Coordinadora の見積もりに税がすでに含まれている場合は、No tax を選択してください。
Coordinadora のリアルタイム料金
リアルタイム見積もりは、コロンビア国内の配送先に対して要求されます。固定料金のみを使う場合は、キーを空欄のままにしてください。
API key: Coordinadora から提供された Coordinadora WooCommerce API キー。保存後、このフィールドは空欄になり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。キーがログに書き込まれることはありません。
Remove the saved API key: 保存済みのキーがある場合にのみ表示されます。オンにして Save をクリックするとキーが削除され、その後は配送業者が固定料金のみを使用します。
Origin city (DANE code): 出荷元都市の 8 桁の DANE コード。例: 11001000 Bogotá、05001000 Medellín、76001000 Cali、08001000 Barranquilla。5 桁の自治体コードも受け付けられ、8 桁に補完されます。
COP per 1 unit of store currency: Coordinadora はコロンビアペソで見積もります。デフォルト通貨が COP でない場合は、通貨 1 単位が何 COP に相当するかを入力してください（例: 4300）。このレートは申告価値を COP で送信する際にも使用されます。空欄にするとリアルタイム見積もりは使用されません。レートは 0 より大きい必要があります。デフォルト通貨が COP の場合は空欄のままにしてください。
固定料金（API キーがない場合、コロンビア以外の配送先、およびリアルタイム見積もりが利用できない場合の予備として使用されます）
Prices by country: 国のリストで、Price 列と、任意のパッケージサイズ別料金を設定する表です。料金はデフォルト通貨で、税抜きです。サイズはカートの重量で決まります: XS は 1 kg 以下、S は 1～2 kg、M は 2～3 kg、L は 3～5 kg、XL は 5 kg 超。サイズ列が 0 または空欄の場合は Price が使われます。Add country をクリックして行を追加し、× をクリックして行を削除します。* All other countries は、独自の行がない国に適用されます。行がない国（* もない場合）には固定料金は適用されません。Price が 0 で、サイズ別料金がない行は送料無料になります。
Fixed price per: Order は料金を 1 回だけ請求します。Item (price × quantity) は、カート内の商品数を掛けた金額を請求します。これは固定料金にのみ適用され、Coordinadora のリアルタイム見積もりは常に注文全体を対象とします。
条件
Min weight: カートの重量がこの値未満の場合、配送業者を非表示にします（kg 単位）。0 は制限なしを意味します。
Max weight: カートの重量がこの値を超える場合、配送業者を非表示にします（kg 単位）。デフォルト: 25（欄が空の場合もこの値が使われます）。0 は制限なしを意味します。Min weight より小さくすることはできません。
Minimum order subtotal: カートの小計（割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。常に表示する場合は空欄のままにします。
Free shipping: 下記の小計以上の場合に送料無料にします。
Free shipping from: 送料が無料になるカートの小計（割引後、税抜き）。Free shipping がオンの場合にのみ使われます。その場合、API リクエストは行われません。
Countries: これらの配送先国に対してのみ Coordinadora を提供します。有効な国のみが表示されます。配送業者のゾーンのすべての国を許可する場合は空欄のままにします。
詳細設定
Debug log: 料金計算の結果を、モジュールフォルダ内の logs/vfd_crd_debug.log.php に書き込みます。このファイルはウェブから開くことはできません。API エラーと設定の不備は、このオプションがオフでも常に記録されます。API キーと購入者の住所は記録されません。
Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。
Remove data on uninstall: オンの場合、モジュールをアンインストールすると Coordinadora の設定、配送業者、キャッシュされた料金、ログが削除されます。オフの場合、再インストールのためにすべてが保持されます。
チェックアウト時の動作
配送のステップで PrestaShop はモジュールに Coordinadora の料金を問い合わせます。対象になるのは実物の商品のみです。バーチャル商品は重量に加算されず、見積もりにも含まれません。モジュールは最初に条件を確認します: 許可された国、カートの重量、注文小計の下限。送料無料が適用される場合、料金は 0 になり、Coordinadora へのリクエストは送られません。
API キーがあり、住所がコロンビアの場合、モジュールは次の順序で配送先都市の DANE コードを探します: 都市欄の DANE コード（コロンビアの県・市のチェックアウトモジュールが書き込みます。例: MEDELLIN (ANT) (05001000)）、8 桁の郵便番号、または県都と約 40 の主要都市の内蔵リスト。住所に県（州）がある場合、リストの都市はそれと照合されます。アクセントと大文字・小文字は無視されます。
次に、モジュールは Coordinadora に、配送先の DANE コードと、各商品の出荷元都市、重量（kg）、寸法（cm）、数量、申告価値（COP）を送信します。申告価値は、税抜きかつカート割引前の商品行の合計です。ショップの単位は自動で換算されます。Coordinadora は COP で料金を返し、モジュールはそれをデフォルト通貨に換算し、次に購入者のカートの通貨に換算します。各見積もりは 1 時間キャッシュされます。失敗したリクエストは 10 分間記録されるため、Coordinadora の障害によってチェックアウトの更新が毎回遅くなることはありません。API のタイムアウトは 10 秒です。
リアルタイム見積もりが利用できない場合（API エラー、不明な都市、重量または寸法のない商品、設定の不足）、固定料金が使われます。固定料金もない場合、そのカートでは配送業者は非表示になります。エラーの詳細はデバッグログに記録され、購入者には表示されません。
配送業者に注文が入った後に Shipping > Carriers で配送業者を編集すると、PrestaShop はそれを新しい配送業者のバージョンとして保存します。モジュールは新しいバージョンに自動的に従います。
モジュールは料金の計算だけを行います。出荷や送り状（guías）の作成、伝票の印刷、集荷（recogidas）の手配、荷物の追跡、代金引換（recaudo）の回収、Droop の受け取りポイントの提供は行いません。これらには Coordinadora のポータルを使用してください。国際配送先には固定料金が使われます。
ライセンスキー
モジュールは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Coordinadora は、Modules > Module Manager > VibeFox Coordinadora > Configure ページの最初のブロックで、設定より上にあります。キーを License key に貼り付けて Activate をクリックします。その後、ブロックにはキーが伏せ字で表示され、ステータス（例：ライセンスの有効期限日とドメイン）と、ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key のボタンが表示されます。その下には Product: presta-shipping-coordinadora の行と、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 のアカウントでドメインの枠を解放してください。
有効なキーがない場合、Coordinadora 配送業者はチェックアウトで購入者に表示されず、料金も計算されません。PrestaShop のフロントエンドは、バックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。購入前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れた場合も、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週に 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Coordinadora が表示されない: ライセンスが有効か、Enable Coordinadora がオンになっているかを確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと購入者の顧客グループを対象にしているか確認してください。Countries、重量の制限、Minimum order subtotal を確認してください。リアルタイム見積もりがない場合、その国または * の固定料金が存在している必要があります。商品ページで、特定の配送業者に商品を限定することもできます。
リアルタイム料金が表示されず、固定料金のみ表示される: Debug log をオンにし、チェックアウトを再読み込みして、モジュールページの Log 欄を確認してください。よくある原因: 配送先都市が認識されない、商品に重量または寸法がない、出荷元の DANE コードや COP 為替レートがない、または Coordinadora がエラーを返した。
配送先都市が認識されない: 都市欄に DANE コードを書き込むコロンビアの県・市のチェックアウトモジュールをインストールしてください。開発者は、モジュールのフック actionVfdCrdDaneCities と actionVfdCrdDestinationDane を使ってさらに都市を登録したり、actionVfdCrdApiUrl で API のアドレスを変更したりできます。
料金に税は含まれていますか？ 料金は Coordinadora が見積もった金額です。Tax のルールを設定すると、PrestaShop は配送税をその上に加算します。見積もりに税がすでに含まれている場合は No tax を選択してください。
変更後に料金が古いように見える: モジュールページで Save をクリックしてください。これによりキャッシュされた見積もりが消去されます。
Coordinadora 配送業者が見つからないと表示される: 配送業者は Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再度作成されます。
アンインストール
Modules > Module Manager に移動し、VibeFox Coordinadora の横にあるメニューを開いて、Uninstall を選択します。ライセンスキー、ライセンスステータス、キャッシュされた見積もりは常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除され（注文の履歴は残ります）、設定とログも削除されます。オフの場合、配送業者は無効になるだけで、すべての設定は保持されます。モジュールを再インストールするか、Reset を行うと、保存されていた配送業者はそれ以前のステータスに戻ります。無効にしていた配送業者は無効のままです。
Coordinadora は、それぞれの所有者の商標です。このモジュールは Coordinadora と提携しておらず、Coordinadora による推奨も受けていません。