API
订单EGD担保校验
更新时间: 2017-11-22 17:16:09 访问次数:2337
接口说明

该接口提供给第三方平台和卖家自有系统,用于校验ebay订单: 1.是否为EGD订单 2.是否Winit担保 3.当前尾程派送服务是否可用 4.获取推荐可用尾程派送服务

使用场景

卖家使用WINIT海外仓,使用该接口进行校验,确认ebay订单是否为eGD订单、WINIT担保订单。若WINIT担保订单由于WINIT或者WINIT供应商原因未在承诺的GDD时效内送达(不包括恶劣天气因素和乙方原因导致的迟延),且卖家被买家要求赔偿时,WINIT可提供相应的赔偿。

备注

images

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 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 收件人邮编
请求示例
{
    "action": "winit.tools.product.recommend",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"38B87482C92FFEF0F10292B7AFA44087",
    "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"
   }
}