API
订单EGD担保校验
更新时间: 2020-12-23 15:36:27 访问次数:6015
接口说明
该接口提供给第三方平台和卖家自有系统,用于校验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" } } }