订单EGD担保校验
更新时间: 2020-12-23 15:36:27 访问次数:9122
接口说明
该接口提供给第三方平台和卖家自有系统,用于校验ebay订单:
1.是否为EGD订单
2.是否Winit担保
3.当前尾程派送服务是否可用
4.获取推荐可用尾程派送服务
使用场景
卖家使用WINIT海外仓,使用该接口进行校验,确认ebay订单是否为eGD订单、WINIT担保订单。
若WINIT担保订单由于WINIT或者WINIT供应商原因未在承诺的时效内送达(不包括恶劣天气因素和乙方原因导致的迟延),且卖家被买家要求赔偿时,WINIT可提供相应的赔偿。
接口名称
winit.tools.product.recommend
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
validationType | String(100) | Y | 校验类型 EGD_ONLY, EBAY_ONLY, USABLE_P_ONLY, ALL。 目前只支持:EGD_ONLY, EBAY_ONLY |
|
sellerID | String(128) | O | 卖家编码 第三方平台卖家编码(比如:ebay卖家ID) 当入参validationType 为EGD_ONLY或者 EBAY_ONLY或者ALL时必填 |
|
winitProductCode | String(128) | O | Winit产品编码 通过查询通过接口winitProductCode查询出参中的deliveryID 当入参validationType 为EGD_ONLY或者 EBAY_ONLY或者ALL时必填 当入参validationType 为USABLE_P_ONLY,预估所有Winit产品的费用 |
OSF810595 |
warehouseCode | String(128) | Y | 发货仓库编码 通过接口queryWarehouse查询得到出参:warehouseCode |
US001 |
–|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 | 收件人地址list | |
–|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 | 收件人邮编 | |
VASList | Object | N | 增值服务列表VASList | |
–|serviceCode | String() | O | 增值服务编码 | OSF24WW008 |
–|attrList | Object | O | 增值服务明细信息VASList.attrList | |
–|–|attrCode | String() | O | 增值服务属性code | PACKAGE_MODE |
–|–|attrValue | String() | O | 增值服务值 | PACKAGING_CUSTOMER |
增值服务:订单包装方式入参
attrCode | attrValue | 说明 |
---|---|---|
PACKAGE_MODE,订单包装方式 | PACKAGING_WINIT,WINIT标准包装 PACKAGING_CUSTOM,客制包装 CUSTOM_LOGISTICS,WINIT标准&客制包装 NO,无包装 |
必填 |
PACKAGE_TYPE_MATERIAL,包材类型 | COURIER_SATCHEL,快递袋 PADDED_ENVELOPE,气泡袋 CARTON_BOX,纸箱 NO,无包装 |
当PACKAGE_MODE为PACKAGING_CUSTOM客制包装时,必填 |
PACKAGE_MERCHANDISE_CODE,包材商品编码 | 指定包材出库商品编码 | 当PACKAGE_MODE为PACKAGING_CUSTOM客制包装时,必填 |
请求示例
{
"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"
}
1、带包材信息
{
"action": "winit.tools.product.recommend",
"app_key": "rebecca",
"client_id": "",
"client_sign": "",
"data": {
"parcels": [
{
"merchandiseInfos": [
{
"SKU": "auto_picking_001",
"eBayItemID": "453344422344",
"eBayTransactionID": "224644422388",
"qty": "1",
"specification": ""
}
]
}
],
"VASList": [
{
"attrList": [
{
"attrCode": "PACKAGE_MODE",
"attrValue": "PACKAGING_CUSTOMER"
},
{
"attrCode": "PACKAGE_TYPE_MATERIAL",
"attrValue": "CARTON_BOX"
},
{
"attrCode": "PACKAGE_MERCHANDISE_CODE",
"attrValue": "custom_medium_paper_20"
}
],
"serviceCode": "OSF24WW008"
}
],
"salesAmount": "",
"currency": "USD",
"receiverAddress": {
"addressLine1": "1 TEST Road",
"addressLine2": "",
"city": "mayo",
"country": "US",
"email": "winit_test@winit.com.cn",
"name": "Winit Tester",
"phone": "01977 123433",
"postCode": " 32066",
"state": "FL"
},
"sellerID": "ebay_testID",
"validationType": "EGD_ONLY",
"warehouseCode": "US0001",
"winitProductCode": "OSF811007043",
},
"format": "json",
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2023-06-02 10:31:45",
"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 | Y | 当前输入winit产品list | |
–|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"
}
}
}