API
订单EGD担保校验
更新时间: 2019-11-24 17:58:01 访问次数:2885
接口说明

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

接口英文名

winit.tools.product.recommend

使用场景

卖家使用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,有需要可申请加大。
请求入参

当入参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
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": "0A33EE4CAB8626817D5B40B896AB75BD",
    "data": {
        "parcels": [
            {
                "merchandiseInfos": [
                    {
                        "SKU": "auto_sku_001",
                        "eBayItemID": "453344422344",
                        "eBayTransactionID": "224644422388",
                        "qty": "1",
                        "specification": ""
                    }
                ]
            }
        ],
        "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": "1D4043827E23B81811A7BD4F01E3F4B7",
    "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"
        }
    }
}