使用 Google 試算表產生逐項的 Inclusive Pricing 明細。
Inclusive Pricing 報告範本是一個 Google 試算表,內含內建指令碼會查詢 Zonos GraphQL API 以取得您的訂單,並產生顯示逐項基礎金額和包含金額明細的報告。對於想深入了解關稅、稅金和費用如何在 Inclusive Pricing 訂單中的逐項分配的商家來說,此功能非常有用。
注意: 此報告僅包含含有 reverseAmountDetail 屬性的訂單項目。不含 Inclusive Pricing 資料的訂單將不會出現在報告中。
reverseAmountDetail
在開始前,請確保您具有下列條件:
credential_live
請遵循這些步驟以首次設定 Inclusive Pricing 報告範本。
開啟 Inclusive Pricing 報告範本,並透過前往 File -> Make a copy 製作您自己的副本。請勿要求編輯原始工作表的存取權。
在您複製的工作表中,從選單列 (在 Help 旁邊) 按一下 Zonos -> Update GraphQL API Key。此選單選項可能需要一分鐘才能在開啟工作表後出現。
對於首次使用者,會出現授權對話方塊。按一下 OK,然後按照提示使用您的 Google 帳戶授權指令碼:
Google 可能會將此指令碼標示為未驗證。這是自訂 Google Apps Scripts 的預期情況。指令碼僅連接至 Zonos GraphQL API 以擷取您的訂單資料。
授權後,對話方塊會提示您輸入 Zonos Secret GraphQL API 金鑰。您可以在 Zonos Dashboard 的 Settings -> Integrations 下找到此項目。
請確保複製具有 credential_live 前綴的有效 Secret 金鑰。過期的金鑰或 Public 金鑰會造成錯誤。
從選單列按一下 Zonos -> Fetch Orders。
在對話方塊中輸入開始和結束日期,或使用預設選項之一 (Last 30 days、This month、Last month、This year),然後按一下 Fetch Orders。
完成後,您的訂單將填入工作表的 Orders 索引標籤中。
注意: 若要儲存報告供日後參考,請以滑鼠右鍵按一下 Orders 索引標籤並選擇 Duplicate,然後視需要重新命名。您也可以匯出或複製整個試算表。
完成首次設定後,產生新報告非常簡單:
您可能會看到包含 HTTP fetch failed from 'order': 401: Unauthorized 的錯誤。
HTTP fetch failed from 'order': 401: Unauthorized
解決方式:請確保您使用來自 Zonos Dashboard 的有效 Secret GraphQL API 金鑰。此錯誤發生在金鑰遺失、無效或不是 Secret 金鑰類型時。
您可能會看到包含 Security requirement failed 的錯誤。
Security requirement failed
解決方式:請確保您使用的是 Secret GraphQL API 金鑰 (不是 Public 金鑰),且其狀態不是 Expired。瀏覽至 Zonos Dashboard 中的 Settings -> Integrations 以驗證您的金鑰狀態。
儘管提供了有效的 Secret GraphQL API 金鑰,但沒有訂單填入。
解決方式:此報告僅為具有 Inclusive Pricing 屬性的訂單產生資料。如果您的項目不包含 reverseAmountDetail 欄位,則將不包含這些項目。驗證您已在所選日期範圍內處理 Inclusive Pricing 訂單。
匯出報告
匯出 Inclusive Pricing 報告
使用 Google 試算表產生逐項的 Inclusive Pricing 明細。
Inclusive Pricing 報告範本是一個 Google 試算表,內含內建指令碼會查詢 Zonos GraphQL API 以取得您的訂單,並產生顯示逐項基礎金額和包含金額明細的報告。對於想深入了解關稅、稅金和費用如何在 Inclusive Pricing 訂單中的逐項分配的商家來說,此功能非常有用。
先決條件
在開始前,請確保您具有下列條件:
credential_live前綴且不得過期。首次設定
請遵循這些步驟以首次設定 Inclusive Pricing 報告範本。
複製 Google 試算表範本
開啟 Inclusive Pricing 報告範本,並透過前往 File -> Make a copy 製作您自己的副本。請勿要求編輯原始工作表的存取權。
連接您的 API 金鑰
在您複製的工作表中,從選單列 (在 Help 旁邊) 按一下 Zonos -> Update GraphQL API Key。此選單選項可能需要一分鐘才能在開啟工作表後出現。
授權指令碼
對於首次使用者,會出現授權對話方塊。按一下 OK,然後按照提示使用您的 Google 帳戶授權指令碼:
Google 可能會將此指令碼標示為未驗證。這是自訂 Google Apps Scripts 的預期情況。指令碼僅連接至 Zonos GraphQL API 以擷取您的訂單資料。
輸入您的 Secret API 金鑰
授權後,對話方塊會提示您輸入 Zonos Secret GraphQL API 金鑰。您可以在 Zonos Dashboard 的 Settings -> Integrations 下找到此項目。
請確保複製具有
credential_live前綴的有效 Secret 金鑰。過期的金鑰或 Public 金鑰會造成錯誤。擷取訂單
從選單列按一下 Zonos -> Fetch Orders。
選擇日期範圍
在對話方塊中輸入開始和結束日期,或使用預設選項之一 (Last 30 days、This month、Last month、This year),然後按一下 Fetch Orders。
完成後,您的訂單將填入工作表的 Orders 索引標籤中。
日常使用
完成首次設定後,產生新報告非常簡單:
疑難排解
401 未授權錯誤
您可能會看到包含
HTTP fetch failed from 'order': 401: Unauthorized的錯誤。解決方式:請確保您使用來自 Zonos Dashboard 的有效 Secret GraphQL API 金鑰。此錯誤發生在金鑰遺失、無效或不是 Secret 金鑰類型時。
安全性需求失敗錯誤
您可能會看到包含
Security requirement failed的錯誤。解決方式:請確保您使用的是 Secret GraphQL API 金鑰 (不是 Public 金鑰),且其狀態不是 Expired。瀏覽至 Zonos Dashboard 中的 Settings -> Integrations 以驗證您的金鑰狀態。
沒有出現訂單
儘管提供了有效的 Secret GraphQL API 金鑰,但沒有訂單填入。
解決方式:此報告僅為具有 Inclusive Pricing 屬性的訂單產生資料。如果您的項目不包含
reverseAmountDetail欄位,則將不包含這些項目。驗證您已在所選日期範圍內處理 Inclusive Pricing 訂單。這個頁面有幫助嗎?