前提条件
開始前に、以下を確認してください:
- Zonosの有効なInclusive pricingサブスクリプション。
- Zonos Dashboardからの Secret GraphQL API key。Settings -> Integrations に移動してAPI keyを確認してください。keyには
credential_liveプレフィックスが必要で、期限切れでないこと。
初回セットアップ
以下の手順に従って、Inclusive pricingレポートテンプレートを初めて設定します。
Google Sheetテンプレートをコピー
Inclusive pricingレポートテンプレートを開き、File -> Make a copy で独自のコピーを作成してください。元のシートへの編集者アクセスをリクエストしないでください。
API keyを接続
コピーしたシートで、メニューバー(Help の隣)から Zonos -> Update GraphQL API Key をクリックします。シートを開いてからこのメニューオプションが表示されるまで1分かかる場合があります。
スクリプトを承認
初回ユーザーには承認ダイアログが表示されます。OK をクリックし、プロンプトに従ってGoogleアカウントでスクリプトを承認します:
- Select all をクリックして必要な権限を付与します。
- Continue をクリックして承認を完了します。
Secret API keyを入力
承認後、Zonos Secret GraphQL API keyの入力を求めるダイアログが表示されます。Zonos Dashboardの Settings -> Integrations で確認できます。
有効な Secret keyで credential_live プレフィックスを持つkeyをコピーしてください。期限切れのkeyまたはPublic keyはエラーの原因になります。
注文を取得
メニューバーから Zonos -> Fetch Orders をクリックします。
日付範囲を選択
ダイアログで開始日と終了日を入力するか、プリセットオプション(Last 30 days、This month、Last month、This year)のいずれかを使用し、Fetch Orders をクリックします。
完了すると、注文がシートの Orders タブに入力されます。
Note: 将来参照用にレポートを保存するには、Orders タブを右クリックして Duplicate を選択し、必要に応じて名前を変更してください。スプレッドシート全体をエクスポートまたはコピーすることもできます。
日常使用
初回セットアップを完了した後、新しいレポートの生成は簡単です:
- ステップ1-3をスキップ - これらは一度限りのプロセスです。
- API keyの期限切れまたは別のZonosストアからデータを取得する必要がない限り、ステップ4をスキップ。
- ステップ5と6を繰り返して、新しい日付範囲の注文を取得します。
401 Unauthorizedエラー
HTTP fetch failed from 'order': 401: Unauthorized を含むエラーが表示される場合があります。
Fix: Zonos Dashboardから有効な Secret GraphQL API keyを使用していることを確認してください。keyが欠落、無効、またはSecret keyタイプでない場合にこのエラーが発生します。
Security requirement failedエラー
Security requirement failed を含むエラーが表示される場合があります。
Fix: Secret GraphQL API key(Public keyではない)を使用しており、Expired ステータスでないことを確認してください。Zonos Dashboardの Settings -> Integrations に移動してkeyのステータスを確認してください。
注文が表示されない
有効なSecret GraphQL API keyを提供しても注文が入力されない場合。
Fix: このレポートはInclusive pricing属性を持つ注文のデータのみを生成します。商品に reverseAmountDetail フィールドが含まれていない場合、レポートに含まれません。選択した日付範囲内でInclusive pricing注文を処理したことを確認してください。
Inclusive pricingレポートをエクスポート
Google Sheetを使用して商品レベルのInclusive pricing内訳を生成します。
Inclusive pricingレポートテンプレートは、組み込みスクリプト付きのGoogle Sheetで、Zonos GraphQL APIから注文をクエリし、ベース金額とInclusive金額の商品レベル内訳を示すレポートを生成します。Inclusive pricing注文の商品間で関税、税金、手数料がどのように配分されているかを把握したいマーチャントに有用です。