首次設置
按照以下步驟首次設置包含性訂價報告範本。
複製 Google Sheet 範本
打開包含性訂價報告範本並透過前往 File → Make a copy 製作您自己的副本。不要要求對原始工作表的編輯器存取權限。
連接您的 API 金鑰
在您複製的工作表中，按一下功能表列中（Help 旁邊）的 Zonos → Update GraphQL API Key。開啟工作表後，此功能表選項可能需要一分鐘才能出現。
授權指令碼
對於首次使用者，將出現授權對話方塊。按一下 OK，然後按照提示使用您的 Google 帳戶授權指令碼：
- 按一下 Select all 以授予所需的權限。
- 按一下 Continue 以完成授權。
輸入您的密鑰 API 金鑰
授權後，對話方塊將提示您輸入您的 Zonos 密鑰 GraphQL API 金鑰。您可以在 Zonos Dashboard 中 Settings → Integrations 下找到此內容。
確保複製帶有 credential_live 前綴的有效密鑰金鑰。過期的金鑰或公開金鑰將導致錯誤。
擷取訂單
按一下功能表列中的 Zonos → Fetch Orders。
選擇日期範圍
在對話方塊中輸入開始和結束日期，或使用預設選項之一（Last 30 days、This month、Last month、This year），然後按一下 Fetch Orders。
完成後，您的訂單將填入工作表的 Orders 選項卡中。
注意： 若要保存報告供日後參考，請右鍵點擊 Orders 選項卡並選擇 Duplicate，然後視需要重新命名。您也可以匯出整個電子表格或製作副本。
日常使用
完成首次設置後，生成新報告非常簡單：
- 跳過步驟 1-3 - 這些是一次性流程。
- 跳過步驟 4，除非您的 API 金鑰已過期或您需要從不同的 Zonos 商店擷取數據。
- 重複步驟 5 和 6 以擷取新日期範圍的訂單。
401 Unauthorized 錯誤
您可能會看到包含 HTTP fetch failed from 'order': 401: Unauthorized 的錯誤。
解決方案：確保您使用來自 Zonos Dashboard 的有效密鑰 GraphQL API 金鑰。當金鑰丟失、無效或不是密鑰類型時，會發生此錯誤。
安全要求失敗錯誤
您可能會看到包含 Security requirement failed 的錯誤。
解決方案：確保您使用密鑰 GraphQL API 金鑰（不是公開金鑰），且其狀態不為已過期。導航至 Zonos Dashboard 中的 Settings → Integrations 以驗證您的金鑰狀態。
沒有出現訂單
儘管提供了有效的密鑰 GraphQL API 金鑰，但沒有訂單填入。
解決方案：本報告僅為具有包含性訂價屬性的訂單生成數據。如果您的項目不包含 reverseAmountDetail 欄位，它們將不被包括。驗證您已在選定的日期範圍內處理包含性訂價訂單。
匯出包含性訂價報告
使用 Google Sheet 生成項目級別的包含性訂價明細。
包含性訂價報告範本是一個 Google Sheet，內含內置指令碼可查詢 Zonos GraphQL API 中的訂單，並生成顯示包含性訂價訂單中各項目基礎和包含性金額分佈情況的報告。這對任何想要了解關稅、稅款和費用在包含性訂價訂單中如何分配到各項目的商戶都很有用。