万师傅开放平台文档中心
二、接入流程指引
复制页面
万师傅开放平台文档中心
一、平台介绍
平台介绍
二、接入流程指引
对接场景介绍
物流类平台接入
ERP类平台接入
电商类平台接入
万师傅业务流程
接口报错快速排查指南
三、开发前必读
万师傅名词说明
版本更新说明
1、申请授权秘钥
2、API 接口参数规范
3、API 签名
4、目前支持的服务类目和类型
5、接口 code 码
四、开发接口列表
最小化对接
下单
下单接口文档
下单接口
服务节点回传
服务节点通知
更多能力接口
订单催服务
商品库查询接口
订单支付接口
订单费用调整相关接口
总包订单费用调整原因查询接口
子订单审核接口
增加子费用
订单新增费用接口
增加子费用示例
完工验收相关接口
订单完工验收接口
退款相关接口
订单退费接口
退款仲裁
仲裁类别查询接口
仲裁撤销接口
仲裁提交证据接口
仲裁申请接口
关单相关接口
关单审核接口
订单关闭接口
第三方工单申请接口
投诉相关接口
获取支持赔付的银行卡列表接口
发起投诉接口
撤销投诉接口
获取投诉类别接口
提交举证接口
补充举证
赔付收款渠道
获取投诉详情
物流相关接口
物流到货信息更新接口
订单信息查询相关接口
费用明细查询接口
查询师傅完工图接口
订单子费用明细查询接口
订单费用明细查询
更多服务节点回传
定时单服务节点通知
总包调整费用节点通知(非最小化对接内容)
仲裁节点通知
费用调整原因列表数据更新节点通知
保外维修单节点通知
催单回复通知
总包发起关单申请通知
旧件寄回通知
二次上门节点通知
总包审核关单申请回传
售后单处理通知
一口价订单服务节点通知
师傅与客户已通话节点通知
师傅发起子订单状态回传
售后单相关接口
创建售后单接口
拉取售后单接口
测试环境查下订单服务节点
查询订单服务节点
测试环境推单给指定师傅接口
测试环境-推送订单给指定师傅
用户信息相关接口
更改子用户角色接口
二、接入流程指引
复制页面
电商类平台接入
电商类平台,如:京东、拼多多
1、注册万师傅账号
#
测试环境:
点击注册/登录
说明:测试环境需要配置hosts,否则无法访问使用
,-->
查看hosts配置信息
测试环境短信接收不到,可联系万师傅测试人员或产品对接人获取;
也可以使用万师傅提供的测试账号:
查看测试账号>
生产环境:
点击注册/登录
2、获取平台授权秘钥
#
请向万师傅产品对接人获取,秘钥区分测试环境和生产环境;
授权秘钥(授权信息请妥善保管,切勿外泄)包含如下:
licenseId:用户账号授权码, 用于识别用户身份
companySecret: 企业秘钥. 用于接口签名加密
3、商品映射配置
#
电商类平台对接支持商品sku映射和商品类目映射两种方式:
模式一:商品sku映射:商家用户在万师傅商家后台-商品库-上传商品,商品型号信息(即SKU)需与第三方系统商品SKU信息保持一致,否则会导致下单失败;
模式二:商品类目映射:请向万师傅产品对接人获取对应商品模板表;并根据模板填商品映射信息,由万师傅进行配置;
模板样例:
模式建议
:如果平台能统一商家的商品类目,
建议走类目映射
,可以节省商家用户维护万师傅商品库的时间,如果采用SKU映射,商品量多时,维护时间也随之增加,商家比较难接受;
4、研发对接
#
第三方研发根据业务诉求,确认需要对接的接口,以及接口对接调试;调试前可运行模拟调用接口,了解接口入参、出参数据结构:
5、测试
#
注册万师傅商家账号商家后台测试账号
下载万师傅-师傅端APP测试版,在历史版本列表选择最新版本下载,-->点击去下载(
https://www.pgyer.com/test-wanshifu
)
注册万师傅-师傅账号,用户接单和服务过程测试;
也可使用万师傅提供的测试师傅账号:
查看师傅测试账号>
根据万师傅业务流程图进行流程测试,
万师傅业务流程>
;
温馨提示:商家下单后(测试环境),师傅看不到订单?可以通过人工推单给师傅--->
测试环境-推送订单给指定师傅
注意:1、如果是下单给总包,请找万师傅测试配合
总包服务商后台
适合下单给总包服务商模式的系统对接方使用
总包服务商后台登录---->
点击登录
测试账号:【
查看总包服务商测试账号
】
6、发布上线
#
测试完成后,请向万师傅产品对接人获取生产环境授权秘钥信息,并发布上线。
修改于
2022-12-20 06:24:36
上一页
ERP类平台接入
下一页
万师傅业务流程