統合
Zonosにまだ登録していない場合は、営業担当へのお問い合わせフォームを完了して開始してください。アカウント契約が成立すると、24時間以内に専任のオンボーディング担当者が連絡し、統合プロセスをご案内します。
このセクションの手順に従って、MagentoストアにCheckoutをシームレスに統合します：
Checkoutアプリをインストール
MagentoでCheckoutを使用するには、Magento Marketplaceから拡張機能を購入し、Composerを使用してターミナルにインストールする必要があります。Magentoの拡張機能の扱い方のため、他のプラグインよりも技術的な手順が必要です。アプリをインストールするには：
- Magento MarketplaceからCheckout拡張機能をダウンロードします。
- Magento MarketplaceからHello拡張機能をダウンロードします。
- 新しいターミナルを開き、Magentoインストールのルートディレクトリに移動し、以下の手順に従います。
以下のコマンドを実行して、Checkoutをサイトの依存関係に追加します。Helloは自動的に含まれます。
composer require zonos/checkout次に、以下のコマンドを実行してCheckoutモジュールを有効にします。
php bin/magento module:enable Zonos_Checkout次に、以下のコマンドを実行して拡張機能をインストールし、必要なデータベースマイグレーションを実行します。
php bin/magento setup:upgrade最後に、以下のコマンドを実行して、Checkoutプラグインを含む新しいバージョンのサイトをコンパイルします。
php bin/magento setup:di:compileNote: CheckoutはHelloに依存しているため、上記のコマンドで両方がインストールされます。
Magentoを設定
- Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout に移動します。
- Dashboardから Zonos API key をコピーし、Service token として入力します。
- Dashboardから Zonos account number をコピーし、Store ID number として入力します。
- Domestic shipping countries で、国内のすべての国をクリックしてハイライトします。
- Cart item attribute mapping で、マッピングしたい情報を選択します。デフォルトでは、Zonosは商品の重量、価格、説明、原産国（利用可能な場合）を取得します。このセクションには、HS code、長さ、幅、高さ、または見積もり計算時にZonosの特別なルールで使用されるカスタム商品レベルの属性を取り込むために商品情報を渡せる空のフィールドがあります。
一般設定を構成
MagentoでCheckoutアプリを設定する際は、Magentoの一般設定もいくつか変更する必要があります。
- Magento admin -> Stores -> Configuration -> General に移動します。
- Allow countries セクションで、国際・国内を問わず配送先とするすべての国をハイライトします。ここでハイライトされていない国がZonosで有効になっている場合、注文は完了できDashboardにも表示されますが、Magentoへのインポートは失敗します。
- Zonosは、Zip/postal code is optional for セクションで米国以外のすべての国を選択することをお勧めします。これにより、郵便番号を使用しない、または要求しない国での注文完了時のエラーを減らせます。さらに、CheckoutにはZonosの不正保護が含まれているため、この要件を削除しても追加のリスクは発生しません。
Helloを設定
HelloはCheckoutアプリのインストール時に追加されます。以下のHello設定手順に従ってください。
- Magento admin -> Stores -> Configuration -> Zonos -> Zonos Hello に移動します。
- Dashboardから Hello site key をコピーし、Site Key として入力します。
- Helloで通貨を変換したい場合、Currency conversion selectors フィールドにCSSセレクターを貼り付けます。複数のセレクターはカンマで区切ります（例：
.price,.__current-price,.__subtotal,.__original-price）。- ストアの基本通貨がUSDでない場合、Dashboard -> Hello でストアの基本通貨をHelloに設定してください。
- 国際顧客向けにHide domestic elementsが必要な場合、非表示にしたい要素のCSSセレクターを入力します（例：
.nav-6,.action-add）。
詳細設定を調整
オプション—以下の設定は詳細設定です。デフォルトが設定されているため、操作は不要です。調整したい場合は、以下のガイドラインに従ってください：
- Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout に移動します。
- 好みに応じて調整します：
- Create invoice on import—デフォルトは Yes です。Zonosは注文インポート時に請求書を作成します。この機能を無効にした場合、独自の請求書を作成する必要があり、Zonosは不正レビューホールドを
zonos_holdステータスに設定します。不正が解除されると、以前のステータスに戻します。 - Customer login—デフォルトは No です。チェックアウトにアカウントを必須にしたい場合、Yes に切り替えます。Customer configuration -> Login options に移動し、Redirect Customer to Account Dashboard after Logging In を No に更新する必要もあります。
- Create invoice on import—デフォルトは Yes です。Zonosは注文インポート時に請求書を作成します。この機能を無効にした場合、独自の請求書を作成する必要があり、Zonosは不正レビューホールドを
統合をテスト
アカウントとアプリの設定が完了したら、統合をテストする準備ができています。テスト中はMagentoでCheckoutとHelloを有効にする必要があります。手順：
- Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout に移動します。
- Enabled を Yes に切り替えます。
- 左メニューで Zonos Hello に切り替えます。
- Enabled を Yes に切り替えます。
本番公開の準備がまだできていない場合は、テスト完了後にこれらを No に戻すことを忘れないでください。テスト完了後、上記と同じ手順でZonosを有効にします。
Checkoutをアンインストール
アプリのアンインストールは、経験豊富なMagento開発者がComposer経由で実行する必要があります。以下のコマンドを実行してCheckoutとHelloをアンインストールします：
php bin/magento module:uninstall Zonos_Checkout Zonos_Hello関税、税金、配送コストの最も正確な見積もりのために、どの商品情報を提供すべきですか？
商品情報は発生する関税・税金の額と配送コストに影響を与える可能性があります。Zonosに提供する商品情報が多いほど、返される見積もりはより正確になります。Zonosはこの情報が利用できない場合でも見積もりを生成できますが、精度向上のために以下の主要な商品詳細の提供を推奨します：
- Weight: 重量は配送コストに影響し、関税や税金に影響を与える可能性があります。Magento商品リストの重量は、存在する場合Zonosが自動的に使用します。
- Dimensions: 寸法は配送コストに影響し、関税や税金に影響を与える可能性があります。ZonosはMagentoの各商品に設定された商品寸法（長さ、幅、高さ）を利用できますが、適切な統合のためにZonosアプリでマッピングする必要があります。
- HS codes: HS codeは関税率に影響し、場合によっては税金にも影響します。ZonosはMagentoの商品リストに設定されたHS codeを使用できますが、ZonosアプリでHS codeフィールドをマッピングする必要があります。
- Country of origin: 商品の原産国は関税率に影響し、税金にも影響する場合があります。Magento商品リストに設定された原産国は、存在する場合Zonosが自動的に使用します。
MagentoからZonosに渡される商品詳細
| Product details↕ | Weights↕ | Dimensions↕ | HS code↕ | Country of origin↕ |
|---|---|---|---|---|
| Automatically passed | ||||
| Must be mapped |
Note: または、Catalogに情報を入力して、Magentoから保存・渡される情報を上書きすることもできます。
プラットフォーム別の商品情報の詳細をご覧ください。
Magento向けCheckout
Magento向けCheckoutプラグインを統合します。Checkoutを統合する前に、期待どおりに動作することを確認してください。Checkoutを使用すると：