文档中心
- 平台公告
- 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授权操作指引
- 常见问题
新手接入指南
更新时间: 2023-08-07 11:47:53 访问次数:35099
注册开发者账户
首先,开始对接API之前,您需注册成为开发者账户,拥有开发者账户才具备调用API权限。
- 如果您已经拥有万邑联系统账户,可以直接使用万邑联账户登录(首次登陆需补充开发者账户信息)
- 如果您没有万邑联系统账户,可以注册开发者后,使用开发者账户登录。立即注册
创建应用&应用授权
登陆开发者管理后台,创建开发者应用(通常指ERP系统,卖家将授权token给应用从而获得访问数据权限),获得卖家绑定万邑联账户的授权链接并完成授权操作
- 创建应用可获取接口请求的基本参数信息:platform、Client_ID、Client_Secret
- 授权操作获取万邑联账户信息:app_key、token
接口调试
对接准备
- 了解接口调用的基础参数和签名认证方法。签名认证获取基本参数信息:sign、client_sign
- 了解测试相关信息:沙箱环境与正式环境。获取API调用地址。
注意:沙箱环境与正式环境的调用地址、创建应用的菜单及应用基本参数和事件订阅url、卖家账户token等信息都不相同。上线前请替换为正式环境信息
项目 | 沙箱环境 | 正式环境 |
---|---|---|
万邑联(卖家网站) | https://sandboxseller.winit.com.cn/ 帐户、密码详见开放平台 |
https://seller.winit.com.cn/ |
开放平台(开发者账户) | https://developer.winit.com.cn |
https://developer.winit.com.cn |
API调用地址 | https://sandboxopenapi.winit.com.cn/openapi/service app_key:rebecca Token:89435277FA3BA272DE795559998E- platform:使用万邑联账号或开发者账号登录开发者平台在菜单【沙箱测试-沙箱应用】创建的应用code client_id:在菜单【沙箱测试-沙箱应用】创建应用的client_id client_secret:在菜单【沙箱测试-沙箱应用】创建应用的client_secret sign:根据正序入参MD5的签名认证 client_sign:根据正序入参MD5的签名认证 |
https://openapi.winit.com.cn/openapi/service app_key:万邑联账号,若无账号请先注册 Token:登录万邑联-个人中心-系统设置-获取token。或通过卖家授权获取 platform:使用万邑联账号或开发者账号登录开发者平台在菜单【我的应用】创建的应用code client_id:在菜单【我的应用】创建应用的client_id client_secret:在菜单【我的应用】创建应用的client_secret sign:根据正序入参MD5的签名认 client_sign:根据正序入参MD5的签名认证 |
事件订阅 | 在菜单【沙箱测试-沙箱应用-管理】中配置的url 注:沙箱测试事件订阅的URL需联系客服申请访问权限 |
在菜单【我的应用-管理】中配置的url |
确认API
确认您需对接的物流服务,并了解对接API的次序
API字典
1、海外仓储:商品 入库 出库 退货 库存
2、全球直发快递:ISP-万邑邮选
3、尾程联盟:LMA
开发
查看SDK进行开发。 SDK/Demo
测试
使用开发者平台提供的工具进行测试
- 接口测试:在线接口调用测试工具,支持沙箱和正式环境接口调用测试。接口测试工具
- 沙箱测试:登录开发者网站创建一个属于自己的应用,进而用这个应用对应的参数进行开发和联调,沙箱环境无需再注册万邑通账号和开发者账号,切换到正式环境时替换为正式环境对应的client_id,client_secret,platform,appkey,token即可。查看沙箱操作说明
- 沙箱用例:沙箱测试时,部分流程需要WINIT协助审核或走单情况,可执行沙箱用例,目前支持执行的用例如下:
- 注册商品审核
- 入库单状态流转
- 出库单状态流程
- 部分流程触发的订阅事件推送
完成上线
上线并投入使用