API
订单EGD担保校验
更新时间： 2020-12-23 15:36:27 访问次数：5577
接口说明
该接口提供给第三方平台和卖家自有系统，用于校验ebay订单：
1.是否为EGD订单
2.是否Winit担保
3.当前尾程派送服务是否可用
4.获取推荐可用尾程派送服务
接口英文名
winit.tools.product.recommend
使用场景
卖家使用WINIT海外仓，使用该接口进行校验，确认ebay订单是否为eGD订单、WINIT担保订单。若WINIT担保订单由于WINIT或者WINIT供应商原因未在承诺的GDD时效内送达（不包括恶劣天气因素和乙方原因导致的迟延），且卖家被买家要求赔偿时，WINIT可提供相应的赔偿。
备注
images
请求说明
| URL | https://openapi.winit.com.cn/openapi/service |
| 接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
| 验证方法 | Token,md5 |
| 格式 | json |
| 字符编码 | UTF-8 |
| http请求方式 | http |
| 请求数限制 | 默认每分钟1000，有需要可申请加大。 |
请求入参
当入参validationType 为EGD_ONLY或者 EBAY_ONLY或者ALL时必填
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| sellerID | String(128) | O | 卖家编码 第三方平台卖家编码（比如：ebay卖家ID） 当入参validationType 为EGD_ONLY或者 EBAY_ONLY或者ALL时必填 |
|
| validationType | String(100) | Y | 校验类型
类型包括： EGD_ONLY, EBAY_ONLY, USABLE_P_ONLY, ALL。 目前只支持：EGD_ONLY, EBAY_ONLY |
|
| warehouseCode | String(128) | Y | 发货仓库编码
通过接口queryWarehouse查询得到出参：warehouseCode |
US001 |
| winitProductCode | String(128) | O | Winit产品编码
通过查询通过接口winitProductCode查询出参中的deliveryID |
OSF810595 |
| --|specification | String(128) | N | 商品规格 | |
| --|qty | Integer(8) | Y | 下单数量
大于0的整数 |
|
| --|eBayTransactionID | String(128) | N | ebay交易ID
validationType 为EGD_ONLY或者EBAY_ONLY或者ALL时，至少存在一条sku信息同时填写eBayTransactionID与eBayItemID |
|
| --|eBayItemID | String(128) | N | ebay商品ID
validationType 为EGD_ONLY或者EBAY_ONLY或者ALL时，至少存在一条sku信息同时填写eBayTransactionID与eBayItemID |
|
| salesAmount | BigDecimal（6,2） | N | 销售金额
限制0.01-999999.99 |
|
| currency | String(128) | N | 销售金额币种 | |
| receiverAddress | Object | Y | 收件人地址,以下为子节点 | |
| --|name | String(128) | Y | 收件人 | |
| --|phone | String(128) | N | 电话 | |
| String(128) | N | 邮箱 | ||
| --|addressLine1 | String(128) | Y | 收件人地址1 | |
| --|addressLine2 | String(128) | N | 收件人地址2 | |
| --|City | String(128) | Y | 收件人城市 | |
| --|State | String(128) | N | 收件人州 | |
| --|Country | String(128) | Y | 收件人国家 | |
| --|postcode | String(128) | Y | 收件人邮编 |
请求示例
{
"action": "winit.tools.product.recommend",
"app_key": "rebecca",
"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign": "5809C9C3768822FD47B2B028702448A2",
"data": {
"parcels": [
{
"merchandiseInfos": [
{
"SKU": "auto_sku_001",
"eBayItemID": "453344422344",
"eBayTransactionID": "224644422388",
"qty": "1",
"specification": ""
}
]
}
],
"salesAmount": "10000",
"currency": "USD",
"receiverAddress": {
"addressLine1": "1 TEST Road",
"addressLine2": "",
"city": "LA",
"country": "US",
"email": "winit_test@winit.com.cn",
"name": "Winit Tester",
"phone": "01977 123433",
"postCode": " 90001",
"state": "CA"
},
"sellerID": "ebay_testID",
"validationType": "EGD_ONLY",
"warehouseCode": "US0001",
"winitProductCode": "OSF810595"
},
"format": "json",
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "E92D050531DE0D1D5D675855A47874B5",
"sign_method": "md5",
"timestamp": "2017-07-12 11:41:53",
"version": "1.0"
}
返回出参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| isEbayOrder | Char(1) | Y | 是否Ebay订单 | 返回Y/N |
| isEGDOrder | Char(1) | Y | 是否EGD订单 | 返回Y/N |
| isGuarantee | Char(1) | Y | 是否担保 | 返回Y/N |
| Reason | String(255) | Y | 结果说明,返回校验结果说明 | |
| currentProduct | Object | 当前输入winit产品,以下为子节点 | ||
| --|winitProductCode | String(255) | Y | 产品编码 | 返回输入的winit产品编码 |
| --|isUsable | Char(1) | Y | 产品是否可用 | 返回Y/N |
| --|productDesc | String(255) | Y | 产品校验描述 | 返回产品是否可用描述 |
| --|estimateDeliveryDate | Date | Y | 产品预计送达时间 | 预计送达时间,暂未实现 |
| --|estimateFee | BigDecimal(16,4) | Y | 产品费用预估 | |
| Currency | String(3) | Y | 产品费用预估币种 | 币种ISO编码 |
| recomendProduct | List | Y | 推荐产品列表 | 预留参数，暂未实现 |
| unavailableProduct | List | Y | 不可用产品列表 | 预留参数，暂未实现 |
返回示例
{
"code": "0",
"msg": "操作成功",
"data": {
"reason": null,
"isGuarantee": null,
"estimateCompleteDate": null,
"unavailableProduct": [],
"isEGDOrder": "N",
"recomendProduct": [],
"isEbayOrder": "N",
"currentProduct": {
"productDesc": null,
"isUsable": "Y",
"estimateDeliveryDate": null,
"winitProductCode": "OSF810595",
"estimateFee": 11.38,
"currency": "USD"
}
}
}
