- 平台公告
- EGD订单担保校验接口上线通知
- API[getToken]下线通知
- 请求入参数Platfrom规范
- 尾程面单乱码问题通知
- eBay DGM渠道标记名变更通
- 中邮港邮面单更新
- 德国仓库部分商品禁止出库
- 接口返回(code)类型变更说明
- 重要-接口认证方式调整的通知
- 调整头尾程下单海外仓库仓码
- 万邑通精选服务商评选标准调研
- 全球直发快递ISP新增渠道通知
- 关于库存接口调用频率限制的通知
- 开放平台服务商信息完善通知
- 海外仓创建订单接口新增字段说明
- 万邑通WINIT新尾程派送服务上线说明
- 接口字段更新说明[2019-04-01]
- 澳洲MCS上传eBay追踪号及供应商更新说明
- API老系统(ADInterface域名)即将停用通知
- 万邑通应用迁移至华为云网络公测通知
- UK DPD获取跟踪号和面单异常通知
- 万邑通新增ISP专线派送服务通知【2019-07-01】
- 系统服务器停机维护通知
- 接口字段更新说明[2019-07-12]
- 万邑通新增ISP专线派送服务通知【2019-7-17】
- 澳洲出库单地址放开eCP地址限制通知
- ISP-万邑邮选-经济小包系统维护通知
- 万邑通新增ISP专线派送服务通知【2019-09-21】
- LMA获取面单接口增加抓单中状态【2019-9-24】
- 万邑邮选-经济小包渠道供应商系统网络不稳定【2019-9-26】
- 海外仓出库接口phoneNum字段扩展到128位【2019-10-12】
- 海外仓出库接口字段更新说明[2019-11-18]
- 关于升级OpenAPI的V2.0授权的通知
- 全球直发接口增加收件人税号recipientTaxID【2020-01-03】
- 库存查询接口说明
- 尾程派送渠道4月13日针对收件人门牌号及其字段校验变更
- 优化门牌号截取【2020-05-21】
- 海外仓部分尾程产品服务商及追踪号上传规则变更通知【2020-6-15】
- 海外仓出库单的增值服务费用金额范围变更
- 沙箱环境版本更新通知【2020-8-5】
- 门牌号截取服务升级
- 开发者网站停机维护(无法访问官网)【2020-9-12】
- 脱欧政策相关API变更【2020-12-22】
- 库存查询相关接口变更【2021-1-27】
- ISP新增发件人VATNO和EORI【2021-3-4】
- 支持欧盟7月1日税改增加IOSS字段传输【6-28】
- 英国新增UKBM仓库及其服务[2021-7-12]
- 开发平台请求升级为https[2021-8-6]
- 入库出库退货接口变更和停用http的通知【2021-9-30】
- 更换沙箱环境调用URL【2021-11-1】
- 新增入库单作废接口【2021-11-18】
- 【2021-11-30】winit在2021年12月6日更改沙箱环境的网址
- 关于openapi升级安全能力的通知
- 【2022-02-17】注册查询商品接口变更通知
- 【2022-02-25】查询入库单详情接口变更通知
- 【2022-05-12】入库单状态变化通知
- 【2022-07-18】Winit开通加拿大仓(CATO)通知
- 【2023-03-14】沙箱自动测试工具上线
- 重要:沙箱环境维护通知
- 基础文档
- ERP授权操作指引
- 常见问题
调用Winit API时,需使用到两个签名串:
- 用户签名“sign”:用于标识万邑联账户/卖家;
- 应用签名“client_sign”:配合使用基础参数“platform”,即创建应用时填写的“应用code”用于标识应用。
签名拼接方法
用户签名,基础参数:sign
按字段名的字母顺序拼接(包括data中的json字符串也按此规则),将token放在字符串的两端并md5加密
用户签名串 = token + action + actionValue + app_key + app_keyValue + data + dataValue + format + formatValue + platform + platformValue + sign_method + sign_methodValue + timestamp + timestampValue + version+ versionValue + token
对以上拼接后的签名串进行MD5运算,并转换成大写的32位签名。
用户签名sign = toUpperCase(MD5(用户签名串)
注:token是由客户/卖家 登陆万邑联->个人中心->获取token,直接可以在万邑联系统后台获得。
应用签名,基础参数:client_sign
按字段名的字母顺序拼接(包括data中的json字符串也按此规则),将client_secret放在字符串的两端
应用签名串 = client_secret + action + actionValue + app_key + app_keyValue + data + dataValue + format + formatValue + platform + platformValue + sign_method + sign_methodValue + timestamp + timestampValue + version+ versionValue + client_secret
对以上拼接后的签名串进行MD5运算,并转换成大写的32位签名。
应用签名client_sign = toUpperCase(MD5(应用签名串))
注:client_secret是由开发者登陆开发者控制台,创建应用时生成,请参照《开发者控制台 操作手册》
示例
{
"action":"createOutboundOrder",
"app_key":"rebecca",
"client_id":"NGRKYWY2YJITYTE2NY00YTBLLWE4YZITYWMWYJEZN2YXMWVK",
"client_sign":"38B87482C92FFEF0F10292B7AFA44087",
"data":{
"address1":"1 Stafford Crt.",
"address2":"aaaaaaa",
"city":"Bayswater North",
"deliveryWayID":"1010520",
"eBayOrderID":"3298473480",
"emailAddress":"abc@winit.com",
"fromBpartnerId":"111",
"insuranceTypeID":1000000,
"isShareOrder":"N",
"phoneNum":"15900001111",
"productList":[
{
"eBayBuyerID":"98877456rere",
"eBayItemID":"3434245",
"eBaySellerID":"99887rtrtr66123",
"eBayTransactionID":"24377766",
"productCode":"LCD-IP4-01",
"productNum":"1",
"specification":""
}
],
"recipientName":"mingbao",
"region":"WV",
"repeatable":"Y",
"sellerOrderNo":"PowerSellerABC123",
"state":"US",
"warehouseID":1000008,
"zipCode":"25085"
},
"format":"json",
"language":"zh_CN",
"platform":"SELLERERP",
"sign":"090C13832E59BD50543DAD0ACB4E5B6E",
"sign_method":"md5",
"timestamp":"2016-06-16 00:19:26",
"version":"1.0"
}
用户签名sign:
89435277FA3BA272DE795559998E-
actioncreateOutboundOrderapp_keyrebeccadata
{
"address1": "1 Stafford Crt.",
"address2": "aaaaaaa",
"city": "Bayswater North",
"deliveryWayID": "1010520",
"eBayOrderID": "3298473480",
"emailAddress": "abc@winit.com",
"insuranceTypeID": 1000000,
"phoneNum": "15900001111",
"productList": [
{
"eBayBuyerID": "98877456rere",
"eBayItemID": "3434245",
"eBaySellerID": "99887rtrtr66123",
"eBayTransactionID": "24377766",
"productCode": "LCD-IP4-01",
"productNum": "1",
"specification": ""
}
],
"recipientName": "mingbao",
"region": "WV",
"repeatable": "Y",
"sellerOrderNo": "PowerSellerABC123",
"state": "US",
"warehouseID": 1000008,
"zipCode": "25085",
"isShareOrder": "N",
"fromBpartnerId": "111"
}
formatjsonplatformSELLERERPsign_methodmd5timestamp2016-06-16 00:19:26version1.0
89435277FA3BA272DE795559998E-
应用签名client_sign:
YME1MJQ0ZMUTMTNMZC00YTDMLWEWM2QTNMY1MDC3OWNJYZQ2MZE0NTKYNZE1MJUWNZE5
actioncreateOutboundOrderapp_keyrebeccadata
{
"address1": "1 Stafford Crt.",
"address2": "aaaaaaa",
"city": "Bayswater North",
"deliveryWayID": "1010520",
"eBayOrderID": "3298473480",
"emailAddress": "abc@winit.com",
"insuranceTypeID": 1000000,
"phoneNum": "15900001111",
"productList": [
{
"eBayBuyerID": "98877456rere",
"eBayItemID": "3434245",
"eBaySellerID": "99887rtrtr66123",
"eBayTransactionID": "24377766",
"productCode": "LCD-IP4-01",
"productNum": "1",
"specification": ""
}
],
"recipientName": "mingbao",
"region": "WV",
"repeatable": "Y",
"sellerOrderNo": "PowerSellerABC123",
"state": "US",
"warehouseID": 1000008,
"zipCode": "25085",
"isShareOrder": "N",
"fromBpartnerId": "111"
}
formatjsonplatformSELLERERPsign_methodmd5timestamp2016-06-16 00:19:26version1.0
YME1MJQ0ZMUTMTNMZC00YTDMLWEWM2QTNMY1MDC3OWNJYZQ2MZE0NTKYNZE1MJUWNZE5
签名认证工具
您可以点击签名认证工具使用认证工具验证您的签名是否正确
特别说明
生成签名时需要注意一下几点:
- 签名时参数必须按字母顺序从小到大排序(字典序);
- 如果参数的值为空不参与签名,如JAVA中参数值为null的,不会参与签名(”” 与 ‘’ 认 为非空,需要参与签名);
- 参数名区分大小写;
- 在向WINIT发送HTTP请求时必须使用正确的编码格式(默认UTF-8)