VibeFox Coordinadora for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされて有効になっている必要があります。WooCommerce がない場合、プラグインは有効化できません。
PHP: 8.0 以降。
Coordinadora API キー（リアルタイム見積もりのみ）: リアルタイム見積もりは、公式の Coordinadora プラグインと同じ Coordinadora WooCommerce サービスを通じて、Coordinadora Cotizador から取得されます。Coordinadora は、有効な商業契約を結んだ顧客に API キーを発行します。Coordinadora の担当アカウントマネージャーに問い合わせるか、wc.coordinadora.com をご覧ください。出荷元の都市の 8 桁の DANE コードも必要です。キーがない場合、この配送方法は固定料金のみで動作します。
商品: リアルタイム見積もりには、カート内のすべての商品に重量と寸法（縦、横、高さ）が必要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_coordinadora フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Coordinadora。または、プラグインのページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. API キー、出荷元都市の DANE コードを入力します。ストアの通貨が COP でない場合は、COP の為替レートも入力します。代替としてコロンビア向けの固定料金を少なくとも 1 つ追加してください（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、コロンビアをカバーする配送ゾーンに VibeFox Coordinadora を追加するか、Ignore shipping zones をオンにして国を選択します。
7. 商品に重量と寸法が設定されていることを確認します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Coordinadora。これらはすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには 1 つの項目だけが表示されます：
Title (zone): このゾーンで購入者に表示される配送方法の名前です。空欄にすると、全体設定の Name が使われます。
リアルタイム見積もりが機能しない場合、または配送方法が非表示になる場合は、設定ページの上部に警告が表示されます：出荷元の DANE コードが未入力または無効、COP の為替レートが未入力、またはコロンビア向けの固定料金がない、といった場合です。設定を保存するたびに、キャッシュされた見積もりは消去されます。数値は小数点またはカンマで入力できます（9,99 = 9.99）。
一般
Enable/Disable: すべてのゾーンで Coordinadora を一度にオンまたはオフにします。
Name: チェックアウトで購入者に表示される配送方法の名前です。初期値は Coordinadora です。ゾーンの Title があれば、それが優先されます。
Tax status: Taxable は、料金に WooCommerce の配送税を追加します。None は追加しません。価格または Coordinadora の見積もりに税がすでに含まれている場合は None を選んでください。
Coordinadora リアルタイム見積もり
リアルタイム見積もりは、コロンビア国内の配送先について取得されます。固定料金のみを使う場合は、キーを空欄のままにしてください。
API key: Coordinadora から受け取った WooCommerce 用の API キーです。ログに記録されることはありません。
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 で送信する際にも使われます。空欄のままにすると、リアルタイム見積もりは使用されません。ストアの通貨が 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 は制限なしを意味します。
Minimum order subtotal: カートの小計がこの金額以上の場合のみ、配送方法を表示します。常に表示する場合は空欄にしてください。
Excluded shipping classes: カート内の商品がこの WooCommerce 配送クラスのいずれかに属している場合、配送方法を非表示にします。
Free shipping: 下記の小計以上の場合に送料無料にします。
Free shipping from: 送料が無料になるカートの小計です。Free shipping がオンの場合のみ使われます。その場合、API へのリクエストは送信されません。
配送ゾーンを使わない場合の利用可否
Ignore shipping zones: 配送方法を配送ゾーンに追加していなくても、下記の国に対して提供します。
Countries: このモードの配送先の国です。空欄にすると、ストアが配送するすべての国が対象になります。この項目は Ignore shipping zones がオンのときのみ使われます。
詳細設定
Debug log: 料金計算を WooCommerce > Status > Logs に記録します。ソースは vfd-coordinadora です。このオプションがオフでも、API のエラーは常に記録されます。API キーと購入者の住所が記録されることはありません。
Remove data on uninstall: オンの場合、プラグインを削除すると、その設定、ゾーンの配送方法、キャッシュされた見積もりが削除されます。無効化によってデータが削除されることはありません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します：カートの重量、注文小計の下限、除外される配送クラスです。送料無料が適用される場合、購入者は無料の料金を受け取り、Coordinadora へのリクエストは送信されません。
API キーがあるコロンビアの住所の場合、プラグインは次の順序で配送先都市の DANE コードを探します：都市欄の DANE コード（コロンビアの県・市のチェックアウトプラグインが書き込みます。例: MEDELLIN (ANT) (05001000)）、8 桁の郵便番号、または県都と約 40 の主要都市の内蔵リスト。リストの都市は、選択された県と照合されます。アクセント記号と大文字・小文字は無視されます。
次にプラグインは、配送先の DANE コードと、各商品の出荷元都市、重量（kg）、寸法（cm）、数量、申告価格（COP）を Coordinadora に送信します。ストアの単位は自動で換算されます。Coordinadora は COP で価格を返し、プラグインがそれをストアの通貨に変換します。各見積もりは 1 時間キャッシュされます。失敗したリクエストは 10 分間記憶されるため、Coordinadora の障害によってチェックアウトの更新がすべて遅くなることはありません。API のタイムアウトは 10 秒です。
リアルタイム見積もりが利用できない場合（API エラー、不明な都市、重量や寸法のない商品、設定の不足）は、固定料金が使われます。固定料金もない場合、配送方法は非表示になります。エラーの詳細は WooCommerce のログに記録され、購入者に表示されることはありません。
この配送方法は、クラシックチェックアウトとカート・チェックアウトブロックの両方で動作します。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。
このプラグインが計算するのは料金のみです。出荷や送り状（guías）の作成、伝票の印刷、集荷（recogidas）の手配、荷物の追跡、代金引換（recaudo）の回収、Droop の受け取りポイントの提供は行いません。これらには Coordinadora のポータルを使用してください。当日配送の見積もりは行わず、海外の配送先には固定料金が使われます。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Coordinadora の上部にあります。License key にキーを貼り付け、Activate をクリックしてください。ブロックには、ライセンスの有効期限日や、お使いのドメインなど、状態が表示されます。Check now で状態を再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクからは、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Coordinadora はチェックアウトで購入者に表示されません。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページには、リマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは引き続き動作します。ただし、アップデートとサポートには更新が必要です。状態はバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Coordinadora が表示されない: ライセンスが有効か、Enable/Disable がオンか、配送方法が購入者の国の配送ゾーンに追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。重量の制限、Minimum order subtotal、Excluded shipping classes を確認してください。リアルタイム見積もりがない場合、その国または * の固定料金が存在する必要があります。
リアルタイム料金が表示されず、固定料金だけが表示される: Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs を開いてください。ソースは vfd-coordinadora です。よくある原因は、配送先の都市が認識されない、商品に重量や寸法がない、出荷元の DANE コードや COP の為替レートがない、または Coordinadora がエラーを返した、といったものです。
配送先の都市が認識されない: 都市欄に DANE コードを書き込むコロンビアの県・市のチェックアウトプラグインをインストールしてください。開発者は vfd_crd_dane_cities と vfd_crd_destination_dane のフィルターを使って、さらに多くの都市を対応付けできます。
料金には税が含まれていますか？料金は Coordinadora が見積もった金額です。Tax status を Taxable に設定すると、WooCommerce がその上に配送税を追加します。見積もりに税がすでに含まれている場合は None を選んでください。
変更後に料金が古いように見える: 設定ページを保存してください。キャッシュされた見積もりが消去されます。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認できた状態で動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持されます。キャッシュされた見積もりだけが消去されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスの状態、およびキャッシュされた見積もりは、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後日の再インストールのために残ります。既存の注文は、配送の明細行を保持します。
Coordinadora は、それぞれの所有者の商標です。このプラグインは Coordinadora と提携しておらず、Coordinadora による推奨もありません。