首次設定
請遵循這些步驟以首次設定包含定價報告範本。
複製 Google 試算表範本
開啟包含定價報告範本,並透過前往 File -> Make a copy 製作您自己的副本。請勿要求編輯原始工作表的存取權。
連接您的 API 金鑰
在您複製的工作表中,從選單列 (在 Help 旁邊) 按一下 Zonos -> Update GraphQL API Key。此選單選項可能需要一分鐘才能在開啟工作表後出現。
授權指令碼
對於首次使用者,會出現授權對話方塊。按一下 OK,然後按照提示使用您的 Google 帳戶授權指令碼:
- 按一下 Select all 以授予所需權限。
- 按一下 Continue 以完成授權。
輸入您的 Secret API 金鑰
授權後,對話方塊會提示您輸入 Zonos Secret GraphQL API 金鑰。您可以在 Zonos 儀表板的 Settings -> Integrations 下找到此項目。
請確保複製具有 credential_live 前綴的有效 Secret 金鑰。過期的金鑰或 Public 金鑰會造成錯誤。
擷取訂單
從選單列按一下 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 未授權錯誤
您可能會看到包含 HTTP fetch failed from 'order': 401: Unauthorized 的錯誤。
解決方式:請確保您使用來自 Zonos 儀表板的有效 Secret GraphQL API 金鑰。此錯誤發生在金鑰遺失、無效或不是 Secret 金鑰類型時。
安全性需求失敗錯誤
您可能會看到包含 Security requirement failed 的錯誤。
解決方式:請確保您使用的是 Secret GraphQL API 金鑰 (不是 Public 金鑰),且其狀態不是 Expired。瀏覽至 Zonos 儀表板中的 Settings -> Integrations 以驗證您的金鑰狀態。
沒有出現訂單
儘管提供了有效的 Secret GraphQL API 金鑰,但沒有訂單填入。
解決方式:此報告僅為具有包含定價屬性的訂單產生資料。如果您的項目不包含 reverseAmountDetail 欄位,則將不包含這些項目。驗證您已在所選日期範圍內處理包含定價訂單。
匯出包含定價報告
使用 Google 試算表產生逐項的包含定價明細。
包含定價報告範本是一個 Google 試算表,內含內建指令碼會查詢 Zonos GraphQL API 以取得您的訂單,並產生顯示逐項基礎金額和包含金額明細的報告。對於想深入了解關稅、稅金和費用如何在包含定價訂單中的逐項分配的商家來說,此功能非常有用。