文档中心
- 平台公告
- 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授权操作指引
- 常见问题
创建开放应用及卖家授权
更新时间: 2018-01-25 18:37:50 访问次数:16057
基于Oauth2.0认证机制,您使用万邑通(Winit)开放平台(developer.winit.com.cn)物流接口需注册开发者账户,登陆开发者控制台可创建 “应用”来管理您系统上绑定的万邑通账户和获得的授权。
通过本操作您可以获取接口调用时需要的:
- client_id
- client_secret(需要使用该值计算出API的client_sign参数值)
- appkey(万邑联账户/卖家账户登录邮箱,username也叫account)
- token(授权码,需要使用该值计算出API的sign参数值)
- platform
说明:
- 1.通俗的理解”应用”是指您的ERP系统(可依版本或不同系统来创建不同的应用),创建应用会对应生成client_id和client_secret,并获得一个授权链接。
- 2.使用您的ERP系统(应用)的卖家(或称万邑联账户)将通过“授权链接”进行万邑联账户权限授权。
- 3.授权后您的ERP系统(应用)将获得客户的access_token/token码(有时效限制),获取到授权码(token)即具备访问物流接口和万邑联账户数据的权限。
创建应用
1.访问开发者网站,在页面导航栏中点击“登陆”,进入登陆页面。去登录
2.填写已注册的开发者账户或使用万邑联账户和密码,并正确填写“验证码”,之后点击【登录】。
3.登录后,进入开发者控制台,进入我的应用菜单,
首先创建应用,点击右侧页面中的【添加】,弹出新增应用的窗口,依次填写应用所需信息,点击【确定】即可创建应用。
- “应用名称”:自定义的应用名称;
- “应用分类”: 1. 第三方软件供应商,请选择公共平台,2. 自主开发ERP系统卖家,请选择自有平台;
- “应用图标”:上传本地系统的图标,系统logo或公司logo小图标;
- “应用Code”: 指应用的平台代码,API调用时基础参数platfrom的值,创建后不可以修改。
列表字段说明:
- “状态”:完成创建应用即是“已开通授权”状态,暂不进行应用审核;
- “用户”:显示已经绑定在您的应用中的卖家万邑联账户数量,点击可跳转至“我的用户”页面。
- “默认授权”:默认可调用物流接口的权限范围。
- “操作“:管理应用:编辑删除应用,进行开发配置,订阅推送消息等
4.进入管理应用页面,完成开发配置
- client_id:应用的唯一标识码
- client_secret:应用的密钥
授权链接:链接需配置后生成,您只需复制并在您的应用中将此链接制成供卖家点击的按键即可,卖家使用万邑联账户进行登陆验证完成授权
授权回调方式配置“回调方式”:1、静态回调,支持默认回调地址及自定义回调地址;2、动态回调,指服务器请求,需返回成功码
- “回调页面URL”: 指在卖家授权时,万邑通(Winit)签权服务器返回给您授权码“access_token/token”,开发者用于接收的URL。
- 使用默认回调地址,即不用填写使用万邑联的默认的回调地址,一般用于不便于使用URL地址接收授权码情形(如您的ERP系统是C/S结构的),卖家授权后直接将授权展示在签权服务器的页面上,卖家可复制粘贴。
- 使用自定义回调地址,静态回调和动态回调,都会返回username(万邑通注册账号)、access_token;区别,静态回调卖家授权成功后浏览器会重定向,动态回调仅提示卖家授权成功
卖家授权&token获取
1、卖家点击上述“授权链接”跳转至授权页面,使用万邑联账户进行授权的界面,如下:
授权成功后,您可以从页面或者URL中的access_token参数获取到卖家的token,在API调用时,需要使用该token值。
account账号即API调用时传输的appkey
2、卖家也可登陆万邑联系统,进入【万邑联-个人中心-系统设置-获取Token】页面,获取token
- 卖家可解除已授权的应用或重新授权操作
- 若卖家刷新token,历史授权的所有应用将失效(需重新授权)
管理应用
1、编辑
2、删除::绑定在应用上的卖家万邑联账户为零时,才可以进行删除
点击“我的用户”,暂只支持显示您的应用已经绑定的卖家万邑联账户信息。
列表字说明:
- “绑定账户”:卖家进行授权的万邑联账户。
- “绑定时间“:卖家进行授权的时间。
- “有效时间”:一次授权默认的授权码有效期为1.5年,卖家可以登陆 “万邑联->个人中心->授权管理”在有效期到来前进行【继延】或【解除】授权。
- “状态”:默认为“已经开通授权”,卖家解除授权后为失效状态。
关键词