VibeFox Servientrega for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：5.0 以降、インストールされて有効であること。WooCommerce がないと、プラグインは有効化できません。
PHP：8.0 以降。
Servientrega 口座（リアルタイム料金のみ）：リアルタイム料金は、Servientrega Cotizador Corporativo（法人向け見積もり API）を使用します。これにアクセスできる Servientrega の法人（クレジット）口座が必要です。ユーザー、パスワード、請求コード（código de facturación、通常は SER で始まります）の 3 つの情報が必要です。これらは SISCLINET の認証情報で、Servientrega の営業担当者から発行されます。固定料金のみを使用する場合、Servientrega 口座は不要です。
サーバーへのアクセス（リアルタイム料金のみ）：サーバーから web.servientrega.com へ、HTTP のポート 8058（見積もり API）およびポート 8081（パスワード暗号化 Web サービス）で接続できる必要があります。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin を開き、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_servientrega フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Servientrega。または、プラグイン画面のプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. リアルタイム料金を使う場合は、ユーザー、パスワード、請求コードを入力し、Servientrega 製品を選択して、発送元の DANE コードを入力します。店舗通貨が COP でない場合は、通貨換算レートも入力します（「設定」を参照）。
6. 任意で、国と重量ごとの固定料金と代替料金を追加します。
7. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox Servientrega を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox Servientrega。これらはすべての配送ゾーンに適用されます。配送ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます：
Title (zone)：このゾーンでお客様に表示される名称です。空欄にすると、全体の Method title が使われます。
設定を保存するたびに、キャッシュされた Servientrega の見積もりとログイントークンが消去されます。保存された設定ではリアルタイム料金が機能しない場合、設定の上部に警告が表示され、理由が示されます：ユーザー、パスワード、請求コードの未入力、換算レートの未入力、または発送元 DANE コードの未入力。
一般
Enable/Disable：すべてのゾーンでこの方法を一括で有効または無効にします。
Method title：カートとチェックアウトに表示される配送方法の名称です。ゾーンごとに上書きできます。初期値：Servientrega。
Servientrega API（コロンビアのリアルタイム料金）（任意。認証情報がない場合は固定料金のみ使用されます）
User (login)：Servientrega / SISCLINET のユーザー名。
Password：Servientrega / SISCLINET のパスワード（入力したとおり）。公式の Servientrega クライアントと同じく、プラグインはログイン前に Servientrega の Web サービスでパスワードを暗号化します。
Billing code：Servientrega 口座の請求コード（código de facturación）。SISCLINET に表示されます。通常は SER で始まります。
リアルタイム料金には 3 つの項目すべてが必要です。リアルタイム料金は、コロンビア国内の配送先に対してのみ取得されます。他の国は固定料金を使用します。
Servientrega product：見積もりの対象となる、Servientrega 契約のサービスです。
請求重量は、実重量と容積重量のうち大きい方です。
Currency conversion rate：Servientrega の料金は COP 建てです。店舗通貨が COP でない場合は、店舗通貨での 1 COP の価値を入力します。例：0.00023。申告された荷物の価格も同じ方法で COP に換算されます。店舗通貨が COP の場合は空欄のままにします。店舗が別の通貨を使用していてこの項目が空欄の場合、リアルタイム料金は使用されず、固定料金が適用されます。プラグインは為替レートを取得しません。小数点記号としてピリオドとカンマのどちらも受け付けます。
発送元（リアルタイム料金に使用）
Origin city (DANE code)：発送元の自治体の 8 桁の DANE コード。例：11001000 Bogotá、05001000 Medellín、76001000 Cali、08001000 Barranquilla。5 桁の自治体コードも使用できます。空欄の場合で、WooCommerce > Settings > General の店舗住所がコロンビアにあるときは、店舗住所の自治体が使われます。
固定料金（リアルタイム料金がない場合に使用されます：認証情報がない、配送先がコロンビア国外、自治体が不明、換算レートがない、API エラーまたはそのルートが対象外の場合）
Price per country：店舗通貨による国と料金の表です。+ Add country をクリックすると行を追加し、×印をクリックすると削除できます。Price はどの重量にも適用されます。重量列 XS ≤1 kg、S 1–2 kg、M 2–3 kg、L 3–5 kg、XL >5 kg は、値が 0 より大きい場合、その重量では Price に代わって使用されます。* Default 行は、独自の行がないすべての国に適用されます。
Fallback cost：リアルタイム料金がなく、表のどの行も一致しない場合に使用されます。空欄にすると、その場合はこの方法を非表示にします。
Fixed price applies：固定料金の課金方法です。
Servientrega のリアルタイム料金は、常に 1 出荷ごとに計算されます。
条件
Minimum weight (kg)：カートの重量がこの値より軽い場合、この方法を非表示にします。0 は制限なしを意味します。
Maximum weight (kg)：カートの重量がこの値より重い場合、この方法を非表示にします。初期値：50。0 は制限なしを意味します。
Minimum order amount：カートの小計（割引後、税抜き）がこの金額に達した場合にのみ、この方法を表示します。空欄の場合は常に表示します。
Free shipping from：カートの小計（割引後、税抜き）がこの金額に達すると、配送料は無料になります。この方法に料金がある場合にのみ適用されます：表の料金または代替料金（この場合、Servientrega へのリクエストは送信されません）、またはリアルタイム料金。空欄の場合、送料無料は提供されません。
Excluded shipping classes：カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、この方法を非表示にします。
Tax status：Taxable は配送料に WooCommerce の税金を追加し、None は追加しません。Servientrega の見積もり（ValorTotal）には、運送会社の料金がすでに含まれています。その上に税金を加えたくない場合は None を選択してください。
配送ゾーンなしでの提供
Ignore shipping zones：この方法がどの配送ゾーンにも追加されていなくても、以下の国に対して Servientrega を提供します。
Countries：このモードでの配送先の国です。空欄の場合は、配送しているすべての国を使用します。この項目は Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log：料金計算と API エラーを WooCommerce のログに書き込みます：WooCommerce > Status > Logs、ソース vfd_servientrega。認証情報、トークン、お客様の住所は記録されません。作業が終わったらログを無効にしてください。
Remove data on uninstall：有効な場合、プラグインを削除すると、Servientrega のすべての設定、ゾーンの方法、キャッシュされた見積もりが削除されます。プラグインを無効化しても、何も削除されません。
チェックアウトでの動作
お客様が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します：配送先の国、カートの重量、最低注文金額、除外された配送クラス。次に料金を探します：Servientrega のリアルタイム料金、次に料金表、最後に代替料金の順です。料金がない場合、この方法は非表示になります。送料無料が適用される場合は、料金 0 でこの方法が表示されます。
認証情報が設定されていて配送先がコロンビアの場合、プラグインはお客様の自治体の DANE コードを見つけます。郵便番号欄または市区町村欄に入力された DANE コードを使用するか、県と市区町村を、内蔵の約 1,130 自治体の表と照合します。アクセント記号と「D.C.」は無視されます。1 つの県にしか存在しない市区町村名は、県を入力しなくても見つかります。
次に、プラグインは注文ごとに 1 個の荷物を Servientrega に送信します。店舗単位から kg に換算した合計重量と、最大の商品の縦・横の寸法およびすべての商品の合計容積から成る箱（cm に換算）です。寸法が未設定の商品は 10 × 10 × 10 cm として扱われます。申告価格は、カート小計を COP に換算した金額で、最低 6,000 COP です。Servientrega は COP で合計を返し、プラグインがそれを店舗通貨に換算します。
ログイントークンは期限切れまで保持され、最長 4 日です。拒否されたトークンは 1 回だけ自動的に更新されます。各見積もりは、ルートと荷物ごとに 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエスト（暗号化、ログイン、見積もり）は 10 分間キャッシュされるため、チェックアウトは再読み込みのたびに Servientrega の応答を待つ必要がありません。タイムアウトはリクエストごとに 10 秒です。
リアルタイム料金がない場合、料金は固定料金表から、次に Fallback cost から取得されます。いずれも該当しない場合、この方法は非表示になります。お客様が API エラーを目にすることはありません。理由はデバッグログに記録されます。
この方法は、クラシックチェックアウト、およびカートとチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。スペイン語翻訳（コロンビア、スペイン）を含みます。
プラグインが行うのは料金の計算だけです。送り状（guías）、ラベル、ステッカーは作成せず、集荷の依頼、発送の追跡やキャンセルは行わず、お客様が Servientrega の営業所（Centro de Soluciones）を選ぶこともできません。送り状は SISCLINET または Servientrega のポータルで作成してください。代金引換（logística de recaudo）の見積もりは行いません。リアルタイムの見積もりは、コロンビア国内の国内発送にのみ適用されます。エクアドル、ペルー、パナマ、および国際発送では固定料金が使われます。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Servientrega の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトのお客様には Servientrega が表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインの設定とテストができます。プラグインの画面と WooCommerce の画面にリマインダーが表示されます。既存の注文には影響ありません。
ライセンスの期限が切れても、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Servientrega が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、そしてこの方法がお客様の国のゾーンに追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。重量制限、Minimum order amount、Excluded shipping classes も確認します。リアルタイム料金がない場合は、その国または * Default に料金が設定されているか、Fallback cost が設定されているかを確認してください。
リアルタイム料金が表示されない：Debug log をオンにして、チェックアウトを再読み込みし、WooCommerce > Status > Logs を開いて、ソース vfd_servientrega を選択してください。よくある原因：換算レートがない（店舗通貨が COP ではない）、発送元の DANE コードがない、お客様の県または市区町村が未入力、または既知の自治体として認識されない、認証情報が誤っている、そのルートが対象外である。固定料金を設定していれば、これらの場合もカバーされます。
ログインに失敗する：ユーザー、パスワード、請求コードを Servientrega の営業担当者と確認してください。ログインに失敗すると、プラグインは次の試行まで 10 分待ちます。設定を保存すると、すぐに再試行されます。
お客様の市区町村が認識されない：県と市区町村は、内蔵の DANE 表と照合されます。表記の揺れがある場合、お客様は 8 桁の DANE コードを郵便番号として入力できます。開発者は vfd_svtg_dane_code フィルターで対応付けできます。
変更後も料金が古いまま：設定ページを保存してください。キャッシュされた Servientrega の見積もりとトークンが消去されます。
開発者向け：vfd_svtg_quote_request と vfd_svtg_default_dimensions のフィルターで、見積もりリクエストと、寸法が未設定の商品の寸法を調整できます。vfd_svtg_api_base と vfd_svtg_soap_url は、Servientrega から別のサーバーを指定された場合などに、エンドポイントを変更します。
ライセンスブロックにエラーが表示される：ブロックに表示されたメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態で動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、無効化してから Plugins 画面で削除してください。このプラグインのライセンスキーとライセンスの状態は、常に削除されます。設定、ゾーンの方法、キャッシュされた見積もり、トークンは、Remove data on uninstall が有効だった場合にのみ削除されます。そうでない場合は、後で再インストールする際のために残ります。既存の注文は、配送の明細を保持します。
Servientrega は、その所有者の商標です。このプラグインは Servientrega と提携しておらず、Servientrega の承認も受けていません。