z-country-change
每次更改国家时，包括初始国家选择时，此事件将被触发。事件的 detail 属性将是一个包含 code 和 name 的对象。
| 属性 | 描述 |
|---|---|
code | 产品来源国家的两位字符 ISO 代码 |
name | 国家名称 |
Hello 集成脚本
1
2
3
4
{
"code": "US",
"name": "United States"
}
z-duty-tax-quote
此事件将在收到关税和税费报价响应时触发。事件 detail 属性将是一个具有以下属性的对象：
| 属性 | 描述 |
|---|---|
subtotal | 报价所基于的商品小计 |
taxOrVat | 根据小计报价的估计销售税或增值税金额 |
dutyTotal | 根据小计报价的估计关税金额 |
dutyTaxTotal | taxOrVat 和 dutyTotal 的合计值 |
foreign (premium) | 一个包含上述相同值的对象，然后转换为外币金额 |
Hello 集成脚本
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"subtotal": 89.99,
"taxOrVat": 18.0,
"dutyTotal": 32.54,
"dutyTaxTotal": 50.54,
"foreign": {
"currencyCode": "GBP",
"subtotal": 89.99,
"taxOrVat": 18.0,
"dutyTotal": 32.54,
"dutyTaxTotal": 50.54
}
}
z-message-change
每次显示的 Hello 消息更改时，此事件将触发。事件的 detail 属性将是一个包含 message 的对象。
| 属性 | 描述 |
|---|---|
message | 当前显示消息的 Html 字符串 |
Hello 集成脚本
1
2
3
{
"message": "<div>Welcome ...</div>"
}
方法
以下是您可以用来与您的网站集成的实用方法。
| 方法 | 返回 | 描述 |
|---|---|---|
zonos.isDomestic() | 布尔值 | 如果当前国家是国内，则返回真 |
zonos.country() | 字符串 | 获取当前选择的国家代码。 |
zonos.country(code) | 字符串 | 手动设置国家并返回。code 应为两个字符的 ISO 代码。 |
zonos.config(object) 是由 Hello 使用的方法。它可以设置为用于估算报价、转换货币或重新显示 Hello 启动 screen 并移动标志位置。根据您想要执行的操作，发送给 config 的对象会有所不同：
| 任务 | 用对象填充配置，如… |
|---|---|
| 估算报价 | {detail: {items: [{id: "字符串", name: "字符串", price: 双精度 / "字符串", quantity: 整数 / "字符串", image: "字符串 图片的 URL / 可选", hsCode: "字符串 / 可选", category: "字符串 / 可选", country: "字符串（原产国）/ 可选", SKU: "字符串 / 可选"}], currencyCode: "字符串 / 可选，默认为 USD", includedTaxRate: 双精度 / 可选，默认为 0}} |
| 转换货币 | {detail: {currencySelectors: ["css 选择器 1", "css 选择器 2"], customConverter: "自定义函数以转换选择器 / 可选，最好保持默认", showDecimal: 布尔值 / 可选}} |
| 重新显示 Hello 启动 screen 并移动标志位置 | {detail: {location: "字符串，选项为：left, right, top, bottom, floating & attached / 可选", showSplash: 布尔值 / 可选}} |
Hello 事件
如何使用 Hello 事件。了解 Zonos Hello 如何使用事件和方法，以及您如何利用这些来增强您的电子商务网站。