万邑通开发者网站 - WO06-1.EGD订单担保校验接口

API

WO06-1.EGD订单担保校验接口

更新时间： 2017-11-22 17:16:09 访问次数：820

接口说明

该接口提供给第三方平台和卖家自有系统，用于校验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	电话
--\|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	收件人邮编

请求示例

Json
XML

{
    "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	不可用产品列表	预留参数，暂未实现

返回示例

Json
XML

{
   "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"
   }
}

关键词

WO06-1.EGD订单担保校验接口