接口说明

该接口提供给第三方平台和卖家自有系统，用于校验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客制包装时，必填

请求示例

{
    "action": "winit.tools.product.recommend",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "5809C9C3768822FD47B2B028702448A2",
    "data": {
        "parcels": [
            {
                "merchandiseInfos": [
                    {
                        "SKU": "auto_sku_001",
                        "eBayItemID": "453344422344",
                        "eBayTransactionID": "224644422388",
                        "qty": "1",
                        "specification": ""
                    }
                ]
            }
        ],
        "salesAmount": "10000",
        "currency": "USD",
        "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": "E92D050531DE0D1D5D675855A47874B5",
    "sign_method": "md5",
    "timestamp": "2017-07-12 11:41:53",
    "version": "1.0"
}

1、带包材信息

{
    "action": "winit.tools.product.recommend",
    "app_key": "rebecca",
    "client_id": "",
    "client_sign": "",
    "data": {
        "parcels": [
            {
                "merchandiseInfos": [
                    {
                        "SKU": "auto_picking_001",
                        "eBayItemID": "453344422344",
                        "eBayTransactionID": "224644422388",
                        "qty": "1",
                        "specification": ""
                    }
                ]
            }
        ],
        "VASList": [
        {
            "attrList": [
            {
                "attrCode": "PACKAGE_MODE",             
                "attrValue": "PACKAGING_CUSTOMER"              
            }, 
            {
                "attrCode": "PACKAGE_TYPE_MATERIAL",             
                "attrValue": "CARTON_BOX"            
            }, 
            {
                "attrCode": "PACKAGE_MERCHANDISE_CODE",             
                "attrValue": "custom_medium_paper_20"             
            }
            ],
            "serviceCode": "OSF24WW008"            
        }
        ],
        "salesAmount": "",
        "currency": "USD",
        "receiverAddress": {
            "addressLine1": "1 TEST Road",
            "addressLine2": "",
            "city": "mayo",
            "country": "US",
            "email": "winit_test@winit.com.cn",
            "name": "Winit Tester",
            "phone": "01977 123433",
            "postCode": " 32066",
            "state": "FL"
        },
        "sellerID": "ebay_testID",
        "validationType": "EGD_ONLY",
        "warehouseCode": "US0001",
        "winitProductCode": "OSF811007043",     
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "00000000000000000000000000000000",
    "sign_method": "md5",
    "timestamp": "2023-06-02 10:31:45",
    "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	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	不可用产品列表	预留参数，暂未实现

返回示例

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

关键词

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