万师傅开放平台文档中心
  1. 二、接入流程指引
万师傅开放平台文档中心
  • 一、平台介绍
    • 平台介绍
  • 二、接入流程指引
    • 对接场景介绍
    • 物流类平台接入
    • ERP类平台接入
    • 电商类平台接入
    • 万师傅业务流程
    • 接口报错快速排查指南
  • 三、开发前必读
    • 万师傅名词说明
    • 版本更新说明
    • 1、申请授权秘钥
    • 2、API 接口参数规范
    • 3、API 签名
    • 4、目前支持的服务类目和类型
    • 5、接口 code 码
  • 四、开发接口列表
    • 最小化对接
      • 下单
        • 下单接口文档
        • 下单接口
      • 服务节点回传
        • 服务节点通知
    • 更多能力接口
      • 订单催服务
      • 商品库查询接口
      • 订单支付接口
      • 订单费用调整相关接口
        • 总包订单费用调整原因查询接口
        • 子订单审核接口
        • 增加子费用
          • 订单新增费用接口
          • 增加子费用示例
      • 完工验收相关接口
        • 订单完工验收接口
      • 退款相关接口
        • 订单退费接口
        • 退款仲裁
          • 仲裁类别查询接口
          • 仲裁撤销接口
          • 仲裁提交证据接口
          • 仲裁申请接口
      • 关单相关接口
        • 关单审核接口
        • 订单关闭接口
        • 第三方工单申请接口
      • 投诉相关接口
        • 获取支持赔付的银行卡列表接口
        • 发起投诉接口
        • 撤销投诉接口
        • 获取投诉类别接口
        • 提交举证接口
        • 补充举证
        • 赔付收款渠道
        • 获取投诉详情
      • 物流相关接口
        • 物流到货信息更新接口
      • 订单信息查询相关接口
        • 费用明细查询接口
        • 查询师傅完工图接口
        • 订单子费用明细查询接口
        • 订单费用明细查询
      • 更多服务节点回传
        • 定时单服务节点通知
        • 总包调整费用节点通知(非最小化对接内容)
        • 仲裁节点通知
        • 费用调整原因列表数据更新节点通知
        • 保外维修单节点通知
        • 催单回复通知
        • 总包发起关单申请通知
        • 旧件寄回通知
        • 二次上门节点通知
        • 总包审核关单申请回传
        • 售后单处理通知
        • 一口价订单服务节点通知
      • 售后单相关接口
        • 创建售后单接口
        • 拉取售后单接口
    • 测试环境查下订单服务节点
      • 查询订单服务节点
    • 测试环境推单给指定师傅接口
      • 测试环境-推送订单给指定师傅
    • 用户信息相关接口
      • 更改子用户角色接口
  1. 二、接入流程指引

ERP类平台接入

ERP类平台,如:吉客云
支持通过阿里奇门的方式对接

1、注册万师傅账号#

测试环境:点击注册/登录
说明:测试环境需要配置hosts,否则无法访问使用,-->查看hosts配置信息
测试环境短信接收不到,可联系万师傅测试人员或产品对接人获取;
也可以使用万师傅提供的测试账号:查看测试账号>
生产环境:点击注册/登录

2、获取平台授权秘钥#

请向万师傅产品对接人获取,秘钥区分测试环境和生产环境;
授权秘钥(授权信息请妥善保管,切勿外泄)包含如下:
licenseId:用户账号授权码, 用于识别用户身份
companySecret: 企业秘钥. 用于接口签名加密

3、商品映射配置#

erp对接支持商品sku映射和商品类目映射两种方式:
模式一:商品sku映射:商家用户在万师傅商家后台-商品库-上传商品,商品型号信息(即SKU)需与第三方系统商品SKU信息保持一致,否则会导致下单失败;
image.png
模式二:商品类目映射:请向万师傅产品对接人获取对应商品模板表;并根据模板填商品映射信息,由万师傅进行配置;
模板样例:
image.png
模式建议:如果平台能统一商家的商品类目,建议走类目映射,可以节省商家用户维护万师傅商品库的时间,如果采用SKU映射,商品量多时,维护时间也随之增加,商家比较难接受;

4、研发对接#

第三方研发根据业务诉求,确认需要对接的接口,以及接口对接调试;调试前可运行模拟调用接口,了解接口入参、出参数据结构:
image.png

5、测试#

注册万师傅商家账号商家后台测试账号
下载万师傅-师傅端APP测试版,在历史版本列表选择最新版本下载,-->点击去下载(https://www.pgyer.com/test-wanshifu)
image.png
注册万师傅-师傅账号,用户接单和服务过程测试;
也可使用万师傅提供的测试师傅账号:查看师傅测试账号>
根据万师傅业务流程图进行流程测试,万师傅业务流程>;
温馨提示:商家下单后(测试环境),师傅看不到订单?可以通过人工推单给师傅--->测试环境-推送订单给指定师傅
总包服务商后台
适合下单给总包服务商模式的系统对接方使用
总包服务商后台登录---->点击登录
测试账号:【查看总包服务商测试账号】

6、发布上线#

测试完成后,请向万师傅产品对接人获取生产环境授权秘钥信息,并发布上线。

修改于 2024-06-13 08:29:28
上一页
物流类平台接入
下一页
电商类平台接入
Built with