属性
请求正文中的JSON键值对
POST https://api.iglobalstores.com/v1/createTempCart
| 字段↕ | 备注↕ |
|---|---|
boxCount | 示例值: 22x15x15(1),8x8x4(2),32x22x14(1) 格式: 逗号分隔的箱子尺寸和数量列表。在上面的例子中，总共有4个箱子。列表中的第一个箱子将是22英寸长、15英寸宽、15英寸高。只有一个箱子会用于该尺寸。会有两个箱子的尺寸为: 8x8x4英寸。如果对您来说很容易，可以传递相同的箱子尺寸多次，例如："22x15x15(1),22x15x15(1)"，这意味着2个尺寸为22x15x15英寸的箱子。此字段描述将用于运送订单的箱子。在订单时间，商家不一定需要知道这一点；但是，如果已知，可以以 string 格式传递。 |
contShoppingURL | 此字段用于传递URL以覆盖Zonos Checkout内部"继续购物"按钮的HREF。 string |
domesticShippingCharge | 此字段用于将国内运费传递给Zonos Checkout，该金额将添加到运费中。可以配置为添加运费总额或作为单独的行项目列出。 正浮点数，两位小数 |
externalConfirmationPageURL | 此字段用于传递您的订单确认/感谢页面的URL。客户在Zonos Checkout内完成付款后，将被重定向到此URL以进行订单确认。此URL经常用于触发对Zonos "orderDetail" API服务端点的调用，以检索订单详情并将订单导入系统。 string |
footerHTML | 此字段用于传递URL编码的HTML字符串。此HTML字符串将被解码并放置在结账页面的关闭body标签之前。通常用于传递重新营销、分析等的代码。 URL编码字符串 |
items REQUIRED | 此字段是项目映射的列表。 JSON string |
items[index].countryOfOrigin | 此字段用于传递项目原产国。参数必须是国家两字母ISO代码。 string |
items[index].description REQUIRED | 此字段用于传递购物车行项目的完整项目描述，包括任何项目选项、颜色等。 string |
items[index].height | 此字段用于传递项目高度，强烈建议用于获得准确的运费报价。高度单位为 REQUIRED string - 正浮点数，两位小数 / 整数（英寸） |
items[index].imageURL REQUIRED | 此字段用于传递项目产品图像的URL。URL必须是HTTPS才能在Zonos Checkout内显示。 string / HTTPS URL |
items[index]itemBrand | 此字段用于传递项目品牌 string |
items[index]itemCategory | 此字段用于传递项目类别，如果项目有多个类别，可以用管道符分隔传递。 示例值: "shoes"或"shoes|sport-shoes|discount-shoes" string` |
items[index]itemCustomization | 此字段用于传递未在Zonos Checkout中显示的有关项目的其他详情；但是，可以通过"orderDetail" API服务端点检索。 |
items[index]itemHSCode | 此字段用于传递项目HS代码，可以有或没有句号。 示例值: "3926901000"或"3926.90.1000" string` |
items[index].itemURL | 此字段用于传递项目产品页面的URL。 string / URL |
items[index].length | 此字段用于传递项目长度，强烈建议用于获得准确的运费报价。长度单位为 REQUIRED string - 正浮点数，两位小数 / 整数（英寸） |
items[index].nonShippable | 此字段用于指示项目是否应包含在运费、关税和税款计算中。数字下载、折扣代码、处理费等应以"true"值传递。 boolean: true或false |
items[index].productId | 此字段用于传递行项目数量。 string |
items[index].quantity REQUIRED | 此字段用于传递行项目数量。 string |
items[index].sku | 此字段用于传递项目SKU / UPC /等。 string |
items[index].unitPrice REQUIRED | 此字段用于传递行项目单价。 正浮点数，两位小数 / 整数 |
items[index].weight | 此字段用于传递项目重量，强烈建议用于获得准确的运费报价。重量单位默认为"LBS"，除非在 items[index].itemWeightUnits 中传递了另一个重量单位 string - 正浮点数，两位小数 / 整数 |
items[index].weightUnits | 此字段用于覆盖默认的项目重量单位。项目重量单位默认为"LBS"，除非在此字段中传递了另一个重量单位。 string - "LB"、"OZ"、"KG"或"G" |
items[index].width | 此字段用于传递项目宽度，强烈建议用于获得准确的运费报价。宽度单位为 REQUIRED string - 正浮点数，两位小数 / 整数（英寸） |
misc1 - misc6 | 此字段用于传递与订单相关的杂项数据，通过Zonos API与从Zonos "orderDetail" API服务端点返回的订单数据一起检索。 string |
referenceId | 此字段用于为您系统中的购物车/会话/等传递唯一的参考标识值。这可用于通过Zonos "orderDetail" API服务端点查找Zonos订单ID。 string |
storeId REQUIRED | 由Zonos提供的商店ID。 integer |
其他字符串数据类型
items[index].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[index].itemMaterial
折扣、优惠券和促销代码
要通过服务器post将折扣、优惠券和促销代码发送到Zonos，必须以单独的项目形式传递，对于参数 "unitPrice" 和 "nonShippable":true 使用负值。
1
{2
"description": "Discount (10OFF) - 10% OFF",3
"unitPrice": -15.5,4
"quantity": 1,5
"nonShippable": true6
}HTTPS响应
成功的HTTP响应
消息格式: JSON
1
{2
"tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"3
}响应JSON定义
| 字段↕ | 备注↕ |
|---|---|
tempCartUUID | 此参数将包含分配给您客户的国际购物车的GUID，并在Zonos系统中创建。此字段将通过URL查询 string 参数传递，同时将用户的浏览器重定向到Zonos Checkout。 |
错误HTTP响应
| 错误代码↕ | 含义↕ |
|---|---|
| 400 | 请求正文中出现意外字符。 |
| 406 | 不可接受。HTTP标头"Accept"无效。 |
| 415 | 不支持的媒体类型。HTTP标头"Content-Type"无效。 |
| 422 | 无法处理的实体。 |
| 500 | "storeId"不正确或JSON正文无法解析。 |
1
2
3
4
5
6
7
Error 422 Unprocessable Entity 8
9
10
11
12
13
HTTP ERROR 422
14
15
16
Problem accessing /v2/createTempCart. Reason:17
Unprocessable Entity
18
19
20
21
The request entity had the following errors:
22
23
24
25
items may not be empty (was null) 26
27
items may not be null (was null) 28
29
30
31
32
33
重定向到Zonos Checkout
收到包含 tempCartUUID 的成功响应后，您的服务器将从客户的浏览器发送重定向到Zonos Checkout，并使用下面涵盖的适当URL查询字符串参数。
重定向URL示例: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA
注意: [yourassignedsubdomain] - 联系您的Zonos实施团队成员以接收您的Zonos.com子域。
URL请求参数
| 字段↕ | 备注↕ |
|---|---|
tempCartUUID REQUIRED | 此值通过调用Zonos createTempCart API服务端点获得。 string / GUID |
country | 目标国家的两字母ISO代码。我们强烈建议传递此参数以获得最佳用户体验。 country 参数将在Zonos Checkout内预选目标国家。使用Zonos Hello JS（JavaScript）在网站上时，您可以通过调用JavaScript方法获得此值: zonos.country()。 string （长度: 2） |
其他字符串数据类型
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZip
创建结账
探索创建结账所涉及的关键/值对。
此API端点用于向Zonos API发送来自客户购物车的购物车信息和项目。
您将收到一个JSON响应，其中包含一个
tempCartUUID，这是Zonos系统中的唯一购物车标识符。这将用于将客户重定向到Zonos Checkout以完成订单。