首次设置
按照以下步骤首次设置包含性定价报告模板。
复制 Google Sheet 模板
打开包含性定价报告模板,并通过转到文件 -> 创建副本来制作自己的副本。不要请求对原始表格的编辑器访问权限。
连接您的 API 密钥
在您复制的表格中,从菜单栏(在帮助旁边)单击Zonos -> 更新 GraphQL API 密钥。打开表格后,此菜单选项可能需要一分钟才能出现。
授权脚本
对于首次用户,将显示授权对话框。单击确定,然后按照提示使用您的 Google 帐户授权脚本:
- 单击全选以授予所需的权限。
- 单击继续以完成授权。
输入您的 Secret API 密钥
授权后,对话框将提示您输入您的 Zonos Secret GraphQL API 密钥。您可以在 Zonos 仪表板的设置 -> 集成下找到此信息。
确保复制具有 credential_live 前缀的有效Secret密钥。过期的密钥或 Public 密钥将导致错误。
获取订单
从菜单栏单击Zonos -> 获取订单。
选择日期范围
在对话框中输入开始日期和结束日期,或使用其中一个预设选项(最后 30 天、本月、上个月、今年),然后单击获取订单。
完成后,您的订单将填充在表格的订单标签中。
注意:要保存报告以供将来参考,右键单击订单标签并选择复制,然后根据需要重命名。您也可以导出或制作整个电子表格的副本。
日常使用
完成首次设置后,生成新报告很简单:
- 跳过步骤 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 密钥)并且它的状态不是已过期。在您的 Zonos 仪表板中导航到设置 -> 集成以验证您的密钥状态。
没有订单出现
尽管提供了有效的 Secret GraphQL API 密钥,但仍未填充任何订单。
修复:此报告仅为具有包含性定价属性的订单生成数据。如果您的项目不包含 reverseAmountDetail 字段,它们将不会包括在内。验证您在选择的日期范围内处理过包含性定价订单。
导出包含性定价报告
使用 Google 表格生成项目级包含性定价明细。
包含性定价报告模板是一个 Google 表格,具有内置脚本,可以查询 Zonos GraphQL API 获取您的订单,并生成显示包含性定价订单中项目级别的基础金额和包含性金额细目的报告。这对于想要了解关税、税费和费用如何分配到包含性定价订单中的项目的任何商家都很有用。