匯出包含定價報告

使用 Google 試算表產生逐項的包含定價明細。

包含定價報告範本是一個 Google 試算表,內含內建指令碼會查詢 Zonos GraphQL API 以取得您的訂單,並產生顯示逐項基礎金額和包含金額明細的報告。對於想深入了解關稅、稅金和費用如何在包含定價訂單中的逐項分配的商家來說,此功能非常有用。

注意: 此報告僅包含含有 reverseAmountDetail 屬性的訂單項目。不含包含定價資料的訂單將不會出現在報告中。

先決條件 

在開始前,請確保您具有下列條件:

  • 與 Zonos 的有效包含定價訂閱。
  • 來自 Zonos 儀表板的 Secret GraphQL API 金鑰。瀏覽至 Settings -> Integrations 以尋找您的 API 金鑰。金鑰必須具有 credential_live 前綴且不得過期。

首次設定 

請遵循這些步驟以首次設定包含定價報告範本。

開啟包含定價報告範本,並透過前往 File -> Make a copy 製作您自己的副本。請勿要求編輯原始工作表的存取權。

在您複製的工作表中,從選單列 (在 Help 旁邊) 按一下 Zonos -> Update GraphQL API Key。此選單選項可能需要一分鐘才能在開啟工作表後出現。

對於首次使用者,會出現授權對話方塊。按一下 OK,然後按照提示使用您的 Google 帳戶授權指令碼:

  1. 按一下 Select all 以授予所需權限。
  2. 按一下 Continue 以完成授權。
Google 安全警告

Google 可能會將此指令碼標示為未驗證。這是自訂 Google Apps Scripts 的預期情況。指令碼僅連接至 Zonos GraphQL API 以擷取您的訂單資料。

授權後,對話方塊會提示您輸入 Zonos Secret GraphQL API 金鑰。您可以在 Zonos 儀表板的 Settings -> Integrations 下找到此項目。

請確保複製具有 credential_live 前綴的有效 Secret 金鑰。過期的金鑰或 Public 金鑰會造成錯誤。

從選單列按一下 Zonos -> Fetch Orders

在對話方塊中輸入開始和結束日期,或使用預設選項之一 (Last 30 daysThis monthLast monthThis year),然後按一下 Fetch Orders

完成後,您的訂單將填入工作表的 Orders 索引標籤中。

注意: 若要儲存報告供日後參考,請以滑鼠右鍵按一下 Orders 索引標籤並選擇 Duplicate,然後視需要重新命名。您也可以匯出或複製整個試算表。

日常使用 

完成首次設定後,產生新報告非常簡單:

  • 略過步驟 1-3 - 這些是一次性流程。
  • 略過步驟 4,除非您的 API 金鑰已過期或您需要從不同的 Zonos 商店提取資料。
  • 重複步驟 5 和 6 以擷取新日期範圍的訂單。

您可能會看到包含 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 欄位,則將不包含這些項目。驗證您已在所選日期範圍內處理包含定價訂單。