VibeFox Andreani for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされていて有効であること。WooCommerce がないとプラグインは有効化できません。
PHP: 8.0 以降。
Andreani アカウント（リアルタイム料金のみ）:リアルタイム料金は Andreani の見積り API を使用します。Andreani は、法人のお客様に API の認証情報、クライアントコード、契約番号を発行します。通常は月におよそ 300 件以上の出荷がある場合が対象です。developers.andreani.com をご覧になるか、ventapyme@andreani.com までご連絡ください。API のユーザー名とパスワード、クライアントコード、契約番号が必要です。Andreani は、サービスごと（自宅配送、営業所受け取り）に別々の契約を発行します。API アクセスがない場合は、固定料金をご利用ください。営業所セレクターは認証情報なしで動作します。
VibeFox ライセンスキー:vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_andreani フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Andreani。または、プラグインの一覧画面でプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 名前、料金のソース、国別の料金（例: AR=5000）を設定します。リアルタイム料金を使う場合は、API の認証情報、クライアントコード、契約番号も設定します（「設定」を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones に進み、アルゼンチン用のゾーンを開くか作成し、VibeFox Andreani を追加します。ゾーンのウィンドウでは、この選択肢のタイトル、配送モード、別の契約を設定できます。Ignore shipping zones をオンにして、代わりに国を選ぶこともできます。
設定
主な設定は WooCommerce > Settings > Shipping > VibeFox Andreani にあります。これらはすべての配送ゾーンに適用されます。設定の未入力に関する警告（API の認証情報、契約番号、為替レート、アルゼンチンの料金が未設定）は、ページ上部に表示されます。設定を保存するたびに、キャッシュされたトークン、営業所リスト、料金が消去されます。
ゾーンのウィンドウ（配送ゾーンに方法を追加したとき）
Title:チェックアウトでのこの選択肢の名前。空欄にすると、全体の Name が使われます。
Delivery modality:Use global setting、または 4 つのモードのいずれか（下記参照）。同じゾーンに 2 回追加すると、たとえば戸口から戸口と営業所受け取りの両方を提供できます。
Contract number:この選択肢に使う Andreani の契約。空欄にすると、全体の契約が使われます。
一般
Enable/Disable:すべてのゾーンで Andreani の配送を一度にオンまたはオフにします。
Name:チェックアウト時に購入者に表示される配送方法の名前。既定値: Andreani。
Tax status:Taxable は、WooCommerce が配送料に税金を加算することを意味するため、API の料金は IVA を含まずに取得されます。None は、API の料金を IVA 込みで取得することを意味します。
Andreani API（リアルタイム料金に必要）
Environment:Sandbox / QA (apisqa.andreani.com)（既定）または Production (apis.andreani.com)。認証情報が属する環境を使用してください。
API username:Andreani API のユーザー名。
API password:Andreani API のパスワード。
Client code:Andreani が提供するクライアントコード（código de cliente）。例: CL0000000。
Contract number:料金の計算に使うサービスの契約。例: 自宅配送。ゾーンごとに別の契約を使うこともできます（例: 営業所受け取り）。
Origin branch code:料金の見積りに使う任意の発送元営業所（sucursalOrigen）。空欄にすると、契約で設定された営業所を使います。
配送と料金
Delivery modality:前半は、Andreani が荷物を受け取る場所（住所、または荷物を預ける営業所）を示します。後半は、購入者が荷物を受け取る場所を示します。
Rate source:料金の計算方法。
Country prices:配送先の国ごとの固定料金を、ストアの通貨で指定します。1 行に 1 つ、CC=PRICE の形式で入力します（例: AR=5000）。固定モードと、API のフォールバックに使われます。別の形式の行は無視され、保存時に警告で一覧表示されます。
ARS exchange rate:Andreani はアルゼンチン・ペソで見積もります。ストアの通貨が ARS 以外の場合にのみ必要です。ストアの通貨で表した 1 ARS の価格（例: 0.001）を入力します。これがないと API の料金は使われません。固定料金は常にストアの通貨で表示されます。
Default product weight (kg):API 料金を要求するときと重量制限を確認するときに、重量のない商品に使われます。既定値: 0.5。
Calculation type:Per order は料金を 1 回だけ請求します。Per item (price x number of items) は、Country prices の固定料金にカート内の商品数を掛けます。Andreani のリアルタイム料金はカート全体に対するものなので、掛け算は行いません。
利用可能条件
Min weight (kg):この方法が表示されるために必要な最小のカート重量。0 は制限なしを意味します。
Max weight (kg):最大のカート重量。超えると、この方法は非表示になります。既定値: 100。0 は制限なしを意味します。
Minimum subtotal:カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると、常に表示されます。
Excluded shipping classes:カート内のいずれかの商品が、選択した WooCommerce の配送クラスに属する場合、この方法は非表示になります。
Ignore shipping zones:配送ゾーンに追加していなくても、下記の国に対してこの方法を提供します。
Countries:このモードの配送先の国。空欄にすると、すべての国を許可します。Ignore shipping zones がオンのときにのみ使われます。
送料無料
Free shipping:送料無料の基準額をオンにします。
Free shipping from:送料が無料になるカートの小計。Free shipping がオンである必要があります。
チェックアウトの営業所セレクター（Door to branch と Branch to branch の場合に表示）
Province select width:都道府県リストの CSS の幅（例: 100% または 300px）。既定値: 100%。
Branch select width:営業所リストの CSS の幅（例: 100% または 400px）。既定値: 100%。
詳細設定
Debug log:API リクエストと料金の計算を WooCommerce > Status > Logs に記録します（ソースは "vfd-andreani"）。エラーは常に記録されます。認証情報とトークンは記録されません。
Remove data on uninstall:オンにすると、プラグインを削除したときに、すべての設定とゾーンの配送方法が削除されます。無効化では何も削除されません。注文に保存された営業所のデータは常に残ります。
チェックアウトでの動作
購入者が配送先住所を入力すると、プラグインはカートの重量（商品の重量は kg に換算され、重量のない商品は Default product weight (kg) を使用）、Minimum subtotal、Excluded shipping classes を確認します。
固定モードでは、料金は Country prices から取得されます。リアルタイムモードでは、プラグインは Andreani API にログインし、配送先の郵便番号、契約、クライアントコード、kg 単位の重量、商品の寸法から求めた容積、申告額（ARS で表したカートの小計）を指定して見積りを要求します。リアルタイム料金は、有効なアルゼンチンの郵便番号に対してのみ要求されます。ストアの通貨が ARS でない場合、ARS の金額は ARS exchange rate で換算されます。
ログイントークンは 23 時間キャッシュされ、Andreani が拒否した場合は自動的に更新されます。見積りは 1 時間キャッシュされます。API 呼び出しに失敗した場合は 5 分間再試行されません。API のエラーが購入者に表示されることはありません。その方法が非表示になるか、フォールバックモードでは固定料金が使われます。理由はログに記録されます。
Free shipping がオンで、カートの小計が Free shipping from に達した場合、料金は 0 になります。送料無料は、その方法に料金がある場合にのみ適用されます。Andreani API が料金を返さず（かつフォールバックする固定料金もない）場合は、その方法は表示されません。Per item の場合、固定料金に商品数が掛けられます。
この方法は、クラシックチェックアウトと、カートブロックおよびチェックアウトブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインは、Andreani の配送データの作成、ラベルの印刷、荷物の追跡は行いません。これらは Andreani の Web ポータルでご利用ください。
受け取り拠点
Door to branch または Branch to branch を選ぶと、チェックアウトの Andreani の選択肢の下に、都道府県リストと営業所リストが表示されます。これはクラシックチェックアウトとチェックアウトブロックの両方で表示されます。都道府県は配送先住所から事前に選択されます。営業所リストは Andreani の公開営業所 API から取得され、12 時間キャッシュされます。荷物の引き渡しを行わない営業所は表示されません。利用できる営業所がない場合、購入者にはメッセージが表示され、別の配送方法を選べます。
営業所を選ばないと注文できません。購入者には Please select an Andreani pickup branch. と表示されます。これは両方のチェックアウトでサーバー側で確認されます。
選択された営業所は注文に保存されます。管理者の注文画面では、配送モードと営業所が配送先住所の下に表示されます。Edit をクリックすると、別の都道府県と営業所を選べます。購入者は注文ページと注文メール（HTML とプレーンテキスト）で、営業所を Andreani pickup branch として確認できます。既存の注文は営業所のデータを保持します。
ライセンスキー
このプラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Andreani の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなど、ステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメイン枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで購入者に Andreani は表示されません。ログインした店舗管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページにはお知らせが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは引き続き動作します。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Andreani が表示されない:ライセンスが有効であること、Enable/Disable がオンであること、購入者の住所のゾーンにこの方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。Country prices にその国の行があること（固定料金またはフォールバックとして）を確認し、重量制限、Minimum subtotal、Excluded shipping classes も確認してください。設定ページの上部にある警告も確認してください。
リアルタイム料金が表示されない:Debug log をオンにし、チェックアウトを再読み込みして、WooCommerce > Status > Logs を開いてください（ソースは "vfd-andreani"）。理由が表示されます。認証情報または契約番号の不足、ログインの失敗（ユーザー名、パスワード、または環境が誤っている）、有効なアルゼンチンの郵便番号がまだない、為替レートがない、Andreani の HTTP エラーなどです。Andreani API, fixed price if the API fails を使っている場合、問題を修正するまで購入者は固定料金を受け取れます。
ストアの通貨がアルゼンチン・ペソではない:ARS exchange rate に、ストアの通貨で表した 1 ARS の値を設定してください。
配送料の税金が正しくないように見える:Tax status を Taxable にすると、IVA を含まない Andreani の料金が使われ、WooCommerce が独自の税金を加算します。None にすると、IVA 込みの料金が使われ、WooCommerce は税金を加算しません。Taxable を使う場合は、WooCommerce の税金が設定されていることを確認してください。
一覧に営業所がない:Andreani の営業所 API が応答しませんでした。失敗したリクエストは 5 分後に再試行されます。ログを確認してください。
変更後も料金が古いように見える:設定ページを保存してください。キャッシュされたトークン、営業所リスト、料金が消去されます。
ライセンスブロックにエラーが表示される:ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持され、キャッシュのみが消去されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータス、およびキャッシュされたトークン、営業所リスト、料金は、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。注文に保存された営業所のデータは、決して削除されません。
Andreani は各所有者の商標です。本プラグインは Andreani との提携や承認を受けたものではありません。