API
订单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 电话
–|email 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客制包装时,必填

请求示例

  1. {
  2. "action": "winit.tools.product.recommend",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "5809C9C3768822FD47B2B028702448A2",
  6. "data": {
  7. "parcels": [
  8. {
  9. "merchandiseInfos": [
  10. {
  11. "SKU": "auto_sku_001",
  12. "eBayItemID": "453344422344",
  13. "eBayTransactionID": "224644422388",
  14. "qty": "1",
  15. "specification": ""
  16. }
  17. ]
  18. }
  19. ],
  20. "salesAmount": "10000",
  21. "currency": "USD",
  22. "receiverAddress": {
  23. "addressLine1": "1 TEST Road",
  24. "addressLine2": "",
  25. "city": "LA",
  26. "country": "US",
  27. "email": "winit_test@winit.com.cn",
  28. "name": "Winit Tester",
  29. "phone": "01977 123433",
  30. "postCode": " 90001",
  31. "state": "CA"
  32. },
  33. "sellerID": "ebay_testID",
  34. "validationType": "EGD_ONLY",
  35. "warehouseCode": "US0001",
  36. "winitProductCode": "OSF810595"
  37. },
  38. "format": "json",
  39. "language": "zh_CN",
  40. "platform": "OWNERERP",
  41. "sign": "E92D050531DE0D1D5D675855A47874B5",
  42. "sign_method": "md5",
  43. "timestamp": "2017-07-12 11:41:53",
  44. "version": "1.0"
  45. }

1、带包材信息

  1. {
  2. "action": "winit.tools.product.recommend",
  3. "app_key": "rebecca",
  4. "client_id": "",
  5. "client_sign": "",
  6. "data": {
  7. "parcels": [
  8. {
  9. "merchandiseInfos": [
  10. {
  11. "SKU": "auto_picking_001",
  12. "eBayItemID": "453344422344",
  13. "eBayTransactionID": "224644422388",
  14. "qty": "1",
  15. "specification": ""
  16. }
  17. ]
  18. }
  19. ],
  20. "VASList": [
  21. {
  22. "attrList": [
  23. {
  24. "attrCode": "PACKAGE_MODE",
  25. "attrValue": "PACKAGING_CUSTOMER"
  26. },
  27. {
  28. "attrCode": "PACKAGE_TYPE_MATERIAL",
  29. "attrValue": "CARTON_BOX"
  30. },
  31. {
  32. "attrCode": "PACKAGE_MERCHANDISE_CODE",
  33. "attrValue": "custom_medium_paper_20"
  34. }
  35. ],
  36. "serviceCode": "OSF24WW008"
  37. }
  38. ],
  39. "salesAmount": "",
  40. "currency": "USD",
  41. "receiverAddress": {
  42. "addressLine1": "1 TEST Road",
  43. "addressLine2": "",
  44. "city": "mayo",
  45. "country": "US",
  46. "email": "winit_test@winit.com.cn",
  47. "name": "Winit Tester",
  48. "phone": "01977 123433",
  49. "postCode": " 32066",
  50. "state": "FL"
  51. },
  52. "sellerID": "ebay_testID",
  53. "validationType": "EGD_ONLY",
  54. "warehouseCode": "US0001",
  55. "winitProductCode": "OSF811007043",
  56. },
  57. "format": "json",
  58. "language": "zh_CN",
  59. "platform": "OWNERERP",
  60. "sign": "00000000000000000000000000000000",
  61. "sign_method": "md5",
  62. "timestamp": "2023-06-02 10:31:45",
  63. "version": "1.0"
  64. }

返回出参

名称 类型 必传 说明 示例
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 不可用产品列表 预留参数,暂未实现

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "reason": null,
  6. "isGuarantee": null,
  7. "estimateCompleteDate": null,
  8. "unavailableProduct": [],
  9. "isEGDOrder": "N",
  10. "recomendProduct": [],
  11. "isEbayOrder": "N",
  12. "currentProduct": {
  13. "productDesc": null,
  14. "isUsable": "Y",
  15. "estimateDeliveryDate": null,
  16. "winitProductCode": "OSF810595",
  17. "estimateFee": 11.38,
  18. "currency": "USD"
  19. }
  20. }
  21. }