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

对接场景介绍

名词解释#

平台师傅:指万师傅平台师傅资源,商家通过万师傅平台直接找师傅完成订单服务;
总包:指万师傅平台总包服务商,商家下单找总包,由总包找师傅并跟进师傅服务完成;
商品类目映射:指万师傅根据第三方平台提供的商品类目ID,配置万师傅系统商品类目与第三方类目映射关系,支持一对多;商家下单时,第三方系统将已配置的类目ID传参给万师傅,万师傅根据类目ID进行订单商品匹配;此模式适合有统一商品类目的平台,优势:商家无需在万师傅后台维护商品信息,减少商家工作量;不足:类目映射无法具体到某一商品,类目属性默认配置;
商品SKU映射:指商家提前在万师傅维护商品信息(含商品sku),商家下单时,第三方系统将已维护的SKU传参给万师傅,万师傅通过SKU进行订单商品匹配;此模式适合第三方没有统一的商品类目,由商家自行维护类目和商品的平台;

1.1 物流类平台接入场景#

物流系统与万师傅打通,由物流系统将上游商家订单统一收口,以平台角色对接万师傅,商家无需使用万师傅系统,此场景一般以商品类目映射模式下单,支持找总包和找平台师傅的模式;
查看物流类平台接入指南>

1.2 ERP类平台接入场景#

ERP平台接入万师傅,包含商家自研类的ERP和商家使用第三方企业提供的ERP对接,此场景支持商品类目映射和商品SKU映射,以及支持找总包和找师傅的模式;
若涉及订单客户信息加密情况,需ERP平台自行解密,或提供解密接口供万师傅对客户信息进行解密,否则系统无法根据订单客户地区推单找师傅,以及师傅无法联系到客户提供服务;
查看ERP类平台接入指南 >

1.3 电商类平台接入场景#

电商平台与万师傅打通,商家直接在电商平台可以下单给万师傅平台,支持商品类目映射和商品SKU映射,以及支持找总包和找师傅。
查看电商类平台接入指南 >

FAQ#

1、万师傅是否支持第三方平台传客户虚拟号下单?
答:支持,客户手机号目前支持的虚拟号样式:
13168760733[1222]
13168760733【1222】
13168760733,1222
13168760733,1222
13168760733#1222
13168760733-1222
使用虚拟号引发的问题:1、虚拟号过期后,师傅将联系不到客户;2、虚拟号无法收到万师傅发送给客户的短信,如告知客户,商家已为客户安排了师傅上门安装等场景短信,无法触达。
2、在商家后台发布了订单,为什么在师傅端看不到订单?
答:1、确认订单服务地址在师傅服务区域之内、师傅是否具备订单服务类型和类目的相关资质;2、可以使用测试环境手动推单给师傅的接口(仅用于联调测试使用)
测试环境-推送订单给指定师傅。
修改于 2024-07-23 12:50:46
上一页
平台介绍
下一页
物流类平台接入
Built with