API
- OpenAPI(Winit) 概述
- 海外仓(OSWH) API接口
- ISP全球直发快递API
- 海外仓API(OSWH)
- 海外仓-商品
- 海外仓-入库
- 海外仓-出库
- 海外仓出库API对接时序
- WO01.仓库代码查询
- WO02.海外仓总库存查询
- WO03.派送方式查询
- WO05.预估派送费用查询(新)
- WO05.预估派送费用查询
- WO06.德国地址校验接口
- WO07.创建海外仓出库单(确认中)
- WO08-1.创建海外仓出库单(草稿)
- WO08-2.提交作废海外仓出库单
- WO08.修改海外仓出库单
- WO09.修改出库单商品信息
- WO10.出库单列表查询
- WO11.海外仓出库单查询
- WO12-1.轨迹查询(库内+尾程派送)
- WO12.轨迹查询(库内)
- WO13.海外仓库存DOI查询
- WO13-1.查询DOI库存详情
- WO05-1.预计运费-新
- WO06-1.EGD订单担保校验接口
- 海外仓出库API列表
- 尾程派送方式代码
- 万邑邮选API(ISP)
WO06-1.EGD订单担保校验接口
更新时间: 2017-11-22 17:16:09 访问次数:711
接口说明
该接口提供给第三方平台和卖家自有系统,用于校验ebay订单: 1.是否为EGD订单 2.是否Winit担保 3.当前尾程派送服务是否可用 4.获取推荐可用尾程派送服务
使用场景
卖家使用WINIT海外仓,使用该接口进行校验,确认ebay订单是否为eGD订单、WINIT担保订单。若WINIT担保订单由于WINIT或者WINIT供应商原因未在承诺的GDD时效内送达(不包括恶劣天气因素和乙方原因导致的迟延),且卖家被买家要求赔偿时,WINIT可提供相应的赔偿。
备注
images
请求说明
URL | http://api.winit.com.cn/ADInterface/api |
接口测试 | http://erp.sandbox.winit.com.cn/ADInterface/api |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
sellerID | String(128) | 是(validationType 为EGD_ONLY, EBAY_ONLY,ALL时必填) | 卖家编码,第三方平台卖家编码(比如:ebay卖家ID) | |
validationType | String(100) | Y | 校验类型 | 类型包括: EGD_ONLY, EBAY_ONLY, USABLE_P_ONLY, ALL。 目前只支持:EGD_ONLY, EBAY_ONLY |
warehouseCode | String(128) | Y | 发货仓库编码 | 调用【WO01.仓库代码查询】接口获取,返回数据中“warehouseCode”,例:US001 |
winitProductCode | String(128) | 是(validationType 为EGD_ONLY, EBAY_ONLY,ALL时必填) | Winit产品编码 | 调用【WO03.派送方式查询】接口获取,返回数据中“winitProductCode” |
--|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 | ebya商品ID | validationType 为EGD_ONLY, EBAY_ONLY,ALL时,至少存在一条sku信息同时填写eBayTransactionID与eBayItemID |
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", "data": { "parcels": [ { "merchandiseInfos": [ { "SKU": "TEST_SKU1", "eBayItemID": "453344422344", "eBayTransactionID": "224644422388", "qty": "1", "specification": "TEST" } ] } ], "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": "OSF810001" }, "format": "json", "language": "zh_CN", "platform": "sw", "sign": "00000000000000000000000000000000", "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": { "recomendProduct": [], "reason": null, "unavailableProduct": [], "isGuarantee": null, "isEGDOrder": "N", "currentProduct": { "productDesc": "查询winit产品异常:产品编码:OSF810001,对应的产品信息不存在", "isUsable": "N", "estimateDeliveryDate": null, "estimateFee": null, "winitProductCode": "OSF810001", "currency": null }, "isEbayOrder": "N" } }